¶ La wiki d'Eixams
Aquesta és la nostra Wiki d'Eixams, just a la pàgina a la que estàs ara. La gestionem amb Wiki.js, una eina de codi obert que ens permet crear, editar i organitzar contingut de manera col·laborativa i estructurada. És el nostre repositori central de coneixement, on documentem tots els processos, eines i aprenentatges de l'organització. Tot i que tothom pot accedir i consultar informació (no a totes les seccions), són les persones de l'organització qui poden crear i mantenir el seu contingut.
¶ Bones pràctiques pel manteniment
Per mantenir la wiki neta i útil, seguim aquestes pautes:
- Estructura jeràrquica: Seguiu l'estructura definida a la pàgina inicial per ubicar els nous documents. No creeu seccions noves sense consens.
- Enllaça internament: Sempre que feu referència a un altre procés, eina o concepte que estigui documentat a la wiki, enllaceu la pàgina corresponent.
- Revisa el que publiques: La wiki és una font de veritat. Abans de publicar, assegureu-vos que la informació és correcta, actual i clara.
- Manteniment continu: Dediqueu una estona de tant en tant a revisar, actualitzar i netejar pàgines obsoletes per tal que la informació no perdi vigència.
Quan editem una pàgina ho farem amb el nostre compte personal, mai amb el compte d'administració. El compte d'administració sols serà necessari per crear i administrar usuaris i permisos.
¶ Edició de la wiki
La wiki s'organitza mitjançant arxius de text interconnectats. Cada pàgina té associada una ruta (per exemple, /inici), que és la part de la URL que permet accedir-hi des del navegador.
Per crear una pàgina nova i fer-la visible al web, has de seguir aquests tres passos:
- Crear la pàgina.
- Assignar-li una ruta – escull un nom únic i descriptiu per a la URL que tindrà aquesta pàgina (per exemple,
/projectes). - Enllaçar-la amb una altra pàgina – perquè els usuaris puguin trobar-la, has de crear un enllaç des d'una pàgina existent.
¶ Creació i edició d'una pàgina nova
Un cop estem dins la wiki podem crear una pàgina o editar l'actual. Al menú de dalt tenim diferents opcions, aquesta ens permetrà crear una nova pàgina:
Si volguéssim fer altra acció, com ara editar, esborrar i demès, sobre la pàgina actual, sempre tindrem aquest menú a sota a la dreta:
Un cop fem clic a nova pàgina, la wiki ens demanarà on la volem. Aquest pas és important, ja que marcarà la ruta d'accés des del navegador i el lloc on es desarà aquesta pàgina.
És aconsellable que mantinguem la wiki endreçada i respectem la mateixa organització marcada per la pàgina d'índex.
El sistema està configurat per a que si el nom d'una pàgina conté “privat” o “privada” aquesta no serà visible per visitants que no tinguin accés a la wiki amb password.
Ara bé quan ens pregunta quin tipus d'editor volem. Si no coneixes els demès tipus, agafa aquest, que és un editor a-lo-Word i amb el que ens basarem durant aquest article:
I ara, per acabar, sols ens quedar donar una mica d'informació per indicar a la persona visitant l'objectiu d'aquesta pàgina (principalment títol i descripció, tot i que encara podrem canviar la ruta on desar-la):
Per fi se'ns obrirà un entorn que ens pot resultar familiar! Aquí l'important és aquest menú des del qual podrem crear ja d'una vegada la pàgina (1), veure les propietats de la pàgina, és a dir, el mateix que em mostrat a l'última captura (2) o tancar l'editor.
¶ Editor de la pàgina
Aquí tenim el menú del editor amb les opcions que són més importants (o més críptiques) marcades:
- Per donar-li estructura al document.
- Dos botons per enllaçar: el primer una altra pàgina de la wiki, el segon una web externa.
- Per inserir una imatge.
¶ Inserir una imatge
Per poder inserir una imatge primer haurem de pujar-la al servidor. Per fer això ens hem de col·locar en la ruta on vulguem desar-la (1), afegirem la carpeta per la secció on vulguem tenir-la (2) i utilitzarem l'eina per pujar arxius (3).
Després sols haurem de fer clic al botó d'inserir, que és al panell (1).
És bona pràctica mantenir el mateix nom de carpeta que d'article o pàgina, per no tenir totes les imatges en un mateix lloc i després saber quines imatges pertanyen a quines pàgines.
¶ Enllaçar la pàgina
Un cop desem la pàgina aquesta romandrà a la wiki, i es podrà accedir mitjançant la URL https://wiki.eixams.cat + ruta assignada, però per a que una persona visitant pugui trobar-la, el que hem de fer és enllaçar-la des d'una altra. La millor opció és fer-ho des de la pàgina de l'arrel, la primera. Així que naveguem fins a ella i li donem a editar.
Anem al text on volem crear l'enllaç, el seleccionem i li donem al botó d'enllaçar una pàgina de la wiki (2, esquerra):
I ara sols hem de dir quina pàgina volem seleccionar:
¶ Edició de permisos i usuaris
Els permisos es donen des del compte d'administració. Les credencials d'aquest compte son a l'eina de passwords. Per entrar a l'administració anirem al seu botó corresponent:
Un cop a l'administració podrem accedir a les seccions d'usuaris i grups. Accedirem a usuaris per administrar aquests:
I accedirem als grups per administrar els permisos dels usuaris. Els grups actuals son tres:
- Guests: Tothom que no hagi fet log-in.
- Administrators: Aquells que poden administrar la wiki (aconsellem fer servir únicament un).
- Editors: Aquells usuaris per persones que poden editar i canviar el contingut de la wiki.
És a partir d'aquests grups que indiquem al sistema si un usuari pot o no accedir a una secció.
Actualment hem indicat que els usuaris convidats (grup Guests) no poden accedir a les pàgines privades. Per fer això hem indicat que tenen bloquejat el permís per pàgines amb una ruta que contingui les paraules privat o privada.
⚠️ Recorda que per impedir l'accés al públic a unes pàgines sols has d'afegir “privat” o “privada” al seu nom.