Project:Manual/pt-br

Manual "logo"
Manual "logo"

Esta página é para discussão e coordenação do Manual do MediaWiki.

O manual está localizado no namespace Manual: (iniciando-se em Manual:Conteúdos ) e é distribuído sob a licença GNU Free Documentation License. Observe que o conteúdo do manual deve ser mantido completamente separado das páginas de ajuda de domínio público localizadas no namespace Help:, pois elas são publicadas sob uma licença diferente e incompatível (veja Project:Direitos autorais para mais detalhes).

Category:Manual/pt-br#%20

Conteúdo

Para informações gerais sobre o que deve ir para qual namespace, consulte Project:Namespaces.

  • Que conteúdo deve estar no namespace Manual:?
    • Informações sobre a configuração de uma nova wiki
    • Informações sobre movimentação/atualização/exportação/importação
    • Documentação para Scripts de manutenção
    • Informações sobre hooks/API/layout de banco de dados etc.
  • O que não deve estar no namespace Manual:?
    • Ajuda básica sobre o uso e edição. Isto pertence ao namespace Help:
    • Extensões e ferramentas, que não fazem parte da distribuição padrão do MediaWiki. (Extension: namespace)

Estrutura

Skins

Skin documentation describes how developers and admins can use and create skins.

Documentation for individual skins is stored outside the Manual: namespace in the Skin: namespace.

Extensions

Extension documentation describes how developers and admins can use and create extensions.

Documentation for individual extensions is stored outside the Manual: namespace in the Extension: namespace.

Extension development

There is a set of pages that provides information for developers about how to create and modify extensions. Some of these pages are specific to extensions, like the extension.json schema, while others also include information that is relevant to MediaWiki core developers, like the hooks documentation.

The landing page for extension development is Manual:Desenvolvendo extensões. All pages related to extension development should include the navigation template Template:Extension development at the end of the page, with the exception of individual hook and configuration variable pages.

Extension points

In the docs, strategies for extending MediaWiki core in extensions, skins, and user scripts/gadgets are referred to as extension points. Documentation about how to use extension points should be stored on a dedicated page in the Manual: namespace, such as Manual:Ganchos. To help developers discover these extension points, the extension points available to extensions, skins, and user scripts are linked from their respective development landing pages.

Extension points used by extensions should be listed on:

Extension points used by skins should be listed on:

Extension points used by user scripts/gadgets should be listed on:

Discussion

Alguma discussão foi firmada em relação ao layout do namespace Manual:, mas não foi feita nenhuma decisão formal. O principal debate é se nas páginas do Manual devem ser organizadas em uma hierarquia plana, com todas as páginas no nível do diretório raiz, ou com subtemas como subpáginas dos principais temas. Aqui é onde a discussão prévia ocorreu:

Diretrizes editoriais

Formatação

a ser discutido

Cores

a ser discutido

Capturas de tela

  • Use http://test.leuksman.com/view/Main_Page para tirar screenshots (Nota Nota: Atualmente não está funcionando)
  • Imagens devem ser cortadas para mostrar apenas a parte relevante do local (sem arredores do navegador).

Tabelas

a ser discutido

Esquema de nomenclatura de páginas que não estão em Inglês

Algumas discussões gerais sobre internacionalização estão em Projeto:Política linguística.

Category:Manual/pt-br