Use --out-file break the links to home

[jesustorresdev]

Run asciidoctor using --out-file to set de output filename:

$ asciidoctor -r asciidoctor-multipage -b multipage_html5  --out-file out/index.html src/main.adoc

Then out/index.html is created, but the links to home in every file refer to main.html, so all are broken.

I know the option -D works fine, but to be able to set the filename of the top-level document, allows to save it as index.html, for example, ready to publish the directory in a website.

After some research, I guess docname is used as the node ID of top-level document and the link URL for home derive from that ID.

Could it be solved if outfile (maybe, without extension) is used instead? I don't know if that change could break other things.

[owenh000]

Hi @aplatanado, thanks for the report. Here are some brainstorming ideas:

• First, the extension should detect when --out-file is used, if possible. If it's not possible, then we can only document this option as unsupported.
• If --out-file can be detected but is not supported, the extension should fail without generating output.
• Ideally the extension would simply use the --out-file value in place of the node ID when generating links to the main page. (This behavior would be unrelated to whether or not the output filename has an extension.) It would also be necessary to make sure the relative paths work between an --out-file path and the --destination-dir (and fail with an error if that is impossible).

Also, this is related to issue #21.