[RÉSOLU] Accès à la dernière documentation sur darktable.fr

[manu]

Bonjour, sur le site darktable.fr le lien à la Documentation > Manuel d'utilisation donne accès à la version 3.8. 

S'il n'est pas possible, comme pour d'autres logiciels, d'avoir un accès à la dernière version, latest étant souvent utilisé dans ce cas à la place du numéro de version dans l'URL (peut-être un simple lien symbolique ?), est-il envisageable de mettre à jour ce lien ?

C'est à dire https://docs.darktable.org/usermanual/4.8/fr/ (en attendant la version 5.0) à la place de https://docs.darktable.org/usermanual/3.8/fr/
(ou https://docs.darktable.org/usermanual/latest/fr/ ce qui serait encore mieux, donc).

Sans parler que quand on clique sur le ? dans dt 5.0 puis un module, ça renvoie vers un 404, mais c'est une autre affaire... encore que. 

[jpverrue]

Bonjour @manu.
J'ai fait la modif pour la version 4.8. Elle devrait apparaître demain.
J'ai regardé sur le site https://docs.darktable.org/usermanual mais le lien "latest" n'existe pas, je ne peux donc pas renvoyer vers celui-ci (dommage).

Quant au second problème soulevé, je viens de tester et je n'ai aucun problème. Le clic sur '?' puis sur un entête de module m'amène bien à la documentation du module. Précision, l'URL de cette page de documentation n'a aucune référence de version.

Par contre, la vérification de ton second point m'amène à penser que je peux régler le problème du numéro de version pour le lien du blog. En effet, en affichant l'aide d'un module, on obtient un lien 'neutre' et aussi le menu complet de toute la doc sur la gauche. En récupérant l'URL et en l'éditant un peu, on obtient ceci : https://docs.darktable.org/usermanual/development/fr/ qui est certes la version en cours d'écriture/traduction de la doc, mais qui pourrait tout à fait convenir comme URL permanente.

Un avis ?

[manu]

J'ai fait la modif pour la version 4.8. Elle devrait apparaître demain.
J'ai regardé sur le site https://docs.darktable.org/usermanual mais le lien "latest" n'existe pas, je ne peux donc pas renvoyer vers celui-ci (dommage).

Merci !

Mais justement, en suivant ton lien vers https://docs.darktable.org/usermanual et de là vers https://github.com/darktable-org/dtdocs?...me-ov-file je lis :

The user manual for the current stable release of darktable can be found at darktable.org.

Et là... BINGO ! ce lien sur darktable.org pour la version stable du manuel utilisateur est https://docs.darktable.org/usermanual/stable/en/ qui, si tu le suis, t'amène à la version... 4.8 qui est bien la dernière stable existante (en attendant la 5.0).

Autrement dit, pas besoin de latest mais juste utiliser cet URL (qui peut finir en /fr/ pour les francophones).

Quant au second problème soulevé, je viens de tester et je n'ai aucun problème. Le clic sur '?' puis sur un entête de module m'amène bien à la documentation du module. Précision, l'URL de cette page de documentation n'a aucune référence de version.

Par contre, la vérification de ton second point m'amène à penser que je peux régler le problème du numéro de version pour le lien du blog. En effet, en affichant l'aide d'un module, on obtient un lien 'neutre' et aussi le menu complet de toute la doc sur la gauche. En récupérant l'URL et en l'éditant un peu, on obtient ceci : https://docs.darktable.org/usermanual/development/fr/ qui est certes la version en cours d'écriture/traduction de la doc, mais qui pourrait tout à fait convenir comme URL permanente.

Étonnant... Nous n'avons peut-être pas la même version de dt (OBS pour Ubuntu 22.04 me concernant), je viens de reproduire ce que je décrivais, et voilà ce que j'obtiens quand je demande la doc du module styles dans la table lumineuse : https://docs.darktable.org/usermanual/5....e-controls

Pour le lien que tu proposes, tu n'as qu'à remplacer development par stable et ça devrait marcher pour la dernière version stable de la doc...

[jpg54]

Merci Jean-Pierre et tous mes vœux pour l'an neuf.

[zakfm]

Bonjour,

Comme le dit manu :

Étonnant... Nous n'avons peut-être pas la même version de dt (OSB pour Ubuntu 22.04 me concernant), je viens de reproduire ce que je décrivais, et voilà ce que j'obtiens quand je demande la doc du module styles dans la table lumineuse : https://docs.darktable.org/usermanual/5....e-controls

Sur mon portable avec la version stable 5.0 l'aide m'envoie sur une page 404.
Sur mon PC de bureau avec la master 5.1, l'aide fonctionne bien avec des réponses en français ou en anglais suivant l'ancienneté des modules naturellement.

[manu]

Oui, sur la version master ça doit pointer vers la doc develop, non ?

[zakfm]

Certainement.
Par exemple dans la version master, l'aide existe en anglais pour color equalizer.
Alors que dans le manuel 4.8, il n'y a rien évidemment sur ce module très récent et génial.

[jpverrue]

Oui, le problème doit venir de là, car je suis en 5.1 (plus exactement 5.1.0+19~gf2352efd98) d'où l'URL 'develop'.

Je refais une PR avec le lien sur stable. Merci pour la recherche !

[manu]

Oui, le problème doit venir de là, car je suis en 5.1 (plus exactement 5.1.0+19~gf2352efd98) d'où l'URL 'develop'.

Je refais une PR avec le lien sur stable. Merci pour la recherche !

Merci ! Celles et ceux qui viendront sur le site y chercher la documentation auront ainsi accès directement à la dernière version stable, sans devoir bidouiller l'URL dans la barre d'adresse de leur navigateur... pour celles et ceux qui savent le faire !  

[jpverrue]

Petit cadeau pour la nouvelle année : ça fonctionne ce matin ! Pensez cependant à rafraichir le cache de votre navigateur.