search

de-jcup / eclipse-asciidoctor-editor

An eclipse editor for asciidoctor files
https://marketplace.eclipse.org/content/asciidoctor-editor
Other
59 stars 15 forks source link

Empty folder between asciidoc files prevents plantuml resolution #428

Closed de-jcup closed 2 years ago

de-jcup commented 2 years ago

Situation

documents
  | main.adoc
  |-----folder2 (empty)
  |          ^---------folder3
  |                           subdocument.adoc
diagrams
  my_diagram.puml

When wrring subdocument.adoc like this:

=== Inside subdocument

lorem ipsum..

plantuml::diagrams/my_diagram.puml[]

The files is not correct rendered (neither ASP nor by native asciidoc)

Analyze

The problem is the base class calculation! The empty folder will be used as the new base and so the diagram will not be found.

Wanted

Improve the base directory resolution

Solution

Workaround: Just add an empty asciidoc file - e.g. pseudo.adoc and the resolution will work again.

A real solution is still open

de-jcup commented 2 years ago

We allow now up to 3 empty folders while resolving base directory

de-jcup commented 2 years ago

Version 2.6.0 did fail when it comes to rendering of bigger documentation projects - e.g. https://github.com/mercedes-benz/sechub/tree/develop/sechub-doc . The diagram path calculation did fail.

Looking back, one has to say that the idea wasn't a very happy or good one. The workaround of putting an empty Asciidoc document in an empty folder is much better!