Estructura del Wiki Documentacion

doc

OOo

Aqueste article a per tòca de vos ajudar a contribuir a la seccion Documentacion d'aqueste wiki.

Ierarquia

La seccion Documentacion es una partida del Wiki. Lo projècte doc.oo.o cèrca a presentar las informacions dins aquesta seccion d'un biais accessible e a una estructura que permet la navigacion pels utilizaires e los contributors.

Totas las paginas Documentacion son pas de sospaginas de la pagina Documentacion principala, d'unas renvian cap a de sospaginas, d'autras cap a de ligams de la documentacion anglesa.

L'arborescéncia de la pagina OC/Documentation del wiki presenta pel moment :

wiki.services.openoffice.org/wiki/OC - | Projècte Documentation
   |
   +---Fièra de las Questions (FAQ)- - | OC/FAQ
   +---Manuals de l'utilizaire - - - - | OC/Documentation
   +---How-to- - - - - - - - - - - - - | OC/Documentation/How_Tos
   +---Documents extèrnes- - - - - - - | OC/Extèrne
   +---Cercar/Telecargar - - - - - - - | OC/Documentation
   +---Guidas d'administracion - - - - | OC/Documentation/Administration_Guide
   +---Guida de programacion BASIC - - | OC/Documentation/BASIC_Guide

Utilizacion de las categorias

Anatz veire aicí se sètz pas familièr de las categorias Wiki. D'autra part, podètz veire aicí meteis dins un guida de l'editor Wiki, en preparacion.

• Tota pagina deuriá aparténer a al mens una categoria.
• Incidentament tota pagina en occitan deuriá aparéisser dins al mens una categoria qu'aparten a la categoria OC.
  

Un exemple simple per utilizar de categorias dins un libre del Wiki :

1. Crear una categoria amb lo nom del capítol corrent.
2. Apondre totas las paginas d'aqueste capítol a la categoria creada.
3. Apondre lo nom d'aquesta categoria a la categoria del libre.

Atal, lo lector pòt veire la categoria del libre. Lo libre categoria indica totes los capítols del libre. Se lo lector clica sus un capítol (soscategoria), veirà totas las paginas dins aqueste capítol (per òrdre alfabetic). Vejatz per exemple lo Guida del desvolopaire (en)

Se una categoria 3 es soscategoria d'una categoria 2, ela meteissa soscategoria d'una categoria 1, cal pas etiquetar 1 a 3, perque 1 es ja supercategoria de 3 per l'intermediari de 2. Per mai d'entresenhas, consultatz la seccion MediaWiki Help:Category disponible Reflexions sus las Categorias.

Es possible, mas pas recomandat, d'utilizar de modèls per apondre una categoria comuna a un ensemble important de paginas. Aquò balhariá l'impression de ganhar de temps, mas l'apondon o la supression d'una etiqueta de categoria dins lo modèl apond pas, ni suprimís pas los listatges a o de la pagina Categoria de las paginas qu'utilizan aqueste modèl, fins a aqueste qu'òm edita una pagina qu'utiliza aqueste darrièr. Per d'autras informacions, vejatz la seccion MediaWiki Help:Category Utilizacion de gabarits per poblar de Categorias.
Proposicion de suprimir aqueste quadre e de lo remplaçar pel paragraf seguent (sus mesa a jorn de MediaWiki ?) :

Es possible, mas pas recomandat, d'utilizar de modèls per apondre una categoria comuna a un ensemble important de paginas. Mas cal saber lo fach seguent : Quand una pagina es etiquetada d'una categoria, sus salvament d'aquesta pagina totas las categorias existentas dins la pagina son mesas a jorn e lo reflècte es immediat. Mentre que dins lo cas d'un modèl l'informacion es mesa en amagatal e tractada segon la disponibilitat del servidor, aquò segon los cases (dixit Wikimedia), pòt prene d'oras o quitament dels jorns ! Çaquelà, se vos cal absoludament metre a jorn una pagina donada immediatament, una publicacion (lo boton Publicar) degun vos rendrà aqueste servici.

Utilizacion dels modèls Wiki

anatz veire aicí se sètz pas familièr dels modèls Wiki (mediawiki templates).

Se volètz crear de modèls novèls, nomenatz-los coma de sospaginas de OC/Documentation :

• Marrit : MonModèl
• Bon: OC/Documentation/MonModel

Modèles existents

Existís un jòc de paginas mai a jorn sus aqueste subjècte aicí.

Nom	Usatge	Exemple
Template:DocBanner
Template:Documentation/OC/EnCors		Aquesta pagina es en cors d'edicion
Template:Documentation/OC/Atencion		Fasètz pas jamais çò qu'es escrich aicí.
Template:Documentation/OC/PertinenciaVerificada		Aqueste article es estat verificat sus sa pertinéncia tecnica per Jòrdi Bòsc
Template:Documentation/OC/PrimierJet		Aquesta pagina es un primièr jet !
Template:Bar
Template:Documentation/OC/AjudaDemandada		Aqueste article a besonh d'ajuda ! Verificatz lo tèxte e l'ortografia
Template:Documentation/Hook
Template:Imported
Template:Documentation/LastEdited		Only works after update of mw engine to > 1.8
Template:Lin		{{{1}}}
Template:Documentation/MasterTOC
Template:Documentation/OC/EnEspera		Aqueste article a besonh d'èsser verificat sus sos aspèctes tecnics, de pertinéncia e/o d'estils.
Template:Documentation/OC/Nota		Informacion notabla
Template:OOoLogo
Template:Documentation/OC/PasPusValable		Aqueste article es pas pus valable.
Template:PDF
Template:OOo		Apache OpenOffice
Template:Documentation/OC/Astucia		Ensajatz aquesta astúcia.
Template:Documentation/*TOC
Template:Win		{{{1}}}

Contengut Grafic

Pels imatges, vaquí qualques principis generals :

1. Utilizatz la pagina de las descripcions dels imatges per precisar l'estatut legal de l'imatge e de son usatge.
2. Utilizatz una descripcion e un títol unic.
3. Se possible adaptetz pas lo format e la talha de l'imatge abans de lo mandar sul servidor, utilizatz la vinheta MediaWiki per far figurar l'imatge.
4. Editatz l'imatge se necessari per èsser segur de far pas aparéisser que çò important d'un biais clar e visible.
5. Gardatz a l'esperit que d'autras personas poirián traduire la pagina ont metètz un imatge. Ensajatz d'inclure pas de bullas d'afichatge o d'autre tèxte suplementari sus l'imatge.
6. Lo format JPG es generalament lo melhor adaptat per las fòtos, SVG, per d'icònas, lògos etc, e PNG per de capturas d'ecran. Dins la mesura de çò possible, utilizetz pas de BMP.

Es possible d'utilizar la foncion MediaWiki Image thumb per "emballar" vòstras illustracions dins un quadre per imatge. Aqueste quadre per imatge comprend un emplaçament per la legenda de l'imatge. La sintaxi es la seguenta [[Imatge:imatge.png|thumb|posicion|talha|Imatge caption]], ont :

• thumb = metre en vinheta l'imatge e l'inclure dins un quadre per imatge
• posicion = la posicion sus la pagina. "none" met l'imatge a esquèrra del quadre sens entrelaçament del tèxte. "left" e "right" met l'imatge respectivament a esquèrra o a drecha sus la pagina amb entrelaçament complet del tèxte.
• talha = la largor maximala en pixèls per l'imatge. Se l'imatge es mai grand qu'aquesta valor, es reducha a l'escala. Se l'imatge es mai pichon qu'aquesta valor, demòra incambiada.

Se declaratz pas ni posicion ni talha, l'imatge es transformat en vinheta pivhona, e se met per defaut a drecha de la pagina amb un entrelaçament complet del tèxte.

Un exemple d'utilizacion [[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]

An example image caption

Ligasons

Content on this page is licensed under the Public Documentation License (PDL).