Export to PDF Bookmarks Incomplete with Flat Structure
under review
M
Mature Spoonbill
When exporting to PDF (we use the default template), there are some basic items that should be included:
- The bookmarks created have no structure. This is simply a list of the articles. Instead this should replicate the category structure that is visible in the documentation site.
- The bookmarks are also incomplete in that any headings added to the articles or categories are not included in the bookmarks or table of contents. The structure should include both page names as well as headings. There should be no visible difference between page names and headings in either the table of contents or the bookmarks
- The table of contents doesn't always have links to the pages as well. There should always be a way to jump from the table of contents to the location further in the document.
Log In
Shakeer Hussain S
marked this post as
under review
Shakeer Hussain S
Hi Mature Spoonbill - Thank you for providing such comprehensive feedback. We are eager to assist you further. To address your concerns effectively, may we request additional information on the points below? We would greatly appreciate if you could take a moment to respond to the following questions:
Regarding Bookmarks
Can you provide an example of the current state of the bookmarks compared to how you’d like them to appear, for a clearer understanding of the issue?
Are there specific criteria or guidelines you follow for structuring the categories on the documentation site that should be mirrored in the PDF bookmarks?
Regarding Incomplete Bookmarks and Table of Contents
Could you please specify if there are particular types of headings or sections that are consistently omitted, or if the issue occurs randomly?
Is there a preference for how the headings and page names should be formatted or distinguished in the table of contents and bookmarks?
Regarding Links in the Table of Contents
Could you share an instance or example where the links were missing in the table of contents, to help us pinpoint and understand the issue better?
Are there specific pages or sections where this issue is prevalent, or does it occur randomly throughout the document?
M
Mature Spoonbill
Shakeer Hussain S: My goal from this is to use an Export to PDF to save the state of portions of our site at particular points in time.
Regarding Bookmarks
Can you provide an example of the current state of the bookmarks compared to how you’d like them to appear, for a clearer understanding of the issue? <DG> Please see Bookmarks Hierarchy.png for an example of what is produced from Doc360 on the left and what is produced from a different tool (different source but the same content) on the right. You will notice that there is no structure and missing headings from Document 360. As an example, a category Account Data above the article Account Input Data is entirely missing from the export. Also missing from the bookmarks are headings of Deposit Account Information, etc.
Are there specific criteria or guidelines you follow for structuring the categories on the documentation site that should be mirrored in the PDF bookmarks? <DG> See above. Also, if a multiple hierarchies are published then I feel that they should be represented at the same level in the document even if they don't appear at the same level in the site. Looking at example hierarchy.png, I would see three heading 1 level section. Within "Working in the Designer", I would expect to have the heading for "Working with Items", but no content from that page since child articles/categories are selected.
Regarding Incomplete Bookmarks and Table of Contents
Could you please specify if there are particular types of headings or sections that are consistently omitted, or if the issue occurs randomly? <DG> All headings are always omitted from both the Bookmarks and the Table of Contents.
Is there a preference for how the headings and page names should be formatted or distinguished in the table of contents and bookmarks? <DG> They should be indistinguishable from each other.
Regarding Links in the Table of Contents
Could you share an instance or example where the links were missing in the table of contents, to help us pinpoint and understand the issue better? <DG> This seems to be a size of PDF issue. When I export a 500 page document the links are there. When it gets above 1,000 pages, the links appear to be missing.
Are there specific pages or sections where this issue is prevalent, or does it occur randomly throughout the document? <DG> See above.