Re: flavours IV

On Fri, 18 Mar 2005, Russell Nelson wrote:
>
> Are they flavours, templates, or flavour templates?  I was confused by 
> #8.  I'd just change the Wiki, but I can't.

A flavour is a group of templates with a common "theme".  So an "html" 
flavour is a group of templates that when passed through the blosxom 
renderer with a bunch of entries renders an html page.  An RSS flavour is 
a group of templates that when passed through the blosxom renderer with a 
bunch of entries renders output in RSS format.  A "prettyblue" flavour 
could be a group of templates that when passed through the blosxom 
renderer with a bunchof entries renders output in HTML format with a 
pretty blue look and feel.

A flavour requires at least the following templates:

  - content_type
  - head
  - story
  - foot

Additionally, plugins can require additional templates.  For example, the 
comments plugin requires comment-story, comment, and comment-form.

For more on flavours and templates, read:

   http://pyblosxom.sourceforge.net/blog/static/man_3_flavours.html

Does that make sense?


> Are there any other flavour files needed by other existing plugins?

It's impossible to quantify what existing plugins there are and what 
templates they might use.  However, you could look through the plugin 
registry and see what plugins are interesting and create the templates 
required by those.

The plugin registry is here:

   http://pyblosxom.sourceforge.net/blog/registry?sortby=path


> What problem does content_type solve?  Shouldn't it just default to
> text/html if it's missing?

The content_type template holds the content type to return in the HTTP 
headers.  Skipping it is not an option--it should be there.  There are a 
bunch of different content types that could be returned:

  - text/html
  - text/xhtml
  - application/xml
  - ...

It does not and should not default to text/html if it is missing.


> If I set defaultFlavour in config.py, it doesn't seem to affect the
> flavour of individual stories.

I'm not sure what you're getting at here.  Hopefully the confusion you 
might have is answered above.


> If I use ?flav=whatever, it is not passed into pycategories, so the
> flavour choice isn't propagated.

Ok.  That could be a bug in pycategories.  I can take a look at that when 
I have a free moment.  Alternatively, if someone else has time to look 
into it, that would be much appreciated.


> I see no way to use ?flav=whatever in a permalink, so that method of
> flavour setting can't be propagated into a single story.

I'm not sure what you mean here, either.


Hope that helps.  Out of curiosity, are you reading documentation we have? 
If so, which documentation have you read?

/will

-- 
whatever it is, you can find it at http://www.bluesock.org/~willg/
except Will--you can only see him in real life.


-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click