UFFS/forja
UFFS/forja
25
1
Fork 0
Code Issues 3 Pull requests Projects Wiki Activity
Page: Personalizar perfil
Pages
Home IN 18/SETI/UFFS/2026 Migração de repositório remoto no Git local Personalizar perfil
6 Personalizar perfil
Dalton Scavassa edited this page 2026-04-12 21:15:12 -03:00
Table of Contents

Personalização de perfil individual ou de organização

Por padrão, a página de um perfil individual ou de uma organização é a lista dos seus repositórios. Há uma descrição curta do perfil que, no caso individual, é exibida à esquerda, sob seu avatar ou, na organização, entre seu nome e outros dados. Além dessa descrição padrão, também é possível personalizar o maior espaço da página de perfil para que, no lugar da lista de repositórios, seja exibido um texto formatado com Markdown. Essa substituição ocorre automaticamente quando há um arquivo README.md em um repositório denominado .profile vinculado diretamente à pessoa ou organização. O texto formatado desse arquivo figurará como a "visão geral" do perfil, precedendo a lista de repositórios, que ficará em uma aba seguinte.

Passo-a-passo para personalizar seu perfil

  1. Caso ainda não tenha se autenticado, inicie a sessão de uso da Forja;
  2. Defina dados gerais do perfil público de usuário, algo também disponível pelo item chave de boca Configurações do menu do seu nome, no canto superior direito;
    • Seu avatar (representação gráfica de seu perfil), por padrão, é obtido do serviço federado Libravatar, com base em um endereço de email, mas pode ser definido localmente (recomenda-se imagem quadrada);
  3. Criar novo repositório — item disponível pelo menu + no canto superior direito;
    • Proprietário: o perfil cuja visão geral será personalizada;
    • Nome do repositório: .profile — o nome deve ser exatamente esse, iniciando com ponto;
    • Tornar o repositório privado: ◻️ deixar desmarcado — precisa ser público;
    • Descrição: opcional;
    • Modelo: selecione UFFS/modelo-personalizacao-perfil, criado para facilitar ainda mais o ato;
    • Itens do modelo: marque ☑️ "Conteúdo Git (Branch padrão)";
    • Acionar o botão "Criar repositório".
  4. Editar o arquivo README.md, em Markdown, com os dados e a estrutura que preferir.
    • O editor no próprio navegador poderá ser acionado por um ícone lápis à direita do cabeçalho do arquivo.
    • Alterne entre as abas "Editar arquivo" e "Pré-visualização" até querer "Criar commit das modificações", que as salvará.

Detalhes

  1. O cartão padrão do perfil não suporta mais do que uma ligação principal.
  2. Apenas repositórios .profile comuns (não derivados) serão utilizados para preencher a página de perfil. Repositórios derivados (forks), mesmo que tenham o nome .profile, não serão exibidos como visão geral do perfil. Se quiser usar para isso o conteúdo de um repositório .profile derivado, precisará convertê-lo de derivado para comum na seção "Zona de perigo" das configurações do repositório.
  3. Se o repositório .profile se tornar privado, o README.md será oculto do perfil.

Ligações sociais (informação técnica)

O cartão básico do perfil tem um espaço dedicado à hiperligação para um sítio eletrônico. Essa ligação principal figura na página HTML do perfil acompanhada do atributo rel=me. Já se personalizar seu perfil com o repositório .profile, pode declarar várias ligações desse tipo no arquivo README.md, obtendo grande flexibilidade sobre como deseja exibi-las.

O atributo rel=me é uma maneira de considerar a página que declara essa ligação e a que tem a ligação contrária pertencentes à mesma pessoa ou organização. Sistemas do chamado Fediverso costumam realizar essa validação.

Para conseguir adicionar um atributo rel=me a uma hiperligação no README.md, será preciso escrevê-la diretamente com HTML, em vez do formato Markdown. Por exemplo: <a rel="me" href="https://exemplo.social.br/@username">Meu perfil no Fediverso</a>.