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 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.
