search

structurizr / lite

Structurizr Lite
https://docs.structurizr.com/lite
MIT License
226 stars 26 forks source link

Content must be specified at line 6: !docs docs #44

Closed temurchichua closed 1 year ago

temurchichua commented 1 year ago

Hey, I have a problem running my structurizr lite with AsciiDoc documentation. I'm getting the following error:

workspace.dsl: Error importing documentation from /usr/local/structurizr/docs: java.lang.IllegalArgumentException: Content must be specified at line 6: !docs docs

This has been working fine and I don't think I have changed anything in the documentation. This is the output from the container terminal meaning that the doc folder and content inside do really exist:

# ls /usr/local/structurizr
docs  images  workspace.dsl  workspace.json
# ls /usr/local/structurizr/docs
1.Introduction.adoc  3.1.Frontend.adoc     3.4.EventsHandlerApp.adoc
2.Cloud.adoc     3.2.Backend.adoc     3.9.Others.adoc
3.0.Components.adoc  3.3.CampaignTasksFunction.adoc  4.Additional.adoc

What seems to be an issue here? Thanks

simonbrowndotje commented 1 year ago

What seems to be an issue here?

Hard to say without more information, but probably an empty file.

temurchichua commented 1 year ago

Thanks for the feedback! That was my initial thought but ls tells me otherwise:

# ls -alh /usr/local/structurizr/docs
total 20K
drwxrwxrwx 1 root root 4.0K Feb  7 13:32 .
drwxrwxrwx 1 root root 4.0K Mar 15 11:57 ..
-rwxrwxrwx 1 root root  382 Jan 31 16:01 1.Introduction.adoc
-rwxrwxrwx 1 root root 2.3K Jan 31 16:01 2.Cloud.adoc
-rwxrwxrwx 1 root root  379 Jan 31 16:01 3.0.Components.adoc
-rwxrwxrwx 1 root root  488 Jan 31 16:01 3.1.Frontend.adoc
-rwxrwxrwx 1 root root 4.1K Jan 31 16:01 3.2.Backend.adoc
-rwxrwxrwx 1 root root 2.7K Feb  2 11:58 3.3.CampaignTasksFunction.adoc
-rwxrwxrwx 1 root root    0 Feb  7 13:32 3.4.EventsHandlerApp.adoc
-rwxrwxrwx 1 root root  131 Jan 31 16:01 3.9.Others.adoc
-rwxrwxrwx 1 root root 1.3K Jan 31 16:01 4.Additional.adoc

What would be the additional information to debug this issue?

temurchichua commented 1 year ago

Oh now I see, I have an empty file named 3.4.EventsHandlerApp.adoc. Removing it fixed the issue!

I think it would be useful if an error message gave this information.

Thanks for your assistance!

simonbrowndotje commented 1 year ago

but ls tells me otherwise

I'm not convinced; is 3.4.EventsHandlerApp.adoc 0 bytes?

-rwxrwxrwx 1 root root    0 Feb  7 13:32 3.4.EventsHandlerApp.adoc
temurchichua commented 1 year ago

True, I have no idea how I've missed that.