Hi, 2023-05-20 23:36 CEST, Holger Wansing: > 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.
Maybe the idea was to introduce %OLD_RELEASE_NAME% and to call sed to replace this kind of strings in a build step, and not rely on sphinx substitution at all. I know that I have done this a few times and it works fine as a very simple preprocessor.
