Skip to main content

Adicionar ou editar páginas de wiki

Você pode adicionar e editar páginas wiki diretamente no GitHub ou localmente usando a linha de comando.

Quem pode usar esse recurso?

Wikis estão disponíveis em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para mais informações, confira "Planos do GitHub".

Adicionar páginas wiki

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique no Wiki .

    Captura de tela do menu em um repositório. A opção "Wiki" está contornada em laranja escuro.

  3. No canto superior direito da página, clique em Nova Página.

  4. Se preferir escrever em um formato diferente do markdown, use o menu suspenso “Modo de edição” para escolher outro formato.

    Captura de tela da página "Criar página". O menu suspenso "Modo de edição" é contornado em laranja escuro.

  5. Use o editor de texto para adicionar o conteúdo da página.

  6. No campo "Editar mensagem", digite uma mensagem de confirmação descrevendo o novo arquivo que você está adicionando.

  7. Para fazer commit das alterações no wiki, clique em Salvar Página.

Editar páginas wiki

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique no Wiki .

    Captura de tela do menu em um repositório. A opção "Wiki" está contornada em laranja escuro.

  3. Usando a barra lateral do wiki à direita, navegue até a página que deseja alterar. No canto superior direito da página, clique em Excluir.

  4. Use o editor de texto para editar o conteúdo da página.

  5. No campo "Editar mensagem", digite uma mensagem de confirmação descrevendo o novo arquivo que você está adicionando.

  6. Para fazer commit das alterações no wiki, clique em Salvar Página.

Adicionar ou editar páginas wiki localmente

Os wikis fazem parte dos repositórios Git, de modo que é possível fazer alterações localmente e fazer push delas no seu repositório usando o fluxo de trabalho Git.

Clonar wikis para seu computador

Cada wiki fornece uma maneira fácil de clonar o respectivo conteúdo para seu computador. Depois de criar uma página inicial no GitHub, você pode clonar o repositório em seu computador com a URL fornecida:

$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.wiki.git
# Clones the wiki locally

Depois de clonar o wiki, é possível adicionar novos arquivos, editar os existentes e fazer commit das alterações. Você e seus colaboradores podem criar branches ao trabalhar em wikis, mas somente as alterações enviadas por push ao branch-padrão serão ativadas e disponibilizadas para os seus leitores.

Sobre nomes de arquivo de wiki

O nome de arquivo determina o título da sua página wiki e a extensão do arquivo determina como o conteúdo do wiki será renderizado.

Os wikis usam nossa biblioteca de marcação de código aberto para converter a marcação e determina o conversor que deve ser usado pela extensão de um arquivo. Por exemplo, se você der a um arquivo o nome foo.md ou foo.markdown, o wiki usará o conversor Markdown, enquanto um arquivo chamado foo.textile usará o conversor Textile.

Não use os seguintes caracteres nos títulos de páginas do wiki: \ / : * ? " < > |. Os usuários em determinados sistemas operacionais não poderão trabalhar com nomes de arquivo contendo esses caracteres. Certifique-se de escrever seu conteúdo usando uma linguagem markup que corresponda à extensão, ou o conteúdo não será renderizado adequadamente.