Updated rst2pdf website

Earlier this year, Lorna spent some time updating rst2pdf‘s website to use Sphinx. The nice thing about Sphinx is that it uses restructuredText, the same as rst2pdf does, so we now stay in the same ecosystem.

While, we could have continued using Jekyll, it makes much more sense for us to use the same markup language as we use for the main tool, and our manual is written in it too. With the Jekyll system, we used docutils with a generic and simple CSS file to create the HTML version of the manual, but now as Sphinx is rST native, it builds the HTML version of the manual and it as it is now styled the same as the website, it looks much better. Of course, we use rst2pdf to generate the PDF version ;)

Rather handily, we now have search on the site and also have a dark mode which you can see in this screenshot if your OS is in dark mode as you view this page. I also like that you can click on the “eye” icon and view the rST source for the page.

This required a fair amount of work. Thanks Lorna for taking the time to do it!