Chunked guide

[Jon Hermansen]

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, <markd at macports.org> 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
> macports-dev at lists.macosforge.org
> http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-dev/attachments/20080720/d58bc072/attachment.html