Navigating between multiple documentation files

Hi,
I'm using Spring REST Docs and since we have a big API, we have the documentation split to several files and the root index.adoc links to all of them. This works great!

But, once you're at one of the sections, for example user/index.html, there is no easy way to navigate back to "homepage".

Adding a "back to homepage" link above the TOC would be enough for me, but I haven't found any way to customize the layout of the pages to add such link.

Thanks you

fprochazka wrote

But, once you're at one of the sections, for example user/index.html, there is no easy way to navigate back to "homepage".

Adding a "back to homepage" link above the TOC would be enough for me, but I haven't found any way to customize the layout of the pages to add such link.

You can create a custom Slim template to add a link back to your home page. Here are some instructions https://github.com/tedbergeron/AsciidoctorCustomTemplate

Or just add a link on your user/index.adoc and other pages back to the home page

link:../index.adoc[Home Page]

or even add an icon

link:../index.adoc[icon:home[] Home Page]

This no longer works as of 1.5.7 for Table of Contents navigation.

I am attempting to create a navigation from TOC (:toc:), which previously added the full link when defined in the document:

link:../index.html#_home_page[Go back]

Before 1.5.7

http://localhost:80/doc/en/index.html#_home_page

After 1.5.7 it creates the following in the TOC

http://localhost:80/doc/en/CURRENT_PAGE/#_home_page    (but works fine outside TOC in the documentation)


Does anyone have an alternative? I have found this issue on GitHub but it does not solve it for me.
https://github.com/asciidoctor/asciidoctor/issues/417