Galette » Documentation

Je suis en train de relire et corriger la page about.

Appliquées, merci :)

J'ai ajouté un commit cc7aa367941154f55d12bc457892431200e2a0f1 (j'ai oublié de référencer le ticket...

Je ne suis pas certain sur le fonds de la correction apportée.
Il reste une option dans le fichier de configuration qui force la compilation en français (source:source/conf.py#L57).
En la supprimant, ça compile par défaut en anglais que j'utilise des locales fr ou en.

Je suis d'avis de supprimer l'option et de mentionner dans la note que sans paramètre de compilation particulier la doc est compilée en anglais :

By default, the ``make`` command will build the documentation in English.

Guillaume AGNIERAY a écrit :

Je ne suis pas certain sur le fonds de la correction apportée.
Il reste une option dans le fichier de configuration qui force la compilation en français (source:source/conf.py#L57).
En la supprimant, ça compile par défaut en anglais que j'utilise des locales fr ou en.

Ha ouais, bien vu ; j'avais omis ce paramètre... :/

Je suis d'avis de supprimer l'option et de mentionner dans la note que sans paramètre de compilation particulier la doc est compilée en anglais :

By default, the ``make`` command will build the documentation in English.

Ok pour moi :)

Guillaume AGNIERAY a écrit :

Johan Cwiklinski a écrit :

Guillaume AGNIERAY a écrit :

Je suis d'avis de supprimer l'option et de mentionner dans la note que sans paramètre de compilation particulier la doc est compilée en anglais :

By default, the ``make`` command will build the documentation in English.

Ok pour moi :)

Voici le patch à cet effet, avec un nettoyage d'autres paramètres de conf inutiles.

Merci.
Juste une question : es-tu sûr pour la suppression de la partie "locale" et les lignes suivantes (tout à la fin) ?

Johan Cwiklinski a écrit :

Juste une question : es-tu sûr pour la suppression de la partie "locale" et les lignes suivantes (tout à la fin) ?

Je ne suis pas sûr de bien voir de quoi tu parles (à part pour la grosse suppression à la fin) :/

• language (qui définissaient la langue de compilation par défaut pour l'html et l'epub ; c'est plus logique de compiler par défaut dans la langue d'origine de la doc, et ça reflète la modif correspondante dans le contenu),
• man pages (à moins que tu veuilles aussi que ce format soit prévu),
• pdf (qui n'ont rien à voir avec latexpdf, mais plutôt avec rst2pdf je suppose).

Les paramètres que tu avais ajoutés pour l'internationalisation de l'ensemble de la documentation à la fin du fichier ont été remontées et commentées plus haut entre la conf globale et la conf html.
Ça pose problème pour la compilation sur rtd ?

Mon dernier patch ne fait rien d'autre sinon.

Est-ce que ça répond bien à ta question ? :)

Guillaume AGNIERAY a écrit :

Les paramètres que tu avais ajoutés pour l'internationalisation de l'ensemble de la documentation à la fin du fichier ont été remontées et commentées plus haut entre la conf globale et la conf html.

C'est de ça dont je parlais, je n'avais pas vu qu'ils étaient plus haut... Je dois commencer à fatiguer :D

Patch appliqué, merci ;)

Tu es certain de vouloir fermer cette tâche et ne pas la laisser à résolu le temps de la relecture ?
Perso, je n'ai relu que la page "about" et rien d'autre pour le moment dans cette partie de la doc.