Avant-propos : cette charte documentaire est là pour entretenir une cohésion rudimentaire sur le site.
Table des matières
Pseudo-règles de nommage des pages
Ba oué, c'est pas vraiment des règles, mais bon, c'est bien mieux si tout le monde le fait !
Chaque page créée doit porter les noms de l'objet concerné et de sa fonction. Par exemple :
- Pour le manuel d'Ardour 3, le nom de la page en question sera Ardour 3 - manuel.
- Pour la page des fonctions avancées d'Ardour 3 : Ardour 3 - fonctions avancées.
Les avantages : une meilleure organisation dans la liste des pages wiki (ou dans le panneaux d'administration des pages), toutes les pages de chaque logiciel sont regroupées (ordre alphabétique) donc simplicité et clarté !
Indiquer que la page est en cours de rédaction
Vous pouvez indiquer que vous êtes actuellement en train de travailler sur une page grâce à ce bout de code :
code :
^__Page en cours de germination__ Lien vers la discussion dédiée à l'écriture de la page dans le [forum8] {userlink user="olinuxx"} (le XX-YY-2016) Admin wiki : ((Page à intégrer))^
rendu :
Page en cours de germination
Lien vers la discussion dédiée à l'écriture de la page dans le forum8
olinuxx (le XX-YY-2016)
Admin wiki : Page à intégrer
Lien vers la discussion dédiée à l'écriture de la page dans le forum8
olinuxx (le XX-YY-2016)
Admin wiki : Page à intégrer
Mettre un lien vers un forum de discussion dédié à l'écriture de cette page permet de travailler collectivement.
Noter qui vous êtes permettra aux autres de vous contacter.
La date permet de voir si la page est à l'abandon ou si l'écriture est effectivement en cours.
La ligne pour les admins wiki leur permet de ne pas oublier que cette page sera à intégrer dans la documentation.
Comment faire une belle image en seulement quelques clics ?
Vous ne savez pas quoi utiliser pour faire des captures d'écran ? Facile,
- en premier lieu, la touche Imp écran sur votre clavier rempli souvent cette fonction,
- Pour gnome, utilisez la commande
gnome-screenshot --interactive
Vous pouvez aussi éditer les raccourcis (système>préférence>raccourcis) pour qu'elle soit automatique en appuyant sur une touche de votre choix) - vous pouvez aussi utiliser directement GIMP pour cela (Fichier/Créer/Capture d'écran),
- ou ksnapshot qui permet lui de capturer la fenêtre sans la bordure de décoration,
- celles et ceux qui ne veulent pas alourdir leur système de dépendances inutiles, mais qui souhaitent malgré tout faire des captures d'écran de leur studio regarderont du côté de xv (voir aussi : http://www.sonic.net/~roelofs/greg_xv.html),
- Shutter, un petit outil très pratique pour prendre des captures et les éditer. http://shutter-project.org/downloads/third-party-packages/.
- Les ombres : si vous envoyez des copies d'écran pour vos pages, mettez-leurs une ombre portée avec GIMP, bouton droit sur l'image et Filtres/Ombres et Lumière/Ombre portée sans toucher les paramètres.
- Si vous voulez mettre en valeur une partie de votre image, dans GIMP : Filtre puis Rendu puis Figure géométrique (Gfig). À noter que si vous faites une ombre portée tout de suite après, elle sera appliquée sur votre mise en valeur (cercle, carré, ...). Et c'est drôlement chouette à voir !
- Pour insérer votre belle image dans une page wiki, allez lire ce paragraphe.
L'orthographe
N'ayez pas peur
Si vous n'êtes pas sûr de votre orthographe, publiez des articles comme vous le sentez, en évitant toutefois le style SMS qui réduit un peu le périmètre de vos documentations et complique les corrections.
Règles orthographiques
Ce paragraphe n'est pas un cours d'orthographe mais relève les fautes fréquemment rencontrées dans ce site et qui ont été corrigées. Il devrait donc permettre à ceux qui font certaines fautes ou qui ne sont pas au courant d'un particularisme de gommer leurs petites imperfections d'écrivain.
Contributeurs de LinuxMAO : certains navigateurs (comme Firefox ou Konqueror) contiennent un correcteur orthographique, celui-ci marche pour le wiki et les forums, et tous les formulaires d'une façon générale. Tip-top !
Orthographe pure
- Question: Doit-on écrire "des pistes audios" ou "des pistes audio" ?
Pareil pour des pistes midis ?? Ça me paraît énorme.
Il semblerait que ce soient des raccourcis de langage en référence à "des pistes de type audio" et "des pistes de type MIDI". Le second mot n'est pas un adjectif et les deux mots ne forment pas un nom composé, il convient de ne pas accorder le second.
NB: "MIDI" est un acronyme (pour "Musical Instrument Digital Interface"), il doit être écrit en majuscules par convention et ne peut donc absolument pas être écrit au pluriel !
Anglicismes
La MAO sous linux contient souvent un gros tas d'anglicismes. Vous pouvez vous aider du glossaire de traduction du site qui est axé sur les termes en audio-numérique pour vous aidez à les débusquer.
Typo
- : après deux points pas de majuscule
- Les signes de ponctuation double doivent habituellement être précédés d'une espace insécable et suivis d'une espace simple. Cela permet d'éviter les retours de ligne automatiques juste avant ces signes de ponctuation. Dans Tiki, la syntaxe ~hs~ permet d'insérer une espace insécable.
- Les acronymes doivent s'écrire en majuscules : MIDI, JACK, VST, LADSPA, DSSI, ...
Liens pour l'orthographe
- Un fil de discussion amusant pour réviser quelques règles : http://forum.hardware.fr/hardwarefr/Discussions/Cours-francais-Lecon-D-ores-deja-sujet-19265-1.htm.
- Le site d'information sur la nouvelle orthographe française officiellement recommandée : http://www.orthographe-recommandee.info/.
- La page de téléchargement des dictionnaires pour le correcteur orthographique intégré dans Firefox : https://addons.mozilla.org/firefox/dictionaries/?lang=fr.
- La page de Wikipédia sur la typographie : http://fr.wikipedia.org/wiki/Typographie.
Divers
Conversion de format HTML<->Tiki
Voir :
- http://cpansearch.perl.org/src/DIBERRI/HTML-WikiConverter-TikiWiki-0.50/README.
- http://www.txt2tags.org/.
Astuces
Voir aussi le guide d'édition wiki pour découvrir les bases de la syntaxe Tiki utilisé sur le site LinuxMAO.
Si vous vous posez une question à propos de ceci, rendez-vous dans le forum : "Le site : philosophie, organisation, problèmes, ..." afin de discuter ensemble.
[+]