Formatação Wiki

De Wiki Software Livre na Educação

Escrever Textos com Formato Wiki


Fonte: http://www.dprf.gov.br/uned/help.php?file=wiki.html


O formato Wiki usa elementos marcadores do texto que serão convertidos em XHTML quando visualizados. Você não precisa aprender o HTML para usar o Wiki e o uso de marcadores é intuitivo. Esta pode ser uma boa alternativa para quem não sabe programar HTML mas quer controlar a formatação.


Você deve digitar textos simples e adicionar caracteres especiais como marcadores para a formatação.


Formatação a nível de bloco de texto


Parágrafos são separados por ao menos uma linha em branco. Para formatar parágrafos adicione um dos seguintes caracteres especiais antes do primeiro caractere da primeira linha do bloco seguido por um espaço...


Caracteres	Tipo de Bloco

Nenhum caractere Parágrafo comum

> Citação

Space Texto Preformatado (Monospaced)

% Texto Preformatado e Wiki são ignorados

!# Título - o símbolo # deve ser substituido por um número (1-6) que corresponde ao tamanho (1 é o maior)

Q. Questão - estilo especial para melhorar a visualização de textos com perguntas/respostas

A. Resposta - estilo especial para melhorar a visualização de textos com perguntas/respostas


Listas

Para formatar listas simples basta digitar um caráter especial no início de cada linha, seguido por um espaço. O fim da lista é uma linha em branco. As listas podem ser aninhadas e podem ser de tipos diversos. Veja, a seguir, os tipos de listas...

Caracteres Tipo de lista

  • Listas não ordenadas (bullet )
  1. Listas ordenadas (1,2,3 etc)
Lista de definições, definição
Lista de definições, texto


Exemplo de listas aninhadas:

 * primeiro bullet
 * segundo bullet
 ## linha aninhada 1
 ## linha aninhada 2
 * terceiro bullet

Resultado:

   * primeiro bullet
   * segundo bullet
        1. linha aninhada 1
        2. linha aninhada 2
   * terceiro bullet 


Formatação de trechos de frases


Você pode usar os marcadores para formatar trechos de frases com um estilo mas a formatação não se estende a outras linhas. Eis os estilos...


Exemplo         Exemplo        Formatação
*hello world*	hello world	Strong ou Bold
/hello world/	hello world	Emphasis ou Italics
+hello world+	hello world	Inserted text
-hello world-	hello world	Deleted ou Strikethrough
hello ~world~	hello world	Subscript
hello ^world^	hello world	Superscript
"hello world"	hello world	Quoted
%hello world%	hello world	Code ou Monospaced
@hello world@	hello world	Cite


Acrônimos

Para indicar um acrônimo, escreva este acrônimo usando letras maiúsculas, seguidas pela descrição entre parêntesis, sem espços entre o acrônimo e os parêntesis. Exemplo...


HTML(Hypertext Markup Language) HTML Links


O endereço URL deve ser inserido no texto seguido (sem espaços) pelo texto a ser visualizado (entre parêntesis). Exemplo: http://www.google.com/ (Search Now) será visualizado como Search Now.

Links a emails também podem ser inseridos, por exemplo:


nobody@example.com (Test User) será visualizado como Test User

Links a módulos da plataforma

Para identificar o número do ID de um módulo plataforma, procure no final do endereço do módulo o trecho: ?id=nn . Com este trecho e o nome do módulo você pode criar um link direto, usando a seguinte sintaxe:


ModuleName:nn(Texto Visualizado)


ex. resource:36(Nova página) forum:10(Vá ao Fórum)


Links a imagens

Para inserir imagens em textos com formato Wiki você deve enviar antes a imagem ao servidor da plataforma e depois anotar o endereço/percurso do arquivo. A sintaxe é:

/..percurso do arquivo..(texto alt)

por exemplo, /mypics/graphic.jpg(Staff picture)


Conversão automática

Muitas instruções comuns são convertidas automaticamente em XHTML. As principais são as seguintes...

   * links HTTP são convertidos em links ativos
   * ..., (R), (TM), (C), 1/4, 1/2, 3/4 são convertidos nos caracteres correspondentes
   * nr x nr é convertido em sinal de multiplicação
   * Uma linha que começa com 4 hífens é convertida em linha horizontal