search

avisi-cloud / structurizr-site-generatr

Static site generator for architecture models created with Structurizr DSL
https://avisi-cloud.github.io/structurizr-site-generatr/
Apache License 2.0
227 stars 34 forks source link

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

Open Heiss opened 3 months ago

Heiss commented 3 months ago

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 commented 2 months ago

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 commented 2 months ago

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.