Nekmo/sphinx-business-theme

Question: Still maintained and would PRs be excepted?

Closed this issue · 1 comments

I have written my own little Sphinx-Theme for PDF, which is heavily based on this work (Thanks ❤️ ).
This was needed, as I had some problems to get the sphinx-business-theme running (pinned old versions, missing docs).

But instead of publishing my own fork, I would be lucky to contribute all my changes back here.
So there are two questions:

  1. Is this project still maintained? :)
  2. And would it except PRs with the following changes?

What I have done so far:

Added a sphinx pdf-builder, which is overwriting the currently set theme by the pdf-theme. At the end it starts weasyprint.
Just pip install sphinx-business-theme and make pdf. No configuration, no file changes, no create-docs needed.
Working immediately for all sphinx-projects.

Added some extra CSS for Sphinx extensions specific HTML output. E.g. Sphinx-Needs

Added some generic css-classes like break, which can be set in the rst to e.g. force a csv-table to start on the next page:

.. csv-table:: 
   :file: data.csv
   :class: break

Added some new scss-vars in _variables.scss to be more configurable by the user (e.g. link color).

Added also a generated main.css as this was not available during build. Or is there a hidden mechanism, so that this file gets generated during a sphinx-build?

Would be happy to enhance this cool project by providing some PRs :)

There was too much stuff in my head regarding the sphinx-pdf build topic, so I created already a new extension to get rid of it:
https://sphinx-simplepdf.readthedocs.io/en/latest/

But the PDF-theme is heavily based on yours. So thanks for all the work.
I tried to honor your work in the docs: https://sphinx-simplepdf.readthedocs.io/en/latest/#one-last-thing