É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 va mettre à 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 un aperçu local, vous convertissez (construisez) les fichiers sources RST du manuel en pages web HTML.

Mise à jour

Tout d’abord assurez-vous que votre copie locale du manuel est à jour avec le dépôt en ligne avec la commande suivante :

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.

Veuillez consulter le /about/contribute/style_guides/writing_guide pour les conventions et le /about/contribute/style_guides/markup_guide pour apprendre à écrire dans le langage à balises reStructuredText.

Bonne écriture !

Des modifications plus importantes

Si vous êtes sur le point d’ajouter ou de réviser une section, veuillez vérifier soigneusement qu’elle n’existe pas déjà. Dans certaines parties, les docs sont si désorganisés que les sections peuvent être dupliquées ou dans un emplacement étrange. Dans le cas où vous trouvez une section dupliquée ou pas à sa place, créez une tâche expliquant le problème, et accessoirement joignez-y une révision (modifications actuelles).

Avant toute édition qui n’est pas simple et pleinement justifiée (par exemple, déplacer des dossiers), vous devriez vérifier avec un mainteneur du manuel que votre contribution s’accorde avec la vision du manuel de la communauté. Ceci assure la meilleure utilisation de votre temps et votre bonne volonté, étant donné qu’il est possible que, pour quelque raison, vos modifications seront en conflit et rejetées ou nécessiteront une revue 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.

Une communication précoce et fréquente est la clé pour avoir un environnement productif, pour ne pas gâcher l’effort des contributeurs et atteindre l’objectif d’un 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 demander 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 des domaines Blender assignés. Voir la page des responsables de modules pour plus d’informations.

Prévisualisation

Pour visualiser vos modifications, construisez le manuel comme décrit ici. Gardez à l’esprit que vous pouvez construire uniquement le chapitre que vous venez d’éditer pour le visualiser rapidement. Ouvrez les fichiers .html générés dans le dossier build/html avec votre navigateur web, ou actualisez la page si vous l’avez déjà ouverte.

Téléversement

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.