La plataforma Labdoo permet als usuaris crear les seves pròpies pàgines wiki. Per fer-ho, l’usuari haurà de tenir el rol de «redactor de wikis» («wiki writer»). Si no teniu assignat aquest rol i voleu escriure pàgines wiki, envieu un correu electrònic a contact@labdoo.org. (Podeu comprovar el rols assignats al vostre usuari anant a «El meu compte» i, a continuació, clicant a la pestanya «Els meus rols»)
La plataforma Labdoo es basa en el concepte de pàgines wiki per permetre als usuaris compartir coneixements i bones pràctiques. A continuació, es mostren algunes de les situacions més freqüents en què voldreu crear una pàgina wiki:
Per crear una pàgina wiki, seguiu aquests passos:
La secció del contingut (body) d'una pàgina wiki permet als escriptors utilitzar una forma simplificada d'etiquetes HTML per ajudar-los a formatar el seu contingut. Tot i que la pàgina «Consells per redactar» (es proporciona un enllaç a aquesta pàgina a la part inferior del camp «body» de cada formulari wiki) ofereix una descripció detallada de les etiquetes HTML compatibles amb el sistema wiki de Labdoo, en aquesta secció us proporcionem informació addicional per algunes de les etiquetes una mica més avançades.
Inserció d'imatges
Tal com s'explica a «Consells per redactar», podeu inserir una imatge amb l'etiqueta <img>. Per exemple, l'etiqueta següent:
<img src="/profiles/labdoo/files/pictures/laptop.png" width="50"/>
genera aquesta imatge:
Per penjar la imatge, seguiu aquests passos:
Figura. Mitjançant la interfície de gestió de fitxers, podeu penjar imatges i fitxers. Si esteu afegint imatges per la wiki, assegureu-vos de penjar el vostre contingut a la carpeta «content». Dins de la carpeta «content», també es recomana crear més carpetes per ajudar-vos a organitzar les imatges i els fitxers, i reutilitzar les carpetes existents si el contingut pertany a la mateixa categoria. |
Format de figures a la vostra pàgina wiki
Si voleu inserir una imatge al text, seguiu aquest format:
Aquí en teniu un exemple:
<hr/>
<table align="center">
<tr><td>
<em> Figura. Aquest és el logotip de Labdoo.</em>
</td></tr>
<tr><td>
<img src="/profiles/labdoo/files/pictures/laptop.png" width="50"/>
</td></tr>
</table>
<hr/>
que es mostra de la següent manera:
Figura. Aquest és el logotip de Labdoo. |
Inserció de vídeos
Podeu inserir vídeos amb aquesta senzilla etiqueta:
Per exemple:
[video:https://www.youtube-nocookie.com/watch?v=Gpo-7GjFydw]
Per obtenir una bona descripció sobre com inserir vídeos, consulteu directament la secció «Video Filter» de la pàgina Consells de redacció.
Si heu de crear un enllaç a una pàgina que es troba dins de www.labdoo.org (per exemple, un enllaç a una altra pàgina wiki), és important utilitzar camins relatius que comencin per la cadena ../
. Per exemple, si voleu crear un enllaç a aquesta pàgina wiki, seguiu aquest exemple:
<a href="../content/crear-enllaços-interns">Un exemple d'enllaç a aquesta pàgina wiki</a>
Què genera aquest enllaç:
Un exemple d'enllaç a aquesta pàgina wiki
L'ús de la cadena ../
davant dels enllaços interns té dos objectius:
L’objectiu de Labdoo és trencar barreres perquè l’educació pugui arribar a totes les regions del món. Una clau per superar aquestes barreres és la capacitat d’escriure documents no només en un idioma, sinó en el màxim possible. Amb aquest objectiu, el sistema wiki de Labdoo proporciona algunes funcions senzilles que faciliten la traducció dels documents wiki a qualsevol idioma. Si trobeu una pàgina wiki o un llibre rellevant que no estigui disponible en el vostre idioma, us animem a iniciar una traducció pel vostre compte.
Aquests són els passos per traduir una pàgina o llibre de la wiki:
És important no posar com a disponible una pàgina wiki fins que el seu text no hagi estat revisat i no se n'hagin corregit els errors tipogràfics i gramaticals. Això és per garantir que tot el contingut compleixi un nivell mínim de qualitat.
Per aconseguir-ho, cada pàgina de la wiki té una etiqueta a la part superior anomenada «Publish/Unpublish» («Publica/Anul·la'n la publicació») (aquesta característica només està disponible per als usuaris que tinguin activat el rol de «wiki writer») que el redactor pot utilitzar per controlar si els lectors poden veure aquesta pàgina o no. Utilitzeu aquesta funció per controlar quan la vostra pàgina està llesta per ser publicada. Tingueu en compte també que només els usuaris amb el rol de «wiki writer» podran veure pàgines no publicades, per a la resta d'usuaris aquestes pàgines no es podran ni veure ni podran cercar-les.
Com que la wiki està dissenyada per ser una eina de col·laboració, sovint hem de donar permís a altres usuaris perquè puguin editar les pàgines wiki. Hi ha dues maneres de donar aquest permís:
Figura. Per concedir a un usuari el dret d'editar una pàgina wiki en concret, cliqueu a la pestanya «Edita» d'aquesta pàgina wiki i afegiu-lo al camp «Grant edit rights». D'aquesta manera, l’usuari podrà editar aquesta pàgina wiki i totes les pàgines wiki que en deriven. |
El sistema wiki de Labdoo proporciona un control de revisions a cadascuna de les pàgines wiki. Cada vegada que un usuari modifica una pàgina wiki, es fa un seguiment dels canvis. Això permet, per exemple, recuperar els canvis introduïts per error o veure quan es van introduir certs canvis.
Per utilitzar aquesta funció, cliqueu a la pestanya «Revisions» que trobareu a la part superior de cada pàgina wiki. (Aquesta funció només està disponible per als usuaris que tinguin activat el rol de «redactor de wikis»).
Cada pàgina wiki té a la part inferior un enllaç anomenat «Versió per imprimir» que els lectors poden utilitzar per generar una versió per imprimir d'aquesta pàgina. (Per provar-ho, cliqueu al mateix enllaç que trobareu a la part inferior d'aquesta pàgina.) Per imprimir el llibre complet en lloc d'una sola pàgina, aneu a la primera pàgina del llibre i cliqueu-ne l'enllaç «Versió per imprimir». Això us portarà a una pàgina que conté tot el llibre.
Aquesta funció també es pot utilitzar per baixar el llibre en format PDF. Per a fer-ho, quan imprimiu el llibre amb l'opció d'impressió del vostre navegador, seleccioneu l'opció «Desar-lo com a PDF». (Aquesta opció dependrà del navegador que utilitzeu.)
Per descarregar una wiki de manera que s'hi pugui accedir sense connexió, podeu utilitzar eines a la vostra disposició de manera lliure que us permetran descarregar un lloc web al vostre dispositiu. Una eina que sembla agradar a la gent per descarregar la wiki de Labdoo és HTTrack, que està disponible de manera gratuïta (sota GPL, llicència de programari lliure) a http://www.httrack.com/.
Aquest tipus d’eines són molt útils, per exemple, quan voleu incloure un determinat llibre wiki en un ordinador portàtil que porteu a una escola que pot tenir un accés limitat a Internet. Si teniu cap pregunta sobre com utilitzar aquestes eines, podeu fer-la al mur de l'equip Quality Assurance.
Manual de HTTrack (resum) https://www.httrack.com/html/index.html
Com utilitzar HTTrack https://www.httrack.com/html/shelldoc.html (principiants)
Manual de HTTrack https://www.httrack.com/html/fcguide.html (experts)
L'equip de Labdoo ha recopilat i preparat aquestes wikis sense connexió que us poden resultar útils:
https://www.labdoo.org/ca/wiki-index
https://wiki.lxde.org/en/Main_Page
https://wiki.ubuntu.com/
https://help.ubuntu.com/
Aquestes wikis es van actualitzant i es poden descarregar del nostre servidor FTP http://ftp.labdoo.org/download/Public/.
Tot i que hi ha força flexibilitat a l’hora d’escriure els vostres propis llibres wiki, és important seguir certes regles de bones pràctiques per garantir que el contingut de la plataforma Labdoo sigui de bona qualitat. Com a redactor de wikis, seguiu aquestes recomanacions:
<em>escriu el text aquí</em>
. Si l’etiqueta no inclou cap contingut (com ara l’etiqueta de línia nova <br>
o l’etiqueta de línia horitzontal <hr>
), teniu dues opcions : podeu utilitzar <br></br>
(sense cap contingut entre les etiquetes) o la versió més compacta <br/>
. Aquesta bona pràctica és especialment important perquè el sistema de Labdoo crea còpies de seguretat automàtiques de tot el contingut de la wiki. Per a fer-ho s'han d'analitzar totes les pàgines de la wiki i, si les etiquetes no estan configurades correctament, aquest procés d’anàlisi es pot trencar.
L'estructura general del sistema wiki de Labdoo és similar a la d'altres sistemes wiki estàndards (com la Viquipèdia) i, per tant, és d'estil lliure. Això vol dir que no cal tenir molta sincronització sobre quins tipus de documents es creen. Si creieu que un determinat article o document pertany al sistema wiki de Labdoo, podeu crear-lo. La wiki és un sistema obert i el vostre treball serà revisat per altres labdooers, de manera que si el nou document no és adequat segons els temes d'interès de la plataforma Labdoo, se us donaran instruccions sobre com editar-ne el contingut. Com en qualsevol sistema wiki obert, el contingut inadequat es pot eliminar en qualsevol moment per garantir que la wiki compleixi certs estàndards de qualitat i rellevància.
A més del principi general d’estil lliure, la wiki té algunes categories de documents que es consideren essencials en la plataforma Labdoo i estàndard per a tots els idiomes disponibles. Quan s’escriu un document nou, primer s’ha de tenir en compte si la nova pàgina pertany a una d’aquestes categories i estructurar-ne el document en conseqüència, assegurant-se que no hi hagi cap superposició i que el text segueixi una experiència de lectura fluida conforme al document original. Aquí teniu la llista de documents/categories essencials:
El principi general per afegir contingut al sistema wiki és: si el tema de la nova pàgina wiki pertany a alguna de les categories essencials anteriors, considereu afegir la nova pàgina com a part del document en qüestió; en cas contrari, podeu crear un nou llibre wiki.
Els llibres wiki tenen diverses pàgines wiki, sent cada pàgina un apartat del llibre. Quan creeu o gestioneu un llibre wiki, és probable que hàgiu de canviar l’ordre en què es presenten cadascun d’aquests apartats. Per exemple, si teniu un llibre format per tres pàgines wiki anomenades «Introducció», «Passos inicials» i «Passos avançats», és lògic que vulgueu ordenar aquests apartats al llibre presentant primer la «Introducció», després els «Passos inicials» i, finalment, els «Passos avançats».
Per reordenar l'ordre de les pàgines d'un llibre wiki, feu el següent:
Figura. A la pàgina de reordenació d’un llibre, cliqueu a la icona de la creu situada a l’esquerra de cada element i arrossegueu-la cap amunt o cap avall per situar-lo a la ubicació correcta. També podeu utilitzar els pesos numèrics de les pàgines per reordenar-ne el contingut. |
El sistema de wikis de Labdoo té un mòdul per detectar enllaços trencats. Aquest mòdul s’executa automàticament en segon pla de tant en tant, examinant les pàgines wiki de Labdoo i comprovant si hi ha enllaços trencats, de manera que no haureu de fer-ho manualment. Això significa que utilitzar aquesta funció és molt fàcil, tal com es descriu a continuació.
Per veure la llista d'enllaços trencats que es troben a les pàgines wiki que heu escrit, aneu a «El meu compte» a l'extrem superior dret de qualsevol pàgina de Labdoo i seleccioneu l'opció «Els meus links trencats». (Tingueu en compte que només veureu aquesta opció si esteu connectat/da al vostre compte i si teniu els drets de redactor de wikis). Això us portarà a una pàgina del vostre compte amb tots els enllaços trencats que s'han detectat a les pàgines wiki que heu escrit. Per a cada enllaç trencat que vegeu en aquesta llista, cliqueu on diu «Edit node $NÚMERO». Això us portarà a aquest node (en mode d'edició) on podreu corregir directament l'enllaç trencat. Si sou un redactor de wikis, de tant en tant assegureu-vos d'anar a aquesta pàgina i assegureu-vos que no teniu enllaços trencats.
També hi ha una manera de veure tots els enllaços trencats (no només els ubicats a les pàgines wiki que escriviu, sinó tots els enllaços trencats de totes les pàgines wiki) en una llista centralitzada. Per veure aquesta llista, aneu al menú «Wiki» a la part superior de qualsevol pàgina de Labdoo i seleccioneu l'opció «Tots els links trencats». (Una vegada més, només si teniu drets de redactor de wikis veureu aquesta opció.) En clicar sobre aquesta opció, anireu a una pàgina que recopila la llista completa d'enllaços trencats de totes les pàgines de la wiki.
Sobre els codis d'error d'enllaços trencats . Cada enllaç trencat inclou el seu propi codi d'error (vegeu la següent figura per obtenir-ne alguns exemples). Els enllaços trencats més importants són els marcats amb el codi d'error 404, que significa que l'enllaç no existeix («Pàgina no trobada»). Corregiu tots els enllaços trencats amb el codi d'error 404. És possible que no calgui corregir altres codis d'error. Per exemple, el codi d'error 301 significa «la pàgina s'ha mogut permanentment a un URL nou», però l'enllaç en sí és correcte, de manera que no cal corregir cap enllaç amb l'error 301.
Com s'examinen les pàgines. Els enllaços trencats es troben examinant pàgines. Això es fa de dues maneres diferents: (1) quan es desa una pàgina, el comprovador d'enllaços proporcionarà un avís si algun dels enllaços es trenca, de manera que pugueu solucionar-lo immediatament; (2) cada hora (a la part superior de l'hora), hi ha un procés de fons que també comprova si hi ha enllaços trencats. Tingueu en compte també que quan corregiu un enllaç, la seva entrada s'eliminarà immediatament de la llista d'enllaços trencats.
Figura. Cliqueu a «Els meus enllaços trencats» per accedir a la llista d'enllaços trencats que es troben a les pàgines wiki. |