Changes between Initial Version and Version 1 of Ticket #20935, comment 14


Ignore:
Timestamp:
Dec 3, 2019, 5:51:03 PM (5 years ago)
Author:
Fredrik Malmfors

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #20935, comment 14

    initial v1  
    2020These 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):
    2121
    22 [[Image(ToC_error_reporting)]]
     22[[Image(ToC_error_reporting.png)]]
    2323
    2424This 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.
     
    8989The 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.
    9090
    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)]]
    9294
    9395This 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.
     
    107109This 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.
    108110
    109 [Img]
     111[[Image(contrib.png)]]
    110112
    111113Proposed solutions for these warnings:
Back to Top