Portal dos Programadores
É uma sinopse de alto nível do desenvolvimento do MediaWiki, incluindo hiperligações para os principais documentos, recursos e ferramentas disponíveis para os programadores do MediaWiki. Está escrito para programadores qualificados LAMP que têm experiência na utilização do MediaWiki.
- Se quiser "utilizar" as APIs da Web da Wikimedia, visite o API:Web APIs hub (trabalho em progresso).
- Se quiser contribuir para o desenvolvimento do software Wikimedia, consulte Novos Programadores .
- Para um guia introdutório para desenvolver o MediaWiki e as extensões do MediaWiki, leia Como tornar-se em um hacker do MediaWiki .
- If you want to collaborate with other third-party MediaWiki users, the Grupo de Participantes do MediaWiki (MWStake) is a MediaWiki user group consisting of MediaWiki developers, system administrators, users, consultants, and hosting providers.
Sinopse
O MediaWiki é o software da Wikipédia, dos projetos relacionados com ela e de milhares de wikis em todo o mundo.
MediaWiki is written in the PHP programming language.[1] It uses jQuery as the client JavaScript library.
MediaWiki is primarily written for the LAMP platform[2] and runs on most operating systems. MediaWiki primarily uses the MySQL and MariaDB database servers.[3]
Development happens in an open source style[4], is largely coordinated online, and supported by the Wikimedia Foundation, though volunteer community developers play a huge part as well.
- A discussão sobre o desenvolvimento acontece em várias listas de discussão e nos canais de IRC. The main developer list is wikitech-l. The main developer IRC channels are #mediawiki and #wikimedia-dev.
- Código fonte is managed using the Git version control system.[5]
- Revisão do código para a maioria dos projetos é executado em Gerrit . Siga este tutorial para configurar o Git e Gerrit para enviar patches.
- Relatórios de Erros (bugs) e tarefas para a maioria dos projetos são geridos no Phabricator .
- Developers extending or interfacing with MediaWiki (instead of working on the core code) have several convenient extension points, including the API, the Hooks system and Skins – see the #Extending MediaWiki section of this page for an overview.
Documentos chave
Código, desenvolvimento e estilo
- Development policy – uma visão geral das principais políticas de desenvolvimento.
- Convenções de programação – aprenda a escrever código no estilo do MediaWiki.
- Security for developers – saiba como ajudar a manter o MediaWiki protegido.
- Manual:Pre-commit checklist – read this checklist before committing code.
- Guia de revisão do código – a guide for reviewers of commits to the MediaWiki source code.
- Technical Decision Making Process – read about the process to decide on making larger technical changes.
Depuração e testes
- Como depurar – um guia para a depuração do MediaWiki.
- Manual:Errors and symptoms – an overview of common MediaWiki errors and their correlating symptoms.
- Browser testing – learn to write UI tests for MediaWiki using Selenium.
- Unit testing – learn to write unit tests for MediaWiki using PHPUnit.
- Testes de integração da API – aprenda a escrever testes de integração da API para o MediaWiki, utilizando Mocha.
- Security for developers – aprenda a escrever código seguro.
Arquitetura
- MediaWiki architecture – an introduction to MediaWiki's architecture.
- Manual:Code – uma visão geral das partes principais do código-fonte do MediaWiki.
- Manual:Disposição da Base de Dados – uma visão geral dos esquemas de banco de dados do MediaWiki.
- Manual:Global object variables – uma lista parcial das principais variáveis globais.
- Tradução – saiba mais sobre o sistema de internacionalização do MediaWiki.
- Manual espaço nominal nesta wiki – documentação para os programadores.
- MediaWiki Class Reference – technical documentation generated from the MediaWiki source code. (Note: The class reference is a large, slow-to-load page.)
Subsistemas
- API – MediaWiki's API provides direct, high-level access to the data contained in the MediaWiki databases.
- ContentHandler – MediaWiki's framework for supporting custom types of page content.
- Acesso à Base de Dados – an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.
- Job queue – MediaWiki's framework for processing long-running tasks asynchronously.
- API das Mensagens – MediaWiki's framework for providing localized application messages with PHP or JavaScript.
Ampliar o MediaWiki
MediaWiki has been designed to allow for modification without changing the "core code". This makes it easy to update to a new version of MediaWiki without having to manually merge in old extension code changes. There are six main extension points that allow developers to change or extend what MediaWiki can do. The extension points are:
- API – access the data and metadata of MediaWiki instances through its web API.
- Hooks – every time a given event happens, do something.
- Funções do Analisador – create a new command like:
{{#if:...|...|...}}
. - Temas – change the look and feel of MediaWiki.
- Páginas Especiais – add a new special page.
- Extensões de Etiqueta – create a new tag like:
<newtag>...</newtag>
. - Extending wiki markup – add a parser hook to modify the content of wikitext.
Ajuda para os programadores de extensões
- Manual:Desenvolver extensões – a guide to developing extensions.
- Project:WikiProject Extensions
- Extensions FAQ
- See Categoria:Extensões , for a list of extensions.
- Manual:$wgExtensionFunctions – use to defer setup (or run other callbacks) for extensions until after the MediaWiki core is setup.
- Extension:BoilerPlate - a blank extension template.
Ajuda para os programadores de temas
- Manual:Skinning Part 1 – instruções sobre como criar um tema para o MediaWiki.
- Manual:Skin configuration – um guia para a configuração de temas para uma wiki.
Ajuda para reutilizar código de bibliotecas
- Manual:Developing libraries – um guia para a inclusão de bibliotecas de terceiros para utilizar com o MediWiki
Utilizações de wikis de terceiros
- Enterprise hub — Para wikis empresariais
- Centro Académico — Para wikis Académicas
Notas
- ↑ Not all of MediaWiki is written in PHP. Some supporting tools are written in other languages, including batch files, shell scripts, makefiles and Python.
- ↑ MediaWiki runs on most platforms that can support PHP, however, the lack of certain utilities or operating system features may limit the functionality or performance of MediaWiki on non-LAMP platforms.
- ↑ MediaWiki has support for DBMS other than MySQL and MariaDB, including PostgreSQL and SQLite.
- ↑ Developers are a mix of volunteers and paid staff (or contractors) for various organizations. For a full list of who works on the MediaWiki code, read the Developers article.
- ↑ Browse the source code and revisions of code repositories at https://phabricator.wikimedia.org/diffusion/ or download the source code to your system by using Gerrit.