Changes between Initial Version and Version 1 of Ticket #20935, comment 14
- Timestamp:
- Dec 3, 2019, 5:51:03 PM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Ticket #20935, comment 14
initial v1 20 20 These errors occurs from the chapters Error reporting and Deploying Static Files, appearing twice in the ToC. This is true for the html docs aswell, not just the epub. In essence, the same chapters can be found both under “ How-to guides“, and under “How-to guides / Deploying Django”. This is seen clearly in the screenshot below (from the website): 21 21 22 [[Image(ToC_error_reporting )]]22 [[Image(ToC_error_reporting.png)]] 23 23 24 24 This violates the ToC correlation with the reading order. It also leads to problems in the epub since (if going through reading order) only the first reference is being rendered, and the second one is missing. … … 89 89 The reason for this warning is that the ToC refers to the sections of topics/class-based-views/index AFTER the included content tree. This makes for a slightly counter intuitive ToC. 90 90 91 [B,C,D] 91 [[Image(class_based_views_1.png)]] 92 [[Image(class_based_views_2.png)]] 93 [[Image(class_based_views_3.png)]] 92 94 93 95 This is likely not an issue if reading everyting on the index page before going to the other pages, but it makes the ToC feel counter intuitive. And, following the ToC ordering indicates that you should read the mentioned chapters, and THEN go back again to the index file. … … 107 109 This sections includes first a local ToC to all the contribs, then, still in the index file, a breif description of each. This might make sense when reading, but it makes for a duplicate looking ToC. 108 110 109 [ Img]111 [[Image(contrib.png)]] 110 112 111 113 Proposed solutions for these warnings: