Primers passos amb la wiki: Difference between revisions
| (33 intermediate revisions by 2 users not shown) | |||
| Line 3: | Line 3: | ||
=Abans de res= | =Abans de res= | ||
En primer lloc crea el teu compte en la part superior dreta d'aquesta pantalla. | 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= | =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ç. | |||
[[File:Page not exist .jpg]] | |||
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: | |||
[[File:Wysiwyg.jpg|none]] | |||
==Afegint text== | ==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=== | ===Encapçalaments=== | ||
Per a distribuir la informació en la pàgina utilitza els encapçalaments. 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 = =. | 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 1 → =Títol= | ||
* Encapçalament 2 → ==Títol== | * Encapçalament 2 → ==Títol== | ||
| Line 36: | Line 45: | ||
* Encapçalament 4 → ====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. | 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. | ||
| Line 48: | Line 59: | ||
* Encapçalament 1 → Punts 1, 2, 3 i 4 | * Encapçalament 1 → Punts 1, 2, 3 i 4 | ||
* Encapçalament 2 → Punts 3.1, 3.2 i 3.3 | * Encapçalament 2 → Punts 3.1, 3.2 i 3.3 | ||
* Encapçalament 3 → Punts 3.3.1, 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. | |||
[[File:Urlsss.jpg|none]] | |||
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 [[Special:AllPages|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 | |||
==Afegint imatges== | |||
=Enllaçant la teva pàgina= | =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ó "[[Primers_passos_amb_la_wiki#Afegint_enllaços|Afegint un enllaços]]". | |||
= Coses de la infrastructura tecnica = | |||
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 | |||
També cal fer | |||
php maintenance/update.php | |||
Mès info → https://www.mediawiki.org/wiki/Manual:Upgrading | |||
Latest revision as of 19:43, 8 February 2024
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
Afegint imatges
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 la infrastructura tecnica
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
També cal fer
php maintenance/update.php
