|
Hi!
We're building a documentation site with Jekyll and AsciiDoc. It contains up to a hundred pages categorised with folders. The documents refer quite a bit to each other by links. I'm having with setting up said links. Referencing with <<document#header,text to show>> works good as long as both files are in the same folder, but if document is in another folder, it just outputs the command as plaintext.
So for example this:
Reference to another file: <<another-document#intro.background,In the same folder>>
Reference to another folder: <<../third-document#intro.goals,In another folder>>
Here the first line produces a link, correctly, while the other one outputs the source AD directly.
Is this how it is supposed to work? Is this the best way to handle links within Jekyll? We'd like to be able to use standard Asciidoc annotations instead of Jekyll ones as we will also produce docbook and pdf from the same Asciidoc source files.
Thanks,
Jens Jansson
Vaadin Ltd.
|