Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.
Sign upPlease update the documentation on how the sidebar / pagination work. #1083
Labels
Comments
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Currently, there seems to to be very little instruction on how/why certain combinations of
_sidebar.md
files and folder structures make the sidebar navigation and pagination work.For example, if my
_sidebar.md
file contains this:and my folder structure is this:
the pagination and menu structure works fine. But there is no explanation to why this works. If I move
.md
files into sub-folders, pagination doesn't work. If I simply have...- [**Services**](services/index.md)
then pagination does not appear and the sidebar no longer shows the sub-pages. It is quite difficult to know where to place files and what to put into the sidebar to try and get a solution whereby the sidebar can auto-generate itself correctly and the pagination work as expected.