Wikipédia:Ptwikis/doc

Origem: Wikipédia, a enciclopédia livre.

O projeto é desenvolvido em Flask que um Framework para aplicações Web em Python, o Flask é relativamente simples, porém, dependendo da ferramenta que está sendo desenvolvida pode não ser necessário entrar nos detalhes de seu funcionamento. Para criar páginas em HTML por exemplo, é suficiente ter um conhecimento básico sobre o Jinja, que é uma biblioteca utilizada pelo Flask para adicionar recursos semelhantes às predefinições e parserfunctions no código HTML.

No ptwikis existe um arquivo/ficheiro HTML chamado base.html, ele é como uma predefinição, é possível chamar ele em outros html e dizer o que deve ser inserido dentro dele, por exemplo

{% extends "base.html" %}
{% block content %}

<p>Este é um exemplo que está sendo explicado na página
 <a href="//pt.wikipedia.org/wiki/Wikip%C3%A9dia:Ptwikis/doc">Wikipédia:Ptwikis/doc</a>.</p>

{% endblock %}

é o suficiente para gerar a página tools.wmflabs.org/ptwikis/Exemplo, veja que o conteúdo está dentro de um bloco Predefinição:Cód, isso no Jinja é o equivalente a Predefinição:Cód em código wiki. Veja a documentação sobre uso de templates do Jinja para ver outros recursos disponíveis.

Adicionando páginas no servidor[editar código-fonte]

O Flask já está configurado para que quando um endereço '/ptwikis/X' seja acessado, seja automaticamente procurado um X.html dentro da pasta 'templates' no servidor, então basta colocar um html lá para ele ser exibido. Ao acessar o servidor e fazer modificações no código lembre-se de fazer um commit, para que as mudanças não se percam e para que fique registrada a sua autoria.