======Índex======
====== Ajuda per treballar amb documents WIKI d'alumnes ======
Els documents de l'alumne són documents WIKI associats a un alumne en concret. Són generats a partir d'un model o plantilla i posteriorment es poden modificar. Per crear/modificar un model cal crear/modificar una pàgina wiki dins de l'apartat "models" del DokuWiki.
Els camps següents poden ser inclosos dins de la plantilla. En el moment de generar un document per un cert alumne aquests camps es convertiran en la informació concreta de l'alumne corresponent.
Els documents WIKI d'un alumne en concret es gestionen còmodament (afegir, visualitzar, editar i eliminar) quan visualitzeu l'alumne des de la Llibreta d'alumnes.
^Camp ^ Es substitueix per ^
|[ab.fn] | Nom complet |
|[ab.n_family] | Cognom |
|[ab.n_given] | Nom de pila |
|[ab.n_middle] | Segon nom |
|[ab.n_prefix] | Prefix |
|[ab.n_suffix] | Sufix |
|[ab.bday] | Aniversari |
|[ab.note] | Notes |
|[ab.tz] | Zona horària |
|[ab.url] | URL |
|[ab.pubkey] | Observacions |
|[ab.org_name] | CIP Alumne |
|[ab.org_unit] | Nom mare |
|[ab.title] | Nom pare |
|[ab.adr_one_street] | Carrer mare |
|[ab.adr_one_locality] | Ciutat mare |
|[ab.adr_one_region] | Província mare |
|[ab.adr_one_postalcode] | Codi postal mare |
|[ab.adr_one_countryname] | País mare |
|[ab.adr_two_street] | Carrer pare |
|[ab.adr_two_locality] | Ciutat pare |
|[ab.adr_two_region] | Província pare |
|[ab.adr_two_postalcode] | Codi postal pare |
|[ab.adr_two_countryname] | País pare |
|[ab.tel_work] | Números de telèfon / Telèfon mare 1 |
|[ab.tel_home] | Números de telèfon / Telèfon pare 1 |
|[ab.tel_cell] | Números de telèfon / Telèfon pare 2 |
|[ab.tel_fax] | Números de telèfon / Fax |
|[ab.email] | Correu electrònic mare |
|[ab.email_home] | Correu electrònic pare |
====== Introducció al Dokuwiki ======
Els termes wiki i wikiwiki s'utilitzen per identificar un tipus de documents d'hipertext (documents amb vincles o enllaços) i el programari col·laboratiu que s'utilitza per crear-los.
Crearem un document wiki des d'un navegador web ja que el programa necessari per crear-los és també una pàgina web. En un mateix lloc web poden haver diferents wikis integrats amb les nostres aplicacions preferides (gestor de continguts, fòrums, e-learning, ...) o independents.
La utilització d'un wiki és flexible i dinàmica, però alhora pot ser anarquista. Les wikis han revolucionat el món web ja que són els propis usuaris qui creen els continguts i tants continguts com faci falta.
El límit de número de pàgines en un wiki no existeix. Es poden crear tantes com siguin necessàries. Els continguts d'aquestes pàgines poden ser modificats pels propis autors o per altres (modificar per tal d'afegir o eliminar informació).
Es guarden còpies de tots els canvis efectuats a aquestes pàgines: sempre es pot recuperar una versió anterior de l'actual.
===== Com funciona =====
El wiki que comentarem és el [[http://www.splitbrain.org/projects/dokuwiki|Dokuwiki]], amb llicència lliure GNU/GPL. Existeixen altres wikis similars fetes amb programari lliure, però el funcionament de totes elles és molt semblant.
Quan entrem a un wiki veurem la pàgina principal. Aquesta generalment conté un índex de tot el seu contingut. Aquest índex ajuda al navegant a que visiti les altres pàgines. Sense aquests índexs la navegació web mitjançant vincles seria molt feixuga.
Tot i així, Dokuwiki permet uns altres dos sistemes per cercar la informació:
* mitjançant el cercador del wiki
* mitjançant l'Índex del Dokuwiki (és un índex creat a partir dels noms de les pàgines).
===== Com editar =====
Per canviar un contingut ens situem en aquella pàgina que volem modificar/editar. Si tenim permisos d'escriptura ens apareixerà el botó **Modifica aquesta pàgina**. Ens apareixerà un petit editor i tres botons: **Desa**, **Previsualitzar** i **Cancel·la**
Es recomanable que abans de desar sempre fem una previsualització de com quedarà el contingut i, si aquest és correcte, el desem.
Per donar format al contingut s'utilitza una sintaxis un xic especial, molt utilitzada en els wikis. S'utilitzen marques (tags) especials per anar més ràpid en el moment d'escriure. Per exemple:
Exemple:
**Negreta**: Els dos asteriscs ens permeten marcar un text en negreta.
En el mode d'edició d'una pàgina ens apareix un enllaç on podem consultar la sintaxis del wiki (recomanable obrir l'enllaç en una nova pestanya). Aquesta sintaxis es pot ampliar i/o modificar ja que aquesta pàgina forma part del mateix sistema wiki.
[[wiki:syntax | Sintaxis del wiki]] en versió espanyola
===== Com crear noves pàgines =====
Les pàgines wiki es guarden classificades en directoris o carpetes. Dins de cada directori hi col·loquem fitxers de text, cadascun d'ells correspon a una pàgina wiki. Els noms dels directoris i dels fitxers han de contenir caràcters alfanumèrics. Eviteu espais, vocals accentuades, ç, ñ i altres caràcters no anglesos. Caràcters de l'**a** a la **z** i del **0** al **9**
Per poder crear pàgines hem de saber a on les crearem. Per exemple, crearem les actes de les reunions mitjançant un wiki.
El nom del fitxer d'una acta podria ser: reunio20060519
Si us hi fixeu, la data s'ha escrit en format anglès i no s'ha accentuat l'"o" de reunió. El motiu de la data en anglès és perquè, quan tingui moltes actes, se'm ordenin automàticament per la data:
reunio20060717
reunio20060623
reunio20060519
Com veieu amb aquest exemple de fitxers amb un nom que conté la data, és recomanable que el nom del fitxer que es crea contingui la màxima informació.
Per exemple, és millor el nom resultats_enquesta_socis_segon_trimestre_2006 que no pas enquesta2006.
Ja tenim el nom del fitxer però, a on ho deixem? Es aconsellable decidir prèviament com organitzar-nos, creant els directoris pertinents.
**reunions** podria ser el nom del directori. **reunions:reunio20060519** seria la ruta (inclou el/s directori/s i el nom del fitxer).
El wiki crearia el directori reunions i, a dins d'ell, trobaríem totes les reunions.
Per tant, els vincles serien:
reunions:reunio20060717
reunions:reunio20060623
reunions:reunio20060519
Podem fer-ho de dos maneres: escrivint directament la URL o creant vincles en altres pàgines.
==== Escrivint directament la URL ====
En el nostre navegador introduiríem directament la URL que inclogui la ruta desitjada.
Per exemple, en la wiki de secretaria (a on estem ara), si volem crear la pàgina **reunio20060717** que està dins del directori **reunions** i el directori **reunions** està dins dels directori **wiki**:
http://domini/secretaria/dokuwiki/doku.php?id=wiki:reunions:reunio20060717
I si volem crear un nou model anomenat **vacunes** a utilitzar per cadascun dels estudiants el guardarem dins del directori **models**:
http://domini/secretaria/dokuwiki/doku.php?id=models:vacunes
==== Fent links en les pàgines ====
Quan creem o editem una pàgina podem crear links externs o interns al wiki.
Per fer els links interns, la sintaxis a usar és:
[[nompagina | Títol de la pàgina]]
Fixa't que a l'esquerra hi ha el nom de la ruta a on es troba fitxer (directori/s i fitxer) i a la dreta el nom visual que es mostrarà, separats per la barra vertical.
Per tant, podríem fer:
[[wiki:reunions:reunio20060717| Reunió 17 juliol 2006]]
====== Models ======
Els models els trobareu:
http://domini/secretaria/dokuwiki/doku.php?idx=models
Creat per Zikzakmedia. Podeu consulta documentació addicional [[http://www.zikmy.com/index.ph?option=com_jd-wiki&Itemid=37|aquí]].