Ferramentas de Usuário

Ferramentas de Site


wiki:guia

Guia da Wiki P@P

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. ;-)

1. A Wiki P@P - apresentação

1.1. Sistema Wiki

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

1.2. Organização

1.2.1. Namespaces

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 .

1.3. Conteúdos e autores

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.

1.4. Manutenção

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

A Wiki Team NÃO tem por objectivo a criação de conteúdos. Esta é uma responsabilidade de toda a comunidade!

2. Criação e edição de documentos

Um guia com imagens encontra-se no FAQ – ponto 3.

3. Sintaxe

Consulta o documento Formatting Syntax para informações mais detalhadas.

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.

3.1. Títulos e subtítulos

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 ==

3.2. Texto corrente

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.

3.2.1. Parágrafos

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.

3.2.2. Personalização do texto

3.2.2.1. Negrito

Texto em negrito

**Texto em negrito**

3.2.2.2. Itálico

Texto em itálico

//Texto em itálico//
Não confundir com o código do parágrafo!

3.2.2.3. Sublinhado

Texto sublinhado

__Texto sublinhado__

3.2.2.4. Monospaced

Text monospaced

''Texto monospaced''

3.2.2.5. Inferior e superior à linha

Texto Inferior e superior à linha.

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

3.2.2.6. Rasurado

Texto rasurado

<del>Texto rasurado</del>

3.2.3. Links

3.2.3.1. Externos (à Wiki)

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]]

3.2.3.2. Internos (à Wiki)

Link para o FAQ

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

FAQ - Quero contribuir! Como o faço?

[[wiki:faq]]

3.2.4. Notas de rodapé

Texto seguido de uma nota de rodapé.1)

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

3.2.5. Listas

  • 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...

3.3. Blocos de código e citações

3.3.1. Normal

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>

3.3.2. Código com highlight

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

3.3.3. Código com download

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>

3.4. Quotes

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!

3.5. Tabelas

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 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 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
^ 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
^          Tabela com alinhamento          ^^^
|       direita|    centro    |esquerdo      |
|esquerda      |       direita|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

3.6. Imagens

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}}

3.6.1. Pelo botão de imagem

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.

4. Outros diveros

4.1. Expressões matemáticas

1)
Uma nota de rodapé
wiki/guia.txt · Última modificação em: 2018/05/14 21:37 (edição externa)