Hi Daniel, This is what I was looking for. I will give it a try thank you. BTW I have asked a question regarding sibling of .node that gets passed through to the macro. Kindly reply for the same when you find time, so that tomorrow morning my time will start working on it. Pradeep.
> Date: Mon, 12 Oct 2015 15:09:32 +0200 > From: [email protected] > Subject: RE: Freemarker manual Local set up > To: [email protected] > > You don't need to use Ant at all while developing. Just run Docgen's > command line class from Eclipse. Of course, you need to add the required > command line arguments under the Run configuration. > Pradeep Murugesan <[email protected]> írta: > >Hi Evangelia, > > Thanks for your pointers. I had gone through that and I am adding logs to > > understand the flow. I have a couple of questions there. > >Lets say in order to debug Transform.java or other Java files I am adding > >logger.info and check what happens. > >1. Is there a way I can issue logger statements inside the templates.2. Is > >it possible to enable debugger in docgen code and while generating manual > >from freemarker can I put breakpoints and check in Transform.java ? > > > >I am asking this because I need to do 3 steps whenever I change the docgen > >code > >1. Do a publish-override2. go to freemarker and do update-deps3. then issue > >a ant manualOffline. > >Is this the way it should work or am I doing something different. > >Pradeep. > > > >> Date: Mon, 12 Oct 2015 00:25:10 -0700 > >> Subject: Re: Freemarker manual Local set up > >> From: [email protected] > >> To: [email protected]; [email protected] > >> > >> Did you run docgen locally, too? If you clone docgen, then run `ant > >> publish-override` in docgen, then in freemarker run > >> `ant manualFreemarkerOrg` it should work. This works on OS X and on > >> Windows 7. > >> > >> Did you double check your version of Java and Ivy? When I do `ivy -version > >> && java -version` i get this: > >> > >> Apache Ivy 2.4.0 - 20141213170938 :: http://ant.apache.org/ivy/ > >> > >> java version "1.8.0_60" > >> > >> Java(TM) SE Runtime Environment (build 1.8.0_60-b27) > >> > >> Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode) > >> > >> > >> > >> > >> On Sun, Oct 11, 2015 at 10:40 AM, Daniel Dekany <[email protected]> > >> wrote: > >> > >> > I'm not sure where exactly you stuck, but I try to give some > >> > pointers. > >> > Read http://freemarker.org/docs/xgui.html if you haven't. As you will > >> > see there, you got the current XML node as .node in the programlisting > >> > macro, and you can move around in the DOM tree from there, like > >> > examine the previous/next programlisting, etc. > >> > > >> > As of shrinking the content, certainly you should work with a > >> > minimalistic docbook. I don't know what error you get. (Of course the > >> > XML must be well-formed XDocBook.) > >> > > >> > -- > >> > Thanks, > >> > Daniel Dekany > >> > > >> > > >> > Sunday, October 11, 2015, 5:50:06 PM, Pradeep Murugesan wrote: > >> > > >> > > Hi Daniel, > >> > > I am still trying to knock it down but in vain. I dig down to > >> > > programListing macro in NodeHandlers.ftlh and I am lost there as what > >> > > is > >> > going on. > >> > > I tried to shrink the content in book.xml and ran docgen to > >> > > understand where do i need to inject the logic but that approach threw > >> > few other errors. > >> > > > >> > > It comes all the way down to generateHTMLFile_inner where we get > >> > > page.fthl and process it and I am not able to proceed further. > >> > > Could you please give me a clue ? > >> > > Pradeep. > >> > >> From: [email protected] > >> > >> To: [email protected] > >> > >> Subject: RE: Freemarker manual Local set up > >> > >> Date: Mon, 5 Oct 2015 14:45:09 +0530 > >> > >> > >> > >> Hi Daniel, > >> > >> > >> > >> I am going through the docgen code and its taking some time to > >> > >> clearly > >> > get what is happening in the Transform.java. > >> > >> I am tracing down to the part where to check if the previous node is > >> > frmDataModel if the current node is Template so that I have a hidden form > >> > and try it out button. I am facing some challenges there. > >> > >> I will try to complete things within this week. > >> > >> Pradeep. > >> > >> > >> > >> > Date: Tue, 29 Sep 2015 21:45:41 +0200 > >> > >> > From: [email protected] > >> > >> > To: [email protected] > >> > >> > CC: [email protected] > >> > >> > Subject: Re: Freemarker manual Local set up > >> > >> > > >> > >> > FM is *built* with JDK 8 (and runs on Java 5+ as of 2.3.24). This > >> > >> > information was missing from the README.txt... I have fixed that > >> > >> > now. > >> > >> > The important thing is to ensure that Ant runs on JDK 8 too. Perhaps > >> > >> > you need to adjust the JAVA_HOME environment variable for that. > >> > >> > (Clearing the Ivy or Ant directories is not needed.) > >> > >> > > >> > >> > > >> > >> > Tuesday, September 29, 2015, 8:56:44 PM, Pradeep Murugesan wrote: > >> > >> > > >> > >> > > Tried upgrading to java 1.8 and cleared the ant and ivy cache. > >> > >> > > still facing the same issue. Have any of you guys faced this > >> > >> > > already > >> > >> > > Pradeep. > >> > >> > > > >> > >> > >> From: [email protected] > >> > >> > >> To: [email protected] > >> > >> > >> Subject: RE: Freemarker manual Local set up > >> > >> > >> Date: Tue, 29 Sep 2015 08:43:05 +0530 > >> > >> > >> > >> > >> > >> Hi, I tried to do "ant manualFreemarkerOrg" to bring up the > >> > manual locally. > >> > >> > >> But end up in the following error. > >> > >> > >> BUILD > >> > FAILEDC:\Users\pmuruge\Desktop\Pradeep\Personal\github\apache\freemarker\incubator-freemarker\build.xml:570: > >> > The following error occurred while executing this > >> > line:C:\Users\pmuruge\Desktop\Pradeep\Personal\github\apache\freemarker\incubator-freemarker\build.xml:556: > >> > java.lang.UnsupportedClassVersionError: > >> > org/freemarker/docgen/TransformAntTask : Unsupported major.minor version > >> > 52.0 > >> > >> > >> > >> > >> > >> Googling got me to the state that the docgen jar would have been > >> > build using different java and from the github readme understood that > >> > docgen requires java 1.8. which means compiling Freemarker project also > >> > require Java 1.8 ? Its not mentioned in Freemarker readme though. > >> > >> > >> Please guide me. > >> > >> > >> Also, > >> > >> > >> How are you guys working with multiple java versions in the same > >> > machine. BTW I am using Windows and tried to manage java 1.7 & java 1.8 > >> > but > >> > failed with an error . If you guys are already following some way kindly > >> > let me know. > >> > >> > >> > >> > >> > >> Pradeep. > >> > >> > >> > >> > >> > >> > >> > >> > >> > Date: Wed, 23 Sep 2015 20:34:03 +0200 > >> > >> > >> > From: [email protected] > >> > >> > >> > To: [email protected] > >> > >> > >> > Subject: Re: Freemarker manual Local set up > >> > >> > >> > > >> > >> > >> > The Manual is in the "freemarker" project, under src/manual. It > >> > also > >> > >> > >> > uses docgen of course. (You can download the latest docgen > >> > artifact > >> > >> > >> > with running `ant update-deps` in the "freemarker" project.) > >> > >> > >> > The > >> > >> > >> > manual is built with `ant manualOffline` or > >> > `manualFreemarkerOrg`. > >> > >> > >> > > >> > >> > >> > As of README-s, all 3 modules (freemarker, site, docgen) has > >> > one, so > >> > >> > >> > what's not described there is probably undocumented... > >> > >> > >> > > >> > >> > >> > Anyway, it's docgen's responsibility to generate the > >> > >> > >> > hidden HTML > >> > forms > >> > >> > >> > and JavaScript that will be needed. (Both the Web site and the > >> > Manual > >> > >> > >> > is built from DocBook XML by Docgen.) > >> > >> > >> > > >> > >> > >> > -- > >> > >> > >> > Thanks, > >> > >> > >> > Daniel Dekany > >> > >> > >> > > >> > >> > >> > > >> > >> > >> > Wednesday, September 23, 2015, 7:33:05 PM, Pradeep Murugesan > >> > wrote: > >> > >> > >> > > >> > >> > >> > > Hi Daniel, > >> > >> > >> > > I could see that freemarker manual is part of the site > >> > >> > >> > > http://freemarker.org/docs/index.html > >> > >> > >> > > Since that is generated using the doc-gen, I am trying to > >> > >> > >> > > look > >> > into > >> > >> > >> > > the https://github.com/apache/incubator-freemarker-site for > >> > manual contents. > >> > >> > >> > > > >> > https://github.com/apache/incubator-freemarker-site/blob/master/src/main/docgen/book.xml > >> > >> > >> > > references to the site but I am not able to get the xml for > >> > manual which doc-gen converts. > >> > >> > >> > > > >> > >> > >> > > I am trying to get the manual up and running locally to > >> > >> > >> > > connect > >> > >> > >> > > with the freemarker online. Is there any readme kind of thing > >> > to achieve the same ? > >> > >> > >> > > Please guide me. > >> > >> > >> > > Pradeep. > >> > >> > >> > > >> > >> > >> > >> > >> > > > >> > >> > > >> > >> > -- > >> > >> > Thanks, > >> > >> > Daniel Dekany > >> > >> > > >> > >> > >> > > > >> > > >> > > >
