Improve build from source section

[melroy89]

• Add Sphinx-Substitution-Extensions to pypi requirements: https://pypi.org/project/sphinx-substitution-extensions/
• Use Sphinix extension for code blocks: sphinx_substitution_extensions
• Rename Ubuntu 20.04 LTS to just Ubuntu
• Use substitution for the version number in both the text as well as the code block

---

Should we also try to upgrade Sphinx to v8.1.3 next?

[k0ekk0ek]

Thanks @melroy89!

[melroy89]

Oei I notice something doesn't work. Somehow with the substitution of the version number in the code block.

@k0ekk0ek But I did do it correcty right? Is the pip package installed om the server correctly? What did I miss?

[k0ekk0ek]

Oh, now I recall... I made these types of changes myself and then found out |version| is not supported in code blocks.

[k0ekk0ek]

@melroy89, do you want me to issue a PR or do you prefer to send a follow-up PR to fix it (either is fine with me).

[melroy89]

Oh, now I recall... I made these types of changes myself and then found out |version| is not supported in code blocks.

Yes it is supported with this python extension. That is the whole point of introducing https://pypi.org/project/sphinx-substitution-extensions/

[k0ekk0ek]

Well, the extension page says Sphinx 7.2.0+. As we've pinned on 5.0.2, that is presumably the problem(?)

[melroy89]

Well, the extension page says Sphinx 7.2.0+. As we've pinned on 5.0.2, that is presumably the problem(?)

Can we upgrade Sphinx for NSD?

[melroy89]

aha you did! 89aeb68 let's hope it works!?