forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Scherler, Thorsten" <>
Subject [css-style] naming convensions - our css contracts
Date Sun, 11 Jul 2004 22:53:34 GMT
Hello devs,

I am preparing a proposal for OSCOM 4

It will be a practical proposal for a cms skin based on standard naming
convensions for cms-systems. Basicly I want to talk about :

1. Why naming convensions? What are naming convensions?
2. How to implement them? What could be a basic standard for naming
3. Example implementations

Ok, nice but what has that to do with forrest ;-)?

Nicola wrote:
3 - the main page areas should be #style like
     '#header' instead of 'header'

I have read the article of Henri Bergius about naming convensions.
He thinks that "if web developers make use of naming conventions for
<div>s too, we can make it easier for regular users to create their own
visual stylesheets that will work across a wide range of sites". [1]

Bottom line I would like to use in the css-style skin standard naming 
convensions. The resulting xhtml-skeleton of the css-style skin I want 
to reuse for the default pub of lenya.

Right now there is no such standard regarding naming convensions for
cms-systems. I am researching the proposals that are out there for 
css-contracts and would implement it in the css-style skin. The result 
will be a css-style skin xhtml-skeleton that supports basic standard 
regarding naming convensions for CMS.

That would mean I will focus now in restructing the <div/>/css elements. 
I see the div names as container. Telling me what I will find there 
(makes searches easier). "Searchbox" for example tells me I will find a 
searchbox. Looking at <div id="top"/> that is not possible.

This container contains now the logos (group/project), the trail and the 
search box. I don't like "top" because it says something (though 
somewhat remotely) about the presentation, which it shouldn't.

For example if the designer wants the e.g. group logo in bottom? Then 
the container name is not representing what it contains because "top" 
contains "grouplogo" which is in the bottom. Resulting that "top" is 

Inspired by [2] I came up with the following:

     Page container makes it possible to have an overall sourrounding 
box in the pages. e.g. [1]&[2] have a black sourrounding box.

Container used for a header and banner to brand the site. That is the 
former "top".

Contains all logos to brand the site.

Used for the grouplogo.

Used for the grouplogo in alternativ location. x stands for a variable 
that represents the number of the alternativ.

Used for the projectlogo.

Used for the projectlogo in alternativ location. x stands for a variable 
that represents the number of the alternativ.

Used for a strapline or tagline to define the site's purpose. Can be as 
well used for site slogans.

Used for a trail or tagline to define the site's purpose

Related to search interface and search results

Search form container

Search form container in alternativ location. x stands for a variable 
that represents the number of the alternativ.

Search results which could include a <div> or other markup
including definition lists

#nav or #navigation
Used to contain the navigation devices

Main or primary navigation AKA tabs.

Navigation to pages within the current site section AKA menu.

Navigation to pages outside the site

     #nav-supplementary or #nav-supp
         A supplementary list of links, perhaps in a footer. This can
replace the common, but presentational #footer

         A list of links named at a designer's descretion

     Used for content rather than for another purpose such as navigation

         The main content area

         News related content

         Could include any form of content, including #content-related,
#content-quote etc.

     Used for various site related information

         Copyright information etc.

         Designer or other credits

  <name>Thorsten Scherler</name>
    "My task which I am trying to achieve is,
     by the power of the written word,
     [...] to make you see."
     *Joseph Conrad (1857-1924)*

View raw message