Guia de comesfa.org

En aquesta secció hi trobareu tant la guia de com treballar amb comesfa.org des del punt de vista d'usuari com també la manera d'aportar-hi continguts i, finalment, el seu funcionament d'administració. Veure la guia completa.

De fet, com a secció, és un exemple de com fer un llibre col·laboratiu des del lloc web. Un llibre col·laboratiu és una informació organitzada en pàgines que ens pot servir tant per la creació de guies de Com es fa? com també per a les de Preguntes més freqüents. Com que tots els continguts aportats es poden anar organitzant en pàgines, tot plegat resulta com si anéssim construint un gran manual, el resultat del qual és la secció.

Qui som?

ComEsFa.org és un grup de voluntaris que ens hem aplegat al voltant d'aquest projecte.
Els membres que ara mateix hi ha "actius" són:

• Dani Armengol i Garreta, parap (at) pinchito.com
• Carles Noguera i Balasch, Carles.Noguera (at) ComEsFa.org
• Ramon Roca i Tió, ramon.roca (at) elserrat.com
• Sergi Sant, sergi.sant (at) gmail.com
• Josep Ysern, josepyl66 (at) yahoo.es
També hi han aportacions de més gent. Tothom està convidat a participar de forma activa. Ho podeu fer enregistrant-vos a la web i apuntant-vos a la llista.

Objectius de comesfa.org

Aquesta web s'adreça a tots els àmbits propis dels entorns *IX en general, especialment a l'àmbit de programari lliure.
Els objectius perseguits són:

• Divulgació i la gestió del coneixement. A través de mecanismes de gestió de la informació.
• Fomentar la contribució i projectes de programari lliure
Tot això seguint un model participatiu, col·laboratiu i descentralitzat. Ningú coneix de tot, i a la vegada, tots coneixem alguna cosa. Es tracta de crear un espai comú on tothom hi pugui aportar, i per extensió, compartir allò que coneix i la vegada un recurs on aprendre allò que no sabem. Si cliques aquí veuràs una relació de les coses que ens pots aportar. 

• Què volem fer?

  1. Orientat a la divulgació i la gestió del coneixement.

     Dins de les àrees que es cobreixen en aquesta web (bàsicament, programari lliure), divulgar i facilitar-ne l'ús a tothom.
     Amb aquesta finalitat, la funció principal és la d'organitzar informació i proporcionar mecanismes que la facin accessible, de la forma més universal i eficaç que ens sigui possible.
     Hi ha ja molta informació disponible a la xarxa sobre aquests àmbits. Ens volem diferenciar respecte de les que van més orientades a l'actualitat, grups d'usuaris o bitàcoles personals, en intentar fer una recopilació i ordenació de coneixement, ja sigui propi o extern.

  2. Foment de la contribució a projectes de programari lliure

     La contribució al programari lliure és sempre una iniciativa voluntària i individual. De combinar aquestes iniciatives en un espai a l'abast de tothom prové la força, i el profit esdevé com a resultat de donar-se a conèixer.

• Com ho volem fer?

  Creant un entorn col·laboratiu on ens ajudem uns als altres. Tothom està convidat a participar-hi. Per tal de facilitar-ho, es procurarà guiar a qui vulgui acompanyar-nos. El valor d'aquesta web està en els seus continguts aportats potser individualment, però agregats i ordenats en un conjunt global: com més gent s'animi a aportar-ne, millor per a tothom. Encara no t'has enregistrat a la web?.

  1. Coneixement

     Per a guiar-los en l'ús d'aquesta web, s'ha redactat la secció de guia per als internautes.
     Els usuaris més familiaritzats amb la web podran administrar les aportacions classificant-les. És un treball en equip i en funció dels membres disposats a assumir aquestes funcions ens anirem coordinant en seccions i compartint les idees i els criteris d'organització.
     Amb aquesta finalitat s'ha redactat el document gestió dels continguts. Aquest mecanisme fa que la web estigui sempre permanentment "en construcció".
     Finalment, obrim fòrums als que tothom hi és convidat per poder plantejar preguntes i a la vegada, qui en conegui les respostes pugui respondre-les.

  2. Projectes

     En funció de la naturalesa del projecte, procurarem orientar i hostatjar aquestes iniciatives a fi d'intentar recolzar aquest procés.

Flux de les aportacions

Les aportacions a la web segueixen aquest camí:

1. Publicar aportacions. Tan aviat una aportació és enviada, apareixerà publicada a la web, s'indexarà en el cercador i quedarà disponible segons el que es descriu en aquest fluxe.
2. Revisió de documents aportats. Les aportacions recentment publicades, queden a disposició de la resta d'usuaris enregistrats perquè el revisin i en puguin expresar la seva opinió. Això es farà per votació, de manera que en aquesta fase es pot promocionar el document a la pàgina d'entrada de la web o demanar que es retorni a l'autor per a la seva revisió.
3. Classificació del document dins d'una secció. Els coordinadors de les seccions, podràn recollir les aportacions dins del llibre que estiguin construint per a la seva secció afegint així un enllaç entre la resta de continguts. Mentre el document no estigui encara recollit en cap secció en concret, o no n'hi hagi cap de prou estructurada per al tipus de contingut de la que es tracta, continuarà estant publicat en el llibre de documents pendents de classificar


Independentment d'aquest flux, un cop incorporats ja els documents, els podrem modificar, ja sigui per corregir-ne faltes, millorar-los o actualitzar la informació.

Els rols que descriuen les funcions estàn recollits en el document que descriu els usuaris.

Guia per als internautes

Aquesta part de la guia està dirigida a explicar com donar els primers passos a la web, accedir als continguts.

També explica com enregistrar-se i començar a fer les primeres aportacions i enregistrar-se.

Un cop estiguis familiaritzat amb aquesta part, et convidem a participar més activament amb qualsevol altre dels [rols d'usuari deins de la web|rols d'usuari dins de la web], d'aquesta manera ens pots ajudar també a organitzar-ne els continguts.

Començar a fer servir aquesta web

Breument, per a començar a bellugar-te per aquesta web...:

• Navegar: Comença per explorar els continguts.
• Enregistrar-me: Llegeix l'apartat de crear un usuari.
• Fer aportacions: T'agrairem les teves aportacions. A posar continguts a la web trovaràs les primeres pautes per fer-ho.

La navegació són aquells instruments que es posen a disposició dels usuaris per permetre la localització de forma intuitiva dels documents que puguiin ser del seu interès. La vocació d'aquesta web és la d'ordenar els continguts de manera que independentment dels coneixements tècnics dels internautes, es pugui oferir i facilitar l'accés als continguts a tothom.



Enregistrar-se és important. Aquest és un projecte sense ànim de lucre en sí mateix, el caliu i la viavilitat de tot plegat la hi dona un esperit participatiu i la compartició en comú del coneixement. Compartir tant els dubtes, les vostres opinions, i les vostres aportacions entre tots és en definitiva el valor real dels continguts i la forma efectiva de divulgar l'àmbit sobre el que treballem. Aquest és en definitiva l'objectiu principal del projecte. Depèn per tant, clarament, de la participació de tothom.

Explorar els continguts de comesfa.org

Es procura que explorar els continguts de la web sigui tan senzill com sigui possible: A la portada o "pàgina d'entrada" hi haurà informació variable, probablement d'interès general, com ara novetats a destacar, darreres aportacions, etc.

En aquesta web, però, els documents que s'aporten no "s'enfonsen" en el temps, sinò que queden classificats en categories i seccions. La idea és anar creant una agregació de coneixement de forma cumulativa, i es proporciona uns mecanismes de navegació dins de cadascuna d'aquestes àrees que són els que es descriuen a continuació.

Vosaltres mateixos podeu decidir, un cop enregistrats, quins són els continguts a destacar a la portada des de la opció revisió de documents aportats. Trovareu més informació del funcionament de la pàgina d'entrada clicant aqui.

A partir d'aquí, per trovar ja les coses dins del lloc web, tens els següents instruments:




Explicació

1. Les pestanyes. Són les caixetes que apareixen a dalt sota el logo de Comesfa.org. A diferència de la pàgina d'entrada, si navegueu clicant per les categories que us presenten les pestanyes, us proporcionarà el conjunt de documents que hi estan relacionats agrupats per diferents criteris. S'ordenen de més recent a més antic.
   Proporcionen doncs una visió personalitzada dels continguts segons la teva àrea d'interès.
2. Controls de ordenació i filtres. En les pàgines on es presenten resums dels articles (pàgina d'entrada, navegació per pestanyes i pàgines de cadascuna de les categories) es proporcionen uns controls que permeten canviar l'ordre de presentació (segons antiguitat, darrers canvis, nombre de visites des de sempra i des dels darrers dies). També permet filtrar segons diferents criteris de classificació, com ara tipus de document ( pregunta, com es fa, article...), nivell d'experiència (iniciació, mig, avançat...) i plataforma del sistema operatiu. També ens permet escollir el format en el que volem que ens presenti els documents, per omisió ens presenta el resum, si en volem llistar més quantitat, podem llistar només el títol. També podem obtenir els articles complerts.
   En resum es tracta d'uns controls que permeten acavar de personalitzar la selecció i proporcionar mecanismes d'accés als continguts segons diferents criteris.
3. El "Mapa de la web". En una pàgina t'informa de totes les seccions de la web. Les seccions són àrees de contingut més o menys ja estructurades al càrrec de colaboradors que s'en fan càrrec. Per obtenir un llistat de les seccions també podeu anar aqui.
4. El "explorador (versió dinàmica)", "explorador (versió html)". Et permetrà navegar dins de l'arbre de categories.
5. El "cercador" convencional. Posant les paraules del teu interés, localitzarà els continguts dins del lloc web fent servir paraules.
6. El "cercador" per categories. A part de cercar també per paraules, podreu "creuar" més criteris alhora de fer la recerca fent servir una o vàries categories de forma combinada.

Exemples pràctics

• Fent servir les pestanyes.Si teniu un perfil tecnològic i cerqueu informació relacionada amb el sistema operatiu i voleu cercar quina informació tenim allotjada, probablement us interessarà aproximar-vos des de la pestanya de "Gestió del Sistema".
  En canvi, si sou un professional de la educació, és probable que us interessi més la selecció de continguts que obtindreu clicant a la pestanya de "Aplicació funcional" i segurament, dins d'aquesta, en la segona línia, la pestanya "Educació".
• Fent servir el cercador combinat amb categories Si sou un usuari novell des del punt de vista tecnològic, i us moveu en un àmbit professional, us pot resultar interessant, per exemple, obtenir un llistat dels continguts filtrant per Nivell->Iniciació, Area Funcional->Empresa.

Crear un usuari a comesfa.org

Crear un nou usuari a comesfa.org és ben senzill. La inscripció és gratuita i lliure.

Això et permetrà d'aportar-hi continguts i fer comentaris. Comesfa.org vol ser interactiu i els seus continguts són vius i han de ser permanentment actualitzats. D'aquesta manera ens hi ajudaràs.

Per crear l'usuari només cal clicar en l'enllaç "Crear nou perfil" des de la capsa d'identificació que trovaràs en l'enllaç "identificar-se".


Tot seguit, omplena el formulari que rebràs. L'adreça de correu només es farà servir de forma confidencial i limitada a la operativa d'aquest lloc web.

La resta d'informació (Ciutat, ID de missatgers instantanis, etc, proporciona-la si tens interès i cap inconvenient en fer-la pública a la resta d'usuaris de comesfa.org.

Un cop conformis la informació que hi hagis posat, rebràs un correu electrònic automàtic donant la benvinguda i amb les credencials d'identificació. Això ens permet de validar que la adreça de correu és vàlida.

Podràs canviar la contrasenya automàticament generada per una que t'en recordis millor seguint les instruccions que hauràs rebiut en el correu, o simplement anant a la opció "editar perfil" que t'apareixerà en la capsa del teu menú d'usuari des de qualsevol part del lloc web.

Rols d'usuari dins de la web

Per als usuaris novells tenim els següents rols:

• Internauta anònim: A qui es dirigeixen els continguts. A través dels mecanismes de [explorar els continguts] i li procurarem un guar-lo perquè tingui el màxim de facilitat per a localizar aquella informació que li resulti del seu interès. Podrà comentar els continguts i així advertir-nos de la seva utilitat, si creu que ha quedat desactualitzat, afegir consells... Per aportar continguts caldrà que s'enregistri ja que els continguts requereixen d'un autor o bé escriure un correu a la llista de correu de comesfa.org.
• Usuari enregistrat (autentificat):
  És el més important. Qualsevol usuari que en coneixem la identitat pot aportar continguts per a la web. També tindrà a la possibilitat de fer servir la web per a mantenir el seu bitàcola (blog o weblog) personal. L'enregistrament és lliure, les instruccions de com fer-ho les són a crear un usuari a comesfa.org.

Per als usuaris més "rodats", que ja coneixen una mica els mecanismes de funcionament de la web i volen anar més enllà de les aportacions com ara encarregar-se de lassificar continguts dins de les seccions, administrar la web, corregir documents, etc, tenim els següents rols:


• Contribuidor:
  Serveix per encarregar-se de un conjunt de seccions o categories dins del lloc web. Amb aquest perfil es poden incorporar directament continguts, i alhora, gestionar els continguts ja aportats. Disposa també de la capacitat d'incorporar nous termes a les taxonomies del lloc web.
  
  La funció d'aquest rol és la de ordenat els documents aportats classificant-los dins de la web amb els diferents mètodes que proporciona i sobre les seccions en les que l'usuari colabora. Cal que estigui per tant familiaritzat amb la seva estructura i que es coordini amb els companys amb qui comparteix secció.
  

• Corrector:
  Revisa de tant en tant els continguts, i si veu que en fem alguna de grossa mirarà d'arreglar-ho (si és que té solució clar )...
  
• Administrador:
  Administració de la estructura del lloc web. Presentació, eina de gestió de continguts, etc.



Els rols no s'han d'interpretar com una jerarquia, sinò simplement com un mecanisme de funcionament per tenir operativitat. Si féssim una jerarquia per importància, l'usuari novell o que s'acava d'identificar és el més important perquè en sí mateixos són l'objectiu d'aquesta web.

Per classificar els continguts o administrar cal un coneixement sobre les eines que fem servir, encara que sigui per vetllar per la bona organització i evolució de la web, i és només en aquest sentit que justifica la creació d'aquests rols, no pas per donar més valor a unes opinions sobre les altres.




Per promocionar a algun d'aquests rols, només ho has de demanar. Les idees i ganes d'aportar són sempre benvingudes i l'unic que es demana és criteri propi combinat amb capacitat de coordinació en equip.

En resum:

Disfrutar aportant.

Posar continguts a la web de comesfa.org

TOTHOM pot aportar lliurement continguts a aquesta web i hi està expressament convidat.

Els continguts a comesfa.org els podreu posar sempre des de l'enllaç aportar continguts que trobareu en el vostre menú un cop estigueu identificats des d'un usuari.

Si no tens usuari, i vols fer les teves aportacions, pots fer-ho enviant-les per correu o bé demanant un usuari (el pots sol·licitar directament des de [Crear un usuari]).

L'explicació dels tipus de documents la trobaras en l'enllaç aportar continguts

Tot seguit us apareixerà un formulari que us permetrà d'introduir-hi el contingut.

El criteri per emplenar els camps és bastant autoexplicatiu (almenys així ho intentem). Si et cal, però, pots trobar ajuda en criteris per emplenar els camps.

Ampliar o corregir informació i posar comentaris a pàgines existents

És possible que mentre llegiu un article, trobeu alguna incorrecció o tingueu
més informació sobre el tema tractat.
Si és així, podeu aportar-hi els vostres comentaris, correccions o informacions en el formulari que trobareu a peu de pàgina o
a través de l'enllaç de afegir comentari que hi ha també
a peu de l'article.


Us animem a fer servir aquests mecanismes. Ens ajudarà a mantenir al dia
els continguts de la web.

Si a més creieu que podeu aportar una nova versió de l'article,
enregistreu-vos a la web i feu-ho des
d'aportar documents.

Les pàgines de la web que així ho permeten, tenen a sota un enllaç per a
comentar el contingut de la pàgina.



Tothom està convidat a comentar aquests continguts fent aclariments, puntualitzant,
ampliant la informació aportada, expressar una opinió sobre el contingut, etc.

Un cop el comentari ha estat aportat, la resta d'usuaris enregistrats tindran opció a
valorar-lo (Interessant, convé convertir-lo el comentari en pàgina de la web,
irrellevant, fora de context, no hi hauria de ser...).


Amb aquesta moderació, els comentaris aniran adquirint una "puntuació" de manera que
resultarà senzill, a través de la opció de visualitzar comentaris, destacar les
aportacions interessants de la resta. Sigui quina sigui la puntuació que rebi, el
comentari mai s'esborra (a no ser que hi hagués algun motiu important que ho
justifiqui).



L'objectiu en sí mateix és permetre als contribuïdors veure la valoració que
en fa la resta d'usuaris sobre els continguts, i d'aquesta manera, millorar-los.


Si us interessa aprofundir en quins son els mecanismes interns del funcionament
dels comentaris, consulta
el manual del drupal

Quines coses es poden aportar?

Per aportar continguts, n'hi ha prou amb conèixer alguna cosa d'interés que volguem compartir. La experiència personal de cadascú és ja de per si una font molt important de coneixement i aquesta web el que vol és instrumentalitzar una manera per compartir aquesta informació.

Els sistemes d'aportació que fins ara tenim previstos són:


Usuaris no enregistrats a la web

• Fer preguntes i contestar-les als fòrums.
  Qualsevol dubte que tinguis relacionat amb aquest món el pots plantejar i si hi ha sort... en coneixeràs la opinió de més gent. A la vegada, si coneixes d'alguna resposta... de ben segur que qui hi ha formulat preguntes agrairà els teus comentaris. Per formular preguntes pots fer-ho des d'aqui, i per respondre-les, ho podràs fer directament des de la pantalla on visualitzes cada tema en concret en el formulari que trovaràs a peu de pàgina o seguin l'enllaç que veuràs a cada comentari.
• Comentaris
  Pots comentar els diferents continguts que veuen en els continguts de la web, afegint així informació, corregint-la, etc. Trovaras un formulari i un enllaç per fer-ho a peu de cada pàgina amb continguts.

Usuaris enregistrats

Un cop enregistrat a la web, podras fer totes les coses apuntades fins ara i a més:
• Aportar documents.
  Que eventualment seran revisats per avaluar si poden promocionar-se a la pàgina d'entrada. Poden ser tant un "Com es fa" com una "Pregunta més Frequent" o un article. La questió es que ens expliqui alguna cosa. Els criteris de com construir-los els trovaràs descrits aqui.
• Aportar enllaços.
  És segurament una forma encara més senzilla de proporcionar informació d'interés. N'hi ha prou que coneguis un enllaç d'interés que encaixi dins d'alguna de les categories, el comentis una mica i el facis arrivar. Té a més la ventatja que periòdicament es comproven de manera que si es trenca l'enllaç, ho hauriem d'advertir de forma automàtica.

Contribuidors

Són els usuaris enregistrats que ja participen d'una forma més activa i continuada en la redacció dels continguts de la web. Poden fer tot el que s'ha apuntat fins ara i a més:
• Entrada en la bitàcola personal
  Un blog (bitàcola) és un diari fet a base d'anotacions, típicament ordenades per data, amb les més recents al principi (un diari és a la inversa). Tendeixen a ser personals, sovint contenen enllaços a coses interessants que has vist o altres articles. Les anotacions que es considerin interessants poden ser promocionades i publicades de forma general.
• Pàgina de llibre (secció)
  Una secció és una aportació col·lectiva formada per documents que s'han anat aportant en forma de llibre. Permet posicionar les pàgines en l'ordre correcte, revisant i/o modificant pàgines ja escrites. El resultat d'això, al estar organitzat, pot ser pròpiament un llibre o també és un format adeqüat per organitzar pmf o faq (preguntes més freqüents) sobre una determinada qüestió. Per tant, aquesta és la manera d'afegir pàgines directament en una secció . Qualsevol contingut pot ser més endavant classificat dins d'una secció.
• Orígen de documents externs
  Un orígen de documents externs és una font de documents que provenen d'altres webs.
• Arxius
  Pots pujar arxius que després es els usuaris podràn baixar.
• Imatge
  Una imatge que pots incorporar als documents (logos, diagrames, fotografies, bolcats de pantalla...)
• Document extern
  Un document extern correspon a un ítem d'una font RSS.
• Pàgina estàtica
  Per afegir un document directament com a pàgina. A diferència de la aportació d'un document normal, una pàgina no passa per la revisió, i a diferència d'una pàgina de secció, no porta navegació de pàgines dins d'un llibre (tot i que més endavant, si es vol, s'hi podrà afegir). És per tant adequat per a la incorporació de continguts "puntuals", que es puguin publicar directament. Si creus que no estas familiaritzat amb aquests processos, fes servir la opció d'aportar document.
• Projectes
  Si vols que hostatjem una iniciativa... podem fer servir els projectes per a estructurar-la i procurarem així donar-li suport.

Com podeu veure, es preveuen moltes maneres de contribuir. De senzilles i de més complertes. La idea és que tothom, independentment del seu grau d'experiència es vegi capaç de fer aportacions. Si s'et acut alguna idea d'incorporar-ne de noves, escriu-nos a la llista.

Que es distingeixi el tipus d'aportacions possibles en funció del tipus d'usuari és una qüestió simplement organitzativa, en funció del nivell d'experiència en la web es van proporcionant més instruments. En cap cas és una ordenació jeràrquica. Aquí s'explica com pots variar el teu rol dins de Comesfa.org.

Tipus de documents

Ara mateix estem diferenciant entre tres tipus de documents en
les aportacions. Intentarem explicar el significat de cascun d'ells i
en línies
generals quins criteris han de cobrir.


1. PMF: style="font-style: italic;">Pregunta style="font-style: italic;">Més style="font-style: italic;">Freqüent.
   
2. CEF: Guia de " style="font-style: italic;">Com style="font-style: italic;">Es style="font-style: italic;">Fa" alguna cosa.
3. Article.

A continuació, s'explica el format i el contingut que hauria de
tenir cadascun d'aquests documents, d'aquesta manera podrem catalogar
cada aportació en algun d'ells.



Procurant respectar els criteris generals que es descriuen en
[Redacció de documents], unificar criteris i proporcionar un
patró a l'hora de redactar-les:




1. PMF:
   
   Les PMFs donen resposta a preguntes sobre conceptes i necessitats que
   es poden tenir. Així, donen resposta des d'una
   definició a un concepte o paraula, fins a encaminar a
   programari relacionat amb la pregunta o altra informació
   pertinent.
   
   
   
   A partir d'aquesta informació base, hom pot continuar la 
   seva cerca cap als CEFn, Internet, bibliografia, xats,  llistes de
   correu, etc.
   
   
   
   Format:
   
   Les PMF, estaran formades per una pregunta (que la posarem com a
   Títol) i la  resposta adequada (en el cos de la
   aportació). El format de la pregunta i la resposta 
   seguiran la forma següent:
   
   • Pregunta: Serà breu, clara i molt centrada  en el
     tema. Intentant evitar que pugui confondre o fer referència a
     altres  conceptes.
   • Resposta: A de dirigir-se a la pregunta. S'hauria d'evitar
     repetir  respostes amb diferents paraules  (Només s'ha
     de possar una resposta clara a una pregunta, les que poden portar
     a confusió seran omeses).

   
   
   

2. CEF:
   
   Donen solució a un aspecte específic. Així,
   a partir d'un problema/necessitat, s'ofereixen una mena de guia de com
   resoldre-ho, típicament amb el programari específic sobre
   el problema que es dirigeix.
   
   
   
   Format:
   
   Les CEF, estaran formades per un breu enunciat (que posarem com a
   Títol) i el text que contingui la informació
   necessària perque en sí mateix dongui una
   orientació clara a la qüestió a la que es dirigeix.
   
   Com que els continguts poden quedar fàcilment desactualitzats,
   és bo que el text en si mateix ja tingui prou significat
   perquè sigui prou entenedor per a la questió que l'ha
   motivat. En aquest sentit pot ser bó fer referències a on
   aconseguir més informació etc. Els enllaços de
   vegades són un bon recurs, pero tampoc convé
   abusar-ne,  també es poden quedar desactualitzats, i si
   resulta que els enllaços no funcionen i fora el que li dona el
   significat... adéu CMF.
   
   
   
   
3. Article:
   
   Els articles seran documents on es faci una anàlisi d'algun tema.
   Els articles no necessariament han de ser documents de formació
   a novells com són les PMFs o  els CEFn. La finalitat
   principal dels articles es la de ser  documents
   "d'innovació'', de reflexió o de revisió
   sobre  qualsevol tema relacionat amb la informàtica,
   més o menys relacionat amb el que es descriu al manifest del
   projecte.

Criteris per omplenar els camps

El formulari per a fer les aportacions és ben senzill, conté dues parts principals, el Títol i el Cos.

• Títol: Títol del contingut a incorporar. Si estem fent un PMF correspon a l'enunciat de la pregunta, si estem fent un CEF és pròpiament el títol del capítol o secció que en resum el contingut. Tot aixó s'explica una mica més a [tipus de documents]. No es bó que el titol sigui un simple enunciat genèric que no diu res: cal que sigui breu però a la vegada resumeixi el seu contingut, i sigui únic. Això ajudarà no només a l'usuari a saber de què es parla en el document i si li interessa o no avans de clicar-lo, també és útil si volem posar enllaços entre pàgines tal i com s'explica a [posar un enllaç intern].
• Categories: Vegeu les instruccions a assignació de categories.
• Cos: En aqui hi podeu posar lliurement el contingut de la aportació. Hi podem escriure simplement el text, o enriquir-lo amb algunes marques del tipus html (negretes, ample de lletra, etc). Mireu les instruccions de [redacció de documents] per a més detalls sobre la forma de construir-los i els recusrsos de presentació disponibles.
  Tanmateix, i per resumir-ho, ni ha prou amb que fem un copiar/enganxar des d'allà on tinguem la redacció del texte a aportar.
• Botó Previsualitzar: Un cop hem "enganxat" el nostre document a la capsa "Cos" cal fer una prova per veure com quedarà presentat un cop es publiqui a la web. Feu servir tantes vegades aquest botò com calgui avans de confirmar l'enviament i desar el document, ja que un cop enviat, serà publicat. Per fer modificacions sobre documents ja aportats, us caldrà adquirir [rols d'usuari dins de la web|rol de contribuidor].
• Botó Enviar: Confirma i desa el contingut que esteu aportant.

Assignació de categories

L'assignació de taxonomies (categories) es fa a les capses que apareixen en el moment d'aportar o editar un document.

En sí mateixes no formen part del contingut del document, ho hem de veure simplement com un mètode de organització i classificació.

Com que determinen la navegació dins de la web, es procurarà anar revisant la forma d'assignació per complir uns criteris uniformes que facilitin la usabilitat de la web. Per tant, poden ser reassignades amb posterioritat obeïnt un criteri d'organització dels continguts.

Si sou un usuari novell, i no us resulten familiars aquests conceptes o encara us resulten feixucs, no us hi atabaleu: no n'assigneu cap. La seva assignació no és obligatòria. En la mesura que es vagin ordenant els continguts ja s'anirà classificant adecuadament. Sempre s'hi és a temps i és millor una categoria no assignada que una de mal assignada.



Com a criteri general, escolliu d'entre les taxonomies que teniu disponibles a les capses aquelles que es puguin relacionar més directament amb el contingut.
Podeu escollir-ne vàries, així els usuaris podran localitzar el document sempre que cerquin dins de la categoria corresponent, sense que per això haguem de fer més còpies d'un mateix document. Així per exemple, si estem fent una informació sobre DNS, i l'aportació proporciona contingut que aplica tant a la categoria "DNS" dins de "servidors", com a "TCP/IP" dins de "Xarxes", escollim els dos.
No hi poseu però aquelles que només hi relacionen "indirectament", seguint l'exemple anterior, no cal posar-ho també a "Protocols"/"SMTP" simplement perquè hi existeix una relació a nivell de concepte. Tampoc cal que ho posem dins de la categoria "pare" quan ja és a la "filla". La idea és que des de la web ja es vagin proporcionant mecanismes de navegació entre conceptes relacionats.



Si esteu contruint una aportació en forma de llibre, i un és la portada que agrupa diverses pàgines (per exemple, les PMF sobre una determinada qüestió), assigneu la categoria només a la pare. Amb això ja queda llistada en l'arbre de categories i no patiu que la filla ja podrà ser "localitzada" a través de la pare (de fet la pare les llistarà). Si assignéssiu també cadascuna de les filles provocarà que hi hagi masses entrades en la categoria, quan en realitat amb una aparició ja és suficient. En qualsevol cas, si el nombre de documents que apareixen al llistar les categories és excessiu, això indica un símptoma evident de que cal agrupar les pàgines i assignar la taxonomia només en la pàgina "pare".



Les taxonomies que hi ha ara són: Tipus de document, Nivell, per aplicació funcional, Sistema *IX i plataforma).


1. Tipus de document: Escolliu el que correspongui dins dels criteris que es fan a [Tipus de documents].
2. Nivell: El nivell de coneixement previ que es requereix per a la
   comprensió del document o a qui va dirigit: Iniciació, mig o avançat.
3. Per aplicació funcional: Perquè serveix des del punt de vista de "fer"
   coses pràctiques i concretes.
4. Relacionades directament amb aspectes del Sistema Operatiu *IX.
5. Plataforma: Si el document es refereix a plataformes concretes dins el món
   *IX o és genèric a totes elles.

Els arbres de taxonomies ara mateix ja els veureu poblats. Tot i així no vol dir que siguin complerts. És lògic pensar que aniran evolucionant: Es vol fer que es vagin adaptant per donar sentit pràctic i ajudar a la localització dels continguts.

Si creieu que requereixen alguna modificació, voleu fer alguna suggerència, rumieu quina i proposeu-la a la llista o als fòrums aportant el criteri que la justifica.

Redacció de documents.

En la capsa "Cos" hi podeu posar lliurement el contingut de la aportació. Hi
podeu incorporar alguns tags html per a donar format al text però no tots. Els que
teniu disponibles us apareixen a sota, us premetran destacar text amb negreta, posar
capses, subratllar, cursives, posar enllaços per a navegar entre pàgines, posar
amplada fixe (útil per exemple per a referir-se a instruccions de la línia de
comandes). Si en troveu a falar alguna, escriviu-nos a la llista donant-le les raons
i mirarem de trovar-hi solució. Us permetrà unes funcions de presentació bàsiques,
deixant que l'aparença del lloc web, determinada per la presentació que estigui en ús
per part de l'usuari o per omisió en la web, s'encarregi de la resta. Penseu que per
exemple, si mai es vol millorar la presentació, o l'usuari s'en escull una de pròpia,
i esteu forçant un determinat color en concret, us podeu trovar que no sigui
visible.





No poseu aqui textes massa curts ni massa llargs. Procurem que siguin descripcions
pràctiques.
És una bona idea separar el contingut de la pàgina en dos parts amb la marca
<!--break-->. Això farà que automàticament la secció anterior es
converteix en el text de resum, de manera que l'altra part només es visualitza al
clicar en llegir més sobre això o quan es va específicament a visualitzar
aquest document. En cas de que no es faci servir la marca de separació, drupal la
posa per omisió. El llindar de caràcters a partir del qual es produeix el tall es
definieix en la administració del site web i aixo pot resultar que parteixi en un
lloc arbitrari.

Penseu, per exemple, en el subtitular d'un diari.

Els continguts que vulguin ser promocionats a la portada seran
particularment revisats amb l'objectiu de que compleixin adequadament aquests
criteris generals.

Avans de confirmar la vostra aportació, és una bona idea fer servir la previsualització, 
així tenim opció a revisar com queda avans no sigui definitivament enviada a la seva publicació.

Idealment hi ha d'haver força continguts dinàmics. Això dóna interactivitat als
documents i en facilita la navegació als usuaris. Tanmateix és important que aquests
enllaços continuin funcionant bé al llarg del temps i es puguin gestionar
adequadament. Per a poder enllaços seguiu les següents instruccions:

Posar un enllaç intern

Per "enllaç intern" entenem un enllaç a una altra pàgina dins de la nostra web.

Com que la generació dels documents és dinàmica i pot variar en el temps, el movem de servidor, etc... no és adeqüat de posar directament el codi html corresponent a un enllaç. En canvi, el que es pot fer servir és el [títol de la pàgina que vull enllaçar] entre corxets en el text que estic introduint. Si el que voleu, en canvi, és posar els caràcters [ ] (literalment), ho heu de fer amb el texte &#91;.

Trovareu més detalls de com fer-ho a la documentació del drupal.


Com veureu, no cal escriure el títol complert, però és possible que alguna lletra canviada o una ambiguitat entre títols de pàgines similars faci que no es produeixi l'efecte desitjat. És per tant important que quan es posa un enllaç, es provi que funciona correctament.

Aportar per correu

Si prefereixes aportar per correu, ara mateix ho has de fer escrivint-nos a la llista .

Indica en el correu que es tracta d'una aportació, per exemple, en el "assumpte" (subject) del correu, ens indiques on creus que s'hauria de posar i hi enganxes el contingut de la teva aportació, en un text plà o si mes no amb format html senzill de la forma que es descriu en redacció de documents.

D'aquesta manera algun membre de la llista de correu que es faci càrrec d'alguna secció o estigui identificat a la web podrà recollir la teva aportació i incorporar-la.

Si vols participar en la llista de correu, a l'apartat de la llista de correu hi trovaràs les instruccions

Ús del llenguatge.

Tot sovint, en el nostre àmbit cultural -el català-, usem molts termes en anglès, encara que hagin estat normalitzats pel Termcat.
També tenim el recurs de l'Institut d'Estudis Catalans per consultar-hi les seves definicions. En procurem un enllaç en una capsa a la web.

Tot i que no es tracta d'imposar una norma estricte, a l'hora d'aportar documentació en aquest lloc web -i, per què no, sempre que utilitzem aquests termes- estaria bé procurar de utilitzar-ne la forma catalana. També és una bona idea fer servir un corrector.

Penseu simplement que no estem en un xat, es volem explicar coses i que procurem que ens entengui tothom independentment de com de familiaritzat estigui amb aquestes màquines del dimoni. No es bò per tant abusar d'abreviacions amb inicials, o expresions poc exteses, a no ser que s'acomanyin d'alguna explicació.

Revisió de documents i promoció a la pàgina d'entrada

Un cop has fet la teva aportació a través de la web, automàticament queda publicada. És accessible accedint a les categories que has especificat al teu document tal i com s'explica a exploració de continguts de la web.

També queda a disposició de la resta d'usuaris enregistrats a revisió de documents aportats. Va bé revisar-los, difícilment un document surt bé a la primera encara que s'hagi previsualitzat avans mentre s'edita.

Durant aquesta revisió, la resta d'usuaris a més podrán valorar el document emetent un vot segons els següents criteris:


• Enviar-lo a la portada (+1). El document no només és considera llest, a més es valora que és especialment interessant i convé fer-ne promoció a la portada de manera que els usuaris el veuen com a novetat tot just entren a la web, encara que no naveguin fins a la categoria on es trova. A més, un cop està a la portada, el document i el seu resum és enviat via RSS.
• Neutral (0.) El document es considera llest i adequat per formar part dels continguts d'aquesta web. Tanmateix no cal destacar-lo a la pàgina d'entrada com en el cas anterior.
• Denegar-lo (-1). Creieu que hi ha algun motiu que fa que aquest contingut no sigui publicat a la web.
Mentre els documents estan en revisió van acumulant punts en un sentit o un altre en funció dels vots emesos. Quan la puntuació arriva fins a un llindar establert i de forma automàtica, es promociona a la portada, es despublica o bé simplement queda publicat sense quedar destacat a la portada.

Com a criteri general, qualsevol contingut propi que sigui una aportació que en sí mateix proporciona informació, es bó que sigui enviat a la portada un cop revisat. Així tots fem més nostra, podem deixar la nostra emprempta i decidim de forma col·lectiva la presentcaió de la web.
Les aportacions externes es promocionen o no ja a criteri subjectiu de cadascú.
Si mentre reviseu un document, creieu que hi ha algun error, s'ha de corregir alguna cosa etc, poseu un missatge en el document especificant la correcció que creieu que fa falta, així donareu oportunitat a l'autor per arreglar-ho. Si creieu que cal despublicar-lo, seria bó que també expliqueu el motiu amb un comentari.

Llista de correu de comesfa.org

Per tractar els temes relacionats amb la gestió del projecte ComEsFa.org tenim una llista oberta gestionada per ezmlm.
Hi pot participar tothom que vulgui colaborar en la web.
Per a gestionar continguts, convé estar a la llista per coordinar-se amb la resta de membres.

Per apuntar-te a la llista, escriu un correu a:

comesfa-subscribe _arroba_ guifi.net

No cal que hi posis res més al correu, rebràs una resposta automàtica i després has de contestar per confirmar la inscripció.

PMF per als usuaris

Preguntes de la operativa normal del nostre lloc web.

Com funciona la pàgina d'entrada?

La portada té els següents continguts o blocs principals:


1. Continguts estàtics
2. Continguts en "promoció"
3. Menú de navegació
4. Enllaços a les categories i guia de com fer servir la web.
5. Cercador
6. Bloc de continguts més accedits
7. Bloc de continguts aportats recentment



Els continguts estàtics
són aquells que tenen aquest atribut activat. Aquest atribut el
trovareu en el formulari que apareix quan s'aporta o s'edita un
contingut, sigui del tipus que sigui. Hauriem de fer-ne ús
només quan es tracti d'un document que realment volem que
estigui de froma continuada present a la pàgina d'entrada. Ha
de tenir per tant un motiu important per justificar aquesta
condició.



Els continguts en promoció
són aportacions que bé perquè són recents, per votació o
per qualsevol altre motiu, es decideix també de publicar-ho
durant un període de temps a la portada. La portada
visualitzarà un nombre limitat de continguts "en
promoció".



Els continguts que estan en votació per a promocionar a la portada els podreu trovar, un cop enregistrats, a revisió de documents.


Convé que els documents tinguin ja
uns nivells mínims d'acavat: Han d'aportar significat en
sí mateixos, no contenir errors importants que els desvirtuin,
contenir una secció de resum a l'inici de l'article separada de
la resta del contingut (el resum és la part que es publica a la
portada). Tot això s'explica amb més detall a [Redacció de documents].



Pel que fa a si el contingut és apropiat o no, en principi qui
hi tindrà més a dir són els responsables de cada
secció.



Fins aquí els continguts que són propis de la portada, un
cop naveguem dins la web, ja s'ens presentarà la pàguina
que estiguem escollint. Els continguts que es descriuen a
continuació ja són fixes a totes les pàgines de la
web.



A dalt hi trovareu també uns enllaços
a les categories i a la Guia
de com fer servir la web i el Cercador.
Esperem que us resultin útils a l'hora de fer servir aquesta web.



El menú de navegació
és el que podrem fer servir per anar-nos movent per les
diferents opcions dins de la web en funció de si estem
identificats o no. Adoneu-vos que si us enregistreu, o us feu
col·aboradors del projecte (a la qual cosa us animem) us

apareixeran més opcions.



Finalment veureu que també hi han uns blocs que ens destaquen,
respectivament, els continguts
més populars de la nostra web, i també els style="font-weight: bold;">aportats o modificats més recentment.
És una manera útil d'identificar què és
recent o és accedit freqüentment.

Puc canviar l'aspecte de la web, per exemple, per accedir només amb mode caràcter?

Si. Per fer-ho has d'estar enregistrat a la web i haver-te identificat adequadament amb les teves credencials.
Un cop degudament identificat, podràs personalitzar-te l'aspecte anant a la opció de editar el teu perfil que trovaràs en el teu menú d'usuari.


En allà hi tens totes les dades pròpies de la configuració. Bastant al final de la pàgina, tot just avans de on esculls la teva franja horària, hi pots escollir el "Tema".
Ara mateix només hi ha un parell de temes actius. Un que és el general, i un altre, per a treballar amb navegadors en mode caràcter, com ara el lynch. També pot ser adeqüat per aalguns tipus de mòbils i PDAs.

Puc rebre notificacions dels canvis i aportacions que s'estan produint a la web via email?

Si. Per fer-ho has de estar degudament enregistrat i haver-te identificat a la web amb les teves credencials. Un cop identificat, accedint a la opció del teu menú personal de "les meves notificacions" podras establir el criteri segons el qual vols ser notificat via email.

Ara mateix només es pot escollir cada quan vols rebre notificacions dels canvis, si hi vols incloure també els comentaris que hi fan els usuaris o no i si vols el títol, el títol més el resum, o tot el text sencer.

També, a través de les subscripcions, pots rebre avisos per fer seguiment d'un article o contingut en concret.

Quina diferència hi ha entre les seccions i les categories?

La web descansa sobre aquests dos grans eixos simultàniament a l'hora de organitzar els continguts. Això fa que fàcilment es confonguin ambdós conceptes.



Tot i que hi ha complementarietat i moltes vegades hi haurà també similituds, en realitat són coses diferents i és per això convé definir cada terme en relació a l'us que en fem a la web.


Categories

És una classificació de cada contingut en funció de la referència que fa a les categories que hi hagi definides.

Estan creades ja d'antuvi (tot i que amb el temps poden evolucionar).

Tenen un funcionament global: Són comunes a tota la web i totes les seccions.

Els usuaris poden especificar a quina categoria pertany una aportació directament en el moment de fer la aportació. Desprès, com a molt, simplement es revisa la seva assignació en funció de com evolucionin les catergories.

L'objectiu de les categories és proporcionar una forma de navegació dins la web, transversal entre les seccions (es a dir, independentment de qui l'aporta), via les definicions que hi ha a les categories i les qüestions amb les que es poden relacionar.



Seccions

És una part de la web que agrupa continguts i que hi te algun(s) usuari(s) que ho coordina.

Es construeix com si anés creant un llibre, ja sigui amb aportacions pròpies, o incorporant aportacions que fa altre gent.

A diferència de les categories, no hi ha una estructura predefinida i la defineix qui coordina la secció. Anirà creixent a mesura que es vagin incorporar continguts.

S'ha d'evitar que hi hagi un llibre amb només una estructura però sense continguts.

Llicència dels continguts

Tots els continguts que hi ha en aquesta web estan sota la protecció, termes i condicions de la llicència Creative Commons License tret de que un autor n'especifiqui una altra per a un contingut concret que li sigui propi. Qualsevol ús que no sigui el descrit en la llicència requereix de l'aprovació expressa del seu autor. Els documents externs estan sota la llicència d'orígen.

Per resumir-ho, aquesta llicència diu:

• no s'en pot fer un ús comercial
• la distribució i còpia dels continguts és lliure referenciant l'autor i l'orígen
• es poden modificiar els continguts i fer-ne treballs derivats si el resultat es distribueix de nou sota les mateixes condicions.

Pots obtenir-ne més detalls si cliques sobre la icona del logo de la Creative Commons License que tens més amunt.

Si per algun motiu vols incorporar un document sota unes condicions diferents, cal que ho especifiquis en la aportació.

Contactant amb l'autor(s) es pot parlar de fer-ne un altre ús sempre que hi donguin la seva aprovació.

Gestió de continguts de la web

Un cop disposis del rol de contribuidor o corrector, podràs ajudar-nos a gestionar els continguts de la web, ja sigui corregint continguts, classificant-los en les seccions en les que vols participar, etc.

En aquesta part de la guia intentarem explicar el procediment per tal de que existeixin unes bases de coordinació global sense contradir-se amb la llibertat de tothom en el moment d'aportar els continguts mantenint així un caràcter el màxim de participatiu possible.

S'assumes en aquesta part de la guia que ja hi ha certa familiarització sobre com fer servir la web des del punt de vista de l'usuari, que és la que es cobreix en la secció de Guia per als internautes.

Tipus d'aportacions

Un cop el teu usuari obté el rol de contribudor, si cliques en la opció d'aportar continguts, t'apareixeran moltes més opcions sobre els tipus de documents a aportar (imatges, pàgines de llibre, pàgines estàtiques, projectes...) i una explicació de cadascun d'ells.

Aquestes opcions no apareixen directament per als usuaris que s'acaven d'enregistrar simplement perquè un usuari novell es liaria amb tanta varietat d'opcions. És bò que per fer-ne un ús correcte, et familiaritzis avans amb el funcionament del gestor de continguts de la web, practiquis al servidor de proves...

En la mateixa pàgina on pots escollir el tipus d'aportació, apareix una breu explicació sobre cadascun dels tipus. Molts amb això ja son autoexplicatius, d'altres els mirarem d'explicar mica en mica a continuació.

Incorporant imatges, fotografies, logos...

Els documents de la web poden incloure imatges més enllà del que pròpiament es pot fer directament via codi html. Per tal de permetre-ho, s'ha incorporat el mòdul "image" del drupal.

Quan vulguis incorporar una imatge a un document, primer cal que incorporis la imatge com a tal, des de la opció d'aportar imatges. Podràs especificar l'arxiu que conté la imatge (png, jpg, gif...) i pujar-lo al servidor, assigna-li una categoria en funció del tipus d'imatgge que es tracti (bolcat de pantalla, fotografia, diagrama, etc...).

Procura que la imatge no tingui més resolució de la necessària: Com més petit sigui l'arxiu, més ràpida i comfortable serà la navegació per als usuaris, i estalviarà espai en el servidor.

Posa un texte explicatiu amb la imatge, a part del títol. Aquest texte apareixerà a continuació de la imatge cuan l'usuari cliqui sobre la seva previsualització, per tant, actua com a explicació del seu contingut i és en sí mateix una pàgina.

Quan pujes la imatge, l'aplicació ja construeix la previsualització en miniatura de forma automàtica.

Un cop es confirma l'aportació de la imatge, la podrem veure directament clicant la opció de "veure" que ens apareix tot just en la pantalla de confirmació de que la imatge ha estat aportada. Podem però també trovar-la si navegem per les galeries d'imatges de la web.

Incorporant les imatges aportades als documents

Adona't que en el moment de clicar en la previsualització de la imatge, es veu un número que correspon al node assignat, just al final de la url que la composa. Aquest número és un identificador únic sequencial que s'assigna en el moment de la incorporació de la imatge i que mai més canviarà.

Fent servir aquest número, podem a partir d'ara incorporar la imatge als nostres documents. Per fer-ho, es fa amb la sintaxi:

[image:<numero_de_la_imatge,right|left]

especificant com a <numero_de_la imatge> l'identificador que s'ha obtingut en el moment en que es va crear la imatge, i "left", "right" ens indica la posició on apareixerà la previsualització de la imatge dins del texte de la plana.

Per exemple, per a la part del resum de la aportació que va avans del tall de la part resumida, fins ara sempre posem la imatge a la dreta.

Trovareu més informació si aneu a la documentació del drupal, i en concret, sobre el mògul "image".

Gestió de les seccions

Una secció és una area de continguts ja classificats.
Requereix per tant de que hi hagi algun usuari que s'encarregui de coordinar-la.
Per fer-ho, n'hi ha prou amb adquirir el rol de contribuidor.




Crear una secció nova

Un cop es disposa del rol, cal crear la pàgina d'entrada de la secció des d'una aportació com a "pàgina de llibre". En aquesta pàgina cal posar-hi una explicació dels continguts, qui s'encarreguen de la coordinació i el funcionament de la secció.
Perquè aquesta pàgina faci bé la seva funció és important que:

1. Faci ús del <!--break--> tal i com s'explica a redacció de documents..
2. Especificar en el camp "Parent" <arrel>. De fet és aquest atribut el que significa que es tracta d'una secció nova.

A partir d'aquí, cal actualitzar el Mapa de la web referenciant a la portada de la secció que acaveu de crear.


No us preocupeu del enllaç "seccions", allà hi apareixerà la secció nova de forma automàtica perquè llista totes les pàgines que penjen del arrel i a més mostrarà el resum de la pàgina (és per això important que contingui el resum).




Manteniment de la secció

Penjarem els diversos documents que volguem en pàgines successives dins de la secció.

Si es tracta d'una pàgina nova, ho farem posant en el camp "Parent" una pàgina que formi part de la nostra secció simplement escollint-ne el títol de la llista desplegable.

Si el que volem fer incorporar al nostre llibre una aportació d'un usuari, el podeu incloure amb el mètode descrit a classsificar documents dins la web..



Per tal de facilitar la navegabilitat a l'usuari, a mesura que es vagin acumulant continguts, serà bò anar creant apartats dins de la mateixa secció amb noves pàgines que els agrupin i organitzin, però no pas avans, ja que llavors l'obligariem innecessàriament a navegar per diverses pàgines buides que nomès fan de portada avans d'arrivar al contingut real. Mentre hi han pocs continguts, és suficient una pàgina d'entrada on es dongui una introducció.



Com a norma general no feu la paginació a través de seccions si simplement el que es vol fer es posar enllaços entre pàgines. Les seccions haurien de ser classificacions ja ben ordenades dels continguts. Recordeu que el text que introduiu en els documents ja permet d'incloure les marques html directament en el mateix redactat.

Classificar els documents dins de la web

A mesura que els usuaris van fent aportacions, aquestes aportacions es troven disponibles a la cua de revisió de documents aportats.

En aquesta cua els usuaris enregistrats poden revisar el contingut valorant-lo. Si el trovem molt interessant, podeu votar perque sigui promocionat a la portada. Si hi ha algun motiu pel qual creieu que l'aportació no es pot publicar, també ho podreu indicar allà, però per fer això haurieu de especificar una raó objectiva (contingut inexacte o equivocat, aportació sense cap valor o significat, expresa una opinió en nom d'altres, ..) i comunicar-la al autor, ja sigui enganxant un comentari o amb un correu i d'aquesta manera li doneu oportunitat d'esmenar el motiu.

Un cop el document ha estat revisat, als usuaris amb el rol d'encarregats de la classificació els hi apareixerà un enllaç a sota del document que diu classificar. Clicant-lo amb això ja s'assigna automàticament el document al llibre de continguts pendents de classificar.

Si ja tenim clar on definitivament ha de quedar ubicat el document dins del llibre de la web, amb l'enllaç administrar o bé d'es de la pròpia [Editar continguts ja aportats|edició del document] podrem assignar-lo dins d'un llibre i posar-lo dins de les categories.

Camps per a la classificació del document.

El formulari per a la aportació de documents esta simplificat al màxim per tal de fer que sigui tan fàcil com sigui possible que un usuari es vegi capaç d'incorporar un contingut.
Amb el rol de contribició podrem ja classificar i ordenar el contingut dins de la web.
Els criteris per a la utilització dels camps són els que es descriuen a continuació:


• Escrit per: Nom de qui proporciona el contingut, per defecte ja agafa l'usuari que està identificat en el lloc web.
• Escrit el: Data de la modificació/creació.
• Opcions (descripció per sobre): Les opcions amb les quals creeu el document. Us apareixeran o no en funció de si teniu privilegi d'administració a la web, de manera que si no les veieu, tot això que us estalvieu i ja podeu passar al seguent camp .
  Si tot just hi esteu treballant, desactiveu-ho tot (no publicar, no promocionar, etc.). Un cop ja estigui prou decent per fer-lo visible, activeu la opció de Publicar. Si creieu que el document ho mereix, podeu activar Promocionat a la pàgina principal, d'aquesta manera, durant un temps i mentre no n'apareguin de nous, l'aportació es "promociona" a la pàgina d'inici. Si voleu però forçar que apareixi a la pàgina principal de forma continuada, activeu Estàtic a la web principal. Finalment, si esteu editant el document i voleu s'en guardin versions de manera que es conservi la versió anterior quan es modifiqu el document, activeu la opció crear nova versió, com a norma general sería bo no abusar d'aquesta opció ja que presumptament incrementaria de forma significativa la ocupació en base de dades dels continguts.
• Permetre comentaris: Especifiqueu o no si els usuaris poden dir-hi la
  seva respecte de la pàgina en forma de comentaris. Penseu que en general és bo ja
  que proporciona un mecanisme de tornada de les impressions del usuari respecte del
  contingut de la pàgina. Els comentaris ens poden ajudar també a adonar-nos de
  quan un document ha quedat desactualitzat, etc.
• Planificar la publicació: Normalment els continguts es publiquen immediatament i de forma permanent. Aquesta web no està orientada a continguts
  que tenen temporalitat, com ara les notícies, etc. Tanmateix, és possible que
  alguns documents tinguin igualment temporalitat o que amb el temps perdin sentit,
  com ara instruccions per fer servir una versió concreta d'una distribució, etc.
  Si preveiem que presumiblement d'aquí a un any el document ja haurà perdut el seu valor, podem especificar aquesta data i automàticament es despublica (no s'esborra,
  per tant sempre serem a temps a recuperar-lo si cal).
• Títol: Està ja explicat aqui
• Parent: No apareix sempre, apareix si el document forma part d'un llibre. Indica dins de quin llibre i relacionat amb quina altra pàgina estem incorporant el contingut. Si és la primera pàgina o portada del llibre, indiqueu-hi <arrel>. Un cop ja estigui definida la portada, incorporeu les noves i successives pàgines escollint en aquí de quin llibre formen part, o dins del llibre, quina pàgina (si es el cas). D'aquesta manera PMF/CEF tot solet ja ens organitzarà una paginació dins del document (que, com sempre, més endavant podrem modificar).
• Taxonomies i categories: En aqui haureu de especificar a quina branca de contingut pertany el document que estigueu aportant. Hi trovareu la llista dels que estan definits a la nostra web. Els criteris els trovareu descrits a assignació de categories. Procureu seguir els criteris que allà s'expliquen. La seva assignació no és obligatòria. En la mesura que es vagin ordenant els continguts ja s'anirà classificant com correspongui.
• Cos: Està ja explicat aqui
• Log: És un bon lloc per posar-hi un comentari que més endavant ens ajudi a identificar la versió del document, com per exemple "versió inicial", "correcció ortogràfica" o "document posat al dia".
• Pes: Indica la ubicació de la pàgina que estem incorporant. Per omisió sempre agafa zero i això bàsicament vol dir que agafarà el mateix ordre que la incorporació. Un número més gran fa que el contingut "s'enfonsi" dins de les pàgines, és a dir, els més pesats, apareixen més avall, i els mes lleugers, primer.
• Tipus: De moment, poseu-hi HTML, si sou molt espabilats i voleu fer alguna birgueria, aqui hi podeu posar codi php.
• Botons "enviar" i "previsualitzar": Està ja explicat aqui

Editar continguts ja aportats

Un cop un document ja ha estat aportat, és força probable que el vulguem actualitzar: Correccions ja sigui del contingut o de l'ortografia, canvis de format, reclassificar-lo dins de les taxonomies, promoció a la pàgina d'entrada, publicar-lo o despublicar-lo, són alguns exemples dels possibles motius.



Per a poder fer-ho, n'hi ha prou amb navegar fins al contingut que es vulgui modificar. Un cop el tinguem en pantalla, si estem degudament identificats en la web, tindrem un enllaç a sota del document que diu "editar aquesta pàgina" o bé "administrar", segons el tipus de document de què es tracti o els privilegis que disposeu dins de la web.



Si cliquem en qualsevol d'aquestes dues opcions, obtindrem el formulari d'aportació de documents, amb els mateixos [Criteris per omplenar els camps|camps que els que es descriuen en aquest enllaç]. En aquest cas, però, ja apareixeran totes les dades que s'hi van deixar el darrer cop.



Si el document ha estat creat amb la capsa "Crear nova versió" activada, cosa que us recomanem, i en el moment d'ediar-lo la continuem deixant activa, en guardar-lo ens crearà una nova versió del document, que de fet serà l'activa a partir de que l'haguem desat, però preservant l'anterior. En edicions posteriors del document A peu de formulari hi trobareu una llista de les versions disponibles pel cas de que en volgueu recuperar alguna.



Si el que feu és "editar aquesta pàgina", observeu que potser apareix el vostre nom d'usuari en el camp reservat a l'autor. Si això no fos correcte, poseu-hi el nom de qui correspongui.



El contingut el trobareu dins de la capsa de text "Cos". Allà el podreu modificar lliurement.



És possible però fer servir un altre editor. Si el text va ser introduit amb un editor html és possible que us resulti difícil d'interpretar-lo directament ja que, per exemple, on hauria d'haver-hi una "ó" (o accentuada) hi trobareu un codi "ó", els salts de línia us seran difícils d'observar, etc. Si aquest fóra el cas, enganxeu el text i copieu-lo a un editor html, com per exemple el redactor ("composer") del mozilla, entre les marques <body> i </body> en la part on hi ha el font html, d'aquesta manera us el interpretarà i el podreu corregir fàcilment en la finestra que us proporciona la visualització normal del document. Un cop acabada la feina, torneu a enganxar el nou codi html que us ha generat i poseu-lo de nou a la capsa on estava substituint el que hi havia abans. Aquest mètode us pot resultar igualment còmode per a editar el text en el vostre editor preferit, encara que es tracti de text normal però vulgueu fer servir el vostre corrector o us resulta més còmode de visualitzar-lo o editar-lo.



El camp "Missatge de log" hi podeu posar el text que vulgueu i que us permeti identificar la versió que esteu generant del document, per exemple "Revisió ortogràfica".



Actualitzeu la informació que vulgueu modificar, i un cop estigui tot llest, a sota de tot trobareu el botó de "Previsualitzar". Això permet visualitzar els efectes dels canvis avans de confirmar-los.



Un cop ja estigueu segurs de que voleu confirmar els canvis, el botó "Enviar" s'encarregarà de fer aquesta feina.



Al costat del botó "Enviar" hi ha el botó "Esborrar", que és el que hem de fer servir si volem esborrar completament el document. No patiu perquè estigui tan a prop del botó "Enviar", us demanarà confirmació abans d'esborrar un contingut de forma definitiva, de manera que es bastant difícil de que una cosa així suceeixi accidentalment.



Si heu entrat a través de la opció "administrar", al final hi veureu una llista amb les versions anteriors del document que hi han guardades. Allà podreu veure-les o recuperar-les. Si les revisions ja no tenen sentit que encara es guardin, convé esborrar-les ja que ocupen innecessàriament espai al servidor.



En cas però d'un accident (qui no en remena, no en trenca), contacteu amb els administradors per veure si amb alguna de les còpies que hi hagi de la base de dades es pot recuperar el que heu perdut. Tanmateix, és bona idea que els autors dels documents també es guardin còpia dels continguts que aporten ja que encara que fem volcats, mai podrem garantir de forma absoluta que es podrà recuperar tot.

Orígen de documents externs

Les fonts de documents externs són documents que provenen d'altres webs
a través dels RSS Feeds i que periòdicament es carreguen automàticament
a la Comesfa.org.

Són per tant un mètode interessant de complementar les aportacions pròpies a través de l'agregació de coneixement extern.

Si n'identifiques una que pugui de ser interès, cal obtenir el rol de
contribuidor a la web, afegirla i fer-te responsable de la seva
administració i seguiment periòdic. Si no tens aquest rol dins de la
web ens ho pots fer saber escrivint-nos a la llista.

Criteris Generals per a publicar documents externs

1. La part del texte que apareix a la nostra web ha d'estar en català avans de ser publicats.
2. El resum ha de contenir un resum suficient que permeti al
   internauta conèixer quin contingut obtindrà si decideix visitar-lo. En
   línies generals, alguna cosa més que un títol genèric.
3. El contingut ha de fer referència a les àrees de coneixement de
   Comesfa.org. En línies generals, es discriminen simples notícies
   d'actualitat, comentaris d'opinió, etc.

Aportar una font externa

Un cop disposes de l'usuari amb capacitat per a gestionar fonts externes, podras afegir la font externa simplement des de l'enllaç d'aportacions. En allà hi podràs veure que hi tens una opció per a aportar orígens de documents externs.

Des del formulari que t'apareixerà allà omple com a mínim els següents camps i amb aquest criteri:

1. Títol de la font (breu, ja apareixerà en el camp d'autor del document).
2. La url que genera l'arxiu XML en format RSS.
3. La url de la web d'orígen (la que apunta a la seva pàgina d'entrada).
4. Una descripció de l'orígen. Excplicant de què es tracta, qui la fa, a què es dirigeix...
5. Cada quan es visitarà el RSS feed de forma automàtica per comprovar que si publica nous documents (update interval).
   S'expresa en minuts. Com a norma general, no hi posis menys de 1 cop al
   dia (1440 minuts). Posa-hi cada quan estàs disposat a revisar el que
   els continguts que s'adquiriran.
6. Temps d'expiració. En el nostre cas, com que ens adrecem a continguts de coneixement i no pas a notícies, el drupal ha estat modificat: Els continguts adquirits no caduquen mai.
   El valor d'aquest camp estableix però cada quan els documents que estan
   pendents de revisió sortiran de la cua de revisió en el cas de no
   arrivar als llindars establerts per ser esborrat o promocionat a la
   pàgina d'entrada. Si un cop vençut aquest termini, el document té una
   puntuació negativa, es despublicarà automàticament, si és positiva,
   queda publicat, però no es promociona a la pàgina d'entrada.
7. Moderació dels nous documents. Deixa aquesta casella en "activat":
   Això és el que et permetrà que els nous documents adquirits passin
   automàticament a la cua de revisió, si ho deixes desactivat, no
   apareixerien mai.

Revisió dels documents externs

Moltes fonts externes
proporcionen també titulars a documents que en realitat no son propis
dels àmbits tractats en aquesta web (notícies, etc). Per això cal
revisar-los. Una altra modificació que s'ha fet al drupal és que els
documents si bé passen a la cua de revisió, mai es publiquen de forma
automàtica.
Un
cop adquirit el document, el responsable del seguiment de la font
externa podrà recollir-lo des de la cua de revisió, clicar sobre la
opció "administrar" mentre s'està visualitzant el document, i un cop
revisat el seu contingut prendre alguna de les següents decissions:
1. El document no interessa,
   no s'ha de publicar a la web. En aquest cas en la pantalla
   d'administració, cal desactivar totes les caselles de "opcions" (la que
   segurament és activa és la de "a la cua de revisió"). Amb això el
   document ni queda publicat ni formarà part de la cua de revisió. No
   esborreu el document, ja que fent això, és probable que torni a
   aparèixer el proper cop que es visiti la font RSS.
2. El document interessa.
• Si
  es creu que el document té interés, des de la pantalla d'administració
  cal activar la casella de "publicat" i d'aquesta manera ja passa a
  formar part dels continguts de Comesfa.org.
• Si el document és escrit en un altre idioma, cal com a mínim traduir la part del resum que es publica dins de la nostra web.
• És
  imprescindible que simultàniament a la publicació del document,
  s'assignin les categories corresponents al contingut que fa referència
  el document. Si no ho feu, quedarà publicat però dins de les pestanyes,
  només apareixeria quan es clica a "Tots".
• Si creieu que val la
  pena publicar-lo, ja li heu assignat les categories, però creieu que no
  mereix que sigui promocionat a la portada, desactiveu la opció de "a la
  cua de revisió".

PMF d'administració de comesfa.org

En aquesta secció trovaràs les preguntes relacionades amb la gestió de la nostra web.

Es pot tenir accès a un volcat amb les traduccions que es fan servir del PMF/CEF amb drupal?

Si. Ara mateix però encara no hi ha carregat un fitxer "estable" perquè encara es modifica freqüentment. Si en voleu un sol·liciteu-lo expressament.



Nota important: Si el voleu per desprès tornar-lo a aplicar aquí mateix, aviseu que aquesta és la intenció: Si es fa la traducció amb un volcat de fitxer plà, al tornar-lo a carregar es perdrien altres traduccions que simltàniament s'hagin pogut fer en línia des del propi lloc web. En resum: Caldrà avisar que ningú més faci traduccions en línia mentre hi hagi algú treballant sobre un volcat en un fitxer de text.

Què ofereix drupal per a gestionar el PMF/CEF?

Pregunta aportada per en Carles.

Doncs moltes coses, potser en podriem anar fent un resum, al menys de les que farem servir aqui, de tota manera ara mateix sempre pots obtenir una llista de les funcioncionalitats de Drupal directament des de la pàgina del projecte.
Aqui hi tens l'enllaç que t'hi portarà.

Arxiu de canvis

Descriu els canvis que vaig fent a la web. De moment en format texte (UTF-8). Segurament a la llarga convindria donar-hi un altre format, més "weblog" o incorporat a la web eb forma de "projecte".

Convertint ComEsFa?org en invencible: Protocol d'actuació en cas de desastres

Ja com a aplicació pràctica del que es descriu a l'article sobre l'unison, en aquest document s'explica quin és el protocol a seguir en cas de fallada o desastre important en la infraestructura que dóna suport a ComEsFa?org, assegurant-ne la supervivència del servei i minimitzant qualsevol pèrdua d'informació.
Si bé ComEsFa?org pot tolerar "caigudes de servei" raonablement curtes (minuts/hores), en cas que l'avaria o motiu d'indisponibilitat, incloent la desaparició del servidor, sigui tan greu com per preveure un temps de recuperació més llarg, es pugui continuar el servei en un MTTR ("Maximum Time To Recover") raonable.
Tot plegat un exemple pràctic interessant no només per assegurar la invencibilitat de ComEsFa?org, sinó també per servir d'exemple a qui vulgui construir-se un sistema robust.

Per tant, les causes d'indisponibilitat que afecten a aquest protocol són fonamentalment dues: Pèrdua de comunicacions de forma continuada i llarga o destrucció/avaria total o parcial del servidor irrecuperable i que n'impedeixi el servei. S'exclouen expressament les indisponibilitats de servei puntuals que es poden resoldre en franjes de minuts/hores, que per la naturalesa de la web, es considera que no és necessari de protegir.

Escenaris contemplats

1. Pèrdua de comunicacions
2. Pèrdua del servidor



Descripció del sistema de protecció

ComEsFa?org és bàsicament un servei web que es proporciona a través de un gestor de continguts que funciona amb PHP (drupal) i una Base de Dades que és el lloc on es desen els continguts. Per tant, podem considerar que en tenim una còpia a partir de que copiem tant la Base de Dades, com el directori arrel on hi ha els programes PHP.
De vegades es podria considerar que de còpia de programes només en cal una, ja que no és habitual que hi hagi canvis. En aquest cas no és així: Malhauradament hi ha alguns continguts que en aquest cas no es desen a la base de dades, com ara arxius o imatges i, a més, sobre el gestor de continguts s'hi van fent periòdicament "hacks" i pegats que convé tenir-los ben sincronitzats.

Per copiar el sistema d'arxius, on hi ha el codi PHP, imatges, etc, aprofitem l'unison: Ens proporciona un mecanisme que garanteix la rèplica segura dels arxius sense excedir-se en ús d'ampla de banda.

El mecanisme és el que es descriu en el diagrama que veieu a dalt a la dreta, cal clicar-lo per veure'l ampliat. Resumint: Hi ha al Bandoler, que és el servidor actual on hi ha ComEsFa?org, s'exporta cap a 2 miralls, un situat a uns metres (el servidor del Serrat) via xarxa local, que es fa cada hora, i un altre distanciat a uns quants quilòmetres (el servidor de l'Esperança), que es copia un cop al dia, per la matinada, via guifi.net.

Per a copiar la base de dades i aprofitant que el seu volum no és important si el comprimim, simplement s'exporta complerta, i es deixa l'arxiu en el directori arrel. L'unison s'encarrega de gestionar-ne la rèplica dels canvis al sistema d'arxius, només amb això aquest arxiu es propagarà a cadascun dels miralls.

Pèrdua de comunicacions amb internet

En situació normal, el bandoler fa servir la sortida a internet que hi ha a l'Esperanca, això és a uns quants quilòmetres de distància, amb 3 routers entre mig i 4 ràdios més en dos "bridges". En cas de desconnexió prolongada, ja sigui en aquesta infraestructura intermitja que proporciona guifi.net, o bé (i més probable), desconnexió prolongada de la connexió ADSL per avaria de la operadora (de vegades poden trigar setmanes en resoldre un inconvenient d'aquest tipus), el que farem és canviar el bandoler de sortida a internet, fent servir una altra ADSL.
• Diagnòstic. Les diferents vies d'accés a ComEsFa?org estan realment simultàniament activades, encara que per defecte, només en funciona una. Si no es pot accedir a ComEsFa?org, podem comprovar de forma molt simple si n'hi ha una d'activa que ens permeti arribar fins al bandoler. Per fer-ho només cal posar un prefix en el nom del domini, i mirar quina d'aquestes funciona i arriba al bandoler:
1. esperanca.comesfa.org és la que correspon a l'accés via el proxy de l'Esperança.
2. elserrat.comesfa.org és la que arriba al bandoler des del proxy del Serrat.
• Actuació. N'hi ha prou amb anar al gestor de noms (DNS) d'Internet. Allà la entrada "www", que és la que correspon a "www.comesfa.org" és de tipus CNAME i apunta normalment a esperanca o gurb. Si, per exemple, l'accés a internet que funciona és el del Serrat, hem de canviar aquesta entrada i posar-hi "elserrat".
• Els canvis al DNS d'internet triguen una estona a propagar-se, hi han servidors cau que tenen en memòria l'adreça anterior i poden trigar en reflectir els canvis. Si el tall és només de la part "guifi", un sistema per aplicar els canvis de forma més immediata, és també fer aquest canvi al servidor de noms de l'Esperança, és a dir, fent que respongi a "www.comesfa.org" amb l'adreça internet del Serrat per contactar amb el bandoler (això es fa posant el registre CNAME a "elserrat-inet.comesfa.org". Si es fa aquesta operació, és important convertir el domini "comesfa.org" en màster en la resta de servidors de noms, ja que quan es recuperi la connexió, aquest canvi es propaga a la resta de servidors, i llavors deixaria de poder contactar-se amb el bandoler.
Caiguda del servidor

Si la caiguda és del servidor, per exemple una avaria greu del maquinari que no quedi resolta amb el RAD1 que hi ha actualment a nivell de disc (avaria en els dos discs, corrupció lògica, memòria, ...) i la resolució del problema va més enllà a allò que s'ha compromès el fabricant (24 hores), llavors podem activar el servei des d'un dels miralls.

Com s'ha dit abans, els miralls ja tenen de forma permanent una còpia actualitzada de la base de dades i l'aplicació. Podem en qualsevol moment verificar-la anant a les respectives url que ens hi donen accès:

1. esperanca.mirror.comesfa.org per al mirall de l'Esperança, que es sincronitza cada dia a la matinada
2. elserrat.mirror.comesfa.org per al mirall del Serrat, que es sincronitza cada 60 minuts
Un cop haguem decidit quin és el mirall que volem fer servir, els passos a seguir son:
1. direccionar el servei a nivell de DNS tal i com es descriu en l'apartat anterior, a la sortida a internet corresponent
2. canviar la configuració de l'apache (arxiu comesfa.conf) per tal de que en lloc de fer de proxy cap al bandoler, faci servir el servei local. Podem prendre com a referència l'entrada que hi ha per al corresponent "xxx.mirror.comesfa.org". Reiniciar l'apache.
3. activar els crons corresponents per a les notificacions i manteniment del drupal
4. desactivar el crons de l'usuari comesfa.org, en la part de carregar la base de dades. Ara la base de dades mestra és la del mirall, per tant, no podem deixar que en cada sincronització la base de dades es "matxaqui".
Salut i llarga vida a ComEsFa?org!

Mapa de la web

Aquesta pàgina us orientarà dins de les seccions i els continguts de la web. Actualment les seccions organitzades que hi han són:
• Guia de la web. És on explica com funciona la web.
• Multimèdia. Coordinada per en Ramon Roca.
• Projectes hostatjats. És on hi penjem els projectes de desenvolupament relacionats amb el nostre grup o aquesta web.
Si voleu participar en qualsevol d'aquestes seccions, escriviu-nos a la llista de correu.
Els documents que encara no han estat aportat a cap d'aquestes seccions, els podreu trovar a la secció de documents pendents de classificar.

Finalment, també s'aporta una navegació per "categories". Cal encara "afinar" una mica en la seva utilització, tanmateix la teniu disponible en aquests enllaços:

• En format dinàmic (desplegable)
• Estàtic

Enllaçat amb aquesta web

Podeu lliurement proporcionar enllaços cap a aquesta web.
Amb aquesta finalitat, si voleu, us proporcionem el botó de la web.

Per fer-ho simplement posa aquest codi des de la part de la pàgina on vulguis posar-hi l'enllaç:

<a href="http://comesfa.org"><img src="http://www.comesfa.org/files/images/botonet-329.png"></a>

Aquest codi proporcionarà un resultat així:

Com podeu veure, clicant sobre el botó el navegador us portarà a comesfa.org.

A la vegada, si voleu que us proporcionem enllaços a la vostra web, des de les nostres pàgines d'enllaços, escriviu-nos un correu a la llista o obriu un tema al fòrum sobre aquesta web.