Reglas de formateado de documentos
También disponible en Deutsch, English, Français, Polski, Русский, 简体中文
Véase también: Acciones
El formateado de texto en Wacko Wiki es ligeramente diferente a otros wikis, por lo que deberías revisar los ejemplos que se muestran a continuación.
Puedes experimentar con el Wiki Markup en el Sandbox.
Como regla general, el texto que se encierre entre dobles comillas dobles no será formateado, por lo que permanecerá inalterado cuando se presente la página.
source | displayed |
1. Tablas de Contenidos
Si se desea incluir una tabla de contenidos con enlaces a las cabeceras del documento, se debe incluir Si se incluye este documento en otro ('include' plugin), pero no se quiere incluir la tabla de contenidos se debe utilizar el siguiente comando:
Descripción detallada... |
2. Estilos de fuentes
**negrita** | negrita |
//cursiva// | cursiva |
__subrayado__ | subrayado |
##fuente monoespaciada## | fuente monoespaciada |
--tachado-- | |
++fuente pequeña++ | fuente pequeña |
!!nota!! | nota |
!!(blue) nota azul!! | nota azul |
!!(green) nota verde!! | nota verde |
!!(red) nota rojo!! | nota rojo |
??énfasis?? | énfasis |
??(blue) énfasis?? | énfasis |
??(red) énfasis?? | énfasis |
??(green) énfasis?? | énfasis |
3. Alineación
La alineación se lleva a cabo con la ayuda de una estructura tan compleja:
%%(wacko wrapper=text wrapper_align=left) izquierda%% |
izquierda
|
%%(wacko wrapper=text wrapper_align=center) centrado%% |
centrado
|
%%(wacko wrapper=text wrapper_align=right) derecha%% |
derecha
|
%%(wacko wrapper=text wrapper_align=justify) justificado%% |
justificado
|
4. Enlaces (links)
Como marcado de caracteres para la creación de enlaces, puede usar redondos ((, ))
o cuadrados [[, ]]
. se utilizan soportes. Ambos caracteres son iguales. Los corchetes pueden ser útiles si el texto del documento ya contiene simples corchetes redondos, lo que puede considerarse erróneamente como un marcado.
4.1. Enlaces externos
[[https://wackowiki.org WackoWiki]] o ((https://wackowiki.org WackoWiki)) | WackoWiki |
https://wackowiki.org se resalta automáticamente. | https://wackowiki.org |
PPR:OneMinuteWiki InterWiki linking | PPR:OneMinuteWiki |
mailto:address@example.com E-mail | mailto:address@example.com |
xmpp:adresse@example.com Jabber | xmpp:adresse@example.com |
((https://example.com/archive.zip Archiv (zip) )) https://example.com/archive.zip | Archiv (zip) https://example.com/archive.zip |
4.2. Enlaces internos
[[/HomePage ]] o ((/HomePage )) | /HomePage |
((/HomePage Página de Inicio)) | Página de Inicio |
Imagen visualizada: https://wackowiki.org/wacko_logo.png | |
Enlace a través de imagen: ((/HomePage https://wackowiki.org/wacko_logo.png)) | |
Declaración de ancla: {{anchor href="test"}} | |
Referencia a un ancla: ((#test)) or ((/HomePage#TOC_1)) | test o /HomePage#TOC_1 |
Notas sobre enlaces:
- Las palabras que contienen al menos dos máyusculas (ej: PruebaPágina) son consideradas páginas internas, no siendo necesario encerrarlas entre parántesis o corchetes. Si no se desea que se considere un enlace, se debe poner una tilde ~ delante de la palabra.
- Solo se debe utilizar "http://" para enlaces externos
- Para redimensionar y alinear imágenes de fuentes externas puede utilizar la siguiente sintaxis:
((http://example.com/image.png width=500 align=center))
, parámetros disponibleswidth
,height
yalign=[left, center, right]
.
5. Incluyendo ficheros cargados
Referencia a ficheros subidos
| file:/Subpage/archive.zip |
5.1. Parámetros del medio
Los parámetros se añaden a la sintaxis del ficheros añadiendo un signo de interrogación ?
y añadiendo parámetros adicionales con un ampersand &
.
e.g. file:/lotus_flower.jpg?right&caption&400
- linking
-
direct
- para archivar -
nolink
- muestra sólo la imagen -
linkonly
- muestra sólo enlace -
meta
- a filemeta handler (default)
-
- alignment
-
right
-
left
-
center
-
- resizing
-
400x300
- width × height -
0x700
- height -
600
- width
-
- others
-
caption
- shows caption -
clear
- clears float
-
6. Títulos
==Título 1== | Título 1 |
===Título 2== | Título 2 |
====Título 3== | Título 3 |
=====Título 4== | Título 4 |
======Título 5== | Título 5 |
Nota: A la derecha del Encabezamiento no requiere el mismo número de caracteres "=", basta con dos signos "=".
El ==Primary Heading==
se suele establecer con el título de la página y por defecto no se incluye en la tabla de contenidos.
7. Listas
Se permiten dos tipos de listas: no numeradas y numeradas
Indent lists with tabs or double spaces, and use *
, 1.
, A.
, a.
, or i.
to specify the type of list you want. This solves the Wakkawiki problem of needing to use tabs in a textarea - double spaces instead work better.
7.1. Listas no numeradas
Las listas no numeradas se realizan mediante la indentación del texto (utilizando 2 espacios para cada indentación). Si se desea que cada elemento de la lista esté señalado con una viñeta se debe añadir un asterico (*) después de los dos espacios.
Ejemplo:
- Primer elemento
- Primer subelemento
- Segundo subelemento
- Segundo elemento
7.2. Listas no numeradas
Las listas numeradas pueden tener numeración decimal, alfabética (mayúsculas o minúsculas), romana. Para seleccionar el tipo de numeración, basta con sustituir el asterisco de cada elemento de una lista no numerada por los siguientes simbolos:
- Decimal: (1.)
- Alfabética (A. o a.)
- Romana (i.)
En listas con múltiples indentaciones, se pueden combinar ambas listas.
Ejemplos:
Numérica | Alfabética | Romana | Mixta |
|
|
|
|
8. Avisos, citas y definiciones
!!Aviso o anotación!! | Aviso o anotación |
<[ Cita: | Cita: |
(?Concepto Definición del concepto?) | Concepto |
(?Concepto con espacios==Definición del concepto?) | Concepto con espacios |
9. Notas a pie de página
..., primera reseña[[*]] y segunda[[**]] ... | ..., primera reseña* y segunda**... |
..., primera reseña numérica[[*1]] y segunda[[*2]] ... | ..., primera reseña 1 y segunda 2... |
[[#*]] Texto de la primera reseña[[#**]] Texto de la segundareseña[[#1]] Texto de la primera reseña numérica[[#2]] Texto de la segunda reseña numérica | * Texto de la primera reseña ** Texto de la segunda reseña 1 Texto de la primera reseña numérica 2 Texto de la segundareseña numérica |
auto generado notas a pie de página[[^ Texto de la nota de pie aquí]] | Genera las notas de pie de página al final de la página, ver ejemplo |
10. Citas
Para marcar un texto como respuesta o comentario, puedes utilizar la siguiente sintaxis:
¡Hola! > Sí, lo es. >> ¿Estás seguro? > ¡Claro que sí! >> ¿De verdad? >> ¿Ahora qué? | ¡Hola! > Sí, lo es. >> ¿Estás seguro? > ¡Claro que sí! >> ¿De verdad? >> ¿Ahora qué? |
11. Tablas
Tabla con borde (anchura determinada por el texto)
#|
*|encabezado 1|encabezado 2|encabezado 3|*
||celda11|celda12|celda13||
||celda21|celda22||
|#
encabezado 1 | encabezado 2 | encabezado 3 |
---|---|---|
celda11 | celda12 | celda13 |
celda21 | celda22 |
Tabla sin borde, anchura 100%
#||
||celda11|celda12|celda13||
||celda21|celda22||
||#
celda11 | celda12 | celda13 |
celda21 | celda22 |
Nota: Se pueden crear tablas complejas utilizando HTML en línea, si está disponible.
Incluir una pipa como contenido dentro de tu celda, encerrada la pipa por un par de comillas dobles: ""|""
12. Varios
Separador horizontal:
----
Forzar nueva línea:
test---
shmest
test
shmest
Ignorar marcas, mostrando el texto "como está escrito"
Existen dos formas que son:
- Cerrar el texto entre dobles comillas dobles.
- Colocar una tilde (
~
) antes del texto
Ejemplo:
<# <input type="text"> #>
Superindices y subíndices:
E=mc^^2^^ | E=mc2 |
H vv2vv O | H 2 O |
13. Inline-HTML
Salida HTML sin formato
Sólo funciona si el administrador lo ha permitido.
<# <input type="text"> #> | <# <input type="text"> #> Si ve aquí <input type="text"> en lugar de un campo de entrada, la función no está activada. ( allow_rawhtml en la configuración debe estar ajustado a 1 . Atención, con las wikis abiertas esto puede permitir abusos). |
14. Autocorrector
El corrector automático integrado en el wiki ajusta automáticamente el texto guardado a las normas de formato, lo que evita que los autores tengan que realizar una edición excesivamente detallada. Aquí están los cambios que hace:
SuperscriptE=mc^^2^^ | E=mc2 |
Subscript Insert spaces before and after vv. H vv2vv O | H 2 O |
Adicional | |
^F | °F |
^C | °C |
(p) | § |
(tm) | (tm) |
(c) | (c) |
(r) | (r) |
+- | +- |
~~ | ~ |
15. Macros
Las macros son utilidades que actualizan el documento automáticamente con variables tales como el nombre del autor, la fecha de edición, etc.
Para insertar automáticamente tu nombre, utiliza:
Insertar el nombre del autor | :::: | WikiAdmin |
Insertar nombre y fecha | ::@:: | WikiAdmin /12.01.2005 20:00/ |
Insertar la fecha | ::+:: | /12.01.2005 20:00/ |
16. Extensiones para el formateado de documentos
WackoWiki puede extenderse para formatear tipos de texto especiales.
Se puede acceder estas extensiones utilizando la sintaxis %%(name) text%%
.
16.1. Scripts PHP
%%(php) |
|
Nota: El código debe comenzar con <?php y finalizar con ?>
16.2. Details
%%(details title="Summary" open=1) |
SummaryThe HTML Details Element (<details> ) creates a disclosure widget in which information is visible only when the widget is toggled into an "open" state. A summary or label can be provided using the <summary> element.
|
16.3. Command Line
%%(cl) |
zypper dup --no-recommends |
16.4. Chat
%%(chat [type="div|table"]) |
|
16.5. E-mail
%%(email) |
Hi! RI>> Yes, it is. >Are you sure? Of course, yes! Roman. |
16.6. Código SQL
%%(sql) |
SELECT * |
16.7. Código HTML
%%(html) |
<html> <a href="http://example.com" width="8">test</a> </html> |
16.8. Código CSS
%%(css) |
body {margin: 0; padding:5px;}
.class {background:url("http://example.com/")}
|
16.9. Ficheros de configuración
%%(ini) |
[Wiki] BestEngine="WackoWiki" Version=6 |
16.10. Código PASCAL
%%(pascal) |
BEGIN
if a = 15 then writeln("test");
END.
|
%%(comment) Comments, they will be hidden when the page is stored and redisplayed %% | |
%%(noautolinks) no AutoLinks if CamelCase-Words%% | no AutoLinks if CamelCase-Words
|
16.11. Info box
%%(info type="note" title="Notas" icon=0) contenido... %%
Tipos: default
, error
, example
, important
, note
, question
, quote
, success
, warning
title
box title
icon
mostrar icono, default value is 1
%%(info type="note")
|
A wiki is a website where users can add, remove, and edit every page using a web browser. It's so terrifically easy for people to jump in and revise pages that wikis are becoming known as the tool of choice for large, multiple-participant projects.
|
%%(info type="warning")
|
As with any software that you expose to the internet, there may be bugs or security problems. Do not install WackoWiki unless you intend to keep up with security upgrades.
|
16.12. Highlighters
Hay también extensiones para resaltar los siguientes formatos ( CSS, diff, DTD, Javascript, mySQL, PHP, Python, SQL, XML).
Estas extensiones se pueden llamar a través de una llamada del tipo %%(hl tipo) donde tipo describe el contenido incluido.
%%(hl css) |
body {margin: 0; padding:5px;} .class {background:url("http://example.com/")} | ||
%%(hl javascript) |
var a = document.getElementById("test"); a.value = new Array(15, 31); function echo (msg) {alert(msg)}; | ||
%%(hl php numbers=2) |
| ||
%%(hl xml) |
<config> <section name="test"> <var>Test</var> <val><![CDATA[..text...]]></val> </section> </config> |
16.13. GeSHi
GeSHi Code Highlighting - Generic Syntax Highlighter
%%(geshi [Formatter] numbers=1 start=35 lines=37) source%%
%%(geshi css) CSS-Code%%
| Formatter
highlight/geshi not found |
Si ves Formatter highlight/geshi no se encuentra, el GeSHi formatter no fue añadido a este sitio. |
17. Contenedores (Wrappers) para los formateadores
Es posible asignar a cualquier formateador un contenedor o "wrapper" mediante el parámetro wrapper
.
Los tipos de contenedores (wrappers) disponibles son:
%%(formatter
[wrapper="box | shade | page | text"]
[wrapper_align= "left | center | right | justify"]
[wrapper_title="Titel"]
[wrapper_type="default | error | example | important | note | question | quote | success | warning"]
[wrapper_width="pixel"]
[col=1 | 2 | 3 | 4 | 5]
[clear])
Text%%
box | shade | page | text | |
---|---|---|---|---|
type | + | + | – | - |
title | + | + | – | - |
alignment | + | –1 | –2 | + |
clear | + | + | – | – |
width | + | –1 | + | –3 |
column | – | + | – | + |
frame | + | + | – | – |
automatic line feed | + | + | + | – |
1 Esta opción no tiene sentido, porque el ancho del bloque es siempre igual al ancho de la página.
2 Sólo a la izquierda.
3 Si no pones la línea de alimentación tú mismo, el ancho del bloque es fijado por el motor en aproximadamente el 90% del ancho de la página.
Grammar = [FORMATTER | FORMAT WRAPPER | FORMAT WRAPPER OPTION | Text]
FORMATTER = [ cl | comment | css | email | hl * | html | info | ini | java | pascal | php | sql | wacko ]
FORMAT WRAPPER = box
, shade
, page
und text
TEXT = todo, libre.