• OOTB Plone Themes discussion

  • Lessons learned thus far from OOTB theming sprint

    from vedawms on Apr 28, 2008 08:13 PM
    I wanted to point out a few things that I've learned during the first wave
    of the OOTB theming project, as I'm seeing some trends. In some cases, I may
    be completely off base, but I'd love to throw these out for feedback.
    
    1) We need a readme for all of our themes that give guidelines on the kinds
    of things that should be included (how to install, contact information,
    prerequisites, browsers it was tested against, licensing, etc.). There's
    apparently one for WordPress that we could pretty easily Plone-ify with some
    input. This would be included as part of the paster template.
    
    2) We need an instruction set on plone.org that advocates best practices.
    We're collecting this information now.
    
    3) In inspecting a lot of the themes going past, I'm noticing that there are
    css and theming-related files turning up in both a skins directory and the
    browser directory. Personally, I don't see the value of having theming stuff
    inside the browser directory, and we're ending up with a lot of empty, junky
    stylesheets. It feels like mixing apples and oranges, and I'd like to see
    the theming stuff wind up only in the skins folder. This would mean a change
    to the paster template.
    
    4) In addition to #3, I realized that the plone stylesheets are pulled in
    very nebulously by buildout, and the only way to gain access to these
    stylesheets is by referencing an old non-buildout installation of the site.
    This is especially problematic for new themers who won't have the historical
    knowledge of what stylesheets are available to them. I'd like to either a)
    alter the paster theme recipe so that those themes are pulled into each and
    every theme, or b) provide a resource to make those available to themers.
    
    5) I'm not very satisfied with the current solution the paster template uses
    to override public.css or base.css (nor do I like the fact that it overrides
    these in the first place). It needs to be optional, and more cleanly
    handled. I'd like to see better instructions on how to override plone css
    files (ie, via the stylesheets.xml file). There's too much magic in it right
    now and empty stylesheets feel like clutter.
    
    6) I'd like any generated css files to support dtml out of the box.
    
    7) I'd like there to be a theming champion for the long haul who can review
    themes for correctness, much like we want editors for various sections of
    the Documentation area. A theme submission process would be necessary, but I
    don't want to see things get backlogged, so this could be optional.
    
    8) I'd like to see sitemap styling pulled out into its own stylesheet.
    Either that, or clean up the base plone.css so it's not so unattractive out
    of the box.
    
    9) Favicon addition would be something neat that could be added via the new
    CSS Manager product, perhaps?
    
    10) @@manage-viewlets window desperately needs to be enhanced so that for
    complex themes, it's easy to see the pieces and parts you're dealing with.
    With a complex theme, items often run over each other and it's hard to read
    / move items. On a super-wish-list, it would be nice to use this area to
    actually create / manage viewlets, but that's a product amongst itself.
    
    Many more ideas coming, I just had to get these out of my head. Thoughts on
    these? 
    
    Thanks,
    
    - Veda
    
    
    ------------------------
    Veda Williams
    Project Manager/Skinner
    ONE/Northwest
    
    New tools and strategies for engaging people in protecting the environment
    
    veda@...
    http://www.onenw.org
    Skype ID: vedawms
    Phone: 206.286-1235 x24
    Fax: 206.260.2737
    
    Subscribe to ONEList, our email newsletter!
    Practical advice for effective online engagement
    http://www.onenw.org/full_signup
    
    
    
    Thread Outline:
  • Re: Lessons learned thus far from OOTB theming sprint

    from duffyd on Apr 28, 2008 08:33 PM
    Hi Veda,
    
    Thanks for the discussion points.
    
    On Mon, 2008-04-28 at 17:12 -0700, Veda Williams wrote:
    
    <snip good discussion points />
    
    > 
    > 4) In addition to #3, I realized that the plone stylesheets are pulled in
    > very nebulously by buildout, and the only way to gain access to these
    > stylesheets is by referencing an old non-buildout installation of the site.
    > This is especially problematic for new themers who won't have the historical
    > knowledge of what stylesheets are available to them. I'd like to either a)
    > alter the paster theme recipe so that those themes are pulled into each and
    > every theme, or b) provide a resource to make those available to themers.
    
    Just wondering if you could clarify what you mean here? Are you talking
    about the base.css and public.css that you mention later on in your
    email?
    
    > 
    <snip more good discussion points />
    
    Thanks,
    Tim
    
    
  • Re: [Plone-Users] Lessons learned thus far from OOTB theming sprint

    from wichert on Apr 29, 2008 01:01 PM
    Previously Veda Williams wrote:
    > 3) In inspecting a lot of the themes going past, I'm noticing that there are
    > css and theming-related files turning up in both a skins directory and the
    > browser directory. Personally, I don't see the value of having theming stuff
    > inside the browser directory, and we're ending up with a lot of empty, junky
    > stylesheets. It feels like mixing apples and oranges, and I'd like to see
    > the theming stuff wind up only in the skins folder. This would mean a change
    > to the paster template.
    
    I feel that the decision in DIYPloneStye/theme ZopeSkel template to use
    browser resouces was premature. Browser resources do not get the proper
    caching handling that skins get, which is a performance problem.
    
    Personally I find the URLs produced by browser resources quite ugly
    as well, but that is not a technical argument.
    
    > 4) In addition to #3, I realized that the plone stylesheets are pulled in
    > very nebulously by buildout, and the only way to gain access to these
    > stylesheets is by referencing an old non-buildout installation of the site.
    > This is especially problematic for new themers who won't have the historical
    > knowledge of what stylesheets are available to them. I'd like to either a)
    > alter the paster theme recipe so that those themes are pulled into each and
    > every theme, or b) provide a resource to make those available to themers.
    
    I'm afraid I have no idea what you are trying to say here.
    
    > 5) I'm not very satisfied with the current solution the paster template uses
    > to override public.css or base.css (nor do I like the fact that it overrides
    > these in the first place). It needs to be optional, and more cleanly
    > handled. I'd like to see better instructions on how to override plone css
    > files (ie, via the stylesheets.xml file). There's too much magic in it right
    > now and empty stylesheets feel like clutter.
    
    For a full skin you always want to override those completely. For
    minimal themes of the add-some-colour-and-a-bit-of-bling style themes
    you can use them.
    
    Wichert.
    
    -- 
    Wichert Akkerman <wichert@...>    It is simple to make things.
    http://www.wiggy.net/                   It is hard to make things simple.
    
    • Re: Re: [Plone-Users] Lessons learned thus far from OOTB theming sprint

      from duffyd on Apr 29, 2008 04:01 PM
      Hi Wichert,
      
      On Tue, 2008-04-29 at 09:44 +0200, Wichert Akkerman wrote:
      
      <snip />
      
      > 
      > > 5) I'm not very satisfied with the current solution the paster template uses
      > > to override public.css or base.css (nor do I like the fact that it overrides
      > > these in the first place). It needs to be optional, and more cleanly
      > > handled. I'd like to see better instructions on how to override plone css
      > > files (ie, via the stylesheets.xml file). There's too much magic in it right
      > > now and empty stylesheets feel like clutter.
      > 
      > For a full skin you always want to override those completely. For
      > minimal themes of the add-some-colour-and-a-bit-of-bling style themes
      > you can use them.
      
      Just my 2c but I always leave the default stylesheets there and work off
      them as a basis and just override the styles in my custom stylesheet.
      
      -Tim
      
      > 
      > Wichert.
      > 
      
      
      • Re: Re: [Plone-Users] Lessons learned thus far from OOTB theming sprint

        from "David Bain" on Apr 30, 2008 12:28 AM
        I also leave the default stylesheets. One of the most valuable tools for me
        is firebug, it helps me to quickly see what affects what.
        
        On Tue, Apr 29, 2008 at 3:00 PM, Tim Knapp <duffyd@...> wrote:
        
        > Hi Wichert,
        >
        > On Tue, 2008-04-29 at 09:44 +0200, Wichert Akkerman wrote:
        >
        > <snip />
        >
        > >
        > > > 5) I'm not very satisfied with the current solution the paster
        > template uses
        > > > to override public.css or base.css (nor do I like the fact that it
        > overrides
        > > > these in the first place). It needs to be optional, and more cleanly
        > > > handled. I'd like to see better instructions on how to override plone
        > css
        > > > files (ie, via the stylesheets.xml file). There's too much magic in it
        > right
        > > > now and empty stylesheets feel like clutter.
        > >
        > > For a full skin you always want to override those completely. For
        > > minimal themes of the add-some-colour-and-a-bit-of-bling style themes
        > > you can use them.
        >
        > Just my 2c but I always leave the default stylesheets there and work off
        > them as a basis and just override the styles in my custom stylesheet.
        >
        > -Tim
        >
        > >
        > > Wichert.
        > >
        >
        >
        >
        > --
        > Archive:
        > http://www.openplans.org/projects/ootb-plone-themes/lists/ootb-plone-themes-discussion/archive/2008/04/1209499260286
        > To unsubscribe send an email with subject unsubscribe to
        > ootb-plone-themes-discussion@....  Please contact
        > ootb-plone-themes-discussion-manager@... for questions.
        >
        >