On Mon, 2009-01-05 at 09:06 -0500, Doug Hellmann wrote:
>
> On Jan 4, 2009, at 11:45 PM, Ian Bicking wrote:
>
> >
> > Doug Hellmann wrote:
> >>
> >> On Dec 30, 2008, at 3:38 PM, Gerard Flanagan wrote:
> >>
> >>>> While theme developers could use YUI or similar libraries or
> >>>> frameworks, I don't think Sphinx's default theme should depend on
> >>>> them.
> >>>>
> >>>> Doug
> >>>>
> >>> Any particular reason? It is BSD licensed. I like it a lot, I have
> >>> to
> >>> say.
> >>
> >> It just seems excessive for a "default" setting to introduce a
> >> dependency to something as complicated as YUI.
> >
> > Dependency? I presume the YUI CSS would be included with the theme.
>
> Yes, but then if I want to make a small change to the default theme I
> have to go figure out all of YUI CSS to understand how, don't I?
> Maybe I'm misunderstanding how it would work. I'm not CSS expert by
> any stretch, but when I used YUI for a project I found it difficult to
> make it do what I wanted.
>
>
Well, I made a few Sphinx/YUI explorations here:
http://gflanagan.net/sphinx-themes/themes/
As you might see, it's not a silver bullet (I thought the 'raw' themes
would look a bit more respectable), but I still think there are
benefits. In terms of theming complexity, I personally find Jinja more
difficult than YUI grids, but that's probably just me.
If there is any interest, here is the procedure for building the above
themes:
+ create a directory, sphinx-themes say
+ in this directory, create 2 subdirectories: _static and themes
+ in _static put all the files that you find here:
http://gflanagan.net/sphinx-themes/_static
+ in themes put the following two files:
http://bazaar.launchpad.net/~grflanagan/python-rattlebag/trunk/annotate/head%3A/src/yuibuilder.py
http://bazaar.launchpad.net/~grflanagan/python-rattlebag/trunk/annotate/head%3A/scripts/mkthemes.py
+ cd to the themes directory and run `python mkthemes.py`
+ this will give you a number of html files, including index.html
+ send me a million dollars/euros
+ run firefox index.html or equivalent
Happy New Year all!
G.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
