Jump to content

Projecte:Ajuda de DP

From mediawiki.org
This page is a translated version of the page Project:PD help and the translation is 53% complete.
Project:PD help is a project to create a set of concise user help pages for MediaWiki users, i.e. for visitors to a website which is powered by MediaWiki.

The project covers all content in the Help namespace. The main entry point for this is Ajuda:Continguts .

This help documentation is separate from the Manual (the GFDL and CC BY-SA-licensed MediaWiki administrator's manual). Contributors, please be clear about the differences! The PD help pages do not contain information for server administrators, about how to install, configure, or maintain MediaWiki software. See the 'Goal' section below, for a detailed statement of what we are trying to achieve.

  Please do not copy and paste content from Meta-Wiki's Help pages in here. They were written under the GFDL and CC BY-SA licenses and are not in the public domain.

Objectiu

L'objectiu és proporcionar un conjunt de pàgines, que es poden copiar en una nova instal·lació wiki o incloure a la distribució MediaWiki. Això inclourà informació bàsica de l'usuari, juntament amb altra informació de Meta, en una forma raonablement concisa. El concepte bàsic és crear una "Guia d'usuari" comprimida, no una obra de referència. Hauria de centrar-se en el que els usuaris volen i no explicar altres funcions.

Llicència

Les contribucions a Ajuda de DP es publiquen com a domini públic a través de l'exempció CC0. Això és necessari per permetre als usuaris copiar fàcilment el text en les seves pròpies instal·lacions wiki. Si us plau, assegureu-vos d'entendre el següent abans de contribuir:

  • Cada pàgina d'Ajuda de DP ha de contenir la línia {{PD Help Page}} per indicar la llicència.
  • No es pot copiar contingut d'altres llocs en aquestes pàgines. Les úniques excepcions són:
  1. El contingut que s'està copiant és personal vostre (p. ex. l'autor), o bé heu documentat el permís de l'autor/s original/s.
  2. El contingut que ja es troba en Domini públic s'hi pot copiar; tanmateix, això NO inclou la majoria de pàgines web publicades!
  • Esteu cedint tots els drets a la informació que contribueix a aquest treball. Encara que continuareu tenint les vostres contribucions llistades i atribuïdes en aquest lloc, altres poden copiar el text sense donar cap referència de l'autoria i poden modificar-lo com considerin oportú.

Lectors de destinació: Usuaris normals

Les pàgines d'ajuda estan molt dirigides als visitants normals d'un lloc web wiki.

No pels administradors del servidor

No pretenem duplicar la documentació completa de MediaWiki. La informació dirigida als administradors del servidor, detallant la instal·lació, configuració o manteniment de MediaWiki, pertany al Manual.

L'excepció només petita a això, són les caixes "Consells d'administració" (descrites a continuació).

Informació menys destacada per a administradors del sistema i usuaris buròcrates

Les pàgines d'ajuda no estarien completes sense descriure també què poden fer els administradors del sistema. Tanmateix, aquestes funcions avançades no estan disponibles per a la majoria del públic objectiu (la majoria dels usuaris d'un wiki). Per tant, aquesta informació s'ha de mantenir lleugerament separada de la majoria dels continguts, de manera que els usuaris normals no es trobin amb informació que no és rellevant per a ells.

Dins de la major part de les pàgines d'ajuda, es poden considerar necessàries breus mencions de les accions que requereixen privilegis de sistema; però, les descripcions detallades dels procediments dels administradors del sistema s'haurien d'amagar en pàgines amb enllaços menys destacats o s'haurien de deixar fora de les pàgines d'ajuda.

Aquesta secció està en debat.

Directrius

  • Create links between the pages, but avoid linking to other namespaces on MediaWiki.org. Keep the links internal to the public domain help pages, or make external links (full URL) to relevant resources, e.g. on meta.wikimedia.org. This is to facilitate easier copying of the text into fresh wiki installations. Do not use interwiki links, as these may not exist in the target wiki.
  • We probably don't want to swap in the {{SITENAME}} syntax anywhere. MediaWiki is the name of the software we are describing. This is the Content Management Software (CMS), that enables the destination wiki to run, so anywhere where our text is referring to the software (everywhere throughout help), it should be left as a literal string "MediaWiki". If, for some reasons, the help text is mentioning the name of the site, then this would be an appropriate exception (use {{SITENAME}}). However, we are not going to swap this in everywhere we mention the word MediaWiki.
  • Translations should be done after the English version of a page has reached a stable status. The naming convention is Pagetitle/language-code (e.g. Help:Editing/pt).
  • Unless you have the perfect solution for navigation in this manual, please refrain from creating navigation templates, and focus content creation first.
  • Do not use extensions such as Cite, since they are not installed on all MediaWiki installations.

Formatting

  • Formatting should be consistent. Use class="wikitable" for any tables you create, highlight cells or rows with {{Hl1}} etc.
  • All wiki markup and code should be put in ‎<code> or ‎<pre> tags. Help for inserting: {{subst:nw|text}}.
  • All references to menu texts and descriptions should appear in italic.

Screenshot images

Screenshots are useful. PD help pages do not have to contain only public domain screenshots (although trademarked logos must not be included). Screenshots should be uploaded to Wikimedia Commons and use the {{MediaWiki screenshot}} license template.

Images can be shipped with the documentation or accessed from Commons with InstantCommons .

Admin tips

If something in Help can be configured by a server administrator, you may insert an 'admin tip' with {{Admin tip }}.

Category

All pages in the "Help:" namespace are, by definition, part of this public domain Help documentation project and should be categorized Categoria:Ajuda . Help pages for MediaWiki extensions, should be categorized in its subcategory Categoria:Ajuda de les extensions .

The former category for pages in the "Help:" namespace, this public domain Help documentation project, was Category:PD help. In keeping with simplicity, the category is now simply Categoria:Ajuda and all pages have been updated.

See also

  • Project:Language policy  – If you are interested in working on non-English versions of the help pages.
  • Project:PD help/export  – Discusses a proposed method of creating usable dumps of the Help: namespace. This is still at the discussion stage and is not yet functional.