Hi, RL <richard.lewis.deb...@googlemail.com> wrote (Sat, 20 May 2023 12:52:25 +0100): > Holger Wansing <hwans...@mailbox.org> writes: > > > However, I may have some objections against the migration at all: > > as far as I know, sphinx/reStructuredText is still lacking some > > functionality, > > which is heavily used in the release-notes. > > That is the use of substitutions within URLs. > > In docbook speach these were entities, and you could use them in URLs like > > this: > > > > Please follow the instructions in the <ulink > > > > url="https://www.debian.org/releases/&oldreleasename;/releasenotes";>Release > > Notes for &debian; &oldrelease;</ulink> to upgrade to &debian; > > &oldrelease; first if needed. > > > > Please note the &oldreleasename; in the URL! > > I could not get this working with sphinx (if someone knows better, please > > contact me!) > > No idea about sphinx, but we could we just run a simple sed script to update
That will not work. You cannot replace all 'bullseye' by 'bookworm' for example. There are places, where the 'bullseye' needs to stay. So that needs to be done selective one-by-one. > i've submitted several patches to release notes, and found the use of > entities and XML more confusing than helpful (especially '&debian;' for > 'Debian') - this is meant to be a document for people, and needs a > decent proof-read anyway. I dropped that &debian; entity already in Sphinx for the release-notes :-) Holger -- Holger Wansing <hwans...@mailbox.org> PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
