A WikiP@P é um recurso do Portugal-a-Programar® cujo objectivo é criar uma Wiki portuguesa de programação com conteúdo fiável e de qualidade em português. É um recurso que depende da boa-vontade da comunidade em contribuir. Infelizmente, são poucos os que se interessam pela Wiki, e mesmo aqueles que se esquecem de a consultar para esclarecer as suas dúvidas. Há aqueles que a não conhecem.

É importante a comunidade contribuir para a Wiki! A comunidade não pode esperar ver as coisas aparecerem, esquecendo que há trabalho e empenho por detrás de cada documento.

O Staff da Wiki trata de garantir a sua boa saúde. Contudo, sozinha não pode garantir conteúdo - o conteúdo deve ser criado por todos.

Para quem deseja ajudar a Wiki e não sabe como o fazer, segue-se um FAQ.

A Wiki está organizada por namespaces. A actual estrutura geral segue o mais próxima possível a estrutura do fórum, e é a seguinte:

• algoritmos - documentos sobre Lógica e Algoritmia.
• dev_geral - organizado por linguagens, tais como Java, Pascal, Python e Assembly.
• dev_net - para linguagens de desenvolvimento na Plataforma .NET, como VB.NET e ASP.NET.
• dev_web - para linguagens de Desenvolvimento Web
• extra-programação - assuntos tais como Automação Industrial, Segurança e OpenGL.
• revistaprogramar_arquivo - zona com artigos da Revista PROGRAMAR, organizados por edições.
• sistemas_operativos - área para documentos relacionados com SOs.

Existe ainda a namespace Wiki, onde estão alguns documentos relevantes, entre eles a To Do List, bem como a namespace playground (recreio), onde se podem realizar diversos testes, ou seja, é uma área só com documentos de teste.

Existe uma To Do List da Wiki. Consulta-a e ajuda no que puderes!

Os documentos são criados partindo de URLs que não existem. O URL de um documento segue a estrutura das namespaces, ou seja, indica a posição do documento. Por exemplo, a To Do List está na namespace wiki, logo o seu URL é wiki:todo, sendo todo um nome dado pelo criador do documento, neste caso derivado de To Do. Imagine-se a criação de um snippet (código) na área de VB.NET com um pequeno programa. Este programa determina o maior e o menor número introduzido pelo utilizador num total de N. O título do documento será "Maior e Menor". Um URL aconselhável será maior_menor. Aceda-se então ao URL http://wiki.portugal-a-programar.pt/dev_net:vb.net:snippet:maior_menor. Vai aparecer o seguinte:

No canto superior esquerdo desta janela, está a opção "Criar página". É aqui que se vai criar o documento.

Existe uma barra de formatação, com as opções de negrito, itálico, etc. Utiliza antes estes botões, a formatação da Wiki é diferente da do fórum! Como pode ser visto, um título é ladeado de seis "iguais" ( = ). Não te esqueças de o colocar!

Por fim, podes ir prevendo o documento antes de ser publicado. O Sumário da Edição diz por defeito "Criação deste novo documento". Podes deixar estar, ou eliminar. NÃO cheques a opção "Alterações Menores", para que o novo documento possa aparecer na Home Page nas Alterações Recentes. Para guardar, faz "Gravar". Irá ver o novo documento.

As tags são etiquetas que listam documentos que abordam o tema dessa tag. Por exemplo, a tag vbnet lista os documentos que abordam VB.NET. A lista está na Home Page, como Categorias. Uma tag é acrescentada com a seguinte estrutura, no fim do documento:

{{tag>categoria1 categoria2 ...}}

Por exemplo, um documento que esteja relacionado com VB.NET e MySQL terá as tags vbnet e mysql:

{{tag>vbnet mysql}}

Na Wiki, estão disponíveis os documentos necessários ao conhecimento das regras e da sintaxe da Wiki.

• Regras e guia de estilo - as regras da Wiki P@P
• DokuWiki (o nosso sistema Wiki) - índice da documentação
• Formatting Syntax (em inglês) - a síntaxe da DokuWiki
• Sintaxe de expressões matemáticas - para introduzir fórmulas matemáticas

Se tiverem mais questões, coloquem-nas para que este FAQ seja actualizado com novas questões pertinentes.

Ajuda a Wiki a crescer! Participa!

Coloca mais questões neste tópico para que este FAQ seja expandido e actualizado!