Règles de rédaction [La Bible de NPDS]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Règles de rédaction ======
Vous souhaitez participer à la Bible de NPDS en partageant vos connaissances? C'est une merveilleuse idée ;-)

Cependant, dans le but de fournir une documentation homogène, il est important que vous lisiez (et respectiez) ces quelques consignes.

Bon amusement! :-D



===== Nom et titre des pages =====
Le nom des pages doit n’être long que d'**un seul mot**, sauf si c'est réellement insuffisant. \\ Ce mot doit être au **singulier**.

Chaque page doit commencer par un titre (balise H1, ''======''). Ce titre doit être explicite. Evitez d'utiliser des déterminants ou le nom de la catégorie dans laquelle la page se trouve.

===== Rédaction =====
Dans le but de rédiger une Bible valable, il faut que nous gardions une certaine homogénéité dans la rédaction. Inspirez-vous des pages déjà présentes.
  * N'hésitez pas à lire le [[:wiki:syntax|guide de la syntaxe wiki]]
  * Un tableau est souvent plus judicieux qu'une liste. [[:npds:historique:start|Exemple]]
  * Il faut structurer ses pensées. Certaines choses doivent êtres dites avant les autres et mises dans des sous-titres cohérents. [[:configuration:upload|Exemple]]
  * Quand on parle d'un fichier, on met toujours un / devant pour signaler qu'il est à la base de npds. [[:configuration:chmod|Exemple]]
  * A complèter

L'orthographe et la syntaxe sont des qualités appréciées.

===== Catégories =====
Sauf cas rares, toutes les pages sont mises dans des catégories (le coin des codeurs, configuration, forums, ...)

Chacune de ces catégories possède une page start contenant une description de cette catégorie et une liste vers les sous-catégories et pages dépendantes.\\
Si vous créez une nouvelle catégorie ou sous-catégorie, commencez par créer la page catégorie:start en vous inspirant des [[:configuration:start|pages déjà présentes]]

Il est dès lors **interdit de mettre des informations à la racine** de la Bible, c'est à dire sur la page start des catégories.\\
Il faut donc modifier une page existante ou [[publication:block-scroll-article|créer une page]] dans cette catégorie.

===== Liens =====
Lorsque vous créez un lien, par défaut il est relatif, ce qui signifie dans la même catégorie. 

Pour aller dans une autre catégorie, c'est-à-dire faire un lien absolu, il faut commencer par "deux-points" ('':'')

Par exemple, vous écrivez dans la catégorie [[:publication:start]] et vous voulez linker vers la page upload qui se trouve dans la catégorie configuration. Tapez donc
  [[:configuration:upload]]
Pour linker vers la première page d'une catégorie, il faut utiliser la page start. Exemple :
  [[:configuration:start]]


===== Les messages d'en-têtes =====
Ce wiki met à votre disposition plusieurs messages à mettre au début de votre page. Inscrivez le code en dessous du titre de votre page
==== Ébauche ====
{{message>ébauche}}
  {{message>ébauche}}

==== Brut ====
{{message>brut}}
  {{message>brut}}

==== A documenter ====
{{message>todo}}
  {{message>todo}}