A Wiki P@P é um recurso que tem por objectivo fornecer conteúdos de confiança e gratuitos em português sobre programação e temas relacionados. Esta depende da boa-vontade dos membros do P@P em contribuir com os seus conhecimentos.

Este guia tem por objectivos:

1. Dar a conhecer a Wiki P@P no seu conjunto;
2. Mostrar como se criam documentos nela;
3. Desvendar a sintaxe da DokuWiki;
4. Ensinar técnicas como expressões matemáticas.

Consulta o FAQ!

Este guia está em actualização constante. As informações vão sendo completadas a pouco e pouco. Se tiveres dúvidas, coloca-as no fórum para que este guia se torne mais completo.

A Wiki P@P está feita recorrendo à DokuWiki, ou seja, é um sistema Wiki de criação e edição de documentos informativos livre.

A Wiki está organizada por namespaces segundo uma hierarquia. A principal divisão é pelo tipo de desenvolvimento (development):

• dev_geral - linguagens de programação de carácter geral;
• dev_net - linguagens que correm sobre a plataforma .NET;
• dev_web - linguagens de web-development.

Há depois outras namespaces de carácter ecuménico:

• algoritmo - área sobre lógica e algoritmia;
• sistemas_operativos - área dedicada aos SO’s;
• extra_programacao - zona onde se abordam outros temas relacionados directa ou indirectamente com programação.

Por fim, existe:

• revistaprogramar_arquivo - um arquivo de vários artigos das várias edições da Revista PROGRAMAR.
• wiki - artigos de referência sobre a Wiki P@P e o seu sistema (DokuWiki).

De referir a existência do playground, onde os membros podem realizar experiências diversas sem prejuízo para a Wiki P@P.

Os links dos documentos mostram a localização de um documento. Vejamos um exemplo:

http://wiki.portugal-a-programar.org/dev_geral:pascal:tutorial_2010:indice

Este é o link do actual Tutorial de Pascal da Wiki P@P. A localização deste é vista neste trecho do link: dev_geral:pascal:tutorial_2010:indice Como podemos verificar, o documento está na namespace principal dev_geral, e dentro desta localiza-se na namespace pascal, que contém conteúdos sobre a linguagem de programação Pascal, incluindo o Delphi. Ainda dentro desta, o documento está dentro da namespace tutorial_2010 - este é um exemplo de um documento dividido em vários devido à sua extensão e que, por isso, merece uma namespace própria. Em suma, o caracter : (dois pontos) faz a divisão das namespaces onde se localiza determinado documento: tal e qual como a localização de um ficheiro nos nossos computadores, onde as pastas estão hierarquizadas pelo caracter / ou .

Os conteúdos que são esperados para a Wiki P@P estão relacionados com programação e áreas afins, tais como lógica, algoritmia, sistemas operativos, bases de dados, passando mesmo pela matemática.

Qualquer membro do P@P pode (e deve!) contribuir para a Wiki P@P com os seus conhecimentos. A edição está interdita tão-somente a não-membros, ou seja, a visitantes. Estando um membro com a sessão iniciada, este poderá criar os seus documentos e editar outros.

Existe uma equipa específica destinada à manutenção da Wiki P@P: a Wiki Team.

A sintaxe da Wiki nada tem a ver com a do fórum. É necessário conhecê-la minimamente para se criar bons documentos. Este capítulo vai demonstrar a sintaxe da DokuWiki de uma forma bastante directa e prática.

A primeira regra a ter em mente é dar um bom título ao documento criado. Este deverá ficar no topo da página, entre seis sinais de igual (=), sem nenhum texto antes: este título dará o nome ao documento no índice lateral.

====== Título do documento ======

Os sinais de igual são os indicadores de títulos e subtítulos, sendo o máximo seis sinais de igual e o mínimo dois.

====== Título principal ======
===== Título =====
==== Subtítulo 1 ====
=== Subtítulo 2 ===
== Subtítulo 3 ==

Após os títulos, queremos escrever o nosso texto. A DokuWiki obriga à indicação de parágrafos, e tem códigos para colocar negritos, itálicos, entre outros.

Um parágrafo é indicado da seguinte forma:

Após esta frase, está o indicador de parágrafo.

Excepção feita às listas, onde os parágrafos são feitos pelo indicador de items.

Texto em negrito

**Texto em negrito**

Texto em itálico

//Texto em itálico//

Texto sublinhado

__Texto sublinhado__

Text monospaced

''Texto monospaced''

Texto _Inferior e ^superior à linha.

Texto <sub>Inferior</sub> e <sup>superior</sup> à linha.

Texto rasurado

<del>Texto rasurado</del>

Link para o Portal do P@P

[[http://www.portugal-a-programar.org|Link para o Portal do P@P]]

http://www.portugal-a-programar.org

[[http://www.portugal-a-programar.org]]

Link para o FAQ

[[wiki:faq|Link para o FAQ]]

FAQ - Quero contribuir! Como o faço?

[[wiki:faq]]

Texto seguido de uma nota de rodapé.¹⁾

Texto seguido de uma nota de rodapé.((Uma nota de rodapé))

• Este é um item de uma lista
• Este é outro
  • Este é um subitem
    • E um subitem do subitem
• Voltando ao nível principal…

  * Este é um item de uma lista
  * Este é outro
    * Este é um subitem
      * E um subitem do subitem
  * Voltando ao nível principal...

Os níveis são dados com dois espaços de diferença. O primeiro nível já deverá conter estes dois espaços. A anterior lista, mas numérica:

1. Este é um item de uma lista
2. Este é outro
   1. Este é um subitem
      1. E um subitem do subitem
3. Voltando ao nível principal…

  - Este é um item de uma lista
  - Este é outro
    - Este é um subitem
      - E um subitem do subitem
  - Voltando ao nível principal...

Este é um texto dentro de um bloco de código

<code>
Este é um texto dentro de um bloco de código
</code>

Uma boa forma de citar livros ou pessoas.

<file>
Uma boa forma de citar livros ou pessoas.
</file>

writeln('Texto com highlight, neste caso de Pascal.');

<code pascal>
writeln('Texto com highlight, neste caso de Pascal.');
</code>

exemplo.pas

program exemplo;
begin
     writeln('Programa do qual se pode fazer download directo. ');
end.

<file pascal exemplo.pas>
program exemplo;
begin
     writeln('Programa do qual se pode fazer download directo. ');
end.
</file>

Como te chamas?

Wiki P@P.

Nome fixe!

Tenho 6 anos de idade!

E o que fazes?

Ensino programação a todos!

> Como te chamas?
>> Wiki P@P.
>>> Nome fixe!
>> Tenho 6 anos de idade!
> E o que fazes?
>> Ensino programação a todos!

Uma tabela simples, já com duas células juntas:

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
| Row 2 Col 1    |   junção horizontal (traço duplo)   ||
| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |

|              ^ Heading 1            ^ Heading 2          ^
^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
^ Heading 4    | sem junção           | Row 2 Col 3        |
^ Heading 5    | Row 3 Col 2          | Row 3 Col 3        |

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | junção vertical | Row 1 Col 3        |
| Row 2 Col 1    | :::             | Row 2 Col 3        |
| Row 3 Col 1    | :::             | Row 2 Col 3        |

^          Tabela com alinhamento          ^^^
|       direita|    centro    |esquerdo      |
|esquerda      |       direita|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Tamanho real: Redimensionado para uma dada largura: Redimensionado para uma dada largura e altura: Imagem externa redimensionada:

Tamanho real:                                     {{wiki:dokuwiki-128.png}}
Redimensionado para uma dada largura:             {{wiki:dokuwiki-128.png?50}}
Redimensionado para uma dada largura e altura:    {{wiki:dokuwiki-128.png?200x50}}
Imagem externa redimensionada:                    {{http://de3.php.net/images/php.gif?200x50}}

Alinhado à direita, à esquerda e ao centro:

Alinhado à direita, à esquerda e ao centro:
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Sem link:

Sem link:              {{wiki:dokuwiki-128.png?nolink}}

No editor de texto existe um pequeno botão que permite inserir imagens. Aaparecerá uma nova janela onde a imagem pode ser carregada para uma namespace pré-existente. Para selecionar a namespace onde se pretende guardar a imagem deve-se aceder-lhe pelo índice lateral que irá aparecer ao lado, e que não é garantidamente o mesmo índice que o dos documentos. Aparecem várias opções, tais como o alinhamento e se se pretende um link na imagem ou não. Apesar deste pequeno wizard, é bom ter em mente a sintaxe das imagens.