Contribuer

Sommaire

  1. Proposer un article
  2. Charte rédactionnelle
    1. Les Sections
    2. Structure de l'article et conseils
    3. La forme
      1. Syntaxe
      2. Les balises acceptées
      3. Le code
    4. Les images
    5. Licence

Proposer un article

Pour contribuer il n'est pas nécessaire d'avoir un compte Jabber. Nous acceptons vos articles par courrier électronique. L'identification jabber vous permet d'avoir un compte sur le site et de poster directement vos articles à partir de votre navigateur. L'identification jabber apporte aussi bien d'autres avantages, pour les découvrir reporter vous à la page dédiée.

N'hésitez pas à contacter l'équipe d'éditeur par courriel ou sur jabber pour savoir si un paquet à déjà fait l'objet d'un article en attente de publication.

L'équipe du site a écrit une charte rédactionnelle. Vous êtes invité à la lire et à la respecter pour soumettre un article sur le site.

Charte rédactionnelle

Vous trouverez dans les paragraphes suivant les informations nécessaires pour écrire une article, tant sur le fond que sur la forme. Si néanmoins vous avez des questions veuillez contacter l'équipe des éditeurs par courrier électronique à l'adresse suivante : editeur@…

Les Sections

Trois sections sont ouvertes aux contributions :

  1. Paquet : Tout paquet de la section « main » des dépôts officiels de Debian peut faire l'objet d'un article.
  2. Script : Un script que vous voulez partager avec la communauté. Assurez vous que ce script fonctionne sur Debian et ne nécessite que des paquets logiciel du dépôt « main ».
  3. Home-rc : Tout fichier de configuration de l'espace utilisateur. C'est à dire les fichiers présents dans $HOME (.procmailrc .vimrc .bashrc .emacs). Il s'agit dans cette section de présenter des configurations personnalisées, des « hacks » ou encore des options peu connues.

Nota bene :

Les articles du site ne sont pas des tutoriels ou des guides d'installation. Par ailleurs nous considérons que les lecteurs sont des utilisateurs avancés, éviter donc de préciser les actions et commandes les plus triviales (commandes shell, édition, installation etc...).

Pour la présentation d'un paquet Debian, contentez vous de présenter les fonctionnalités et l'intérêt du logiciel. Quelques aspects de configuration peuvent être présentées dans la mesure ou elles éclairent l'utilisateur quant au potentiel du programme (e.g. présentation de bc sur debaday).

Il en est de même pour la section Home-rc. Il s'agit, dans cette section, de présenter des astuces de configuration et non de faire un présentation exhaustive du paramétrage d'un logiciel dans l'espace utilisateur.

Structure de l'article et conseils

Le titre avec le nom du paquet/script suivi d'une courte description en 10~15 mots. Par exemple :

  • screen : un multiplexeur de terminaux.
  • xplanet : Un outils de rendu d'images des principaux astres du système solaire.
  • parefeu : Pare-feu manuel dans /etc/init.d

Une introduction dans laquelle il serait préférable de ne pas répéter la description officiel (pour ce qui est des paquets, du moins). L'introduction doit permettre aux lecteurs de savoir si ils vont lire ou non l'article. De quoi s'agit il ? un éditeur de texte, un jeu, une application propre à KDE/Gnome.

Dans la description employez votre verve à séduire le lecteur afin de l'amener à taper un « aptitude install <paquet> » ! Décrivez le paquet/script plus en détail. Pour les fichiers des configurations décrivez les fonctionnalités spéciales qui sont utilisées et/ou les hacks que vous avez mis en place, bref ce qui sort de l'ordinaire. Insérez des captures d'écrans ou de fenêtres quand il s'agit d'un programme avec une interface graphique ou si cela est nécessaire pour présenter les fonctionnalités du paquet (art ascii par exemple). Pourquoi ce paquet et pas un autre qui fait exactement la même chose ? A t-il de lourdes dépendances ? Le paquet est il bogué ? Si c'est un jeu, pensez à donner des indications pour un démarrage rapide, ainsi les lecteurs impatients pourront se lancer dans le jeu sans passer par la case manuel ! Essayez de ne pas appeler le troll de service dans les articles, restez un minimum objectif, les commentaires seront là pour débattre si il y a lieu :).

Dans la conclusion indiquez les liens vers les ressources et la documentation en ligne, la disponibilité des paquets en fonction des version de Debian (stable, testing etc…). Des références pour des paquets similaires.

La forme

Écrivez français ! La plupart de termes spécifiques de la terminologie informatique existent en français. Reportez vous au lexique Debian (entre autres) : http://www.debian.org/intl/french/lexique. Jeux de caractères

Le jeu de caractère utilisé est l'UTF-8. Respectez au mieux la typographie française : http://www.debian.org/intl/french/typographie. Pour aller plus loin, consultez Les Petites leçons de typographie de Jacques André.

Syntaxe

La mise en forme des articles se fait en xhtml, seules certaines balises et attributs sont sponibles. Si vous ne connaissez pas le xhtml envoyez du texte brute non formaté.

N'utilisez pas d'éditeur html WYSIWYG tel que nvu, open office ou abiword.

Les balises acceptées

  • balises : a acronym blockquote br code em img li p pre strong ul
  • attributs : abbr alt cite class height href hreflang id lang longdesc span src title width
  • protocoles : ftp http https mailto xmpp
  • attributs acceptant une URL : href src

Le code

Le moteur pygment (http://pygments.org/languages/) est utilisé pour la coloration syntaxique du code. Lorsque vous insérez du code veillez préciser le langage dans l'attribut class de la balise code : <code class="language">.

Les images

Licence : L'ensemble du site et a fortiori les articles seront couverts par la licence GNU/GPL. Veillez à respecter cette licence lorsque vous incluez des images aux articles.

Les captures : Les captures d'écran devraient se limiter à l'information utile seulement, c'est-à-dire une capture de la fenêtre avec le programme et pas tout le bureau.

Format des images : Le format png est à privilégier.

Éthique : Évitez absolument toutes images à contenu discriminatoire ou provocateur. Les images sexistes, racistes ou choquantes ne regardent que vous et votre fond d'écran, évitez de vous en servir pour illustrer vos articles.

Licence

Le site est couvert par la licence générale publique GNU version 3.