[PATCH] D87242: [flang] Add new documentation main page
Richard Barton via Phabricator via llvm-commits
llvm-commits at lists.llvm.org
Thu Sep 10 11:58:02 PDT 2020
richard.barton.arm added a comment.
> The TOC tree is displayed in the right `indexsidebar`, if it could be displayed at the top (see http://llvm.org/docs/CMake.html for reference) of individual pages that would be better and it would help reader initially to navigate to the internal section in the respective page.
> Further I went on to apply `D87226`(contains a fixed side bar index links ) and the TOC disappears probably due to above mentioned issue.
Can you help me understand what you mean here? When I build the pages they look like this to me:
F12910087: image.png <https://reviews.llvm.org/F12910087>
Compare that to the reference page you linked me to (same browser, same computer):
F12910094: image.png <https://reviews.llvm.org/F12910094>
I don't see a difference in the two for style. Both seem to have previous | next | index links in the top (and bottom) bars, as well as the indexsidebar as you point out. The indexsidebar seems to be a standard default from sphinx. LLVM uses a special one in llvm/docs/_templates/indexsidebar.html which does not have the previous/next topic links and instead has the permalinks to other articles.
Repository:
rG LLVM Github Monorepo
CHANGES SINCE LAST ACTION
https://reviews.llvm.org/D87242/new/
https://reviews.llvm.org/D87242
More information about the llvm-commits
mailing list