Theming is done via HTML and CSS, so no Latex is involved. (Backend is based on weasyprint) As it is based on HTML, all extensions should be supported out of the box.
Main colors and images can be configured inside your conf.py file.
So no CSS knowledge is needed for generic changes.
I hope you like it and that it is useful for your project. Happy to get some feedback :)
Have a great day, Daniel
Renato Pontefice
unread,
Aug 26, 2022, 5:40:01 AM8/26/22
Reply to author
Sign in to reply to author
Forward
Sign in to forward
Delete
You do not have permission to delete messages in this group
Copy link
Report message
Show original message
Either email addresses are anonymous for this group or you need the view member email addresses permission to view the original message
to sphinx...@googlegroups.com
Hi all,
I’ve typed the command tp install simplepdf and the make simplepdf.
This is the result:
make simplepdf
Sto eseguendo Sphinx v5.1.1
sto creando la cartella di output... fatto
loading pickled environment... fatto
Setting theme to sphinx_simplepdf
Generating css files from scss-templates
building [mo]: targets for 0 po files that are out of date
File "/usr/local/lib/python3.10/site-packages/cffi/api.py", line 827, in _load_backend_lib
raise OSError(msg)
OSError: cannot load library 'pango-1.0-0': dlopen(pango-1.0-0, 0x0002): tried: '/usr/local/lib/pango-1.0-0' (no such file), 'pango-1.0-0' (no such file), '/usr/local/lib/pango-1.0-0' (no such file), '/usr/lib/pango-1.0-0' (no such file), '/Users/renatopontefice/sphinx/docs/pango-1.0-0' (no such file). Additionally, ctypes.util.find_library() did not manage to locate a library called 'pango-1.0-0'
build succeeded.
The HTML page is in build/simplepdf.
But (as the log show) in simplepdf folder I found just an index.html and objects.inv
As I have currently no idea for a solution, I only have one question: What operating system are you using?
I will try to solve this in the next days.
Thanks for testing it!
Daniel
Renato Pontefice
unread,
Aug 26, 2022, 6:57:31 AM8/26/22
Reply to author
Sign in to reply to author
Forward
Sign in to forward
Delete
You do not have permission to delete messages in this group
Copy link
Report message
Show original message
Either email addresses are anonymous for this group or you need the view member email addresses permission to view the original message
to sphinx...@googlegroups.com
Mac osx 12.5.1
Let me know.
Thank you
Renato
--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
So you could decide to simply remove the image inside the grids for PDF build. Or you can add some rst, which is not based in sphinx-design.
2) is the easiest one, but would force you to maintain problematic content twice.
1) is the cleanest one, but can be very specific to the current documentation.
I'm sure Sphinx-SimplePDF will get some extensions specific CSS code, to avoid such general show-stoppers in future.
But it would be really helpful and welcome, if everybody who figures out some custom css rules could share thes with Sphinx-SimplePDF via a PR.
Cheers,
Daniel
On Sun, 2022-08-28 at 05:02 +0300, Luc Saffre wrote:
Thanks, Daniel, for having written this cool builder. I tried it on one of my websites, and it gave a nice result quasi out of the box. That's a convincing start!
Of course the devil is in the detail. A show-stopper for me is that I usesphinx-designwhen i want text or images either side-by-side (on a larger screen) or top-down (on a small screen).
Example::
.. grid:: 1 2 2 2
.. grid-item::
This goes to the left column when there is enough space.
.. grid-item::
This goes to the right column when there is enough space.
These parts of my website aren't rendered correctly in the pdf version.
Luc
aero engineer
unread,
Aug 29, 2022, 3:57:55 PM8/29/22
Reply to author
Sign in to reply to author
Forward
Sign in to forward
Delete
You do not have permission to delete messages in this group
Copy link
Report message
Show original message
Either email addresses are anonymous for this group or you need the view member email addresses permission to view the original message
to sphinx-users
I tried it. It does produce a pdf with a nice look. But the .png images which are 810 pixels wide are running off the right side of the pdf pages. Is there a fix for this? Thanks.
Marvin Kastner
unread,
Aug 30, 2022, 11:53:59 AM8/30/22
Reply to author
Sign in to reply to author
Forward
Sign in to forward
Delete
You do not have permission to delete messages in this group
Copy link
Report message
Show original message
Either email addresses are anonymous for this group or you need the view member email addresses permission to view the original message
to sphinx-users
Thank you very much for this nice builder! I have tried it out and created some issues at the GitHub project. I am really looking forward to using it! I like your choice of styles etc.! Also thanks for sharing your code!