Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Asciidoc inter-doc cross-ref does not work #565

Open
Heiss opened this issue Jul 12, 2024 · 2 comments
Open

Asciidoc inter-doc cross-ref does not work #565

Heiss opened this issue Jul 12, 2024 · 2 comments

Comments

@Heiss
Copy link

Heiss commented Jul 12, 2024

Hey, me again.

As i am trying out your software, i found another problem with the asciidoc parser. The official doc shows, how it should work... But sadly, the used parser in this software generates a link do document-b.html, but your software generates a site with the first headline as filename, so the generated link does not work correctly.

Greetz.

@jenspav
Copy link
Collaborator

jenspav commented Aug 8, 2024

But sadly, the used parser in this software generates a link do document-b.html, but your software generates a site with the first headline as filename, so the generated link does not work correctly.

Sorry, I don't fully understand this. Could you write out an example, what you see and what you expected to see?

@Heiss
Copy link
Author

Heiss commented Aug 8, 2024

Assume you have a 04-document-a.adoc in your /docs/example.
Write xref:03-asciidoc-features.adoc into document-a.adoc, then the the generated html page for 04-document-a.adoc from generatr will link to /03-asciidoc-features.html. But your software names the file generated from 03-asciidoc-features.adoc to asciidoc-features/index.html, so i cannot link from one asciidoc-file to another, because generatr takes the name from the first headline in the file instead of the filename, which is the behaviour expected by asciidoctor.

Hope, this clarify things. :)

I would expect, that the generated link in 04-document-a.adoc is working. I do not mind, which behaviour is better as long as the link works.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants