Hi Daniel, Had a quick look at FREEMARKER-154 but document generation fails for me but I have no time to look into it
[INFO] --- freemarker-docgen-maven:0.0.2-SNAPSHOT:transform (docgen-transform) @ freemarker-generator-website --- Using FreeMarker 2.3.31 Loading /Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-website/src/main/docgen/book.xml... Output directory: /Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-website/target/website [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ [INFO] Total time: 2.237 s [INFO] Finished at: 2021-09-11T08:53:17+02:00 [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal org.apache.freemarker.docgen:freemarker-docgen-maven:0.0.2-SNAPSHOT:transform (docgen-transform) on project freemarker-generator-website: Error during document transformation: Insertable file with symbolic name "websitePomGenerated" points to a directory that doesn't exist: "/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-website/target/docgen-insertable-outputs" -> [Help 1] And XMLMind looks quite nice to use ... Skimmed through comments regarding to documentation * I used the examples in the documentation as mental notes so many of them might be irrelevant and should be removed altogether * And yes, a lot of stuff needs to be rewritten .-) * Gomplate documentation is under MIT licence * Since I don't have the final output - how annoying are all the ASL headers in the sample file? Guess they add a lot of noise? So I suggest to get FREEMARKER-188 out of the door since this is the biggest pain point regarding initial release and move the documentation step by step - what do you think? Thanks in advance, Siegfried Goeschl > On 09.09.2021, at 21:06, Daniel Dekany <daniel.dek...@gmail.com> wrote: > > Maybe it's already too late, but I will... hopefully at the weekend. > > Oh, and the documentation conversion too... what was completed will drag > behind the md-s again. /-: Sorry about that. Have you ever tried using what > we have in that branch? It can save time and improve the quality of the > content, as it inserts the actual example files, runs them, and inserts the > actual output. No copy-pasting. So it's guaranteed that what we tell > is accurate and up to date. XXE is another time saver for me... though > admittedly it needs initial investment to use. (Don't even touch XML > editors where you edit on source level... that's clearly not for > documentation.) > > On Tue, Sep 7, 2021 at 9:38 PM Siegfried Goeschl < > siegfried.goes...@gmail.com> wrote: > >> Hi folks, >> >> After Corona, lockdown, home schooling and endless telcos and finally >> returned to my pet project :) >> >> I'm tackling now the age-old topic of generating output files driven by >> data sources - https://issues.apache.org/jira/browse/FREEMARKER-188 < >> https://issues.apache.org/jira/browse/FREEMARKER-188> >> >> Daniel, since we invested a lot of energy discussing the topic you are >> happily invited to share your thought :) >> >> Thanks in advance, >> >> Siegfried Goeschl >> >> > > -- > Best regards, > Daniel Dekany
