diff options
Diffstat (limited to 'css/README.txt')
-rwxr-xr-x | css/README.txt | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/css/README.txt b/css/README.txt new file mode 100755 index 0000000..3a128ae --- /dev/null +++ b/css/README.txt @@ -0,0 +1,134 @@ +ZEN'S STYLESHEETS +----------------- + +Don't panic! + +There are 28 CSS files in this sub-theme, but its not as bad as it first seems: +- The drupal6-reference.css is just a reference file and isn't used directly by + your sub-theme. See below. +- There are 9 CSS files whose names end in "-rtl.css". Those are CSS files + needed to style content written in Right-to-Left languages, such as Arabic and + Hebrew. If your website doesn't use such languages, you can safely delete all + of those CSS files. +- If you aren't using this theme while doing wireframes of the functionality of + your sub-theme, you can remove wireframes.css from your sub-theme's .info file + and delete the file as well. + +That leaves just 17 CSS files. (Okay, still quite a few, but better than 28.) + +- Instead of one monolithic stylesheet, your sub-theme's CSS files are organized + into several smaller stylesheets that are grouped to allow cascading across + common Drupal template files. +- The order of the stylesheets is designed to allow CSS authors to use the + lowest specificity possible to achieve the required styling. + + +ORDER AND PURPOSE OF DEFAULT STYLESHEETS +---------------------------------------- + +First off, if you find you don't like this organization of stylesheets, you are +free to change it; simply edit the stylesheet declarations in your sub-theme's +.info file. This structure was crafted based on several years of experience +theming Drupal websites. + +- html-reset.css: + This is the place where you should set the default styling for all HTML + elements and standardize the styling across browsers. If you prefer a specific + reset method, feel free to add it. + +- layout-fixed.css: +- layout-liquid.css: + Zen's default layout is based on the Zen Columns layout method. The + layout-fixed.css file is used by default and can be swapped with the + layout-liquid.css file. These files are designed to be easily replaced. If you + are more familiar with a different CSS layout method, such as Blueprint or + 960.gs, you can replace these files with your choice of layout CSS file. + +- page-backgrounds.css: + Layered backgrounds across scattered divs can be easier to manage if they are + centralized in one location. + +- tabs.css: +- messages.css: + While most of the CSS rulesets in your sub-theme are guidelines without any + actual properties, the tabs and messages stylesheets contain actual styling + for Drupal tabs and Drupal status messages; two common Drupal elements that + are often neglected by site desiners. Zen provides some basic styling which + you are free to use or to rip out and replace. + +- pages.css: + Page styling for the markup in the page.tpl.php template. + +- blocks.css: + Block styling for the markup in the block.tpl.php template. + +- navigation.css: + The styling for your site's menus can get quite bulky and its easier to see + all the styles if they are grouped together rather then across the + header/footer sections of pages.css and in blocks.css. + +- views-styles.css: + Views styling for the markup in various views templates. You'll notice this + stylesheet isn't called "views.css" as that would override (remove) the Views + module's stylesheet. + +- nodes.css: + Node styling for the markkup in the node.tpl.php template. + +- comments.css: + Comment styling for the markup in the comment-wrapper.tpl.php and + comments.tpl.php templates. + +- forms.css: + Form styling for the markup in various Drupal forms. + +- fields.css: + Field styling for the markup produced by theme_field(). + +- print.css: + The print styles for all markup. + +- ie.css: +- ie6.css: + The Internet Explorer stylesheets are added via conditional comments. Many CSS + authors find using IE "conditional stylesheets" much easier then writing + rulesets with CSS hacks that are known to only apply to various versions of + IE. An alternative method presented by Paul Irish can be found at + http://paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/ + +In these stylesheets, we have included all of the classes and IDs from this +theme's tpl.php files. We have also included many of the useful Drupal core +styles to make it easier for theme developers to see them. + + +DRUPAL CORE'S STYLESHEETS +------------------------- + +Many of these styles are over-riding Drupal's core stylesheets, so if you remove +a declaration from them, the styles may still not be what you want since +Drupal's core stylesheets are still styling the element. See the +drupal6-reference.css file for a complete list of all Drupal 6.x core styles. + +In addition to the style declarations in these stylesheets, other Drupal styles +that you might want to override or augment are those for: + + Book Navigation See line 74 of drupal6-reference.css file + Forum See line 197 of drupal6-reference.css file + Menus See line 667 of drupal6-reference.css file + News Aggregator See line 20 of drupal6-reference.css file + Polls See line 287 of drupal6-reference.css file + Search See line 320 of drupal6-reference.css file + User Profiles See line 945 of drupal6-reference.css file + + +INTERNET EXLORER HATES YOU +-------------------------- + +All versions of IE limit you to 31 stylesheets total. What that means is that +only the first 31 stylesheets will load, ignoring the others. So you'll have +missing styles in IE7 and later and a broken layout in IE6. + +This is a known bug in IE: http://support.microsoft.com/kb/262161 + +Please read http://john.albin.net/css/ie-stylesheets-not-loading for the gory +details. |