u451f / criticalinfrastructurelab Goto Github PK

We create nice PDFs out of markdown, but if they are supposed to be sent to an actual printer, they need

• a blank orange cover inside at the beginning and the end
• a page number that is a multiple of four

To generate these additional pages, we need more code and potentially an option to pass to our printing pipeline.

Check if the page bleed and margins in printed material are well respected.
The file size seems correct and includes the bleed, but does it also respect the margins?

i did not indeed include this into the PDF generation but it is wanted.

so we can have an image full page width, and maybe one that is pulled out of the frame, and the "normal" one that is as wide as the text

currently we use "page-break-before" and consorts: https://developer.mozilla.org/en-US/docs/Web/CSS/break-before, and they've been renamed - but we need to check if the weasyprint engine accepts the new or the old name

How about we put all the CILs into a separate directory to separate the actual code from the output? Something like ./CIL/ so it's still easily accessible.

Pulled quotes slide down below the main text when a section ends. we'd consider a section to be an h3, rather than encountering a new h6. if we can manage to define this better, then the pulled quotes would "stay above the footnotes".

… @maxigas

The "Shifting terrain" report (https://zenodo.org/records/10229828) makes heavy use of pulled quotes and there seem to be some issues with that where the page breaks after the quote but that should never happen:

While waiting for #6 to get fixed, provide empty pages to the lab so that they can be manually added using https://tracker.debian.org/pkg/pdfarranger

There are elements which were either not designed but are being used in markdown and then result in a strange print layout. I'm colleting them below and we should look into why these things happen, if something in the mdwn needs to change or if we want to account for every possible corner case when building the PDF.

CIL006:

• second level titles are italized (I guess that's because they are not actual second level titles)
• executive summary entirely italized and indented as if it were a quote
• page 5 indented text has no paragraphs
• page 42, there's a lot of space in the footnote n° 11
• references lack title "References" as we have in previous publications