Ohh yes, grid design for HTML output is tough to be transformed correctly for 
PDF output.
There are currently two ways to solve it.

1) Some custom CSS via a custom.css file. 
https://docs.readthedocs.io/en/stable/guides/adding-custom-css.html

2) Using the "if-builder" directive.
This one is available since Sphinx-SimplePDF 1.3 and it allows you to decide 
what content shall be used for which
builder.
https://sphinx-simplepdf.readthedocs.io/en/latest/directives.html

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 use 
> sphinx-design when 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

-- 
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+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/1cf01dd18b5cabe392311173ebd5601cdf06aa9f.camel%40useblocks.com.

Reply via email to