Conversation
Signed-off-by: Ranjini M N <ranjini.n@suse.com>
| userDataBase64: I2Nsb3VkLWNvbmZpZwpkaXNhYmxlX3Jvb3Q6IGZhbHNlCnNzaF9wd2F1dGg6IFRyd | ||
| WUKdXNlcnM6CiAgLSBkZWZhdWx0CiAgLSBuYW1lOiBzdXNlCiAgICBncm91cHM6IH | ||
| N1ZG8KICAgIHNoZWxsOiAvYmluL2Jhc2gKICAgIHN1ZG86ICBBTEw9KEFMTCkgTk9 | ||
| QQVNTV0Q6QUxMCiAgICBsb2NrX3Bhc3N3ZDogRmFsc2UKICAgIHBsYWluX3RleHRf | ||
| cGFzc3dkOiAnc3VzZScK |
There was a problem hiding this comment.
@hardys This renders differently in the PDF version and runs off the page. Is there an option to replace this with anything more generic?
There was a problem hiding this comment.
This, and the strings below, are examples if I understand it correctly. I suggest to shorten them to something like
I2Nsb3VkLW[...]Anc3VzZScK
OK with you @hardys ?
| [,console] | ||
| ---- | ||
| $6$G392FCbxVgnLaFw1$Ujt00mdpJ3tDHxEg1snBU3GjujQf6f8kvopu7jiCBIhRbRvMmKUqwcmXAKggaSSKeUUOEtCP3ZUoZQY7zTXnC1 | ||
| $6$G392FCbxVgnLaFw$Ujt00mdpJ3tDHxEg1snBU3GjujQf6f8kvopu7jiCBIhRbRvMmKUqwcmXAKggaSSKeUUOEtCP3ZUoZQY7zTXnC1 |
There was a problem hiding this comment.
I had to remove the number from the password as it was not breaking the text correctly in the PDF rendition. Please let me know if it's okay.
There was a problem hiding this comment.
Again, an example string
| == High-level architecture | ||
|
|
||
| image::quickstart-elemental-architecture.svg[scaledwidth=100%] | ||
| image::quickstart-elemental-architecture.png[scaledwidth=100%] |
There was a problem hiding this comment.
We need to use PNG images in the document. I have converted all the SVG images to PNG images as the text in an SVG image was not visible in the PDF version.
There was a problem hiding this comment.
Please do not convert SVGs to PNG. Just leave the SVFs as sources, but use the .png suffix in ASCIIDoc (like in the example above). DAPS will detect that an SVG with the same basename exists and will automatically convert it to PNG.
2 participants
Hi, I have accessed the PDF version of the Edge documentation, and there are some issues at least for the last few versions of the document. For example you can take a look at https://documentation.suse.com/suse-edge/3.5/pdf/edge_en.pdf:
Images that represent diagrams aren't correct, they are missing all the text, this text is displayed correctly on the HTML page, like PDF pages 21 (xxi), 22 (xxii), 24 (xxiv), 31 (3), 55 (27).
Text that represents code goes beyond document right margin, like in pages 76 (48), 80 (52), 82 (54), 170 (142), 174 (146), 176 (148). And sometimes beyond the bottom margin and overlap the page number like pages 199 (171), 200 (172), 202 (174), 203 (175).
Screenshots are larger than page size and go beyond the right margin or the bottom margin and you cannot really see the whole screenshot that is necessary, like in pages 178 (150), 180 (152).
The pages I mention are only examples. I guess the whole PDF should be reviewed in detail since there can be more issues.
I hope it helps.
https://suse.slack.com/archives/C072TF88KNU/p1771545274219749