Here comes the followup according to the TomC's protocol :)
On Wed, 9 Feb 2000, Robin Berjon wrote:
> Hello fellow mod_perlians,
>
> I know I had promised to send this in by the end of December / early
> January, I am really late and sorry. I was caught in France by the french
> army for being an alleged deserteur, and they were *very* insistent on
> having me stay there. Anyway I'm out now :)
Robin, I thought it happens only in Israel :) I hope you are free now. I
went free on this Sunday. Hooray!!!
> The following document is also available at:
> http://modperl.knowscape.org/outline20000209.txt
Great document! Seems great to me!
> - small, concentrated Netcraft box heralding usage and growth
> . Apache Servers: x million / 63%
> . Modperl Powered: x hundred thousand / 5%
> . Modperl presence keeps growing at an incredible pace,
> . more -> link to /about/netcraft/
Won't it make the index.html overloaded?
> /docs/guide/
> - Stas' guide from http://perl.apache.org/guide/
> Note: there's a lot of great documentation out there. I don't know
> if we should do a separate section for the guide or not, or
> for all. The size of the guide seems to require it.
Ged, I and probably Andrew will work on restructing the guide to improve
the structure and navigatability. But this after Ged completes the review
of the current chapters more or less, and me inserting the long list of
items from my todo list.
> Note: should the guide match layout of the rest of the site ? Doing
> it shouldn't be a problem and it might be better to have a
> consistent layout but I'm totally unsure of this, and of
> course it is up to Stas to make the final decision on this
> point. The HTML of the guide being generated, I guess we can
> have as many layouts as we want/need.
Everything is generated from the POD sources. I'll tweak the output
generator as you will like, to make the look and feel consistent.
BTW, you didn't mention a usage of CSS files to enforce the look and feel.
> - mention Stas' guide + Eric -> book
Please don't forget Eric, he works harder than me, but you cannot see that
before the book gets published. The news item at the demo page doesn't
mention his name. Thank you!
> Wrapper/converter for text and pod files
> ========================================
>
> Much of the user-contributed material comes in text or pod. To provide a
> look and feel consistent with the rest of the site, we will need to
> develop a script to "wrap" into a template for the site. The pod2html
> script is insufficient for this task but we can probably leverage
> earlier work by Stas (for the Guide) on such scripts as well as
> Pod::Parser.
Yup, I've hacked the original pod2html, which I use in the guide. You can
use it. Another code to use is the Site::Builder that I wrote for the
Source Garden. It knows automatically generate htmls from .pod, .prepod
(item lists + pod) and .txt -- see
http://modperl.sourcegarden.org/safari/modperl/-/-/site_builder/
> Module Database
> ===============
>
> A list of the names + download link + description/author/last_modified/
> CPAN_status + link to the homepage for the module + synopsis.
>
> Part of this can be handled automatically by a cron script that would
> check CPAN on a regular basis (or the already existing database of
> search.cpan.org) and update the list using more or less the same method
> as for the news.
>
> This would hopefully help keep the modlist constantly up-to-date while
> reducing the maintenance to be done on it. Meanwhile, the maintenance
> can still be done by hand.
That's something that Fresh:: modules should cope with when James
completes them. They will serve the sourcegarden goal to make all the
stuff generated from the DB. The intention is to remove all the static
pages (from the perl.apache.org) that would benefit from the
administration speedup.
> . sending PNG instead of GIF to user-agents that support them would
> be nice, but I haven't come up with a reliable way to do this yet
> (content-negotiation is probably insufficient)
Be careful with PNG as they kicks off my older Netscape browser on linux!
> >text
> - this is much easier obviously, however I've often heard people say
> they thought text-navigation was easier with the navbar at the top
> and bottom of the page. I'd like to have opinions on this, but
> please let's avoid religion wars on this subject.
I think what you wanted/need to write here is a lynx compatibility for
the impared folks and those who prefer text mode browsing.
-----
Thanks Robin!!!
_______________________________________________________________________
Stas Bekman mailto:[EMAIL PROTECTED] http://www.stason.org/stas
Perl,CGI,Apache,Linux,Web,Java,PC http://www.stason.org/stas/TULARC
perl.apache.org modperl.sourcegarden.org perlmonth.com perl.org
single o-> + single o-+ = singlesheaven http://www.singlesheaven.com
