Wiki source code of XWiki CSS Files
Version 1.4 by agoncal on 2007/03/22
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | 1 CSS Files | ||
| 2 | |||
| 3 | This page helps you to understand the different css files used in XWiki, their purpose and content. XWiki skins use several css files to separe the different components of the skin: basic elements, layout, colors, etc. Check this [page>CSSLayout] to learn about XWiki layout. | ||
| 4 | |||
| 5 | 1.1 Core files | ||
| 6 | |||
| 7 | 1.1.1 style.css | ||
| 8 | Is the top level style file. It's purpose is to include all the other files. It shouldn't have any other css in there. It looks like that : | ||
| 9 | {code} | ||
| 10 | @import "classes.css"; | ||
| 11 | @import "colorsblack.css"; | ||
| 12 | @import "elements.css"; | ||
| 13 | @import "presentation.css"; | ||
| 14 | @import "screenlayout.css"; | ||
| 15 | ... | ||
| 16 | {code} | ||
| 17 | \\ | ||
| 18 | |||
| 19 | 1.1.1 elements.css | ||
| 20 | This stylesheet is intended to provide general design rules | ||
| 21 | regarding the html elements. For example, default font size and family for headings, underline for links, etc. You can get a blank version of this stylesheet at this [address > http://www.webproducer.at/lab/elements.css]. It should not provide color properties. It looks like that : | ||
| 22 | {code} | ||
| 23 | body { | ||
| 24 | margin: 0; | ||
| 25 | padding: 0em; | ||
| 26 | font-size: 90.01%; | ||
| 27 | line-height: 1.25em; | ||
| 28 | background: white; | ||
| 29 | color: black; | ||
| 30 | font-family: "Arial", "Lucida", "Trebuchet MS", "Luxi Sans", "Helvetica", sans-serif; | ||
| 31 | } | ||
| 32 | h1 { | ||
| 33 | font-size: 1.5em; | ||
| 34 | line-height: 1.33em; | ||
| 35 | margin: 0.89em 0; | ||
| 36 | } | ||
| 37 | ul { | ||
| 38 | margin: 1em 0; | ||
| 39 | padding: 0 0 0 2.5em; | ||
| 40 | } | ||
| 41 | ... | ||
| 42 | {code} | ||
| 43 | \\ | ||
| 44 | |||
| 45 | 1.1.1 classes.css | ||
| 46 | Like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a | ||
| 47 | random id). As examples, .underline, .hidden, .sep, wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css. It looks like that : | ||
| 48 | {code} | ||
| 49 | .xwikisep, .xwikisep2 { | ||
| 50 | display: none; | ||
| 51 | } | ||
| 52 | .clear, .clearfloats { | ||
| 53 | clear: both; | ||
| 54 | } | ||
| 55 | .none, .hidden { | ||
| 56 | display: none; | ||
| 57 | } | ||
| 58 | ... | ||
| 59 | {code} | ||
| 60 | \\ | ||
| 61 | |||
| 62 | 1.1.1 screenlayout.css | ||
| 63 | The place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side | ||
| 64 | panels, menu, footer...). | ||
| 65 | {code} | ||
| 66 | body#body{ | ||
| 67 | width: 100%; | ||
| 68 | padding: 0; | ||
| 69 | margin: 0 ; | ||
| 70 | min-width: 760px; | ||
| 71 | } | ||
| 72 | .minwidth, .minwidthb, .minwidthc{ | ||
| 73 | width: 720px; | ||
| 74 | height: 0px; | ||
| 75 | } | ||
| 76 | .minwidthc{ | ||
| 77 | width: 438px; | ||
| 78 | } | ||
| 79 | ... | ||
| 80 | {code} | ||
| 81 | \\ | ||
| 82 | |||
| 83 | 1.1.1 presentation.css | ||
| 84 | Refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.). | ||
| 85 | {code} | ||
| 86 | .box, | ||
| 87 | .main-content { | ||
| 88 | margin: 0.5em; | ||
| 89 | } | ||
| 90 | ... | ||
| 91 | {code} | ||
| 92 | \\ | ||
| 93 | |||
| 94 | 1.1.1 colors*.css | ||
| 95 | Is the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color. | ||
| 96 | {code} | ||
| 97 | .heading-1, .heading-1-1, .heading-1-1-1, .heading-1-1-1-1 { | ||
| 98 | color: #369; | ||
| 99 | } | ||
| 100 | ul.xwikiintra{ | ||
| 101 | border-bottom-color: #DDD; | ||
| 102 | background-color: #EEE; | ||
| 103 | } | ||
| 104 | ... | ||
| 105 | {code} | ||
| 106 | \\ | ||
| 107 | |||
| 108 | 1.1 Special purpose files | ||
| 109 | |||
| 110 | 1.1.1 rss.css | ||
| 111 | A few rules to format how profile rss is displayed. | ||
| 112 | \\ | ||
| 113 | |||
| 114 | 1.1.1 microformats.css | ||
| 115 | Stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...). | ||
| 116 | \\ | ||
| 117 | |||
| 118 | 1.1.1 chwSkin.css | ||
| 119 | Formatting for the Chart Wizard. | ||
| 120 | \\ | ||
| 121 | |||
| 122 | 1.1.1 tdwSkin.css | ||
| 123 | Formatting of the Table Datasource Wizard (part of Chart Wizard). | ||
| 124 | \\ | ||
| 125 | 1.1.1 print.css | ||
| 126 | Formatting for the @media print. | ||
| 127 | \\ | ||
| 128 | |||
| 129 | 1.1 Deprecated (soon to be removed) | ||
| 130 | 1.1.1 wiki.css | ||
| 131 | It was supposed to format wiki generated syntax, like .wikilink and .heading-1-1. | ||
| 132 | \\ | ||
| 133 | |||
| 134 | 1.1.1 xwiki.css | ||
| 135 | It was one of the few files holding css (stage 1). | ||
| 136 | \\ | ||
| 137 | |||
| 138 | 1.1.1 ie.css | ||
| 139 | Some old hacks to make the default skin work in IE too. | ||
| 140 | \\ | ||
| 141 | |||
| 142 | 1.1.1 styel1/2/3.css | ||
| 143 | Variants of the 'default' skin, with green, pink and yellow colors. | ||
| 144 | \\ | ||
| 145 | |||
| 146 | 1.1.1 temp.css | ||
| 147 | Used for some tests. | ||
| 148 | \\ | ||
| 149 | |||
| 150 | 1.1 Possibly usable files | ||
| 151 | ~~if somebody makes the skin wizard~~ | ||
| 152 | |||
| 153 | 1.1.1 customlayout.css | ||
| 154 | A dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. | ||
| 155 | \\ | ||
| 156 | |||
| 157 | 1.1.1 customcolors.css | ||
| 158 | Same, but for colors. | ||
| 159 | \\ |
