Primers passos amb la wiki

Aquesta és una petita guia d'introducció a l'edició d'aquesta wiki.

Abans de res

En primer lloc crea el teu compte en la part superior dreta d'aquesta pantalla. Si trobes algun problema posa't en contacte amb l'ÀG de comunicació i documentació.

Una vegada aprobat el teu compte logejat i visita algunes pàgines.

Obre aquesta mateixa (que té imatges, enllaços i seccions) fes clic en "edit", en la part superior de la pantalla, tan sols per a veure com està escrita. No et preocupis. No pots trencar res que no es pugui reposar al seu lloc. Deixa-la oberta en una pestanya a part i continua al següent pas d'aquesta guia.

Creant una pàgina

Les pàgines es creen directament escrivint el títol que vulguem per a la pàgina en el caixetí de les urls del nostre navegador a continuació d'aquesta url https://wiki.calafou.org/index.php/

És a dir, si volem crear una pàgina per a la fantàstica Ripley, hem d'escriure https://wiki.calafou.org/index.php/Ripley.

En el cas que la pàgina no existeixi en la wiki, rebràs un missatge com el de la imatge, indicant-te'l i convidant-te a crear-la fent clic en un enllaç.

Afegeix una mica de contingut (un Hola món pot valer ara com ara) i salva. La teva pàgina hauria d'estar en línia.

Afegint contingut a la teva pàgina

Aquesta wiki fa servir un llenguatge anomenat markdown que té la seva pròpia sintaxi.

També disposa d'un editor senzill com el que hauràs emprat amb Wordpress, Bloguer, LibreOffice etc... Així que no t'espantis. Aquesta és la part superior de l'editor quan editem aquesa mateixa pàgina:

Afegint text

Com dèiem més amunt, pots escriure de manera regular amb les icones de qualsevol editor de text realitzant les funcions que estàs acostumada a utilitzar: inserir enllaç, inserir imatge, negreta, headings (encapçalaments).

Encapçalaments

Per a distribuir la informació en la pàgina utilitza els encapçalaments. Pots fer servir el caixetí que diu "Heading" i seleccionar la grandària (1 mes gran 4 més petit) o escriure el títol de la secció directament en markdown i aventurar-te en un llenguatge molt emprat al llarg de la internet.

En markdown els encapçalaments es generen envoltant al text amb el símbol = sent el més gran el que porta menys símbols comprenent-ho. Són els coneguts en HTML com headings. En comptes d'envoltar el títol entre les etiquetes h1, h2, h3... s'envolta el títol amb = =.

• Encapçalament 1 → =Títol=
• Encapçalament 2 → ==Títol==
• Encapçalament 3 → ===Títol===
• Encapçalament 4 → ====Títol====

Al principi tendim a no utilitzar els encapçalaments (i fer servir massa negrita) però són fonamentals per a una bona distribució de la informació i condició necessària per al següent punt d'aquesta guia.

La taula de continguts

Els encapçalaments són necessaris si vols que la teva pàgina mostri una taula de continguts com la que es mostra en la part superior d'aquesta pàgina. La taula es genera automàticament si empres encapçalaments jerarquitzats.

Fixa't com estan distribuïts els continguts en la part superior i al llarg de la pàgina

Comença utilitzant el heading 1 (=Títol=) per a les seccions i veu emprant els altres per a crear els subapartats de cada secció. No tinguis por. Totes les modificacions a les pàgines són recuperables amb un clic en l'històric de la pàgina en la part superior.

En aquesta pàgina s'utilitzen els següents encapçalaments per a distribuir la informació:

• Encapçalament 1 → Punts 1, 2, 3 i 4
• Encapçalament 2 → Punts 3.1, 3.2 i 3.3
• Encapçalament 3 → Punts 3.1.1, 3.1.2, 3.1.3 i 3.1.4

Afegint enllaços

Per a afegir un enllaç només necessites pegar la url en el cos del text i tota la direcció serà clickable. Exemple aquesta mateixa pàgina:

https://wiki.calafou.org/index.php/Primers_passos_amb_la_wiki

Per afegir enllaços a pàgines externes o enllaços a pàgines internes d'aquesta wiki fes servir l'editor enriquit. Fes clic sobre la cadenita grisa. S'obrirà un quadre de diàleg.

En el caixetí superior pots buscar el nom de pàgines internes. En començar a escriure un títol, el quadre de diàleg et suggereix les pàgines que comencen igual. És fàcil trobar les pàgines si recordes com comença el seu títol. Si no, sempre pots buscar-les en aquesta pàgina.

El caixetí superior també és el lloc en el qual afegir l'enllaç a una url externa a la wiki com la teva pàgina o la pàgina oficial d'Àlien.

En el caixetí inferior escriu el text que vols que sigui clickable

Enllaçant la teva pàgina

Una vegada que hagis creat la teva pàgina has de fer-la visible, sigui en la Portada o en alguna pàgina ja creada i relacionada amb el teu tema.

Si l'afegeixes a la portada fes-ho en la secció que li correspon.

El procés és el mateix de la secció "Afegint un enllaços".

Coses de l'infrastructura tècnica

Mediawiki està dins d'un contenidor LXC. Quan actualitzem de debian 9 > 10 > 11, cal fer modificacions en systemd service launch perquè apache2 i mariadb s'apaguin :

• https://forum.proxmox.com/threads/apache2-service-failed-to-set-up-mount-namespacing-permission-denied.56871/
• https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=920643#20

Si y tambien en 10.2024, hay que hacer para que functiona dentro del contenidor LXC :

• https://stackoverflow.com/questions/65040703/apache2-failed-to-set-up-mount-namespacing-permission-denied
• https://stackoverflow.com/questions/59952398/mariadb-service-failed-to-set-up-mount-namespacing-permission-denied-failed

També cal fer

 php maintenance/update.php

Mès info → https://www.mediawiki.org/wiki/Manual:Upgrading

Per borrar usaries o contingut en cas de SPAM

Hay que ser en el group sysop y nuke, para hacer esto :

 root@wiki:/var/www/mediawiki# php maintenance/createAndPromote.php user 'password' --sysop --custom-groups nuke --force

Veure aqui https://www.mediawiki.org/wiki/Manual:CreateAndPromote.php

Després es pot fer serveir el plugin Nuke, i s'ha d'anar aqui https://wiki.calafou.org/index.php/Special:Nuke