PmWikiPt / Basic Editing

As páginas deste site são páginas WikiWikiWeb, o que significa que as páginas podem ser criadas e editadas por vários autores. Para editar uma página, clique na opção Edit que usualmente é apresentada no cabeçalho ou rodapé da página. Dependendo da política de segurança do sistema, algumas destas páginas podem estar protegidas com password.

A apresentação visual de uma página é controlada por um conjunto de regras e de marcas de controlo. As marcas de controlo são anotações colocadas no texto da própria página. Para editar uma página é portanto necessário conhecer estas regras e anotações:

  1. Para definir um parágrafo entre dois segmentos de texto, coloque uma linha vazia entre os segmentos
  2. Para definir uma lista, inicie cada linha com o símbolo # para listas numeradas ou com o símbolo * para listas não ordenadas (bulleted).
  3. Para definir um título, inicie a linha de texto com dois ou mais ! marcas; !! define um sub-título, e !!! um sub-sub-título.
  4. Para realçar o texto, delimite-o por 2 ou 3 apóstrofes 'single quotes''; ''texto' para itálico ou '''text''' para negrito.
  5. Para definir uma ligação para outra página, delimite o nome da página com ângulso rectos double brackets; por exempoo, [[basic editing]] define uma ligação para esta página. Ligações para nonexistent pages? são visualizadas de forma especial, permitindo que sejam criadas pela própria ou por outras pessoas.
  6. Para especificar uma ligação para outro site, escreva o seu endereço, por exemplo http://www.example.com/ .

If you want to experiment with editing a page, try it on the WikiSandbox. You can edit the WikiSandbox without affecting anything important on this site. If you do edit other pages, it's courteous to sign your contribution; using ~~~ effectively 'signs' the name that you provide in the Author field on the Page Edit form.

Exemplos

A tabela de baixo exemplifica anotações comuns a mpáginas. A coluna esquerda visualiza o efeito da anotação, e a coluna esqurda mostra como escrever a anotação que alcança o efeito visual apresentado na coluna esquerda. Podem ser consultados em text formatting rules mais detalhes da anotação. Uma lista exaustiva exhaustive list de anotação pode ser consultada em markup master index

Uso geral

Apresentação final

O que escrever

A single newline usually doesn't affect the layout. 

A single newline
usually doesn't affect the layout.

An author must

place an empty line in the markup to start a new paragraph. For a break
in the paragraph, use two backslashes. 

An author must

place an empty line in the markup to
start a new paragraph. For a break\\
in the paragraph, use two backslashes.
  • Lists are created by using asterisks
    • More asterisks result in deeper lists
      • The list is terminated

by the first line that is not a list

  1. Numbered lists
  2. are also possible
    • and lists can nest 
* Lists are created by using asterisks
** More asterisks result in deeper lists
*** The list is terminated
by the first line that is not a list

# Numbered lists
# are also possible
** and lists can nest
  • A backslash at the end of a line joins the next line to the previous one.
  • Two backslashes create
    a line break.
  • Three backslashes generate

    two line breaks. 
* A backslash at the \
end of a line joins the \
next line to the previous one.
* Two backslashes create \\
a line break.
* Three backslashes generate\\\
two line breaks.
An arrow (->) indents a paragraph
Longer arrows indent more
A reverse arrow creates a hanging indent, the first line is outdented and remaining lines are indented. 
->An arrow (->) indents a paragraph
-->Longer arrows indent more

--<A reverse arrow creates a \
hanging indent, the first line \
is outdented and remaining lines \
are indented.
Definition list
list of definitions
item
the item's definition
another item
another item's definition 
: Definition list : list of definitions
: item : the item's definition
: another item : another item's definition 

 Lines that begin with
 a space are formatted exactly
 as typed, in a fixed-width font.

Note that very long lines of preformatted text can cause the whole page to be wide. 

 Lines that begin with
 a space are formatted exactly
 as typed, in a fixed-width font.

This text is centered.

This text is right justified. 

%center% This text is centered.

%right% This text is right justified.

Four or more dashes at the beginning of a line

produce a horizontal line. 

Four or more dashes
at the beginning of a line
----
produce a horizontal line.

PmWiki.Links

What it looks like

What to type

Practice editing in the PmWiki.wiki sandbox.

  • Text in double brackets become links to other pages.
  • Words are automatically capitalized in page titles. 
Practice editing
in the [[wiki sandbox]].

Practice editing in the practice area.

  • Text after a pipe (|) is used as the link text 
Practice editing in the
[[PmWiki.WikiSandbox | practice area]].

Practice editing in the PmWiki.wiki sandboxes.

Practice editing in the PmWiki. sandbox.

  • Endings become part of the link text.
  • Parentheses hide parts of the link name. 
Practice editing in the
[[wiki sandbox]]es.

Practice editing in the
[[(wiki) sandbox]].

What's an aardvark, anyway?

  • Pmwiki can use InterMap prefixes that have specific meanings.
  • Parentheses can hide those too. 
%newwin%What's an
[[(Wikipedia:)aardvark]], anyway?

Links to external sources can be entered

  1. bare url: http://www.google.com
  2. link text: Google
  3. as reference: [1] 
Links to external sources can be entered
# bare url:  http://www.google.com
# link text: [[http://www.google.com | Google]]
# as reference: [[http://www.google.com |#]]

Links can open in another window, as in http://www.pmwiki.org. 

Links can open in another window,
as in %newwin% http://www.pmwiki.org.

Character formatting

Emphasize, strongly, very strongly.

  • These are all apostrophes (single-quote marks), not double-quotes. 
''Emphasize'', '''strongly''', 
'''''very strongly'''''.

Monospaced text 

This is a
  preformatted
    text block
 
@@Monospaced text@@ 
 
[@This is a
  preformatted
    text block@]
  • Text with superscripts
  • Text with subscripts
  • deleted strikethrough text
  • inserted underline text
  • big, bigger, small, smaller text 
* Text with '^superscripts^'
* Text with '_subscripts_'
* deleted {-strikethrough-} text
* inserted {+underline+} text
* [+big+], [++bigger++], [-small-], [--smaller--] text

WikiStyles? allow text to be different colors.

  • Use lowercase letters for RGB colors (#ff7f00, not #FF7F00). 
[[WikiStyles]] allow %red% text
%blue% to %green% be 
%color=#ff7f00% different %%colors.

Headings and blocks

Major subheading

Minor subheading

 
!! Major subheading

!!! Minor subheading
Page titles

Not shown

  • The (:title:) directive sets the page's title to something other than its name. 
(:title Basic Editing:)
Block styles

All of the text in this block is purple.

  • Purple cow
  • Purple people eater
  • Now this list is red
  • And this is normal 
>>purple<<
All of the text in this block
is purple.
* Purple cow
* Purple people eater
>>red<<
* Now this list is red
>><<
* And this is normal

<< | PmWiki.DocumentationIndex | >>