====== Participer à la documentation du site Debian Facile.======

Vous voulez aider DF((Debian-Facile !)) en participant au WiKi ? \\
Quelle bonne idée ! :-) \\
Voici quelques informations pour vous indiquer comment faire.

===== Prérequis =====

==== Licence ====

Pensez à lire le paragraphe [[#contributions-et-licence | contributions et licence]] afin de vérifier que vous êtes en accord avec la politique de partage de la connaissance de DF. :-)

==== Créer un compte et se connecter ====

Pour contribuer au wiki, il suffit d'être membre df inscrit sur le forum.
===== Création et modification des pages =====

=== Contributions et licence ===

<note info>Toutes vos contributions à ce wiki seront placées sous les termes de la licence suivante : [[http://www.gnu.org/licenses/gpl-2.0.html | GNU General Public License 2]] et les droits d'auteurs seront partagés avec l'Association Debian-Facile. Elles ne pourront alors plus être retirées du Wiki sans bonne raison.</note>


==== Modifier une page existante ====

Comme sur le forum, les entretiens concernant le wiki se font sur le forum au post dédié pour le tuto à modifier (sinon le créer) et surtout pas par MP, (//s'péce d'égoïstes//) que tout l'monde en profite aussi ! :-D \\
Pour **maintenir un tuto sans modification** par d'autres contributeurs, on le signale dans la rubrique **Suivi :** de l'entête par le tag : **en-chantier**, tout simplement. :-)

Merci à tous de vos efforts pour ce wiki !


Avant de créer une page dans le wiki, __afin de ne pas créer de doublon__, vérifier TOUJOURS par une petite recherche qu'elle n'existe pas déjà. \\
Si la page existe, vous pouvez la modifier pour l'améliorer ou la mettre à jour. \\

<note important>Veuillez tout de même signaler les gros changements, comme une refonte complète de page, dans le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]]. \\
Les pages récentes du wiki disposent déjà d'un tel sujet signalé dans l'en-tête. \\
Si aucun n'est indiqué, vous pouvez en créer un nouveau dans cette section du forum (sans oublier de le reporter aussi dans l'en-tête **url** de la page du wiki).</note>

Si la page du Wiki n'existe pas //Taïaut//, créez-là dans le chantier ! \\
Voir ci-dessous :

===== Le chantier =====

Pour créer une nouvelle page allez dans la page [[atelier:chantier:]] et suivez les indications qui y sont portées.

===== Comment bien rédiger =====

==== Conseils et conventions ====

La rédaction des tutos est libre bien sûr. Voici tout de même une liste de conseils qui permettront une meilleure intégration et à faciliter le suivi de votre page.

Lors de la rédaction : 

  * faites simple et généraliste pour faciliter son adaptation aux futures versions de Debian
  * utilisez les balises <nowiki><code> <code user> <code root> etc.</code></nowiki>
  * évitez surtout les redites ou documentations en doublon, //c'est une plaie infâme lors des mises à jour// ! :-P

Merci également de suivre les conventions suivantes :
  * On utilise ''apt-get'' plutôt qu' ''aptitude'' autant que possible.
  * On n'utilise pas d' ''apt-url'', c'est tabou, c'est cruel, ça tue des chatons à coup de cuillère en bois.
  * On limite au maximum l'utilisation des dépôts externes à Debian, ou alors on avertis fortement des dangers de sécurité qu'ils entraînent.
  * On signale les mélanges de branches Stable/Testing/Sid par un encart Warning, parce que [[https://wiki.debian.org/fr/DontBreakDebian#Ne_pas_fabriquer_un_FrankenDebian|les FrankenDebian]], ça fait peur ;-) 

//N'hésitez pas à demander conseil sur le forum aux habitués !//


==== Syntaxe du wiki ====

Les pages du wiki se rédigent en syntaxe DokuWiki. \\
Consultez la page d'aide à la syntaxe et entraînez-vous ou testez vos écritures si besoin est dans le bac-à-sable.

  * [[syntaxe|La syntaxe de Dokuwiki]]
  * [[bac-a-sable | Le bac à sable pour vous entrainer à rédiger sur le Wiki]]

==== Insérer une image dans le wiki ====

Pour insérer une image dans le wiki, celle-ci doit impérativement être hébergée chez Debian-Facile car elle pourrait être retirée par son hébergeur à tout moment. \\
Assurez-vous aussi que cette image est sous GPL3 ou +. :-?

  * [[:atelier:insertion-image| Images dans le wiki]] La méthode pas à pas.

==== Créer une video-tuto pour le wiki ====
  * [[doc:systeme:debian-mini-tuto-video|Créer des mini-tuto-video]]

==== Tags et retours sur le forum ====

Pour assurer le suivi et la maintenance des tutos, nous utilisons deux canaux distincts :
  * Un sujet dans le forum pour les annonce, commentaires, retours et suggestions.
  * Un système de tag pour indiquer l'état du tuto aux modérateurs.

=== Retour sur le forum ===

L'en-tête des tutos contient la ligne suivante :
<nowiki>  * Commentaires sur le forum : [[:url-a-changer | Lien vers le forum concernant ce tuto]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))</nowiki>

Elle est destinée à recevoir le lien vers le sujet du forum permettant les retours. \\
Il vous revient donc de créer le sujet de votre tuto dans la section [[http://debian-facile.org/viewforum.php?id=26|DebianDocs(wiki) et Projet-df(git)]] du forum et de compléter l'url l'en-tête du tuto.

=== Tags ===

Pour faciliter le suivi d'un tuto, il est important de maintenir ses tags à jour. \\
On place les tags d'un tuto dans l'en-tête ou juste en dessous de la ligne de titre, via la syntaxe suivante :
<nowiki>  * Suivi : {{tag>en-chantier à-tester à-placer}}</nowiki>

S'il y a plusieurs tags, ils peuvent être listés séparés par des espaces :
  {{tag>mon-tag1 mon-tag2 mon-tag3}}

|  Pour marquer un tuto comme  |  rajouter le tag  |
|  À créer                     |  ''à-créer''      |
|  En chantier                 |  ''en-chantier''  |
|  À tester                    |  ''à-tester''     |
|  À placer                    |  ''à-placer''     |
|  À compléter                 |  ''à-compléter''  |
|  À corriger                  |  ''à-corriger''   |
|  Obsolète                    |  ''obsolète''     |

Par exemple, pour un nouveau tuto, il faut veiller à ce que soit présente la ligne complète :
  {{tag>en-chantier à-tester à-placer}}



===== Comment aider à améliorer le WiKi =====

Créer une page n'est pas le seul moyen d'aider le Wiki. Plus importante encore est la tâche de maintenir les pages existantes. \\
Pour voir l'[[:atelier:qa | état du wiki, c'est ici !]]
===== Statistiques sur le Wiki =====

Les statistiques du wiki sont (seront) accessibles ici : [[:atelier:stats]].

===== Arborescence =====

Pour les curieux mais à usage des modos principalement :
  * [[atelier:arborescence | L'arborescence du wiki expliquée pas à pas]].