Édition du manuel¶
Vous pouvez modifier le manuel en éditant les fichiers textes locaux. Ces fichiers sont synchronisés avec ceux en ligne via un dépôt, le serveur mettra à jour le manuel en ligne.
Ce manuel est écrit dans le langage de balisage reStructuredText (RST) et peut être édité en utilisant un éditeur de texte brut. Pour une prévisualisation locale, vous convertissez (construisez) les fichiers sources RST du manuel en pages web HTML.
Mise à jour¶
Firstly, make sure that your local copy of the manual is up to date with the online repository using:
svn update
Écriture¶
Vous pouvez éditer les fichiers de documentation, qui sont les fichiers .rst dans le dossier manual avec un éditeur de texte de votre choix.
Be sure to check the Guide de style d’écriture for conventions and Guide de style de balisage to learn how to write in the reStructuredText markup language.
Bonne écriture !
Des modifications plus importantes¶
If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create a task explaining the issue, and optionally include a revision (actual changes).
Avant toute édition qui n’est pas simple et pleinement justifiée (par exemple, déplacer des dossiers), vous devez vérifier avec un mainteneur du manuel que votre contribution s’accorde avec la vision du manuel par la communauté. Ceci garantit la meilleure utilisation de votre temps et de votre bonne volonté, étant donné qu’il est possible que, pour une raison quelconque, vos modifications soient en conflit et soient rejetées ou nécessiteront un examen chronophage. Par exemple, une autre personne pourrait être déjà en train de travailler sur la section que vous voulez modifier, la section peut être programmée pour une suppression ou une mise à jour selon une modification planifiée de Blender.
Communiquer tôt et fréquemment est la clé pour avoir un environnement productif, pour ne pas gaspiller les efforts des contributeurs et pour atteindre l’objectif du meilleur manuel de Blender.
Pour de l’aide et des réponses¶
Si vous avez un doute sur une fonctionnalité que vous voulez documenter, vous devriez poser vos questions aux développeurs de Blender en charge de ce domaine ou présenter votre demande sur le canal de support utilisateur non officiel dans le canal #docs ou #blender-coders dans Blender Chat.
Blender a son propre système de responsables de modules avec des membres développeurs et artistes qui sont en charge de la conception et de la maintenance de domaines Blender qui leur sont assignés. Voir la page des responsables de modules pour plus d’informations.
Preview¶
To view your changes, build the manual as instructed.
Keep in mind that you can also build only the chapter you just edited to view it quickly.
Open the generated .html files inside the build/html folder using your web browser,
or refresh the page if you have it open already.
Upload¶
Quand vous êtes satisfait de vos modifications, vous pouvez les téléverser, ainsi elles figureront dans le manuel en ligne. Au début, ceci est réalisé en soumettant des patches, ainsi quelqu’un peut réviser vos modifications et vous en donner un retour. Après, vous pourrez soumettre vos modifications directement. Cette procédure est décrite en détail dans la section suivante.