Reglas de edición de PmWiki en Español.
Mientras no se realiza una traducción completa de las instrucciones, se sugiere como referencia BasicEditing. Mientras tanto, aquà van unas instrucciones básicas:
Lo básico
El texto que se ve al editar una página describe no sólo el contenido de la página, sino también su formato. Las reglas básicas de formateado son muy simples.
- Poner una lÃnea en blanco entre párrafos.
- Para hacer una lista, comenzar cada lÃnea con un signo de cuadradillo (‘#’) para listas ordenadas (numeradas, como ésta) y con un asterisco (‘*’) para listas sin numerar (las que tienen un bolinche o viñeta.
- Para hacer un encabezado, comenzar la lÃnea con un signo de exclamación: ‘!’ es un encabezado, ‘!!’ es un encabezadp de segundo nivel, ‘!!!’ lo es de tercer nivel, etcétera.
- Para resaltar el texto, escribirlo entre 2 o tres apóstrofes (bajo el signo de cerrar interrogación en vuestros teclados): ''texto'' para cursivas y '''texto''' para negritas.
- Para enlazar a otra página dentro del wiki, escribir su nombre entre corchetes dobles: [[Edición de páginas]] lleva a esta misma página: Edición de páginas?. Los enlaces a páginas no existentes llevan a una página especial que permite crearlas.
- Para enlazar a una página externa, basta con poner su dirección web de este modo: http://www.ejemplo.es/.
- Si se quiere hacer un enlace “bonito”, en el que el texto que lee el usuario es distinto del enlace, hay dos sistemas, o bien [[enlace | texto]], o bien [[texto -> enlace]]. AsÃ, tanto [[http://uoc.edu/ | Universitat Oberta de Catalunya]] como [[Universitat Oberta de Catalunya -> http://uoc.edu/]] dan como resultado este enlace: Universitat Oberta de Catalunya.
El resto de esta página estaba desactualizado, asà que lo he sustituÃdo por el texto en inglés para que la gente pueda hacer su traducción.
Si quieres experimentar editando una página, hazlo en la WikiSandbox. Puedes editar the WikiSandbox sin afectar algo importante en este sitio. Si editas otras páginas, es cortés firmar tu aportación; firmando con el nombre que has provisto en el campo autor, en la forma de edición de página.
Ejemplo
La tabla de abajo nos enseña muchas de las marcas comunes usadas para formatear páginas. La columna derecha muestra los efectos de la marca, mientras la izquierda nos muestra lo que hay que escribir para lograrlos. Más detalles están disponibles en las text formatting rules? y otras páginas. Una lista exhaustiva de marcas por defecto está disponible en el markup master index?
Uso General
|
Que escribir
|
Como se verá
|
An empty line
starts a new paragraph.
| An empty line
starts a new paragraph.
|
A single newline
usually doesn't affect the layout.
Use two backslashes\\
to break a line.
[[<<]]
Use three backslashes\\\
for two line breaks.
| A single newline
usually doesn’t affect the layout.
Use two backslashes
to break a line.
Use three backslashes
for two line breaks.
|
A single backslash \
joins the next line \
to the previous one.
| A single backslash joins the next line to the previous one.
|
[[#lists]]
* lists are created by using asterisks
** more asterisks produce deeper lists
*** the list is terminated
by the first line that is not a list
# Numbered lists
## are also possible
### more hashes produced deeper lists
**** and lists can nest
|
- lists are created by using asterisks
- more asterisks produce deeper lists
by the first line that is not a list
- Numbered lists
- are also possible
- more hashes produced deeper lists
|
-> An arrow (->) indents content.
Line up text to continue the indent.
-->Longer arrows (-->) indent
further.
-<A reverse arrow (-<) creates a
hanging indent, the first line is
outdented and remaining lines are
indented.
--<Longer reverse arrows (--<)
indent further.
| An arrow (→) indents content.
Line up text to continue the indent.
Longer arrows (→) indent further.
A reverse arrow (-<) creates a hanging indent, the first line is outdented and remaining lines are indented.
Longer reverse arrows (--<) indent further.
|
: Definition list : list of definitions
: item : the item's definition
: another item : that item's definition
:: indentation : more leading colons
produce deeper lists
| - Definition list
- list of definitions
- item
- the item’s definition
- another item
- that item’s definition
- indentation
- more leading colons produce deeper lists
|
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.
Note that very long lines of preformatted text
can cause the whole page to be wide.
|
%rfloat% This text floats to the right
%rframe% This text floats to the right
with a frame
%center% This text is centered.
%right% This text is right justified.
| This text floats to the right
This text floats to the right with a frame
This text is centered.
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.
|
|
What to type
|
What it looks like
|
* Text in double brackets become links
to other pages.
* Words are automatically capitalized
in page titles.
Practice editing
in the [[wiki sandbox]].
| - Text in double brackets become links to other pages.
- Words are automatically capitalized in page titles.
Practice editing
in the wiki sandbox?.
|
- When linking to a page in a different wikigroup, provide the group name, followed by a separator, and then the page name.
- If the separator you use is a slash, only the page name will appear.
- If the separator you use is a dot, the full string (group name and page name) will appear.
Practice editing
in the [[Main/WikiSandbox]].
Which one?
Oh, in the [[Main.WikiSandbox]].
| Practice editing
in the WikiSandbox.
Which one?
Oh, in the Main.WikiSandbox.
|
- Text after a pipe (|) is used as the link text, or use the alternate (and perhaps more understandable) arrow (text → link) notation.
- PmWiki adds capitalisation to links
Practice editing in the
[[WikiSandbox | practice area]].
Practice editing in the
[[Main.WikiSandbox | practice area]].
Practice editing in the
[[practice area -> Wiki sandbox]].
Advanced tables are described in
[[table directives]].
| Practice editing in the
practice area?.
Practice editing in the
practice area.
Practice editing in the
practice area?.
Advanced tables are described in table directives?.
|
- 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]].
# as reference: [[Tables |#]]
# to a page title [[Basic editing|+]]
| Practice editing in the
wiki sandboxes?.
Practice editing in the
sandbox?.
- as reference: [1]?
- to a page title ?
|
- Pmwiki can use Inter map prefixes? that have specific meanings.
- Parentheses can hide those too.
What's an [[(Wikipedia:)aardvark]],
anyway?
| What’s an aardvark, anyway?
|
Links to external sources can be entered
# bare url: http://google.com
# link text: [[http://google.com |
Google]]
# as reference: [[http://google.com
|#]]
| Links to external sources can be entered
- bare url: http://google.com
- link text: Google
- as reference: [1]
|
Links can open in another window,
as in %newwin% http://www.pmwiki.org.
| Links can open in another window,
as in http://www.pmwiki.org.
|
Character formatting
|
What to type
|
What it looks like
|
- These are all apostrophes (single-quote marks), not double-quotes.
''Emphasize'', '''strongly''',
'''''very strongly'''''.
| 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++] text
* [-small-], [--smaller--] text
| - Text with superscripts
- Text with subscripts
- deleted
strikethrough text
- inserted underline text
- big, bigger text
- small, smaller text
|
- Use lowercase letters for RGB colors (#ff7f00, not #FF7F00).
[[WikiStyles]] allow %red% text
%blue% to %green% be in
%color=#ff7f00% different %%colors.
| WikiStyles? allow text
to be in
different colors.
|
Headings and blocks
|
What to type
|
What it looks like
|
- Headings are useful for creating a “well-structured” page.
They’re not just for making big text.
!! Major Subheading
!! [-Major Subheading With Smaller
Text-]
!!! Minor Subheading
!!!! And More
!!!!! Subheadings
| Major Subheading
Major Subheading With Smaller Text
Minor Subheading
And More
Subheadings
|
Page titles
- The
(:title:) directive sets the page’s title to something other than its page name.
(:title Basic Editing:)
The title of this page is {$Title},
spaced as {$Titlespaced}.
| The title of this page is Basic Editing, spaced as Basic Editing.
|
Block styles
- blocks allow styles to be applied across a number of lines and paragraphs of text and images.
>>purple<<
All of the text in this block
is purple.
* Purple cows and purple flowers
* Purple people eater
>>red<<
* Now this list is red
>>center<<
* and this text is centered
>>right green<<
* and this text is green and right
justified
>><<
* And this is normal
|
All of the text in this block
is purple.
- Purple cows and purple flowers
- Purple people eater
- and this text is centered
- and this text is green and right justified
|
« | Documentation Index? | »
Q I’m new to PmWiki, where can I find some basic help for getting started?
The Basic Editing? page is a good start. From there, you can just follow the navigational links at the bottom of the page (they are called WikiTrails?) to the next pages, or to the Documentation Index? page, which provides an outline style index of essential documentation pages, organized from basic to advanced.
Q How do I include special characters on my wiki pages?
Use character codes to insert special characters?, such as Copyright (©) and Trademark (® or ™) symbols, that don’t appear on your keyboard.
Q Why are separate lines of text in the markup combined into a single line on output?
PmWiki normally treats consecutive lines of text as being a paragraph, and merges and wraps lines together on output. This is consistent with most other wiki packages. However, an author can use the (:linebreaks:) directive to cause separate lines of markup text to be kept as separate lines in the output.
Q Can I just enter HTML directly?
By default (and by design), PmWiki does not support the use of HTML elements in the editable markup for wiki pages. There are a number of reasons for this described in the PmWikiPhilosophy? and PmWiki:Audiences. Basically, Pm feels that enabling HTML markup within wiki pages in a collaborative environment has the effect of excluding some potential authors from being able to edit pages, as well as posing a number of display and security issues. However, a site administrator can use the Cookbook:EnableHTML recipe to enable the use of HTML markup directly in pages.