Este documento describe la Sintaxis Wiki usada en el proyecto wikidot.com
Cualquier página de cualquiera de los sitios existe en dos formas distintas: el código fuente y el código compilado.
El código fuente es lo que tú puedes editar y que describe el contenido de la página. El código fuente es compilado a código XHTML que es enviado al navegador cuando ves(navegas la página. La Sintaxis Wiki es usada para crear el contenido de las páginas a base de editar su código fuente.
Si estás buscando trozos de código para wikidot listos para copia/pegar/modificar visita nuestra página de Snippets.
Helpful is: [http://doc.wikidot.com/] (build by Community-Admins ) with the translate-button right side!
Table of Contents
|
Formato Rápido
Lo que escribes | lo que obtienes |
---|---|
//italic text// | italic text |
**bold text** | bold text |
//**italic and bold**// | italic and bold |
__underline text__ | underline text |
--strikethrough text-- | strikethrough text |
{{teletype (monospaced) text}} | teletype (monospaced) text |
normal^^superscript^^ | normalsuperscript |
normal,,subscript,, | normalsubscript |
[!-- invisible comment --] | |
[[span style="color:red"]]custom //span// element[[/span]] | custom span element |
##blue|predefined## or ##44FF88|custom-code## color | predefined or custom-code color |
Tamaño del texto
what you type | what you get |
---|---|
[[size 80%]]80% del Tamaño Normal[[/size]] | 80% del Tamaño Normal |
[[size 100%]]100% del Tamaño Normal[[/size]] | 100% del Tamaño Normal |
[[size 200%]]200% del Tamaño Normal[[/size]] | 200% del Tamaño Normal |
[[size xx-small]]xx-small text[[/size]] | xx-small text |
[[size x-small]]x-small text[[/size]] | x-small text |
[[size small]]small text[[/size]] | small text |
[[size smaller]]smaller text[[/size]] | smaller text |
Normal text | Normal text |
[[size larger]]larger text[[/size]] | larger text |
[[size large]]large text[[/size]] | large text |
[[size x-large]]x-large text[[/size]] | x-large text |
[[size xx-large]]xx-large text[[/size]] | xx-large text |
Párrafos y líneas nuevas
Los Párrafos están separados por dos líneas nuevas. Una línea nueva procude… Una línea nueva
Primer párrafo. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Segundo párrafo. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Una línea nueva.
Otra línea nueva.
Primer párrafo. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Segundo párrafo. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Una línea nueva.
Otra línea nueva.
Tipografía
Si te preocupa la tipografía, aquí hay algunas formas sencillas de mejorarla en tus textos:
tecleas | obtienes |
---|---|
``quotation'' | “quotation” |
`quotation' | ‘quotation’ |
,,quotation'' | „quotation” |
dots... | dots… |
em -- dash | em — dash |
Texto Literal
Si quieres evitar el parseo (transformación del texto origen) y mostrar el texto tal cual lo escribes, enciérralo entre caracteres @@ dobles.
Este //texto// será **parseado**.
@@Este //texto// no será **parseado**.@@
Este texto será parseado.
Este //texto// no será **parseado**.
Comentarios
Los comentarios son bloques de código fuente que no se tomarán en cuenta a la hora de formar la página y mostrarla. Muy útiles para los editores. Para añadir un comentario en el código fuente usa la construcción [!-- ... --] como se indica:
[!--
Este texto no será mostrado
--]
Encabezados
Para hacer un encabezado comienza la linea con un símbolo "más". Usa tantos mases como el nivel de encabezado que quieras conseguir.
+ Level 1 Heading
++ Level 2 Heading
+++ Level 3 Heading
++++ Level 4 Heading
+++++ Level 5 Heading
++++++ Level 6 Heading
Tabla de Contenidos
Para crear una lista con cada encabezado, y un enlace a ese encabezado, pon una etiqueta de Tabla de Contenidos (Table of contents, TOC) en una linea propia.
[[toc]]
[[f>toc]] - Tabla de contenidos flotante a la derecha
[[f<toc]] - Tabla de contenidos flotante a la izquierda
Lineas horizontales
Usa cuatro guiones o más (----) para crear una línea horizontal
Listas
Listas Ordenadas
Para crear un elemento de una lista inicia la línea con un asterisco. Para anidar elementos en otros elementos de la lista, pon espacios extra antes del asterisco.
* Bullet 1
* Bullet 2
* Bullet 2.1
- Bullet 1
- Bullet 2
- Bullet 2.1
Listas numeradas
De forma similar, puedes crear listas numeradas iniciando un nuevo párrafo con uno o más almohadillas (gatos, cuadradillos, o como lo llames).
# Item 1
# Item 2
# Item 2.1
- Item 1
- Item 2
- Item 2.1
Puedes mezclar listas ordenadas y numeradas
Listas de definiciones
Puedes crear una lista de definiciones (descripciones) con la siguiente sintaxis:
: Item 1 : Algo
: Item 2 : Algo distinto
- Item 1
- Algo
- Item 2
- Algo distinto
Bloque de Cita
Puedes señalar una cita comenzando una linea con uno o más signos '>' , seguidos de un espacio y el texto a ser citado.
Esto es texto normal.
> Sangria! The quick brown fox jumps over the lazy dog. \
Now this the time for all good men to come to the aid of \
their country. Notice how we can continue the block-quote \
in the same "paragraph" by using a backslash at the end of \
the line.
>
> Otro bloque que nos lleva a...
>> Segundo nivel de sangría. This second is indented even \
more than the previous one.
Volvemos al texto normal.
Esto es texto normal.
Sangria! The quick brown fox jumps over the lazy dog. Now this the time for all good men to come to the aid of their country. Notice how we can continue the block-quote in the same "paragraph" by using a backslash at the end of the line.
Otro bloque que nos lleva a…Segundo nivel de sangría. This second is indented even more than the previous one.
Volvemos al texto normal.
Enlaces
Enlaces internos
De manera distinta a otros sitios wiki, wikidot.com no procesa palabras UnidasYCapitalizadas . En vez de eso, cada enlace debe ser marcado con 3 corchetes anidados.
Si una direccion de página contiene caracteres no autorizados, la direccion será "arreglada" para albergar sólo caracteres autorizados, aunque el nombre mostrado mantendrá el formato original.
lo que tecleas | lo que obtienes | comentarios |
---|---|---|
[[[link-to-a-page]]] | link-to-a-page | usando un nombre de página tal cual |
[[[link "TO" ą pagE]]] | link "TO" ą pagE | purificación automática de la página de destino |
[[[category: sample page]]] | sample page | enlazada a una pagina perteneciente a una categoría |
[[[some page| custom text]]] | custom text | usando un texto para el enlace |
[[[fauna | Fauna de Regnum]]] | Fauna de Regnum | enlazar a una pagina existente o inexistente aun |
[[[doc#toc1|Section 1]]] | Section 1 | enlazando a un ancla con un texto (Primera sección) |
[[[doc#toc1]]] | doc | enlazando a un ancla (primera seccion) |
URLs
lo que tecleas | lo que obtienes | comentarios |
---|---|---|
http://www.wikidot.com | http://www.wikidot.com | enlace simple |
[http://www.wikidot.com wikidot] | wikidot | enlace sobre un texto particular |
*http://www.wikidot.com [*http://www.wikidot.com wikidot] |
http://www.wikidot.com wikidot |
abre en una ventana nueva |
[# empty link] | empty link | enlace muerto a href="javascript:;" i.e. no lleva a ningun sitio. util para crear menus desplegables |
Anclas
Para situar un ancla usa la sintaxis [[# nombre-ancla]] . Para referirte a un ancla (y situarte en él) usa [# nombre-ancla texto a mostrar].
Emails
what you type | what you get | comments |
---|---|---|
support@example.com | moc.elpmaxe|troppus#moc.elpmaxe|troppus | simple inline email |
[support@example.com email me!] | moc.elpmaxe|troppus#!em liame | custom anchor |
Although we discourage anyone from putting his/her email address on the web, WikiDot engine provides a simple scrambling mechanism to prevent automated bots from reading emails. Each email is scrambled and it is decoded in the client's browser. So it is not 100% spam-safe, but much safer than plain-text emails.
InterWiki
Para enlazar directamente a un artículo de Wikipedia puedes usar la sintaxis:
what you type | what you get |
---|---|
[wikipedia:Albert_Einstein] | Albert_Einstein |
[wikipedia:Albert_Einstein Albert] | Albert |
Otros enlaces definidos como ejemplo:
- [google:free+wiki] - buscar en google los terminos "free wiki"
- [dictionary:wiki] - buscar definiciones de la palabra wiki en dictionary.reference.com
Imágenes
Imágenes sencillas.
Para insertar una imagen en una página usa la sintaxis siguiente
[[image origen-de-la-imagen atributo1="valor1" atributo2="valor2" ...]]
Y aquí está la lista de atributos admitidos.
nombre de atributo | valores permitidos | valor de ejemplo | descripción |
---|---|---|---|
link | nombre de pagina wiki o URL | "wiki-page" "http://www.example.com" |
hace que la imagen enlace con otra página o dirección web; esto es ignorado cuando se usa Flickr como origen de las imágenes; precede el elnace con un '*' para hacer que se abra en una ventana nueva |
alt | cualquier cadena | "una foto de mi papa" | sustitución del texto cuando la imagen no esta disponible |
width | número de pixels | "200px" | fuerza el ancho de la imagen al ser mostrada |
height | número de pixels | "200px" | fuerza el alto de la imagen al ser mostrada |
style | definición de estilo CSS válida | "border: 1px solid red; padding: 2em;" | añade estilo CSS extra a la imagen |
class | clase CSS | "mystyle" | fuerza la clase CSS para la imagen - sugerido sólo cuando usas "temas" personalizados |
size | "square" - 75x75 pixels "thumbnail" - 100 en el lado más largo "small" - 240 en el lado más largo "medium" - 500 en el lado más largo "large" - 1024 en el lado más largo (sólo para imáagenes grandes de Flickr) "original" - imagen original (sólo Flickr) |
cualquiera de los admitidos ;-) | muestra una imagen a escala ; genial para l thumbnails if flickr is the source it pulls required size from a Flickr server; esta opción solo tiene efecto en imágenes locales o almacenadas en Flickr |
el atributo size funciona muy bien con archivos locales (adjuntos a la página) no sólo con archivos de imagen, sino con por ejemplo e.g. PDF o archivos PostScript. Ver esta página (en inglés) para más detalles.
El origen-de-la-imagen sólo puede ser una de las siguientes cosas:
tipo de origen | formato | valor de ejemplo | descripción |
---|---|---|---|
direccion URL | cualquier direccion URL válida | http://www.example.com/image.jpg | muestra la imagen desde su sitio web original |
archivo adjunto (en la página actual) | nombredearchivo | exampleimage.jpg | muestra la imagen adjunta a la página actual |
archivo adjunto (en otra pñagina) | /nombre-de-la-pagina/nombredearchivo | /another-page/exampleimage.jpg | muestra la imagen adjunta en otra página |
imagen de flickr | flickr:photoid | flickr:83001279 | muestra la imagen desde Flickr y enlaza con la página original de Flickr |
imagen de flickr (privada) | flickr:photoid_secret | flickr:149666562_debab08866 | muestra la imagen desde Flickr y enlaza a la pagina original de Flickr; si el secret es incluído, la imagen es accesible aunque esté marcada como no-pública |
Para hacer que el documento enlazado se abra en una nueva ventana puede usar el atributo link con '*' (e.g. link="*http://www.example.com" o preceder el elemento src con '*' (e.g. *flickr:149666562_debab08866, *image-file etc.) para imágenes que automáticamente generan links.
Para elegir una colocación horizontal usa::
- [[=image… - imagen centrada
- [[<image… - imagen a la izquierda
- [[>image… - imagen a la derecha
- [[f<image… - imagen flotante a la izquierda (rodeada por el texto)
- [[f>image… - imagen flotante a la derecha (rodeada por el texto)
Galería de imágenes
Para insertar una serie de imagenes dentro del contenido de una pagina use el elemento [[gallery]]:
[[gallery size="image-size"]]
ó
[[gallery size="image-size"]]
: image-source1 attribute1="value1" attribute2="value2" ...
: image-source2 attribute1="value1" attribute2="value2" ...
...
[[/gallery]]
El único atributo permitido dentro de [[gallery]] es la etiqueta size con los valores permitidos "square", "thumbnail", "small", "medium".
Si la etiqueta [[gallery]] es invocada sin una lista de imágenes este automaticamente mostrara imagenes reescaladas (thumbnails) de archivos de imagenes adjuntas en la página actual (Esto también incluye thumbnails para cualquier documento .pdf ó .ps).
Si [[gallery]] es invocado con una lista de imágenes, solo esas imágenes son mostradas. image-source no debe ser una URL en este caso. Atributos permitidos por imagen son:
- link - URL ó nombre de una pagina wiki (No trabaja con imágenes Flickr para estar o.k. con los terminos Flickr)
- alt - Texto alternativo cuando una imágen no esta disponible
Para abrir un documento en una nueva ventana seguir las mismas reglas como se aplica a una sola imagen.
Ver también FlickrGallery module si ud. desea importar imágenes de Flickr.
Bloques de Código
Crea bloques de código usando las etiquetas [[code]]…[[/code]] (cada una en su propia línea).
Esto es un ejemplo de codigo!
Para crear bloques de código PHP que son automaticamente coloreados cuando usas etiquetas PHP, simplemetne rodea el código con las etiquetas [[code type="php"]]…[[/code]] ).
Para conseguir código PHP coloreado, deberás rodearlo con <?php.. ?>.
WikiDot.com usa PEAR::Text_Highlighter y soporta algunos temas de colores. Aqui se muestran los que se soportan (valores aceptados):
php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml.
[[code type="php"]]
<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>
[[/code]]
/* comment */ for($i=0; $i<100; $i++){ echo "number".$i."\n"; }
Tablas
Puedes crear tablas usando pares de barras verticales:
||~ head 1 ||~ head 2 ||~ head 3 ||
|| cell 1 || cell 2 || cell 3 ||
|||| long cell 4 || cell 5 ||
||cell 6 |||| long cell 7 ||
|||||| looong cell 8||
head 1 | head 2 | head 3 |
---|---|---|
cell 1 | cell 2 | cell 3 |
long cell 4 | cell 5 | |
cell 6 | long cell 7 | |
looong cell 8 |
|| lines must start and end || with double vertical bars || nothing ||
|| cells are separated by || double vertical bars || nothing ||
|||| you can span multiple columns by || starting each cell ||
|| with extra cell |||| separators ||
|||||| but perhaps an example is _
the easiest way to see ||
lines must start and end | with double vertical bars | nothing |
cells are separated by | double vertical bars | nothing |
you can span multiple columns by | starting each cell | |
with extra cell | separators | |
but perhaps an example is the easiest way to see |
Para una nueva linea dentro de una celda usa _ (guión bajo) al final de la linea (ver el ejemplo anterior).
Bloques de Formato
Left, right, centered and justified
Para usar alineamiento horizontal en un bloque usa los siguiente:
[[<]] ... [[/<]] | alinear izquierda |
[[>]] ... [[/>]] | alinear derecha |
[[=]] ... [[/=]] | alinear centro |
[[==]] ... [[/==]] | alinear justificado |
E.j.
[[=]]
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\
Aenean a libero. Vestibulum adipiscing, felis ac faucibus \
imperdiet, erat lacus accumsan neque, vitae nonummy lorem \
pede ac elit.
Maecenas in urna. Curabitur hendrerit risus vitae ligula.
[[/=]]
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Maecenas in urna. Curabitur hendrerit risus vitae ligula.
Para centrar una sola línea usa = al comienzo:
= Linea centrada
Linea centrada
Bloques div personalizados
Para mejorar el diseño puedes usar elementos [[div]] ... [[/div]] que se transformaran en bloques HTML @div> ... </div@.
Atributos permitidos: class y style sólo pero deberían ser más que suficientes para conseguir el diseño deseado.
Los bloques [[div]] pueden ser anidados.
A continuación hay un ejemplo de como crear un diseño de 2 columnas usando bloques div:
[[div style="float:left; width: 45%; padding: 0 2%"]]
columna izq columna izq columna izq columna izq columna izq
columna izq columna izq columna izq columna izq columna izq
[[/div]]
[[div style="float:left; width: 45%; padding: 0 2%"]]
columna der columna der columna der columna der columna der
columna der columna der columna der columna der columna der
[[/div]]
~~~~~
columna izq columna izq columna izq columna izq columna izq columna izq columna izq columna izq columna izq columna izq
columna der columna der columna der columna der columna der columna der columna der columna der columna der columna der
El elemento ~~~~ se usa para limpiar los floats y se traduce mas o menos como <div style="clear:both"></div>).
Los bloques [[div]] personalizados pueden usarse para crear diseños de página muy avanzados.
Matemáticas
WikiDot.com usa LaTeX para crear bonitas ecuaciones. Para aquellos que conozcan la sintaxis LaTeX usar las ecuaciones de WikiDot debería ser muy fácil.
Ecuaciones
Simplemente pon la ecuación entre los bloques de etiquetas [[math etiqueta]] … [[/math]] (la etiqueta es opcional). La ecuación será realizada con el entorno LaTex \begin{equation} ... \end{equation} . Por favor para detalles sopbre la sintaxis, consulte cualquier manual de referencia sobre LaTex.
[[math label1]]
\rho _{\rm GJ} = -\sigma (r) \left[ (1 - \eta _{\ast }^2 {\kappa \over {\eta ^3}}) \cos \chi \right.
+ \left. {3\over 2} \theta (\eta) H(\eta)
\xi \sin \chi \cos \phi \right]
[[/math]]
To refer to a labeled equation simply use [[eref label]] to get a raw number or e.g. Eq. ([[eref label1]]) which gives Eq. (1).
Para acortar largas ecuaciones use un type="eqnarray" attribute, e.g.
[[math label2 type="eqnarray"]]
\lefteqn{ \cos x = 1
-\frac{x^{2}}{2!} +{} } \\
& & {}+\frac{x^{4}}{4!}
-\frac{x^{6}}{6!}+{}\cdots
[[/math]]
Matemáticas Inline
Para usar expresiones matemáticas dentro del texto (frase) usa las etiquetas de bloque [[$ ... $]]
[[$ E = mc^2 $]] is much more popular than
[[$ G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu} $]]
$E = mc^2$ is much more popular than $G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu}$
Notas al Pie
Para hacer Notas al Pie en el texto usa un bloque [[footnote]] . Para forzar a la lista de notas al pie a aparecer en un lugar distinto al pie de página usa
[[footnoteblock]].
Algo de texto[[footnote]]Y una nota.[[/footnote]]. Alla vamos con otra nota al pie[[footnote]]Contenido de otra nota al pie.[[/footnote]].
[[footnoteblock]]
Algo de texto1. Alla vamos con otra nota al pie2.
Si no te gusta el título por defecto ("Footnotes") puedes forzarle a mostrar un titulo distinto usando [[footnoteblock title="título personalizado"]] o incluso no usar ningun título en absoluto (title="").
Bibliografía
El bloque de Bibliografía esta definido por [[bibliography]]...[[/bibliography]]. Cada item de bibliografía tiene la forma:
label : referencia completa
Para citar una entrada en la bibliografía usa((bibcite label)).
The first pulsar was observed by J. Bell and A. Hewish [((bibcite bell))]. Another reference [see ((bibcite guy))].
[[bibliography]]
: bell : Bell, J.; Hewish, A.; Pilkington, J. D. H.; Scott, P. F.; and Collins, R. A. //Observation of a Rapidly Pulsating Radio Source.// Nature 217, 709, 1968.
: guy : Guy, R. K. //Modular Difference Sets and Error Correcting Codes.// §C10 in Unsolved Problems in Number Theory, 2nd ed. New York: Springer-Verlag, pp. 118-121, 1994.
[[/bibliography]]
El primer pulsar fue observado por J. Bell and A. Hewish [1]. Para otra referencia [see 2].
Si no te gusta el título por defecto("Bibliography") puedes forzarle a mostrar un titulo distinto usando [[bibliography title="Custom title"]] o incluso no usar ningún título en absoluto(title="").
Incluir otras páginas
Si quieres incluir contenido de otras páginas usa:
[[include nombredepagina]]
La etiqueta include debería empezar y terminar en una línea.
The [[include]] tag can also take parameters and substitute variables in the included source. To denote variables in the included page use:
{$var1}, {$number_books}, {$title}, {$variable_name}, {$variableName}
and in the including page use:
[[include pagename var1=value1 | number_books = 43 | title=Best Wiki Ever
| variable_name = just a variable
| variableName = another variable
]]
As you can see you can splid variable definitions over several lines for cleaner code.
NOTE: includes and images/files: The [[include]] works just by inserting the page source at a given place. If you have any images or files attached in the included page and you refer to them as [[image filename.jpg]] in the included page, please rather use the image/file source with the name of the page too, e.g. [[image included-page/filename.jpg]]
Embebiendo Medios
Video
Para embeber video directamente dentro de una página use el bloque [[embedvideo]] ... [[/embedvideo]] .
Entre el "código html embebido" debería ubicarse alguna de las siguientes galerías en-línea de videos:
E.j.
[[embedvideo]]
<embed style="width:400px; height:326px;" id="VideoPlayback" align="middle"
type="application/x-shockwave-flash"
src="http://video.google.com/googleplayer.swf?docId=263244138622602613"
allowScriptAccess="sameDomain" quality="best" bgcolor="#ffffff" scale="noScale" salign="TL"
FlashVars="playerMode=embedded"> </embed>
[[/embedvideo]]
Audio
Para embeber audio use [[embedaudio]] ... [[/embedaudio]] y el código html que presente el sitio de hosting de audio.
Actualmente se soporta:
E.j.
[[embedaudio]]
<embed src="http://www.odeo.com/flash/audio_player_standard_gray.swf"
quality="high" width="300" height="52" name="audio_player_standard_gray"
align="middle" allowScriptAccess="always" wmode="transparent"
type="application/x-shockwave-flash" flashvars="audio_id=99133&audio_duration=282.0&valid_sample_rate=true&external_url=http://www.vitalpodcasts.com/FileSystem/podcasts/89/opensource_episode1.mp3" pluginspage="http://www.macromedia.com/go/getflashplayer" />
</embed><br /><a style="font-size: 9px; padding-left: 110px; color: #f39;
letter-spacing: -1px; text-decoration: none" href="http://odeo.com/audio/99133/view">
powered by <strong>ODEO</strong></a>
[[/embedaudio]]
Embebiendo código desde otros sitios
A veces los sitios web (generalmente los de orientación social) te permiten pegar un bloque de código directamente dentro de otras páginas para de esta forma aumentar la funcionabilidad de tu sitio o embeber algún contenido del sitio web original.
[[embed]] tag
La etiqueta [[embed]] te permite hacer lo mismo con las págians de tu wiki. Ej. para mostrar la nube de etiquetas de del.icio.us generada desde http://del.icio.us/help/tagrolls simplemente copie el código html:
[[embed]]
<script type="text/javascript" src="http://del.icio.us/feeds/js/tags/michal_frackowiak?icon;size=12-35;color=87ceeb-0000ff;title=my%20del.icio.us%20tags"></script>
[[/embed]]
Para una lista de los servicios soportados, por favor consulta la página: Embedding code from other services.
Please note that if the code contains <script type="text/javascript"… i.e. just JavaScript, the content will not be fully rendered when you click preview while editing the page. It should be there however when you view the page afterwards.
[[iframe]] element
Using the iframe element one can embed content of any other web page. The syntax is
[[iframe url-source attributes]]
and it translates into HTML tags <iframe src="url-source" attributes></iframe>. The allowed attributes are: frameborder (0 or 1 allowed), align (left, right, top, bottom, middle), height (number of pixels or %), width (number of pixels or %), scrolling (yes or no), class, style
Iftags
Tags are kind of special labels for a page, manually added in by editors by clicking on the tags link at the page options buttons on bottom of a page. Every tag can be max 64 characters long, tags are "space" separated and there is no limit of tags per page. Tags are very useful to label pages and then it's easy to create Tag Cloud, which allow to find interesting pages or topics much faster.
Special tags start with an underline: they are not automatically shown in tag clouds, but they can be used as special limitations in [[iftag]] conditions. Tags can be used in ListPages Module with generic conditions ( +, - ) too.
Iftag is a special condition question. You can use it on every page to "react" on tags and set up on the particular page used .
Syntax:
[[iftags +tag1 -tag2 tag3]] ... [[/iftags]]
where the +/-"tag#" stands for the requested tag-indexes.
- + before a tagname means - this tag must exist, (tag without a modifier works in a same way)
- - before a tagname means - this tag must not exist.
Example:
[[iftags +science]]
This page is labeled as: science.
Click here to view more science articles >
[[/iftags]]
[[iftags +bug -fixed]]
This is a bug, but it's not fixed yet.
[[/iftags]]
Módulos
Modules are independent widgets that can be placed in the pages. The general syntax is:
[[module ModuleName param1="value1" param2="value2" ...]]
To read more about modules see the modules section of the documantation.
Archivos adjuntos
what you type | what it means |
---|---|
[[file filename]] | produces a link to a file attached to this page |
[[file /another-page/filename]] | produces a link to a file attached to another-page |
The destination file must be first attached to the page — by clicking "files" and "upload file" from the options at the bottom of any page.
Usuarios
what you type | what you get | comments |
---|---|---|
[[user user-name]] e.g. [[user michal frackowiak]] |
michal-frackowiak | user info (no buddy icon) |
[[*user user-name]] e.g. [[*user michal frackowiak]] |
michal-frackowiak | user info (with buddy icon) |
Marcadores sociales
It is easy to add "social bookmarking" buttons to your pages — just write [[social]] (without any parameters) and get:
Esto es equivalente a:
[[social blinkbits,blinklist,blogmarks,co.mments,connotea,del.icio.us,de.lirio.us,digg,fark,feedmelinks,furl,linkagogo,ma.gnolia,newsvine,netvouz,rawsugar,reddit,scuttle,shadows,simpy,smarking,spurl,tailrank,wists,yahoomyweb,facebook]]
You can also choose only selected services, e.g. to choose digg, furl and del.icio.us use:
[[social digg,furl,del.icio.us,facebook]]
and get:
Tip: use social bookmarking! It is always a good idea to put social shortcuts under an article or inside your side bar.
Standalone buttons (page options)
Somehow it might be convenient to hide the default page options and present only selected buttons to the users. The syntax for it is:
[[button type options]]
Where the type is: edit, edit-append, edit-sections, history, print, files, tags, source (view page source), backlinks, talk (works similar as in MediaWiki/Wikipedia).
Possible attributes are:
- text — alternative text to be displayed
- class — CSS class of the A element
- style — CSS style definition
For some nice "view source" and "print" buttons with icons you can use the following code:
[[>]]
[[button source style="background-image: url(http://www.wikidot.com/local--files/files/view-source.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px; color: #444"]]
[[button print style="background-image: url(http://www.wikidot.com/local--files/files/document-print.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px;color: #444"]]
[[/>]]
to get: