Ajuda avançada del wiki – Sintaxi

DokuWiki accepta negreta, cursiva, subratllat i monospaced texts. Per descomptat, podeu utilitzar-les totes alhora.

DokuWiki accepta **negreta**, //cursiva//, __subratllat__ i ''monospaced'' texts.
Per descomptat, podeu **__//''utilitzar-les totes alhora''//__**.

També podeu utilitzar _subíndex i ^superíndex

També podeu utilitzar <sub>subíndex</sub> i <sup>superíndex</sup>

Podeu tatxar una paraula.

Podeu <del>tatxar</del> una paraula.

El paràgrafs s'han de crear des de línies en blanc. Si voleu forçar una nova línia sense fer un nou paràgraf, podeu utilitzar dues antibarres seguides per un espai en blanc o un final de línia.

Aquest és un text amb trencament de línia
Fixeu-vos que les dues antibarres solament funcionen bé al final d'una línia
o seguides d'un
espai en blanc \\això és el que passa sense ells.

Aquest és un text amb trencament de línia\\ Fixeu-vos que les dues 
antibarres solament funcionen bé al final d'una línia\\
o seguides d'un\\ espai en blanc \\això és el que passa sense ells.

Hauríeu d'utilitzar el forçat de línia només quan sigui realment necessari.

Amb el DokuWiki hi ha moltes maneres de crear enllaços.

Els enllaços externs són reconeguts automàticament: http://www.google.com o simplement www.google.com. També podeu anomenar els enllaços: Aquest Link porta a google. Les adreces electròniques com aquesta: maria@rubi.org també són reconegudes.

Els enllaços externs són reconeguts automàticament: http://www.google.com o 
simplement www.google.com. També podeu anomenar els enllaços:
[[http://www.google.com|Aquest Link porta a google]]. Les adreces de Email com 
aquesta: <maria@rubi.org>  també són reconegudes.

Els enllaços interns es creen amb els parèntesis quadrats. Podeu simplement donar un wiki:pagename (nom de pàgina) o bé utilitzar un Títol. Els noms de pàgina wiki es converteixen de forma automàtica a lletra minúscula. Els caràcters especials (accents, ç…) no estan permesos.

Els enllaços interns es creen amb els parèntesi quadrats. Podeu simplement donar un 
[[doku>wiki:pagename]] (nom de pàgina)o bé utilitzar un 
[[doku>wiki:pagename|Títol]]. Els noms de pàgina wiki es converteixen de forma
automàtica a lletra minúscula. **Els caràcters especials (accents, ç...) no estan permesos**.

Podeu utilitzar noms d'espais (namespaces) fent servir els dos punts al nom de pàgina.

Podeu utilitzar noms d'espais (namespaces) fent servir els dos punts abans del nom de 
pàgina.

Si voleu més detalls sobre els noms d'espais, aneu aquí.

Enllaçar a una secció específica és també possible. Simplement, afegiu aquest símbol # darrere del nom de la secció, tal i com es fa amb l'HTML. Així es fa: Anar a la secció

Així es fa: [[syntax#internal|Anar a la secció]]

Notes:

• Els enllaços a pàgines existents es mostren de manera diferent als enllaços a les com_crear_una_pagina_nova.
• El DokuWiki, d'entrada, no entén que les lletres majúscules entre paraula indiquen dues paraules diferents DuesParaules i no reconeix aquestes construccions per tal de crear enllaços de forma automàtica. Ara bé, si voleu, es pot fer que les reconegui a través del fitxer wiki:config. Una manera fàcil de saber si teniu o no aquesta opció activada és comprovar si la paraula DokuWiki és un enllaç. Si ho és, ja ho teniu activat.
• Quan el títol d'una secció canvia, el seu marcador canvia també. Per tant, no us refieu d'enllaçar molt amb les seccions, perquè podria passar que aquests enllaços no funcionessin.

DokuWiki reconeix els enllaços Interwiki. Aquests són enllaços ràpids a altres wikis. Per exemple, aquest és un enllaç a la pàgina de Wikipedia (l'enciclopèdia d'internet) sobre els Wikis: Wiki.

DokuWiki reconeix els enllaços [[doku>wiki:interwiki|Interwiki]]. Aquests són enllaços       
ràpids a altres Wikis. Per exemple, aquest és un enllaç a la pàgina de Wikipedia
(l'enciclopèdia d'internet) sobre els Wikis: [[wp>Wiki]].

Es pot compartir finestres així. Si us plau, tingueu en compte que això només té sentit en un grup homogeni d'usuaris, com una Intranet corporativa.

Es pot compartir finestres [[\\server\share|així]].

Notes:

• Per raons de seguretat, la possibilitat de compartir finestres de forma directa només està activada per defecte amb el Microsoft Internet Explorer, i solament a la “zona local”.
• Al Mozilla i Firefox, pot activar-se a través de l'opció de configuració security.checkloaduri, però no s'aconsella.
• Vegeu 151 permís informació.

També podeu utilitzar una imatge per fer un enllaç a una altra pàgina interna o externa, combinant la sintaxi per enllaços i imatges (vegeu avall) així:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Si us plau, tingueu en compte que el format d'imatge és la única sintaxi de format acceptada en els noms d'enllaç.

La sintaxi completa d'imatges i enllaços és acceptada (incloent l'acció de canviar la mida original de la imatge, imatges internes o externes, i enllaços URLs o interwiki)

Podeu afegir notes a peu de pàgina ¹⁾ utilitzant el doble parèntesi.

Podeu afegir notes a peu de pàgina ((això és una nota a peu de pàgina)) utilitzant el  
doble parèntesi.

Podeu utilitzar diferents nivells de titulars per estructurar els vostres continguts. Si teniu més de tres titulars, una taula de continguts es genera de forma automàtica – -aquesta opció es pot desactivar incloent la seqüència ~~NOTOC~~ al document.

==== Nivell de titular 3 ====
=== Nivell de titular 4 ===
== Nivell de titular 5 ==

Utilitzant quatre o més guions "-", podeu generar una línia horitzontal:

Podeu incloure imatges externes i internes amb els caràcters "{ }". Vegeu wiki:images per a més informació. De forma opcional, podeu especificar la mida de les imatges.

Mida real:

Redimensionada a una determinada amplada:

Redimensionada a una determinada amplada i alçada:

Imatge externa redimensionada:

Mida real:                        {{wiki:dokuwiki-128.png}}
Redimensionada a una determinada amplada::            {{wiki:dokuwiki-128.png?50}}
Redimensionada a una determinada amplada i alçada:: {{wiki:dokuwiki-128.png?200x50}}
Imatge externa redimensionada:            {{https://secure.php.net/images/php.gif?200x50}}

Utilitzant espais en blanc a dreta o esquerra, podeu escollir l'alineament.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Per descomptat, podeu afegir un títol (que apareix quan poseu el cursor damunt de la imatge a la majoria de navegadors).

{{ wiki:dokuwiki-128.png |Títol de la imatge}}

Si especifiqueu un nom d'arxiu (extern o intern) que no és una imatge (gif, jpeg, png) apareixerà com un enllaç.

Per enllaçar una imatge a una altra pàgina, vegeu els Enllaços mitjançant imatges més amunt

Dokuwiki accepta llistes ordenades i desordenades. Per crear un element de la llista, poseu un asterisc "*" més dos espais, per fer llistes desordenades, i un guió normal "-" més dos espais per llistes ordenades

• Això és una llista
• El segon element
  • Podeu fer diferents nivells *
• Un altre element

1. La mateixa llista, però ordenada
2. Un altre element
   1. Utilitzeu el sagnat per fer subnivells
3. Aquí ho teniu

  * Això és una llista
  * El segon element
    * Podeu fer diferents nivells
  * Un altre element

  - La mateixa llista, però ordenada
  - Un altre element
    - Utilitzeu la sangria per fer subnivells
  - Aquí ho teniu

DokuWiki converteix els codis de les emoticones en els seus equivalents gràfics.

Tot seguit us oferim l'assortiment d'emoticones introduïdes a DokuWiki.

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• ARREGLA'M
• ESBORRA'M

DokuWiki pot convertir els caràcters de text simples en les seves entitats tipogràfiques correctes. Aquí teniu un exemple dels caràcters reconeguts.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640x480 © ™ ® “Pensava ‘És un home de món’…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
“Pensava ‘És un home de món’...” 

Si us plau, tingueu en compte que aquestes conversions poden desactivar-se a través d'una opció de configuració, config option, i un fitxer plantilla pattern filefitxer plantilla.

Algunes vegades us pot interessar marcar algun text com a una resposta o comentari. Podeu utilitzar la sintaxi següent:

Crec que podríem de fer-ho

> No, no ho hem de fer

>> Bé, he dit que “podríem”

> De veritat?

>> Sí!

>>> Llavors, fem-ho

Crec que podríem de fer-ho

No, no ho hem de fer

Bé, he dit que “podríem”

De veritat?

Sí!

Llavors, fem-ho

DokuWiki està dotat d'una sintaxi simple per a la creació de taules.

Les files normals de la taula han de començar i acabar amb | o ^ pels títols.

^ Títol 1         ^ Títol 2             ^ Títol  3              ^
| Fila 1 Col 1    | Fila 1 Col 2        | Fila 1 Col 3          |
| Fila 2 Col 1    | Columnes combinades (doble barra vertical) ||
| Fila 3 Col 1    | Fila 2 Col 2        | Fila 2 Col 3          |

Per combinar cel·les horitzontalment, simplement deixeu la cel·la següent completament buida, com es mostra aquí amunt. Assegureu-vos de tenir sempre la mateixa quantitat de separadors de cel·les

En aquesta versió s'ha afegit l'opció de combinar cel·les verticalment

Simplement afegiu el signe de dos punts ":" tres vegades a les cel·les que no s'han de dibuixar

^ Títol 1        ^ Títol 2                              ^ Títol 3       ^
| Fila 1 Col 1    | Files combinades (triple dos punts) | Fila 1 Col 3  |
| Fila 2 Col 1    | :::                                 | Fila 2 Col 3  |
| Fila 3 Col 1    | :::                                 | Fila 2 Col 3  |

Els títols en les files també són possibles.

Com podeu veure, és el separador de cel·la que va davant de la cel·la el que decideix el format.

|              ^ Títol 1            ^ Títol 2          ^
^ Títol 3    | Fila 1 Col 2          | Fila 1 Col 3        |
^ Títol 4    | Aquesta vegada, no combinem les cel·les |                    |
^ Títol 5    | Fila 2 Col 2          | Fila 2 Col 3        |

Nota: Els textos en vertical no són possibles.

També podeu alinear els continguts de la taula. Simplement, afegiu almenys dos espais en blanc abans o després del text. Afegiu dos espais a l'esquerra per alinear a la dreta, dos espais a la dreta per alinear a l'esquerra o almenys dos espais abans i després del text per tal de centrar-lo.

Així es com queda en codi font:

^           Taula alineada           ^^^
|         dreta|    centre    |esquerra          |
|esquerra          |         dreta|    centre    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Podeu incloure blocs sense format en els vostres documents de dues maneres diferents: fent precedir els textos per, almenys, dos espais o utilitzant les etiquetes "code" o "file".

Aquest és un exemple on tots els espais es respecten: com              <-això

"file" és bàsicament el mateix.

Per fer que l'analitzador ignori completament una àrea determinada i la deixi sense format, deixeu-la sense cap etiquetat wiki o, encara més simple, precediu-la i poseu al final dos signes de percentatge %%.

Exemple: Aquest text conté un enllaç a: http://www.splitbrain.org i **negreta**, però l'enllaç no funciona i no surt la negreta

Vegeu el codi font d'aquesta pàgina per aprendre a utilitzar aquests blocs.

DokuWiki DokuWiki pot ressaltar el codi font, per tal de fer-ne més fàcil la lectura. Utilitza el GeSHi (Ressaltador Genèric de la Sintaxi), per tant, qualsevol llenguatge que accepti GeSHi és acceptat. La sintaxi és la mateixa que al bloc de codi que hem vist a la secció prèvia, però aquesta vegada, el nom del llenguatge que voldrem utilitzar l'hem d'inserir dintre d'aquesta etiqueta. Exemple: <code java>

/** 
 * La HolaMónApp class implementa una aplicació que
 * simplement mostra "Hola Món!" a la sortida estàndard.
 */
class HolaMónApp {
    public static void main(String[] args) {
        System.out.println("Hola Món!"); //Mostra la seqüència.
    }
}

Són reconegudes les seqüències de llenguatge següents : actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml

Podeu incrustar codi HTML o PHP als vostres documents, utilitzant "htm"l o "php" tags com aquests:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

This is some HTML

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

Nota important: La possibilitat d'incloure HTML i PHP està per defecte desactivada a la configuració. Si és així, el codi es mostra en comptes de ser executat.

Només cal afegir a la pàgina d'edició

~~DISCUSSION~~

i, després, der clic a la pastilla 'Desa'.

La sintaxi del DokuWiki pot ser ampliada mitjançant Plugins. Com s'utilitzen els connectors instal·lats s'explica a les seves corresponents pàgines descriptives.