Ajuda per a escriure les pàgines en format Wiki

Les pàgines en format Wiki proporcionen la possibilitat de marcar el text amb una formatació intuïtiva, fàcilment llegible, que es transformarà en XHTML quan es visualitze. Els principals avantatges són que no necessiteu aprendre HTML per a obtindre resultats bastant complexos i que el text que escriviu tindrà bon aspecte, fins i tot abans de transformar-lo. És una alternativa real a guardar documents Word com a pàgines web alhora que manté la possibilitat d'editar el recurs en línia.

Heu d'escriure bàsicament només text. Hi ha alguns caràcters especials que podeu inserir per tal d'afegir format.

Formatació a nivell de bloc

Els blocs de paràgraf se separen per una línia en blanc com a mínim. Per a afegir formatació especial a un paràgraf afegiu un dels caràcters especials següents, més un espai en blanc, al començament de la primera línia del bloc:

Caràcter Tipus de bloc
Sense caràcter Paràgraf ordinari
> Citació
Espai Text preformatat (Monoespaiat)
% Preformatat i el format Wiki s'ignora
!# Encapçalament - on # és 1-6, el nivell d'encapçalament (1 el més gran)
Q. Pregunta - s'afegix informació d'estil al paràgraf per a millorar la presentació tipus pregunta/resposta (dins del tema).
A. Resposta - com l'anterior però resposta.

Formatació de llistes

Podem construir fàcilment llistes senzilles escrivint un caràcter especial al principi de cada línia de la llista seguit d'un espai en blanc. El final de la llista el marca una línia en blanc. Es poden imbricar llistes dins de llistes i les llistes imbricades poden ser d'un tipus diferent. Es poden barrejar lliurement llistes de text i de definició per a aconseguir l'efecte desitjat. Els caràcters especials són els següents:

Caràcter Tipus de llista
* Llista no numerada (pics)
# Llista numerada (1,2,3, etc.)
: Llista de definicions, definició
; Llista de definicions, text

Exemple de llistes imbricades

  * Primer pic
  * Segon pic
  ## línia 1 de llista imbricada
  ## línia 2 de llista imbricada
  * Tercer pic

I este és el resultat:

Formatació dins del text

La formatació dins del text permet marcar part d'una línia amb un estil particular. Els caràcters especials emprats poden aparéixer en qualsevol punt de la línia, però observeu que la formatació no pot ultrapassar la línia i continuar a la següent. Els codis són:

Exemple Exemple Format
*hola tothom* hola tothom Negreta
/hola tothom/hola tothom Èmfasi o cursiva
+hola tothom+hola tothom Text inserit
-hola tothom-hola tothom Text suprimit o barrat
hola ~tothom~hola tothom Subíndex
hola ^tothom^hola tothom Superíndex
"hola tothom"hola tothom Citació
%hola tothom%hola tothom Codi o Monoespaiat
@hola tothom@hola tothom Referència

Acrònims

L'etiquetatge d'acrònims s'aconseguix posant l'acrònim en lletres majúscules seguit de la descripció entre parèntesis. No ha d'haver-hi cap espai entre l'acrònim i el parèntesi. Per exemple:

HTML(Hypertext Markup Language)
HTML

Enllaços

Es poden col·locar enllaços dins del text tot escrivint l'URL seguit del text que es mostrarà entre parèntesis (sense cap espai entre l'URL i el parèntesi). Exemple: http://www.google.com/(Busca ara) es convertirà en Busca ara.

Enllaços a mòduls del Moodle

Si sabeu el número id d'un mòdul del Moodle (busqueu ?id=nn al final de l'adreça d'un mòdul) i el nom del mòdul, podeu enllaçar directament el recurs fent servir esta sintaxi:

ModuleName:nn(Text descriptiu)

Per exemple, resource:36(La pàgina nova); forum:10(Vés al fòrum)

Enllaços a imatges del Moodle

Es poden inserir gràfics dins d'una línia d'una pàgina Wiki. Cal que pengeu el gràfic al servidor i que anoteu el seu camí dins de l'àrea de fitxers penjats. La sintaxi és:

/..camí del fitxer..(text alternatiu)

Per exemple: /imatges/grafic.jpg(Foto de l'equip)

Enllaços a fitxers del Moodle

Igual que els enllaços a imatges, esta característica habilita enllaços en pàgines wiki a fitxers prèviament penjats. La sintaxi és:

file:..camí del fitxer(text de l'enllaç)

Per exemple: file:/pdfs/moodle.pdf(Informació sobre el Moodle)

Reformatació automàtica

Moltes funcions habitualment utilitzades es convertixen automàticament en els seus equivalents XHTML. Les principals són les següents:

Correcció ortogràfica (experimental)

El formatador wiki es pot posar en mode de correcció ortogràfica. Inseriu esta línia en un text i es comprovarà l'ortografia de tot el text que vaja a continuació:

!SPELL:language_code:language_variant

Exemples:
!SPELL:en:british
!SPELL:sp

Canvieu "language_code" pel codi d'idioma apropiat (p. e. qcv, ca, es, etc.). "language_variant" (després de dos punts) és opcional i servix per a indicar una varietat regional.

Quan es visualitze el text, els mots desconeguts es ressaltaràn i podreu veure els suggeriments alternatius posant el cursor damunt de cada mot.

NOTA: la correcció ortogràfica utilitza les biblioteques pspell. Estes i els diccionaris han d'estar instal·lats al servidor per tal que funcione el corrector ortogràfic. En Windows no es pot usar este programari.