Re: APTEditor + Doxia
Hi Math, 2007/7/26, Mathieu Avoine [EMAIL PROTECTED]: Thanks to all of you for the answers. Now more questions! ;) I've been reading through some code in Doxia lately to understand how HTML site generation is done, however foreign code is always hard to read and I was hoping someone would digest it a little bit for me (like I always say, saving time requires to be lazy :P). What I need to know is if it's still possible to call a Driver to have the contents generated in a given place? Let me explain. If I try to make a parallel with what I have done with Pixware's parser to achieve my goal, I only extended the class fr.pixware.apt.convert.Driver ( apteditor.drivers.APTEditorDriver) and called the appropriate method. A bit I was not aware about this but it sounds very useful for a book playing of code explains always better, so take a look at the following link, on line 200, this is where all the magic happens in APT Editor: http://apteditor.cvs.sourceforge.net/apteditor/APTEditor/src/apteditor/editors/MultiPageEditor.java?revision=1.3view=markup I wish I could do the same with Doxia and let it do the dirty work: finding the css, figures and other, execute macros, etc, so I can concentrate on adding nice features to the UI of APT Editor. Actually, no style exists in the AptSink. It is the renderer that pushes style. Cheers, Vincent If anyone knows the answer let me know. In the mean time, I will have a look at Trygve's code (thanks for the links by the way) to see how he's done it. Trygve, if you want to contribute some code (in one way or the other) let me know, I'm sure we can help each other, we seem to have the same goal! Thanks, Math On 7/26/07, Trygve Laugstøl [EMAIL PROTECTED] wrote: Lukas Theussl wrote: Vincent Siveton wrote: Hi Math! I recently add a pointer on your tool, so I am aware about your tool. 2007/7/25, Mathieu Avoine [EMAIL PROTECTED]: Hi everyone, I'm developing an Eclipse plugin called APT Editor which, like its name suggests, is an editor/viewer for APT files. Basically, it offers an edit pane to update the contents of the document, and a view pane to preview the formatted version of the document in HTML. It is a great tool for dev. We could have a live renderer. The project page is http://apteditor.sf.net Some people asked me if it was possible to offer the possibility to use Maven Doxia's parser/renderer instead of the original code from pixware. Sounds like a good idea to me, however not being a Doxia developer (not even a Maven user to be honest) I wouldn't know where to look. I'd appreciate if someone could give me some pointers as to how I could integrate Doxia with the APT Editor. To summarize, I'd need to know what libraries to load and what methods to invoke to generate an HTML version of a given APT file into a chosen directory. First, I suggest you to do a smart co of the doxia site http://svn.apache.org/repos/asf/maven/doxia/site We added lot of documentations these days. Would be nice if we could publish the new docs already (for people who are not familiar with maven to build the site themselves), at least somewhere on a stage site, or even live, since the main site is just user docs. WDYT? And another co from the full doxia project The apt parser is here: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-modules/doxia-module-apt Another link that might be useful is Trygve's doxia-editor: https://svn.apache.org/repos/asf/maven/sandbox/trunk/doxia/doxia-editor/ It's still in the sandbox and not very much advanced (it currently only does apt - xdoc conversion, and that not correctly... :( ), but from what I understand, it's supposed to be a stand-alone editor/renderer for any doxia-supported format. The biggest problem with creating an editor for Doxia is that Doxia has no object model, it is all about events which is a major PITA. The only thing that is usable from the editor I made is the stuff that builds the objects. -- Trygve
Re: APTEditor + Doxia
Lukas Theussl wrote: Vincent Siveton wrote: Hi Math! I recently add a pointer on your tool, so I am aware about your tool. 2007/7/25, Mathieu Avoine [EMAIL PROTECTED]: Hi everyone, I'm developing an Eclipse plugin called APT Editor which, like its name suggests, is an editor/viewer for APT files. Basically, it offers an edit pane to update the contents of the document, and a view pane to preview the formatted version of the document in HTML. It is a great tool for dev. We could have a live renderer. The project page is http://apteditor.sf.net Some people asked me if it was possible to offer the possibility to use Maven Doxia's parser/renderer instead of the original code from pixware. Sounds like a good idea to me, however not being a Doxia developer (not even a Maven user to be honest) I wouldn't know where to look. I'd appreciate if someone could give me some pointers as to how I could integrate Doxia with the APT Editor. To summarize, I'd need to know what libraries to load and what methods to invoke to generate an HTML version of a given APT file into a chosen directory. First, I suggest you to do a smart co of the doxia site http://svn.apache.org/repos/asf/maven/doxia/site We added lot of documentations these days. Would be nice if we could publish the new docs already (for people who are not familiar with maven to build the site themselves), at least somewhere on a stage site, or even live, since the main site is just user docs. WDYT? And another co from the full doxia project The apt parser is here: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-modules/doxia-module-apt Another link that might be useful is Trygve's doxia-editor: https://svn.apache.org/repos/asf/maven/sandbox/trunk/doxia/doxia-editor/ It's still in the sandbox and not very much advanced (it currently only does apt - xdoc conversion, and that not correctly... :( ), but from what I understand, it's supposed to be a stand-alone editor/renderer for any doxia-supported format. The biggest problem with creating an editor for Doxia is that Doxia has no object model, it is all about events which is a major PITA. The only thing that is usable from the editor I made is the stuff that builds the objects. -- Trygve
Re: APTEditor + Doxia
Thanks to all of you for the answers. Now more questions! ;) I've been reading through some code in Doxia lately to understand how HTML site generation is done, however foreign code is always hard to read and I was hoping someone would digest it a little bit for me (like I always say, saving time requires to be lazy :P). What I need to know is if it's still possible to call a Driver to have the contents generated in a given place? Let me explain. If I try to make a parallel with what I have done with Pixware's parser to achieve my goal, I only extended the class fr.pixware.apt.convert.Driver ( apteditor.drivers.APTEditorDriver) and called the appropriate method. A bit of code explains always better, so take a look at the following link, on line 200, this is where all the magic happens in APT Editor: http://apteditor.cvs.sourceforge.net/apteditor/APTEditor/src/apteditor/editors/MultiPageEditor.java?revision=1.3view=markup I wish I could do the same with Doxia and let it do the dirty work: finding the css, figures and other, execute macros, etc, so I can concentrate on adding nice features to the UI of APT Editor. If anyone knows the answer let me know. In the mean time, I will have a look at Trygve's code (thanks for the links by the way) to see how he's done it. Trygve, if you want to contribute some code (in one way or the other) let me know, I'm sure we can help each other, we seem to have the same goal! Thanks, Math On 7/26/07, Trygve Laugstøl [EMAIL PROTECTED] wrote: Lukas Theussl wrote: Vincent Siveton wrote: Hi Math! I recently add a pointer on your tool, so I am aware about your tool. 2007/7/25, Mathieu Avoine [EMAIL PROTECTED]: Hi everyone, I'm developing an Eclipse plugin called APT Editor which, like its name suggests, is an editor/viewer for APT files. Basically, it offers an edit pane to update the contents of the document, and a view pane to preview the formatted version of the document in HTML. It is a great tool for dev. We could have a live renderer. The project page is http://apteditor.sf.net Some people asked me if it was possible to offer the possibility to use Maven Doxia's parser/renderer instead of the original code from pixware. Sounds like a good idea to me, however not being a Doxia developer (not even a Maven user to be honest) I wouldn't know where to look. I'd appreciate if someone could give me some pointers as to how I could integrate Doxia with the APT Editor. To summarize, I'd need to know what libraries to load and what methods to invoke to generate an HTML version of a given APT file into a chosen directory. First, I suggest you to do a smart co of the doxia site http://svn.apache.org/repos/asf/maven/doxia/site We added lot of documentations these days. Would be nice if we could publish the new docs already (for people who are not familiar with maven to build the site themselves), at least somewhere on a stage site, or even live, since the main site is just user docs. WDYT? And another co from the full doxia project The apt parser is here: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-modules/doxia-module-apt Another link that might be useful is Trygve's doxia-editor: https://svn.apache.org/repos/asf/maven/sandbox/trunk/doxia/doxia-editor/ It's still in the sandbox and not very much advanced (it currently only does apt - xdoc conversion, and that not correctly... :( ), but from what I understand, it's supposed to be a stand-alone editor/renderer for any doxia-supported format. The biggest problem with creating an editor for Doxia is that Doxia has no object model, it is all about events which is a major PITA. The only thing that is usable from the editor I made is the stuff that builds the objects. -- Trygve
Re: APTEditor + Doxia
2007/7/26, Lukas Theussl [EMAIL PROTECTED]: Vincent Siveton wrote: Hi Math! I recently add a pointer on your tool, so I am aware about your tool. 2007/7/25, Mathieu Avoine [EMAIL PROTECTED]: Hi everyone, I'm developing an Eclipse plugin called APT Editor which, like its name suggests, is an editor/viewer for APT files. Basically, it offers an edit pane to update the contents of the document, and a view pane to preview the formatted version of the document in HTML. It is a great tool for dev. We could have a live renderer. The project page is http://apteditor.sf.net Some people asked me if it was possible to offer the possibility to use Maven Doxia's parser/renderer instead of the original code from pixware. Sounds like a good idea to me, however not being a Doxia developer (not even a Maven user to be honest) I wouldn't know where to look. I'd appreciate if someone could give me some pointers as to how I could integrate Doxia with the APT Editor. To summarize, I'd need to know what libraries to load and what methods to invoke to generate an HTML version of a given APT file into a chosen directory. First, I suggest you to do a smart co of the doxia site http://svn.apache.org/repos/asf/maven/doxia/site We added lot of documentations these days. Would be nice if we could publish the new docs already (for people who are not familiar with maven to build the site themselves), at least somewhere on a stage site, or even live, since the main site is just user docs. WDYT? Done. Just waiting for sync. Cheers, Vincent And another co from the full doxia project The apt parser is here: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-modules/doxia-module-apt Another link that might be useful is Trygve's doxia-editor: https://svn.apache.org/repos/asf/maven/sandbox/trunk/doxia/doxia-editor/ It's still in the sandbox and not very much advanced (it currently only does apt - xdoc conversion, and that not correctly... :( ), but from what I understand, it's supposed to be a stand-alone editor/renderer for any doxia-supported format. FYI, Lukas started an issue to see the differences between pixware APT parser and doxia one: DOXIA-138 Here's the full link, just in case ;) http://jira.codehaus.org/browse/DOXIA-138 Cheers, -Lukas Cheers, Vincent Thanks for your help! Math
Re: APTEditor + Doxia
Hi Math! I recently add a pointer on your tool, so I am aware about your tool. 2007/7/25, Mathieu Avoine [EMAIL PROTECTED]: Hi everyone, I'm developing an Eclipse plugin called APT Editor which, like its name suggests, is an editor/viewer for APT files. Basically, it offers an edit pane to update the contents of the document, and a view pane to preview the formatted version of the document in HTML. It is a great tool for dev. We could have a live renderer. The project page is http://apteditor.sf.net Some people asked me if it was possible to offer the possibility to use Maven Doxia's parser/renderer instead of the original code from pixware. Sounds like a good idea to me, however not being a Doxia developer (not even a Maven user to be honest) I wouldn't know where to look. I'd appreciate if someone could give me some pointers as to how I could integrate Doxia with the APT Editor. To summarize, I'd need to know what libraries to load and what methods to invoke to generate an HTML version of a given APT file into a chosen directory. First, I suggest you to do a smart co of the doxia site http://svn.apache.org/repos/asf/maven/doxia/site We added lot of documentations these days. And another co from the full doxia project The apt parser is here: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk/doxia-modules/doxia-module-apt FYI, Lukas started an issue to see the differences between pixware APT parser and doxia one: DOXIA-138 Cheers, Vincent Thanks for your help! Math