De kk2011

PmWikiPtBr: Regras básicas para editar páginas wiki

autores (básico)

As páginas neste site são chamadas de páginas WikiWikiWeb, significa que páginas podem ser criadas e editadas por múltiplos autores. Para editar uma página, clique no link Editar que normalmente se encontra no cabeçalho ou rodapé da página. Algumas páginas podem ser protegidas por senha (en), dependendo da política de segurança do sistema, mas muitos sistemas permitem editar qualquer página livremente.

Ao editar uma página, você vê a marcação de texto que descreve o conteúdo da página. As regras básicas para entender as marcações são bem simples:

  1. Coloque uma linha em branco entre os parágrafos.
  2. Para fazer uma lista, inicie cada linha com # para listas ordenadas por números ou * para listas ordenadas por pontos (sem ordem).
  3. Para fazer um título, inicie a linha com dois ou mais pontos de exclamação !; !! formam um subtítulo, e !!! são um sub-subtítulo.
  4. para dar ênfase, inclua a palavra entre duas ou 3 aspas simples; ''texto'' para itálicos ou '''texto''' para negrito.
  5. Para fazer um enlace para outra página, inclua o nome da página em [[basic editing]], fazendo o enlace para página. Enlaces para páginas inexistentes são mostradas especialmente, para convidar outros a criarem a página.
  6. Para fazer um enlace para outro site, escreva seu endereço, assim http://www.example.com/ .

Se você quiser editar uma página para experimentar, tente na WikiSandbox. Você pode editar o WikiSandbox sem afetar nada importante no site. Se você editar outras páginas, seria cortês assinar sua contribuição; usando ~~~ , você assinará efetivamente a página, com o nome que você prover no campo Autor no formulario de edição da página.

Exemplos

A tabela abaixo, demonstra muitas das marcações comumente usadas para formatar o texto das páginas. A coluna esquerda mostra o efeito da marcação, a coluna à direita mostra o que escrever para alcançar o mesmo efeito. Mais detalhes estão disponíveis em Regras de Formatação de Texto e em outras páginas da documentação. Uma lista exaustiva da marcação padrão está disponível em markup master index (en)

Uso geral

Como se parece

O que escrever

Uma nova linha única normalmente não afeta o layout. Mas ''(infelizmente) afeta'' a marcação.

Uma nova linha única
normalmente não afeta o layout.  
Mas ''(infelizmente)
afeta'' a marcação.

Um autor deve

colocar uma linha em branco na marcação para iniciar um novo parágrafo. Para uma parada
no parágrafo, use duas barras invertidas.

Um autor deve

colocar uma linha em branco na marcação para
iniciar um novo parágrafo. Para uma parada\\
no parágrafo, use duas barras invertidas.
  • Listas são criadas usando asteriscos
    • Mais asteriscos resultam em listas mais profundas
      • A lista é terminada

por uma nova linha que não é uma lista

  1. Listas numeradas
  2. Também são possíveis
    • e podém ser aninhadas umas dentro das outras
* Listas são criadas usando asteriscos
** Mais asteriscos resultam em listas mais profundas
*** A lista é terminada
por uma nova linha que não é uma lista

# Listas numeradas
# Também são possíveis
** e podém ser aninhadas umas dentro das outras
  • Uma barra invertida no final da linha junta a próxima linha com a linha anterior.
  • Duas barras invertidas criam
    uma quebra de linha.
  • Três barras invertidas geram

    duas quebras de linha.
* Uma barra invertida no \
final da linha junta a \
próxima linha com a linha anterior.
* Duas barras invertidas criam\\
uma quebra de linha.
* Três barras invertidas geram\\\
duas quebras de linha.
uma flecha (->) recua um parágrafo inteiro.
Flechas mais longas (-->) recuam mais ainda um parágrafo.
Uma flecha invertida (-<) cria umrecuo solto, a primeira linha não sofre recuo e as linhas restantessão recuadas.
Novamente, flechas invertidas longas(--<) recuam mais ainda um parágrafo.
->uma flecha (->) recua um parágrafo inteiro.
-->Flechas mais longas (-->) recuam mais ainda um parágrafo.

-<Uma flecha invertida (-<) cria um\
recuo solto, a primeira linha \
não sofre recuo e as linhas restantes\
são recuadas.
--< Novamente, flechas invertidas longas(--<) \
recuam mais ainda um parágrafo.
Lista de definições
lista de definições
item
Definição do item
outro item
definição de outro item
: Lista de definições : lista de definições
: item : Definição do item
: outro item : definição de outro item
 Linhas que iniciam com
 um espaço são formatadas exatamente como
 foram digitadas, com fonte de tamanho fixo

Note que linhas longas de texto pre-formatado podem deixar uma página muito larga.

 Linhas que iniciam com
 um espaço são formatadas exatamente como
 foram digitadas, com fonte de tamanho fixo

Note que linhas longas de texto pre-formatado 
podem deixar uma página muito larga.

Este texto está centralizado.

Este texto está justificado a direita.

%center% Este texto está centralizado.

%right% Este texto está justificado a direita.

Quatro traços no inicio da linha


fazem uma linha horizontal.

Quatro traços
no inicio da linha 
----
fazem uma linha horizontal.

Links

O que isso parece

o que escrever

Practique no WikiSandbox.

  • Texto entre um par de coclhetes se torna um link para outras páginas become links to other pages.
  • As palavars ficam automáticamente com a primeira letra em maiúsculas nos títulos das páginas.
Practice editing
in the [[wiki sandbox]].

Praque no WikiSandbox.

Qual? Oh, no PmWikiPtBr.WikiSandbox.

  • Quando se cria um link para uma página num grupowiki diferente, escreva o nome do grupo, seguido de um separador, e o nome da página.
  • Se o separador for uma barra, somento o nome da página será mostrado.
  • Se um ponto for usado como separador, a linha inteira aparecerá.
Practique no [[PmWikiPtBr/WikiSandbox]].

Qual?
Oh, no [[PmWikiPtBr.WikiSandbox]].

Pratique editando em area de treino.

Pratique editando em area de treino.

Pratique editando em Area de treino.

  • Texto depois de um sinal de (|) é usado como texto que aparecerá no link, ou use o formato alternativo (e talvez mais intuitivo) notação de flecha (texto -> link).
Pratique editando em 
[[PmWikiPtBr/WikiSandbox | area de treino]].

Pratique editando em 
[[PmWikiPtBr.WikiSandbox | area de treino]].

Pratique editando em
[[area de treino -> PmWikiPtBr/WikiSandbox]].

Pratique editando as WikiSandboxes.

Pratique editando em box.

  • finais de texo se tornam parte do texto do link.
  • Parênteses escondem partes do texto do link.
Practice editing in the
[[WikiSandbox]]es.

Practice editing in the
[[(WikiSand)box]].

O que é um aardvark?

  • Pmwiki pode usar prefixos InterMap (en) que tem significados especiais.
  • Parênteses também podem esconder o texto do link.
%newwin%O que é um [[(Wikipedia:)aardvark]]?

Links para fontes externas podem ser colocadas como

  1. url normal: http://www.google.com
  2. texto de link: Google
  3. como referência: [1]
Links para fontes externas podem ser colocadas como
# url normal:  http://www.google.com
# texto de link: [[http://www.google.com | Google]]
# como referência: [[http://www.google.com |#]]

Links podem ser abertos e novas janelas, como em http://www.pmwiki.org.

Links podem ser abertos e novas janelas,
como em %newwin% http://www.pmwiki.org.

Formatação de caracteres

ênfase, forte, fortíssimo.

  • As aspas utilizadas , são simples e não duplas.
''ênfase'', '''forte''', 
'''''fortíssimo'''''. 

texto monoespaçado

Este é
   um bloco de
        texto pré-formatado
@@texto monoespaçado@@ 
 
[@Este é
   um bloco de
        texto pré-formatado@]
  • Texto com superscripts
  • Texto com subscripts
  • Texto deletado riscado
  • Texto inserido sublinhado
  • Texto grande, maior, pequeno, menor
 
* Texto com '^superscripts^'
* Texto com '_subscripts_'
* Texto deletado {-riscado-}
* Texto inserido {+sublinhado+}
* Texto [+grande+], [++maior++], [-pequeno-], [--menor--]

WikiStyles (en) permite texto em vermelho, azul, verde e outras cores.

  • Use letras minúsculas para as cores RGB (#ff7f00, not #FF7F00).
[[WikiStyles]]permite texto em %red% vermelho,
%blue% azul, %green% verde e 
%color=#ff7f00% outras  %%cores.

Cabeçalhos e blocos

Sub-cabeçalho maior

Sub-cabeçalho menor

e mais

Sub-cabeçalhos
!! Sub-cabeçalho maior
!!! Sub-cabeçalho menor
!!!! e mais
!!!!! Sub-cabeçalhos
Títulos de página

não exibido

  • A diretiva (:title:) define o título da página para um texto outro do que seu nome.
(:title Regras básicas para editar páginas wiki:)
Estilos em bloco

Todo o texto neste bloco é roxo.

  • flores e vacas roxas
  • Comedor de pessoas roxas
  • Agora esta lista é vermelha
  • e este texto está centralizado
  • e este texto está justificado à direita
  • e este texto está normal.
>>purple<<
Todo texto deste bloco é roxo.
* flores e vacas roxas
* comedor de pessoas roxas
>>red<<
* e agora esta lista é vermelha
>>center<<
* e este texto está centralizado
>>right<<
* e este texto está justificado à direita
>><<
* e este texto está normal

<< | Documentação | Criando novas páginas >>

Originário de http://kk2011.confabulando.org/index.php/PmWikiPtBr/BasicEditing
Pagina modificada em 11 de March de 2010, às 23h05