Re: [Doxygen-develop] doxygen5
Brought to you by:
dimitri
From: Peter M. <ped...@gm...> - 2013-04-24 11:34:02
|
> > == Git == > > - can the doxygen start to use git as its native repos. this kinda > works, svn is not really in anymore.. (a gf u kinda dating but > releationship is boring.. from years ago.. before your first data with csv, > and before that your straightforward ftp date ;-) > > I've been experimenting with Git a bit locally and I like it, so that > certainly a direction to go to in the future. > What would you chose as a hosting site? GitHub? > Well I use gotorious, sf, github and bitbucket .. For Doxygen I would recommend github, mainly because you can still use SVN and github client works sweet on Windows... (also merges can be made on the web interface) > > > > > == New HTML 5 + CSS3 Output == > > so instead of having all complex tags everywhere, we > > just spool out the html in html5 style.. > > > > Css3 is the used to format and layout the document as required.. > > Css-3 can be used to full max strength > > > > I'm worried about cross-browser compatibility. > Not everyone is using the latest greatest browser. > Dont panic; there are tools out there to make it backward compatible.. eg html5reset and other boilerplate project inject js and like to solve this issue so I dont see this as a problem > > > > ========================== > > Tempalting > > ========================== > > The document structure and output of html needs to move into templating > land.. > > The resason for this is simple... Presentation is not part of a document > structure.. > > > > In www land, which is where documentation co exists.. > > Grentlee looks good and means we can use jinga templates. > > ie share the same stuff with a possible online inteface and rendering.. > > I've been thinking about this as well (and the layout file is a first step > into this > direction). Doxygen does have many output formats, making this less > trivial. > Probably the best solution is to start with a new backend (or use the XML > output as input). > > > > > But this leads to the issue that grantlee uses script taags.. and QScript > > and that doxygen doesn't use any recent version of Qt (only the wizard > does). > well looking at htmlgen.cpp, it should be pretty straightforward to drop in qtScript and created a "nested dictionary" for the templating. This would mean removing almost all html from htmgen.cpp and moving it to a template regards pete |