====== Ajuda avançada del wiki – Sintaxi ====== Aquí trobareu la sintaxi que podeu utilitzar quan editeu les pàgines. Per comprendre el funcionament del Wiki us recomanem que llegiu el [[04_ajuda_wiki:breu|Breu manual d’edició del wiki]]. Si voleu fer proves, teniu a la vostra disposició el [[playground:playground|pati]]. També es pot accedir fàcilment als marcadors més simples mitjançant les [[wiki:editor:inici|tecles d'accés ràpid]]. ===== Format de text bàsic ===== 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índex i superíndex Podeu tatxar una paraula. Podeu tatxar 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. ===== Enllaços ===== Amb el DokuWiki hi ha moltes maneres de crear enllaços. ==== Externs ==== 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 electròniques com aquesta: 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: també són reconegudes. ==== Interns ==== Els enllaços interns es creen amb els parèntesis 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**. 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 [[wiki:miniguia:pagines_i_namespaces#diferencies_entre_pagines_i_espais_de_nom_namespaces|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 [[wiki:miniguia:pagines_i_namespaces#diferencies_entre_pagines_i_espais_de_nom_namespaces|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: [[syntax#internal|Anar a la secció]] Així es fa: [[syntax#internal|Anar a la secció]] Notes: * Els enllaços a [[wiki:syntax|pàgines existents]] es mostren de manera diferent als enllaços a les [[wiki:miniguia:operacions_basiques#com_crear_una_pagina_nova]]. * El DokuWiki, d'entrada, no entén que les lletres majúscules entre paraula indiquen dues paraules diferents [[wp>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 [[doku>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. ==== Interwiki ==== 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]]. 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]]. ==== Compartir finestres ==== Es pot compartir finestres [[\\server\share|així]]. Si us plau, tingueu en compte que això només té sentit en un grup homogeni d'usuaris, com una [[wp>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ó [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], però no s'aconsella. * Vegeu [[bug>151]] permís informació. ==== Enllaços mitjançant imatges ==== També podeu utilitzar una imatge per fer un enllaç a una altra pàgina interna o externa, combinant la sintaxi per enllaços i [[#images_and_other_files|imatges]] (vegeu avall) així: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[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'[[#images_and_other_files|imatges]] i [[#links|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) ===== Notes a peu de pàgina ===== Podeu afegir notes a peu de pàgina ((això és una nota 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. ===== Fer seccions ===== 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 == ==== Nivell de titular 3 ==== === Nivell de titular 4 === == Nivell de titular 5 == Utilitzant quatre o més guions "-", podeu generar una línia horitzontal: ---- ===== Imatges i altres fitxers ===== Podeu incloure imatges externes i internes amb els caràcters "{ }". Vegeu [[doku>wiki:images]] per a més informació. De forma opcional, podeu especificar la mida de les imatges. 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}} 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 }} {{ 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}} {{ 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 ===== Llistes ===== 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 - La mateixa llista, però ordenada - Un altre element - Utilitzeu el sagnat per fer subnivells - 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 ===== Emoticones ===== DokuWiki converteix els codis de les [[wp>emoticon]]es en els seus equivalents gràfics. Tot seguit us oferim l'assortiment d'emoticones introduïdes a DokuWiki. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% ARREGLA'M %% * DELETEME %% ESBORRA'M %% ===== Tipografia ===== 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 (c) (tm) (r) “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ó, [[doku>wiki:config#typography|config option]], i un fitxer plantilla [[doku>wiki:entities|pattern file]]fitxer plantilla. ===== Diàleg / Comentaris ===== 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 ===== Taules ===== DokuWiki està dotat d'una sintaxi simple per a la creació de taules. ^ 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 | 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** ^ 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 | 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. | ^ 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 | 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. ^ Taula alineada ^^^ | dreta| centre |esquerra | |esquerra | dreta| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Així es com queda en codi font: ^ Taula alineada ^^^ | dreta| centre |esquerra | |esquerra | dreta| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | ===== Blocs sense format ===== 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. ===== Senyalar la sintaxi ===== [[DokuWiki]] DokuWiki pot ressaltar el codi font, per tal de fer-ne més fàcil la lectura. Utilitza el [[http://qbnz.com/highlighter/|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: '''' /** * 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// ===== Incrustar HTML i PHP ===== Podeu incrustar codi HTML o PHP als vostres documents, utilitzant "htm"l o "php" tags com aquests: This is some HTML This is some HTML echo 'A logo generated by PHP:'; echo 'PHP Logo !'; echo 'A logo generated by PHP:'; echo '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. ===== Introducció d'un fòrum de discussió ===== Només cal afegir a la pàgina d'edició ~~DISCUSSION~~ i, després, der clic a la pastilla **'Desa'**. ===== Connectors per a la sintaxi ===== La sintaxi del DokuWiki pot ser ampliada mitjançant [[doku>wiki:plugins|Plugins]]. Com s'utilitzen els connectors instal·lats s'explica a les seves corresponents pàgines descriptives.