I found that having the guide all on one page was VERY handy, I was skipping all around it when I wrote my first port. Since package management isn't too scary to me, and building from source isn't either, I essentially knew how to build the package I was trying to write, but I didn't know how to implement it in a Portfile. Getting help in IRC and cross-referencing people's suggestions with information from the guide made things really easy.
Anyways, just my two cents. On Sun, Jul 20, 2008 at 10:34 AM, <[EMAIL PROTECTED]> wrote: > >Hi, > > > >I just committed a new target "guide-chunked" to the doc-new Makefile > >which > >generates a chunked version of the guide [1]. > > > >I used a Tcl script to add the table of contents to each page. Please > >have a > >look at [2] and tell me what you think. > > > >If you like it we can activate the guide-chunked target on the > >documentation > >server and make it available to everybody. > > > >Thanks, > >Simon > > Thanks for your work on this! That is some nice scripting work. I think > we should make the chunked guide available now that you've got the TOC > handled. I think the real question now is whether to keep a "single html" > version around. The only "problem" with the chunked version is you can't > do a browser search of the whole document, but I'm not sure how many > people want that. I can live without it. I'd like to hear comments from > others. > > If a consensus is that keepind a "single html" version around is > desirable, I wouldn't want to make people select between two versions > before viewing, but provide a link to a "single html" version as an option > so the chunked version is the default viewing methood. > > Mark > > _______________________________________________ > macports-dev mailing list > [email protected] > http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev >
_______________________________________________ macports-dev mailing list [email protected] http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev
