Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
xrefs between chapters (was: links between sections) #27
It looks like the links using
Maybe related to #19
changed the title from
links between section
xrefs between chapters (was: links between sections)
Dec 16, 2015
Here's the workaround I've come up with thus far.
Basically, you have to make a manual link when the EPUB3 converter is being used.
I could try to work on a better solution over the weekend as that fix is very invasive.
The other option, of course, is to use a custom template for the inline_anchor node (e.g., inline_anchor.html.slim), then write the xref like:
You'd then need to map the chapter file name to the chapter id so that you output the correct link target.
But that seems like a lot of work when we could just fix the converter :)
I have proposed a fix. However, there is still one requirement for it to work. The id on the chapter must match the basename of the chapter file.
For example, if you have a chapter file named shell-introduction.adoc, then you must define an id on the chapter as follows:
Then, you can refer to a section in this chapter from another chapter using.
The fact that the id of the chapter and the file name must match is related to #46. I think perhaps we should just retain the file name of the original file.