maven-doxia-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Vincent Siveton" <vincent.sive...@gmail.com>
Subject Re: APTEditor + Doxia
Date Fri, 27 Jul 2007 13:55:35 GMT
Hi Math,

2007/7/26, Mathieu Avoine <avoinemt@gmail.com>:
> 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.3&view=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 <trygvis@apache.org> 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 <avoinemt@gmail.com>:
> > >>
> > >>> 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
> >
>

Mime
View raw message