Historique: Créer une page
Aperçu de cette version: 134
Avant-propos : vous trouverez ici des formulaires pour créer facilement de nouvelles pages de documentation wiki.
Table des matières
astuce
Il existe d'autres méthodes* pour créer une page, mais l'utilisation des formulaires ci-dessous est conseillée pour leur simplicité.
Conseils de remplissage et ajout d'infos
Voici quelques conseils liés au premier remplissage d'une page :
Nommer une page
Quelques règles de nommage d'une page :
- si elle se rapporte à un logiciel particulier, mettre le nom de ce logiciel dans le nom de la page, ex : "Installation de abgate"
- corollaire : si elle se rapporte à plusieurs logiciels particuliers, mettre le nom de ces logiciels dans le nom de la page, ex : "Utilisation de abgate avec jalv en ligne de commande"
- ne pas utiliser de caractères spéciaux autres que les espaces et les signes moins "-" dans le nom des pages car ceux ci ont tendance à mettre le souk
- pas de signe apostrophe "'" car il engendre un bogue qui empêche l'affichage des commentaires en bas de page (voir forumthread51450).
- les caractères accentués sont acceptés
- en bon français, la première lettre est une majuscule, les suivantes des minuscules. Exemple "Utilisation de abgate avec jalv en ligne de commande" et pas "Utilisation de abGate avec jalv en Ligne de Commande"
Introduis les concepts
Mets toi dans la peau de quelqu'un qui n'y connaît pas grand chose, tu dois lui expliquer un minimum ce que fait le logiciel avec des termes simples. Tu peux utiliser des liens et le glossaire pour cela.
Évite : Machpro est un VSTI autotuner.
Écrit plutôt : Machpro est un logiciel de correction de hauteur des sons au format VSTI.
Ne te contente pas d'une copie d'écran
Explique la démarche.
Évite : Lance Machpro avec Rosegarden **capture d'écran Machpro**
Écris plutôt : Lance Rosegarden, puis clique sur le bouton "Machpro" qui apparaît dans le menu fichier/greffon de Rosegarden. Machpro apparait : **capture d'écran Machpro**
Indique le lien de la page dédiée au logiciel
Quand tu parles d'un logiciel, mets-le entre double-parenthèse, cela aura pour effet de créer un lien interne vers sa page dédiée sur LinuxMAO.
Fait confiance aux autres
Une documentation commencée ne devrait pas contenir juste un lien vers la page du site (encore qu'il faille bien commencer par quelque chose). Tu peux par exemple ajouter un plan succinct, cela est généralement facile et permet aux autres contributeurs d'ajouter des informations.
Donne des indications pour favoriser les contributions : par exemple si tu n'as pas encore eu le temps de mettre des captures d'écrans, indique qu'à tel endroit figurera une image représentant telle fenêtre du logiciel. Quelqu'un d'autre pourra alors la rajouter. Même chose si tu souhaites de l'aide pour compléter une section, indique qu'à tel endroit, telle explication devrait figurer.
Tu peux également inscrire dans le forum La documentation et les nouvelles de LinuxMAO tes idées et projets pour telle ou telle page afin de motiver d'autres personnes à contribuer à cette démarche.
N'aie pas peur
Si tu n'es pas sûr(e) de ton orthographe, publie ton article comme tu le sens, en évitant toutefois le style SMS qui réduit un peu le périmètre de tes documentations et complique les corrections.
In French please
Ça n'est pas par chauvinisme, mais pour rendre ta documentation accessible au plus débutant et aussi pour respecter une certaine cohérence sur le site. Au besoin réfère-toi au glossaire de traduction Anglais-Français.
Évite : driver, plugin, package...
Écris plutôt : pilote, greffon, paquets...
Participe à l'intégration de la nouvelle page au reste du wiki
Une fois la nouvelle page créée, n'hésite pas à ajouter des liens sur celle-ci à partir de toutes les autres pages wiki en rapport avec elle pour lui donner de la visibilité.
Tu es aussi encouragé(e) à notifier la création de ta page dans le Journal des modifications du site, pour que les Administrateurs Wiki la repèrent plus facilement et l'ajoutent rapidement dans la structure de la documentation du site. Si tu penses savoir où devrait se placer la page dans le menu, précise-le à l'intérieur de la boîte "NOTE" en haut de la page. Par exemple :
Copy to clipboard
{NOTE()}((Page à intégrer)) dans le menu ((portail des logiciels)){NOTE}
* Il est aussi possible de créer une page en cliquant sur le point d'interrogation suivant un lien tel que Audacity - traitement par lot ou à partir de la liste des pages wiki (deuxième onglet).
Créer une page de logiciel
Vous n'avez pas les droits pour ajouter une fiche
Créer un autre type de page
info
Ce nom doit être le plus court et explicite possible sans caractères spéciaux (&~#{([-ù%^$£ê_\ç@)]=}"). Les e accentués é et è sont tolérés.
Exemples : "Instruments virtuels", "Manuel Ardour", "Debian Trixie pour la MAO"
Toute mention supplémentaire est à ajouter dans l'onglet Propriétés.
Vous n'avez pas les droits pour ajouter une fiche
Retrouver ta page
Il se peut que tu veuilles retrouver ta page plus tard et il se peut également que tu ne saches pas où chercher. Voici plusieurs pistes :
- immédiatement après la création et à ta prochaine connexion, tu pourras retrouver ta page sur la page d'accueil dans le bloc "Depuis votre dernière visite...". Cette possibilité de la retrouver disparaîtra vite, étant supplantée par d'autres nouveautés plus ... nouvelles !
- un autre moyen plus pérenne est d'aller jeter un œil sur cette page mais là aussi, au bout d'un certain temps (variable), elle ne sera plus présente ici.
- une méthode sûre (car avec elle, la page ne disparaît jamais) est d'aller regarder dans : menu du haut -> Mon LinuxMAO -> Mon LinuxMAO -> bouton "Mon profil" -> onglet "Contribution(s)" qui recense les pages auxquelles tu as participé et/ou que tu as créés.
- enfin, une méthode très simple consiste à repérer ta page en cours d'achèvement grâce au marques-pages situé au bas de la colonne de gauche des menus. Tu pourras rappeler la page par simple clic sur son libellé, dans cette même boîte.
Et si jamais tu es quand même perdu, viens en parler dans le 3 - Le site : philosophie, organisation, problèmes, .... où les habitués se feront un plaisir de t'aider.
[+]