rst2pdf / rst2pdf.github.io

Website for the rst2pdf project "use a text editor, make a PDF"
https://rst2pdf.github.io/
8 stars 8 forks source link

Convert content and switch from jekyll to sphinx #38

Open lornajane opened 3 weeks ago

lornajane commented 3 weeks ago

A ReStructuredText project really should have rst website source! Update our content and manual to be rendered by Sphinx and published to GitHub pages. Add some dummy directives to do a "no op" for the stuff that isn't supported/needed when Sphinx renders the manual as HTML.

Things that still need sorting out:

Followup tasks:

We should update the default branch to main and publish from that when we deploy this change.

lornajane commented 5 days ago

To see how this work is progressing, grab an artifact from the build action, extract it locally and preview the site with python -m http.server. If we merge #1245 which removes external dependencies from the manual and generally makes it a bit more docs-like, the result is easier to read (that version of the manual is what's in the branch at the moment, until we automate that part!)