Re: pyblosxom 1.4 rc1 -- call for help

On 6/11/07, John Gabriele <[email protected]> wrote:
>
> 1. I wanted to read the docs as html. I see that, in the docs
> directory, there's a couple of css files and a docutils conf file. You
> might also provide a simple script that generates all the html docs
> for the user.

Whoops--that's a problem with my packaging process.  I'll fix that in
the next release.


> 2. Also regarding the doc files:

I went through and factored these suggestions in.  I'm in the process
of merging the two install files right now.


> So, it installed and worked fine on a Slackware server running Apache,
> with Python 2.5 out of my own home directory (installed in
> ``~/py-2.5.1``). I've got the docutils installed here too, so figured
> I'd set things up so I could write my entries formatted in reST.
> Grabbed contrib-1.3.3 for this. I might've tried getting it from svn,
> but I didn't see rst listed at
> http://pyblosxom.svn.sourceforge.net/viewvc/pyblosxom/trunk/contrib/plugins/text/
> . Is it supposed to be there? In the contrib-1.3.3 archive, the entry
> parsers are separated from the plugins. Why is that?

I'm not entirely sure.  I thought before I passed the plugins off to
Ryan that I had moved the plugins around in SVN so that SVN mirrored
the registry.  But that was a while ago and it's possible it was a
project I started and never finished and then didn't adequately pass
it off to Ryan.


> For now, I only want to use the blosxom renderer, and only want html
> output, and I'm guessing that most pyblosxom users start out this way.
> Maybe this portion of the manual should have a "Common basic setups"
> section for this. Also, it's seeming like there should be more
> overview material in the about_pyblosxom chapter of the manual -- or
> else maybe an overview.txt chapter of the manual.

I added some more material to about_pyblosxom so that it's clearer
what "things" in PyBlosxom are responsible for what and which pages to
look at for more information.  I'll add a "what do i do now?" section
to the INSTALL guide.


> Well, I grabbed the Gray plugin. Still reading the
> flavours_and_templates chapter, I think the first paragraph of the
> "Where to Put Your Flavour Files" could use some clarification. I
> don't yet know whether I want to (or what it means to) override and
> existing flavour or add a new flavour. So, the manual starts talking
> about "order of overiding" (sic), and ... and then I'm totally lost at
> this point.

I'm not entirely sure how to fix this.  If you could contribute fixed
text for this, that'd be very helpful.


> A tutorial for creating your own very simple html flavour would be
> most helpful here.

This would be really helpful as well.  If you have some time and want
to bang out a first draft, that'd be very helpful.

/will

-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/