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


{{toc numerate=1}}


Si se desea incluir una tabla de contenidos con enlaces a las cabeceras del documento, se debe incluir {{toc}}.


Si se incluye este documento en otro ('include' plugin), pero no se quiere incluir la tabla de contenidos se debe utilizar el siguiente comando:


{{include page="ReglasFormato/Cabeceras" notoc=1}}


Descripción detallada...

2. Estilos de fuentes


**negrita** negrita
//cursiva// cursiva
__subrayado__ subrayado
##fuente monoespaciada## fuente monoespaciada
--tachado-- 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)) 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 disponibles width, height y align=[left, center, right].

5. Incluyendo ficheros cargados

Referencia a ficheros subidos

file:/mammut_mascot.jpg
comprueba sólo el archivo global
file:mammut_mascot.jpg
comprueba primero el archivo local
file:/Subpage/archive.zip
ruta absoluta para el archivo local, necesaria para que los archivos locales se incluyan en otra página
El fichero ya debe estar cargado.


descripción detallada...

mammut mascot
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

Lotus Flower
Shinobazu Pond at Ueno Park at Ueno, Taito-ku in Tokyo
(Source:: Yoshikazu TAKADA /Some rights reserved)

  • 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éricaAlfabéticaRomanaMixta
  1. lista numérica-1
  2. lista numérica-2
  1. lista alfabética-1
  2. lista alfabética-2
  1. lista romana-1
  2. lista romana-2
  3. lista romana-3
  4. lista romana-4
  1. elemento 1
    1. elemento 1.1
      • punto 1.1.1
      • punto 1.1.2
    2. elemento 1.2
  2. elemento 2

8. Avisos, citas y definiciones


!!Aviso o anotación!! Aviso o anotación
<[ Cita:
Autor de la cita ]>
Cita:
Autor de la 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!

11. Tablas


Tabla con borde (anchura determinada por el texto)


#|
*|encabezado 1|encabezado 2|encabezado 3|*
||celda11|celda12|celda13||
||celda21|celda22||
|#


encabezado 1encabezado 2encabezado 3
celda11celda12celda13
celda21celda22

Tabla sin borde, anchura 100%
#||
||celda11|celda12|celda13||
||celda21|celda22||
||#


celda11celda12celda13
celda21celda22

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 OH 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:


Superscript
E=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)
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;
%%

<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;


Nota: El código debe comenzar con <?php y finalizar con ?>

16.2. Details

%%(details title="Summary" open=1)
Details info.
%%

Summary The 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
%%

zypper dup --no-recommends	

16.4. Chat

%%(chat [type="div|table"])
chat log
%%

Mike Hi altogether.
12:04
Alice Did you check out the link https://example.com/
12:05
Pete I did't read your message.
The images
you drawn
are awesome!
12:10

16.5. E-mail


%%(email)
Hi!
RI>> Yes, it is.
>Are you sure?

Of course, yes!

Roman.
%%

Hi!
RI>> Yes, it is.
>Are you sure?

Of course, yes!

Roman.	

16.6. Código SQL


%%(sql)
SELECT *
FROM sometable
WHERE a = '12' AND b = 2
ORDER BY c DESC --Comment;
%%

SELECT * 
FROM sometable
WHERE a = '12' AND b = 2 
ORDER BY c DESC --Comment;

16.7. Código HTML


%%(html)
<html>
<a href="http://example.com" width="8">test</a>
</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/")}
%%

body {margin: 0; padding:5px;}
.class {background:url("http://example.com/")} 	

16.9. Ficheros de configuración


%%(ini)
[Wiki]
BestEngine="WackoWiki"
Version=6
%%

[Wiki]
BestEngine="WackoWiki"
Version=6	

16.10. Código PASCAL


%%(pascal)
BEGIN
if a = 15 then writeln("test");
END.
%%

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")
contenido...
%%

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")
contenido...
%%

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/")}
%%

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)};
%%

var a = document.getElementById("test");
a.value = new Array(15, 31);
function echo (msg) {alert(msg)};

%%(hl php numbers=2)
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;
%%

1
2
3
4
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;

%%(hl xml)
<config>
<section name="test">
<var>Test</var>
<val><![CDATA[..text...]]></val>
</section>
</config>
%%

<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.

17.1. box

%%(css wrapper=box wrapper_align=left wrapper_width=270)
.d { font-size: 70% }
%%


17.2. shade

%%(css wrapper=shade)
.d2 { font-size: 70% }
%%

.d2 { font-size: 70% } 	

17.3. text

%%(wacko wrapper=text wrapper_align=center) text on to center %%
text on to center

text is derived the "floating" (float) block of text.

17.4. page

%%(wacko wrapper=page wrapper_width=200) this text cannot be wider than two hundred pixel%%
this text cannot be wider than two hundred pixel

page it makes it possible to regulate the width of the usual block of text.

17.5. Ejemplo

%%(wacko wrapper=box wrapper_type="quote" wrapper_width=300 wrapper_title="Box")
«A hundred times every day I remind myself that my inner and outer life depend upon the labors of other men, living and dead, and that I must exert myself in order to give in the measure as I have received and am still receiving.» – Albert Einstein
%%