Conversation
|
Thank you for the contribution! This is useful. In the PDF I built from this PR, tutorials start from page 443. In the table of contents, I don't see anything about the tutorials. Or should I look specifically somewhere? Also, the Quickstart tutorial (only), appears to have larger font. I guess this is because it does not yet have a sidebar (intentionally, but maybe we can rethink that decision), but then this is a separate issue. As a side effect of including the tutorials (which have many pictures), the resulting PDF is 17MB (compared to the previous 3-4MB). If you see any easy way to reduce the size, that would be great! In any case, I would appreciate it if you could post screenshots of any updates, or share the PDF itself, as it is currently a bit cumbersome for me to build locally. |
|
I will add tutorial_sidebar loop to tocpage.html (pg 443+) To solve the size issue caused by tutorial pictures, I was confused a bit to either use an argument or to implement some variable technique. docs: I believe we should explicitly list these optimization techniques in docs-meta-publish-to-pdf.md as this will serve as a guide for future work to ensure that the PDF remains lightweight. |
|
@the-matrixneo hey! solid PR! PS. minor suggestion regarding commit history. I think its better to use |
- Updated prince-list.txt and tocpage.html to include tutorials - Integrated --raster-images-res 150 flag in pdf-docs.sh to reduce size - Documented optimizations in docs-meta-publish-to-pdf.md
07ca382 to
efe296d
Compare
I have tested the implementation locally by ensuring the generated prince-list.txt correctly populates with URIs for both documentation and tutorials. The logic supports the full nested structure of the tutorial sidebar.
Please review the merge request
Issue no: #468