===== Manual d'estil de la wiki bytes.cat =====

Pots introduir-te a [[https://www.dokuwiki.org/wiki:syntax|la sintaxi de Dokuwiki aquí]].

També tens aquí una [[https://www.dokuwiki.org/cheatsheet|xuleta ràpida de Dokuwiki]].

Bytes.cat té 2 objectius primordials:

  * **Publicar** continguts col·laboratius
  * **Compartir** continguts personals

Aquest manual només cobreix la part de PUBLICACIÓ, que la implementem mitjançant una wiki (Dokuwiki per votació al canal de Telegram “Portal per compartir”).


==== Barra lateral ====
La barra lateral o //sidebar// de bytes.cat té un cercador de totes les pàgines de la wiki indexades amb les etiquetes abans descrites. Quan creeu un nou article no cal que l'inclogueu enlloc ni cal fer cap link des de la barra lateral, simplement etiqueteu-lo correctament amb el cicle, mòdul professional i unitat formativa.


==== Etiquetatge de les pàgines ====
El sistema de categorització està inspirat en el descrit en [[https://profesinformatica.github.io/FpInfor/|aquest projecte d'etiquetatge i indexació de pàgines]] de professors d'FP d'informàtica:
  https://profesinformatica.github.io/FpInfor/
  
Utilitzarem, doncs, la mateixa nomenclatura de tags: #Smx #DawMp01 #AsixMp08Uf2 ...


=== Etiquetage Dokuwiki ===
Per etiquetar un article adequadament cal incloure una primera línia (o a qualsevol lloc del document, però preferentment prop de l'inici) amb el control TAG:
  {{tag> tag1 tag2 tag3 ... }}
Un exemple més concret:
  {{tag> apache webserver servidorweb www web http https serveis #FpInfor #Daw #DawMp08 #DawMp08Uf01 #Asix #AsixMp08 #AsixMp08Uf02 #Smx #SmxMp07 #SmxMp07Uf03 }}
Noteu que:
  * Hi ha **etiquetes lliures** com //apache//, //webserver//, //www//, etc. dels temes que cregueu oportuns.
  * Hi ha **etiquetes amb #** i que ens permeten etiquetar segons la **nomenclatura del projecte #FpInfor** descrita més amunt, per cerca a motors genèrics com Google.
  * Convé etiquetar independentment el cicle (#Daw), el mòdul professional (#DawMp08) i les unitats formatives (#DawMp08Uf1, #DawMp08Uf01) pertinents perquè aparegui aquesta pàgina indexada en tots els cercadors de la barra lateral.


==== Normes generals ====
  * Tothom pot crear articles.
  * Tothom pot editar articles. Si algú no està d’acord, es parla i es desfà el canvi.

...fins aquí és el comportament estàndard d’una wiki…

  * El **nom dels articles de pràctiques** han de ser descriptius del contingut i exactes. Per exemple, no convé fer un article “Apache” sinó “Administració d’Apache2 sobre Debian” o “Instal·lació i configuració de ISC DNS sobre Ubuntu”
  * Els **articles de teoria** poden contenir noms més genèrics com “Servidor web”, “Correu electrònic” o “Arquitectura del backbone de la Internet”.
  * Per classificar per MPs i UFs ho farem mitjançant categories, ja que s’actualitzen quan creem un article i l’afegim a la categoria.
  * Es requeriran voluntàries per mantenir els continguts de cada MP, una coordinadora que vetlli per matenir aquest manual d’estil.