Como Edito Las Paginas

This document describes the Wiki Syntax used within the Wikidot.com project.

Cualquier página de cualesquiera de los sitios existe en dos diversas formas: el código de fuente y el código compilado. El código de fuente es lo que usted puede corregir y qué describe el contenido de la página. El código de fuente se compila en el código (XHTML) que se envía al browser cuando usted view/browse la página. El sintaxis de Wiki es utilizado para crear el contenido de las páginas corrigiendo el código de fuente.

Si usted está buscando los snippets del código del wiki listos para copiar/pegar/modificar, visite por favor nuestroCode Snippets Site.

Formato En línea

lo que escribe lo que obtiene
//texto en cursiva// texto en cursiva
**texto en negrilla** texto en negrilla
//**cursiva y negrilla**// cursiva y negrilla
__texto subrayado__ texto subrayado
--texto con una línea-- texto con una línea
{{texto monoespaciado (teletipo)}} texto monoespaciado (teletipo)
normal^^superíndice^^ normalsuperíndice
normal,,subíndice,, normalsubíndice
[!-- comentario invisible --]
[[span style="color:red"]]custom //span// element[[/span]] custom span element
##blue|predefined## or ##44FF88|custom-code## color predefined or custom-code color

Párrafos y líneas nuevas

Los párrafos son separados por dos nuevas líneas. Una nueva línea produce… una nueva línea.

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 nueva línea.

Otra nueva línea.

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 nueva línea.

Otra nueva línea.

Tipografía

Si usted cuida sobre tipografía hay algunas maneras de mejorarla en su texto :

ud escribe ud obtiene
``texto'' “texto”
`texto ' ‘texto’
,,texto'' „texto”
puntos... puntos…
em -- dash em — dash

Literal texto

Si usted desea escapar del código y desea escribir el texto crudo, debe utilizar los caracteres @@.

Este //texto// va **crudo**. 

@@Este //texto// no va  **crudo**.@@

Este texto va crudo.

Este //texto// no va **crudo**.

Comments

Un comentario es un bloque de la fuente que no se obtiene en la versión compilada. Para agregar un comentario a la fuente utilice la construcción del ]}} del {{[!…, e.g.:

[!--

This texto  will not be rendered.

--]

Encabezados

Para hacer un encabezado, comience una línea con "más". Haga tantos más como el nivel que dirige que usted desea conseguir.

+ Nivel 1 Encabezado

++ Nivel 2 Encabezado

+++ Nivel 3 Encabezado

++++ Nivel 4 Encabezado

+++++ Nivel 5 Encabezado

++++++ Nivel 6 Encabezado

Table of Contents

To create a list of every Encabezado, with a link to that Encabezado, put a table of contents tag on its own line.

[[toc]]

[[f>toc]] - right-float table of contents

[[f<toc]] - left-float table of contents

Horizontal Rules

Use four dashes or more (----) to create a horizontal rule.

Lists

Bulleted Lists

Make a list element by starting a line with an asterisk. To increase indent put extra spaces

before the asterisk.

* Bullet 1

* Bullet 2

 * Bullet 2.1
  • Bullet 1
  • Bullet 2

* Bullet 2.1

Numbered Lists

Similarly, you can create numbered lists by starting a paragraph with one or more hashes.

# Item 1

# Item 2

 # Item 2.1
  1. Item 1
  1. Item 2

# Item 2.1

You can mix bulleted lists and number lists.

Definition Lists

You can create a definition (description) list with the following syntax:

: Item 1 : Something

: Item 2 : Something else
Item 1
Something
Item 2
Something else

Block Quotes

You can mark a blockquote by starting a line with one or more '>' characters, followed by a space and the texto to be quoted.

This is normal texto  here.

> Indent me! 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.

>

> Another block, leading to...

>> Second Nivel of indenting. This second is indented even \

more than the previous one.

Back to normal texto .

This is normal texto here.

Indent me! 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.

Another block, leading to…

Second Nivel of indenting. This second is indented even

more than the previous one.

Back to normal texto .

Links

Internal links

Unlike some other wiki engines wikibox.net does not process SqusherAndCapitalized words as page links. Instead any link should be marked with 3 nesting square brackets.

If a page address contains disallowed characters the address will be "unixified" to contain only allowed chars. The displayed name however will maintain original form.

what you type what you get comments
[[[link-to-a-page]]] link-to-a-page using raw page name
[[[link "TO" ą pagE]]] link "TO" ą pagE automatic purification of destination page
[[[category: sample page]]] sample page linked to a page with category
[[[some page| custom texto ]]] [[[some page| custom texto ]] using custom texto
[[[doc|Documentation]]] Ducumentation linking to an existing page (different color)
[[[doc#toc1|Section 1]]] Section 1 linking to an anchor (first section)
[[[doc#toc1]]] doc linking to an anchor (first section)

URLs

what you type what you get comments
http://www.wikidot.com http://www.wikidot.com simple inline link
[http://www.wikidot.com wikidot] wikidot named link (custom anchor)

[*http://www.wikidot.com wikidot] || http://www.wikidot.com

wikidot || opens in a new window ||

[# empty link] empty link link with href="javascript:;" i.e. not leading anywhere. usefull when constructing pull-down menus

Anchors

To place an anchor use [[# anchor-name]] syntax. To refer to an anchor (and scroll to it) use [#anochor-name texto to display].

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

InterWiki

To link directly to a Wikipedia article you can use a syntax:

what you type what you get
[wikipedia:Albert_Einstein] Albert_Einstein
[wikipedia:Albert_Einstein Albert] Albert

Other links defined by example:

  • [google:free+wiki] - search google for the "free wiki" term
  • [dictionary:wiki] - look up definitions of the word wiki from dictionary.reference.com

Images

Single images

To insert an image into the page use the following syntax:

[[image image-source attribute1="value1" attribute2="value2" ...]]

And here is the list of allowed attributes:

attribute name allowed values example value description
link wiki page name or URL

"http://www.example.com" || makes image a link to another page or web address; this is ignored when using Flickr as a source; prepend the link with '*' to make it open in a new window ||

alt any string "a photo of me" texto substitution when image not available
width number of pixels "200px" forces width of a image when displaying
height number of pixels "200px" forces height of a image when displaying
style valid CSS style definition "border: 1px solid red; padding: 2em;" adds extra CSS style to the image
class CSS class "mystyle" forces the image CSS class - suggested use only with customized themes
size

"thumbnail" - 100 on longest side

"small" - 240 on longest side

"medium" - 500 on longest side

"large" - 1024 on longest side (only for Flickr large images)

"original" - original image (Flickr only) || any of allowed ;-) || displays a resized image; great for thumbnails

if flickr is the source it pulls required size from a Flickr server;

this option has effect only on local images or Flickr images||

size attribute works very well with local files (attached to pages) not only with image files, but with e.g. PDF or PostScript. See this page for more details.

The image-source can be one of the following:

source type format example value description
URL address any valid URL address http://www.example.com/image.jpg displays image from the web address
file attachment (current page) filename exampleimage.jpg displays image attached to the current page
file attachement (different page) /another-page-name/filename /another-page/exampleimage.jpg displays image attached to a different page
flickr image flickr:photoid flickr:83001279 displays image from Flickr and links to the original Flickr page
flickr image (private) flickr:photoid_secret flickr:149666562_debab08866 displays image from Flickr and links to the original Flickr page; if the secret is provided the image is available despite being marked as non-public

To make the linked document in a new window you can either prepend the link attribute with '*' (e.g. link="*http://www.example.com" or prepend the src element with '*' (e.g. *flickr:149666562_debab08866, *image-file etc.) for images that automatically generate links.

To choose horizontal alignment use:

  • [[=image… - centered image
  • [[<image… - image on left
  • [[>image… - image on right
  • [[f<image… - image on left floating (surrounded by texto )
  • [[f>image… - image on right floating (surrounded by texto )

Gallery of images

To insert a series of images into a page content use the [[gallery]] element:

[[gallery size="image-size"]]

or

[[gallery size="image-size"]]

: image-source1 attribute1="value1" attribute2="value2" ...

: image-source2 attribute1="value1" attribute2="value2" ...

...

[[/gallery]]

The only allowed attribute within the [[gallery]] tag is size with allowed values: "square", "thumbnail", "small", "medium".

If the [[gallery]] tag is invoked without a list of images it automatically displays rescaled images (thumbnails) of imageable files attached to the current page (this also include thumbnails for any .pdf or .ps document).

If [[gallery]] is invoked with a list of images, only these images are displayed. image-source must not be a URL in this case. Allowed "per-image attributes are:

  • link - URL or wiki page name (does not work with Flickr images to be o.k. with Flickr terms)
  • alt - alternative texto when the image is not available

To make a document open in a new window the same rules as with a single image applies.

Also see FlickrGallery module if you wish to import images from Flickr.

Code Blocks

Create code blocks by using [[code]]…[[/code]] tags (each on its own line).

This is an example code block!

To create PHP blocks that get automatically colorized when you use PHP tags, simply surround the code with [[code type="php"]]…[[/code]] tags).

To get PHP code colorized you should surround it with <?php.. ?>.

WikiDot.com uses PEAR::texto _Highlighter and supports a number of color schemes. Here is what is supported (allowed type values):

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]]
<?php
 
/* comment */
 
for($i=0; $i<100; $i++){
 
echo "number".$i."\n";
 
}
 
?>

Tables

You can create tables using pairs of vertical bars:

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

the easiest way to see ||

For a newline inside the table cell use _ (underscore) at the end of the line (see the example above).

Block formatting elements

Left, right, centered and justified

To apply horizontal alignment to a block of texto use:

[[<]] ... [[/<]] align left
[[>]] ... [[/>]] align right
[[=]] ... [[/=]] align center
[[==]] ... [[/==]] align justified

E.g.

[[=]]

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.

To center a single line use = at the beginning:

= Centered line

Centered line

Custom div blocks

To improve the layout you can use [[div]] ... [[/div]] elements which transform to html @div> ... </div@ blocks.

Allowed attributes are: class and style only but this should be more than enough to create desired layout.

[[div]] blocks can be nested.

Below is an example how to create a 2-column layout using div block:

[[div style="float:left; width: 45%; padding: 0 2%"]]

left column left column left column left column left column

left column left column left column left column left column

[[/div]]

[[div style="float:left; width: 45%; padding: 0 2%"]]

right column right column right column right column right column

right column right column right column right column right column

[[/div]]

~~~~~

left column left column left column left column left column left column left column left column left column left column

right column right column right column right column right column right column right column right column right column right column

The ~~~~ element is used to clear floats and translates more or less to <div style="clear:both"></div>).

Custom [[div]] blocks can be used to create very advanced page layouts.

Math

WikiDot.com uses LaTeX to render beautiful equations. For these who know LaTeX syntax using wikidot equations should be quite obvious. Please

Equations

Simply put the equation between [[math label]] … [[/math]] block tags (the label is optional). The equation is rendered within LaTex \begin{equation} ... \end{equation} environment. Please refer to any LaTeX reference manual for details about syntax.

[[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]]
(1)
\begin{align} \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] \end{align}

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

To break long equations use a 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!}+{}\cpuntos

[[/math]]
(2)
\begin{eqnarray} \lefteqn{ \cos x = 1 -\frac{x^{2}}{2!} +{} } \\ & & {}+\frac{x^{4}}{4!} -\frac{x^{6}}{6!}+{}\cpuntos \end{eqnarray}

Inline math

To use math expressions inside texto (sentence) use [[$ ... $]] block tags.

[[$ 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}$

Footnotes

To make footnotes in the texto use [[footnote]] block. To force the list of footnotes

to appear not at the end of the page, use [[footnoteblock]].

Some texto [[footnote]]And a small footnote.[[/footnote]]. Here we go 

with another footnote[[footnote]]Content of another footnote.[[/footnote]].

[[footnoteblock]]

Some texto1. Here we go with another footnote2.

If you are not satisfied with the default title ("Footnotes") you can force your own title by using [[footnoteblock title="Custom title"]] or even do not use title at all (title="").

Bibliography

The bibliography block is defined by [[bibliography]]...[[/bibliography]]. Each bibliography item has the form:

label : full reference

To cite a bibliography entry use ((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]]

The first pulsar was observed by J. Bell and A. Hewish [1]. Another reference [see 2].

Bibliography
1. 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.
2. 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.

If you are not satisfied with the default title ("Bibliography") you can force your own title by using [[bibliography title="Custom title"]] or even do not use title at all (title="").

Include other pages

If you want to include contents of another page use:

 [[include pagename]]

The include tag should start and end with a newline.

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

Embedding media

Video

To embed video directly into the page use [[embedvideo]] ... [[/embedvideo]] block.

Between the the "embedding html code" should be placed from any of the following video online galleries:

E.g.

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

To embed audio use [[embedaudio]] ... [[/embedaudio]] and the html embedding code found on the audio hosting website.

Currently supported are:

E.g.

[[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; texto -decoration: none" href="http://odeo.com/audio/99133/view">

powered by <strong>ODEO</strong></a>

[[/embedaudio]]

Embedding code from other sites

Sometimes web sites (mainly social-oriented ones) allow you to paste a code block directly into other pages in order to increase your site functionality or embed some contet from the original site.

[[embed]] tag

The [[embed]] block tag allows you to do the same with your wiki pages. E.g. to display del.icio.us tag cloud as generated from http://del.icio.us/help/tagrolls simply wrap the html code:

[[embed]]

<script type="texto /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]]

For the list of supported services please see the page: Embedding code from other services.

Please note that if the code contains <script type="texto /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

Modules

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.

Attached files

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.

Users

what you type what you get comments

e.g. [[user michal frackowiak]] || michal frackowiak || user info (no buddy icon)||

e.g. [[*user michal frackowiak]] || michal frackowiakmichal frackowiak || user info (with buddy icon)||

Social bookmarking

It is easy to add "social bookmarking" buttons to your pages — just write [[social]] (without any parameters) and get:

BlinkListblogmarksdel.icio.usdiggFarkfeedmelinksFurlLinkaGoGoNewsVineNetvouzRedditYahooMyWebFacebook

This is equivalent to:

[[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]]

You can also choose only selected services, e.g. to choose digg, furl and del.icio.us use:

[[social digg,furl,del.icio.us]]

and get: diggFurldel.icio.us

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:

  • texto — alternative texto 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:

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-Noncommercial-No Derivative Works 2.5 License.