...very nice piece of software, not only can it be customized to handle a given computer language, but also any language, I mean, English, Spanish, French, Italian, etc. Such versatility should be include in the documentation as a plus.
So, I have about a dozen directories with source files that I want to document, when I use ROBODoc, I get an identical hierarchy of directories/files for the documentation.
In the html files, I noticed there are a couple of emtpy sections, namely, logo and extra.
There are a few lines of html that I would like to include in the logo section to customize the top of every page but such customization disappears upon RE-generation of the documentation...is there a way to tell ROBODoc what to include in the logo/extra sections in an automatic manner so that I don't have to go around including such thing every time the documentation is generated?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Thanks for the compliment :) Will add a few lines about this to the documentation.
As to the customization.
It is currently not possible to specify sniplets of html that are then
included in each generated html file.
The closest thing possible is to use the option --headless.
With the option the head of the documentation is not generated,
for html this would be the <html><head> ... </head> part.
With some automated post processing you can then add your own
'head' to the documents.
Have fun,
Frans.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
...very nice piece of software, not only can it be customized to handle a given computer language, but also any language, I mean, English, Spanish, French, Italian, etc. Such versatility should be include in the documentation as a plus.
So, I have about a dozen directories with source files that I want to document, when I use ROBODoc, I get an identical hierarchy of directories/files for the documentation.
In the html files, I noticed there are a couple of emtpy sections, namely, logo and extra.
There are a few lines of html that I would like to include in the logo section to customize the top of every page but such customization disappears upon RE-generation of the documentation...is there a way to tell ROBODoc what to include in the logo/extra sections in an automatic manner so that I don't have to go around including such thing every time the documentation is generated?
Thanks for the compliment :) Will add a few lines about this to the documentation.
As to the customization.
It is currently not possible to specify sniplets of html that are then
included in each generated html file.
The closest thing possible is to use the option --headless.
With the option the head of the documentation is not generated,
for html this would be the <html><head> ... </head> part.
With some automated post processing you can then add your own
'head' to the documents.
Have fun,
Frans.
Yeah, I kind of figured that one out after playing with the options some more.
I ended up putting the doc generation commands in a make file and added some sed command there too to add a common header to all files.
Thanks for your reply.
G.Salazar