Say, when we cut a release, can we also run this from the inkscape_web directory on SF:
pod2html --cachedir=/tmp --infile=../inkscape/inkscape.pod --outfile=doc/inkscape.html
And what do people think of adding a "man page" link to the "documentation.php" file to look at this file?
On Sun, 30 Nov 2003, Kees Cook wrote:
Say, when we cut a release, can we also run this from the inkscape_web directory on SF:
pod2html --cachedir=/tmp --infile=../inkscape/inkscape.pod --outfile=doc/inkscape.html
I've added this to the CreatingDists page in Wiki, but I'm wondering if there might be a better way of handling it? I've noticed with the Doxygen pages we get a ton of chmod warnings when updating the website.
Is it possible to set up some <Location> segragation in an .htaccess file to split up the website file structure into logical components?
Actually, in thinking about it, you probably want to use man2html, since to create the man page there were some additional steps such as substituting the AUTHORS section.
Also, make sure to strip the header/footer and replace it with php includes of the site header/footer. Look at the 'stripheadfoot' script in tgen, for an example.
And what do people think of adding a "man page" link to the "documentation.php" file to look at this file?
That's fine. I figure once we've accumulated enough docs here, someone may want to restructure this section a bit. For example, we're mixing user and developer docs together but these may be better to split out independently.
Thanks, Bryce
On Sun, Nov 30, 2003 at 11:22:24AM -0800, Bryce Harrington wrote:
there might be a better way of handling it? I've noticed with the Doxygen pages we get a ton of chmod warnings when updating the website.
Hopefully that won't happen any more. The perms were wrong.
Actually, in thinking about it, you probably want to use man2html, since to create the man page there were some additional steps such as substituting the AUTHORS section.
Whoops, yeah.
Also, make sure to strip the header/footer and replace it with php includes of the site header/footer. Look at the 'stripheadfoot' script in tgen, for an example.
True as well. Can someone script this up? I've done the initial steps in inkscape_project/doxygen/update.sh, but it needs:
- step to replace AUTHORS section - step to add/replace header footer
That's fine. I figure once we've accumulated enough docs here, someone may want to restructure this section a bit. For example, we're mixing user and developer docs together but these may be better to split out independently.
I think just listing user docs first might be good enough.
On Sun, 30 Nov 2003, Kees Cook wrote:
On Sun, Nov 30, 2003 at 11:22:24AM -0800, Bryce Harrington wrote:
there might be a better way of handling it? I've noticed with the Doxygen pages we get a ton of chmod warnings when updating the website.
Hopefully that won't happen any more. The perms were wrong.
Cool, thanks.
Also, make sure to strip the header/footer and replace it with php includes of the site header/footer. Look at the 'stripheadfoot' script in tgen, for an example.
True as well. Can someone script this up? I've done the initial steps in inkscape_project/doxygen/update.sh, but it needs:
- step to replace AUTHORS section
- step to add/replace header footer
Add these to the Roadmap for 0.37 in the website section, and if no one else beats me to it, I'll do take care of it then.
That's fine. I figure once we've accumulated enough docs here, someone may want to restructure this section a bit. For example, we're mixing user and developer docs together but these may be better to split out independently.
I think just listing user docs first might be good enough.
Okay.
Bryce
participants (2)
-
Bryce Harrington -
Kees Cook