Open ahus1 opened 2 years ago
Thanks for this improvement idea. It makes sense, still I don't know yet how this should work from a UX perspective.
For the time being, as a workaround, I suggest adding a specially crafted .gitignore
file that would prevent users from accidentally committing these files (for example "all *.docx files in the pages folder should be ignored").
Thanks. We've already got DOCX in .gitignore. It's mainly a matter of keeping repositories clean since people sometimes forget what should and should not be there.
I'll have to settle the UX for this feature ... I am not sure how this could work.
I am not a fan of pop-ups, and plugin's settings are user specific, not project specific (at least at the moment). Once those can b project specific, they could eventually be checked into the repository of the project.
In Gradle projects there is usually a build
folder, in Maven projects there is a target
folder, maybe use some convention here?
About the scope of this issue: At least PDF could work the same way as DOCX, as images are embedded in the created file. With HTML, this is a bit more difficult, as with a destination folder the images in the HTML might be broken? Let's see what we come up with.
For now, I'm changing the title to include PDF as well, and I'm happy to hear thoughts about HTML.
@ahus1
My order of preference would be:
target
or build
.Option 3 might currently be the best option for minimal effort for max flexibility.
I think the HTML relative links issue can be fixed by placing assets into their own folder in the root. E.g:
myproject
-> assets
--> images
--> fonts
-> src
--> something.adoc
-> build (target folder for HTML build)
--> something.html
The URLs will remain the same, no?
Would it be possible to identify an AsciiDoc file that's in an Antora repository and give the user the option to save the DOCX file elsewhere? Most of the team gets it (don't just dump random files in the Antora repository if they're not explicitly used by Antora to create sites), but it wouldn't hurt to remind them.
Originally posted by @KLynn2019 in https://github.com/asciidoctor/asciidoctor-intellij-plugin/issues/1074#issuecomment-1167851560