Hi Osamu, Osamu Aoki <[email protected]> wrote (Wed, 24 Jun 2026 14:08:02 +0900): > Control: tags -1 help > > Hi, > > This is an Interesting proposal which require good thought over how to be > implemented. > > * URL choice: > - > https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html > (proposed > ) > - https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html > [1] (more stable over release)
You can also use stable in the URL as in https://manpages.debian.org/stable/systemd/systemd-networkd.8.en.html That will redirect you to the trixie page: https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html So that's as solid over releases as the unstable variant. > > *Changing English XML directly for all manpage references is a very cumbersome > task and breaks translation. > - adding such links using script without changing English original RAWXML > files is the desirable implementation. > FROM: <literal>systemd-networkd</literal>(8) > TO: <ulink > url="https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html";>?? > ???(?) </ulink> > > Challenge: it is non-trivial to identify package name "systemd" here from the > English text. > > $ apt-file find systemd-networkd.8 > manpages-de: /usr/share/man/de/man8/systemd-networkd.8.gz > systemd: /usr/share/man/man8/systemd-networkd.8.gz > > I suppose skip all manpages-?? packages as There is no need to determine the package name. Just link to https://manpages.debian.org/unstable/systemd-networkd(8) and it will auto-magically redirect you to https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html ;-) We also do this in the Debian release-notes exactly like this BTW. > > Since I don't want to break existing translation, I am not going to manually > edit English text and wait until someone create such fillter. > > TASKS to do: > * extranct candidates for manpages > * identify paclage name for each manpage see above. no need for this second task. > * replace matching part just before building HTML etc. Holger -- Holger Wansing <[email protected]> PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
