Skip to main content

Sobre wikis

Você pode hospedar a documentação para seu repositório em um wiki para que outras pessoas possam usar e contribuir com seu projeto.

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".

Cada repositório em GitHub.com vem equipado com uma seção para hospedar documentação, chamada wiki. Você pode usar o wiki do repositório para compartilhar conteúdo longo sobre seu projeto, por exemplo, como usá-lo, como ele foi projetado ou seus princípios básicos. Um arquivo README informa rapidamente o que seu projeto pode fazer, enquanto você pode usar um wiki para fornecer documentação adicional. Para obter mais informações, consulte "Sobre LEIAMEs".

Com wikis, é possível gravar conteúdo assim como em qualquer outro lugar no GitHub Enterprise Cloud. Para obter mais informações, consulte "Introdução à escrita e formatação no GitHub". Usamos nossa biblioteca de marcação de código aberto para converter diferentes formatos em HTML, de modo que você possa optar por escrever seu aplicativo em Markdown ou em qualquer outro formato com suporte.

Você pode usar o Markdown para adicionar expressões matemáticas renderizadas, diagramas, mapas e modelos 3D ao wiki. Para obter mais informações sobre como criar expressões matemáticas renderizadas, confira "Como escrever expressões matemáticas". Para obter mais informações sobre como criar diagramas, mapas e modelos 3D, confira "Criando diagramas".

Se você criar um wiki em um repositório público, o wiki estará disponível para o público. Se você criar uma wiki em um repositório privado ou interno, somente as pessoas com acesso ao repositório poderão acessar a wiki. Para obter mais informações, consulte "Definir a visibilidade do repositório".

Você pode editar wikis diretamente no GitHub Enterprise Cloud ou editar arquivos wiki localmente. Por padrão, somente as pessoas com acesso de gravação ao repositório podem fazer alterações no wikis, embora você possa permitir que todos em GitHub.com contribuam para uma wiki em um repositório público. Para obter mais informações, consulte "Alterar as permissões de acesso para wikis".

Observação: os mecanismos de pesquisa indexarão apenas wikis com 500 ou mais estrelas configurados para impedir a edição pública. Para obter mais informações, consulte "Alterar as permissões de acesso para wikis".

Caso precise que os mecanismos de pesquisa indexem o conteúdo, use o GitHub Pages em um repositório público. Para obter mais informações, consulte "GitHub Pages".

Observação: Por motivos de desempenho, as wikis têm um limite flexível de 5.000 arquivos no total, independentemente do tipo de arquivo. Se você exceder esse limite, talvez os usuários não consigam acessar algumas páginas. Se você precisar de um wiki maior, recomendamos usar o GitHub Pages. Para obter mais informações, consulte "GitHub Pages".

Leitura adicional