Fossil SCM
Removed doc/help references to "overriding" CSS rules, as that no longer applies in this branch.
Commit
a21e26684f76a3685ea03511ee596e4ba2264a2a2becca03e41f477093700488
Parent
5abc0f6e79dfbfc…
2 files changed
+1
-3
-33
+1
-3
| --- src/skins.c | ||
| +++ src/skins.c | ||
| @@ -708,13 +708,11 @@ | ||
| 708 | 708 | ** for use only from the /setup_skinedit page. |
| 709 | 709 | */ |
| 710 | 710 | static void skin_emit_css_defaults(){ |
| 711 | 711 | struct strctCssDefaults const * pCss; |
| 712 | 712 | fossil_print("<h1>CSS Defaults</h1>"); |
| 713 | - fossil_print("If a skin defines any of the following CSS selectors, " | |
| 714 | - "that definition replaces the default, as opposed to " | |
| 715 | - "cascading from it. "); | |
| 713 | + fossil_print("Fossil's list of its own CSS classes follows. "); | |
| 716 | 714 | fossil_print("See <a href=\"https://fossil-scm.org/fossil/" |
| 717 | 715 | "doc/trunk/www/css-tricks.md\">this " |
| 718 | 716 | "document</a> for more details."); |
| 719 | 717 | /* To discuss: do we want to list only the default selectors or |
| 720 | 718 | ** also their default values? The latter increases the size of the |
| 721 | 719 |
| --- src/skins.c | |
| +++ src/skins.c | |
| @@ -708,13 +708,11 @@ | |
| 708 | ** for use only from the /setup_skinedit page. |
| 709 | */ |
| 710 | static void skin_emit_css_defaults(){ |
| 711 | struct strctCssDefaults const * pCss; |
| 712 | fossil_print("<h1>CSS Defaults</h1>"); |
| 713 | fossil_print("If a skin defines any of the following CSS selectors, " |
| 714 | "that definition replaces the default, as opposed to " |
| 715 | "cascading from it. "); |
| 716 | fossil_print("See <a href=\"https://fossil-scm.org/fossil/" |
| 717 | "doc/trunk/www/css-tricks.md\">this " |
| 718 | "document</a> for more details."); |
| 719 | /* To discuss: do we want to list only the default selectors or |
| 720 | ** also their default values? The latter increases the size of the |
| 721 |
| --- src/skins.c | |
| +++ src/skins.c | |
| @@ -708,13 +708,11 @@ | |
| 708 | ** for use only from the /setup_skinedit page. |
| 709 | */ |
| 710 | static void skin_emit_css_defaults(){ |
| 711 | struct strctCssDefaults const * pCss; |
| 712 | fossil_print("<h1>CSS Defaults</h1>"); |
| 713 | fossil_print("Fossil's list of its own CSS classes follows. "); |
| 714 | fossil_print("See <a href=\"https://fossil-scm.org/fossil/" |
| 715 | "doc/trunk/www/css-tricks.md\">this " |
| 716 | "document</a> for more details."); |
| 717 | /* To discuss: do we want to list only the default selectors or |
| 718 | ** also their default values? The latter increases the size of the |
| 719 |
-33
| --- www/css-tricks.md | ||
| +++ www/css-tricks.md | ||
| @@ -10,43 +10,10 @@ | ||
| 10 | 10 | |
| 11 | 11 | This document is *not* an introduction to CSS - the web is |
| 12 | 12 | full of tutorials on that topic. It covers only the specifics |
| 13 | 13 | of customizing certain CSS-based behaviors in a Fossil UI. That said... |
| 14 | 14 | |
| 15 | -# Overriding Default Rules | |
| 16 | - | |
| 17 | -One behavior of the skinning system works considerably differently | |
| 18 | -from the cascading nature of CSS: if a skin applies a CSS selector for | |
| 19 | -which Fossil has a built-in default value, Fossil elides the entire | |
| 20 | -default definition for that rule. i.e., the skin's definition is the | |
| 21 | -only one which is applied, rather than cascading the definition from | |
| 22 | -the default value. | |
| 23 | - | |
| 24 | -For example, if Fossil has a default CSS rule which looks like: | |
| 25 | - | |
| 26 | -```css | |
| 27 | -div.foo { | |
| 28 | - font-size: 120%; | |
| 29 | - margin-left: 1em; | |
| 30 | -} | |
| 31 | -``` | |
| 32 | - | |
| 33 | -And a skin has: | |
| 34 | - | |
| 35 | -```css | |
| 36 | -div.foo {} | |
| 37 | -``` | |
| 38 | - | |
| 39 | -Then Fossil will *not* emit its default rule and the user's copy will | |
| 40 | -become the only definition of that CSS rule. This is different from | |
| 41 | -normal CSS cascading rules, in which the above sequence would result | |
| 42 | -in, effectively, the top set of rules being applied because the second | |
| 43 | -(empty) one does not override anything from the first. | |
| 44 | - | |
| 45 | -If a skin applies a given selector more than once, or imports external | |
| 46 | -style sheets which do, those cascade following CSS's normal rules. | |
| 47 | - | |
| 48 | 15 | ## Is it Really `!important`? |
| 49 | 16 | |
| 50 | 17 | By and large, CSS's `!important` qualifier is not needed when |
| 51 | 18 | customzing Fossil's CSS. On occasion, however, particular styles may |
| 52 | 19 | be set directly on DOM elements when Fossil generates its HTML, and |
| 53 | 20 |
| --- www/css-tricks.md | |
| +++ www/css-tricks.md | |
| @@ -10,43 +10,10 @@ | |
| 10 | |
| 11 | This document is *not* an introduction to CSS - the web is |
| 12 | full of tutorials on that topic. It covers only the specifics |
| 13 | of customizing certain CSS-based behaviors in a Fossil UI. That said... |
| 14 | |
| 15 | # Overriding Default Rules |
| 16 | |
| 17 | One behavior of the skinning system works considerably differently |
| 18 | from the cascading nature of CSS: if a skin applies a CSS selector for |
| 19 | which Fossil has a built-in default value, Fossil elides the entire |
| 20 | default definition for that rule. i.e., the skin's definition is the |
| 21 | only one which is applied, rather than cascading the definition from |
| 22 | the default value. |
| 23 | |
| 24 | For example, if Fossil has a default CSS rule which looks like: |
| 25 | |
| 26 | ```css |
| 27 | div.foo { |
| 28 | font-size: 120%; |
| 29 | margin-left: 1em; |
| 30 | } |
| 31 | ``` |
| 32 | |
| 33 | And a skin has: |
| 34 | |
| 35 | ```css |
| 36 | div.foo {} |
| 37 | ``` |
| 38 | |
| 39 | Then Fossil will *not* emit its default rule and the user's copy will |
| 40 | become the only definition of that CSS rule. This is different from |
| 41 | normal CSS cascading rules, in which the above sequence would result |
| 42 | in, effectively, the top set of rules being applied because the second |
| 43 | (empty) one does not override anything from the first. |
| 44 | |
| 45 | If a skin applies a given selector more than once, or imports external |
| 46 | style sheets which do, those cascade following CSS's normal rules. |
| 47 | |
| 48 | ## Is it Really `!important`? |
| 49 | |
| 50 | By and large, CSS's `!important` qualifier is not needed when |
| 51 | customzing Fossil's CSS. On occasion, however, particular styles may |
| 52 | be set directly on DOM elements when Fossil generates its HTML, and |
| 53 |
| --- www/css-tricks.md | |
| +++ www/css-tricks.md | |
| @@ -10,43 +10,10 @@ | |
| 10 | |
| 11 | This document is *not* an introduction to CSS - the web is |
| 12 | full of tutorials on that topic. It covers only the specifics |
| 13 | of customizing certain CSS-based behaviors in a Fossil UI. That said... |
| 14 | |
| 15 | ## Is it Really `!important`? |
| 16 | |
| 17 | By and large, CSS's `!important` qualifier is not needed when |
| 18 | customzing Fossil's CSS. On occasion, however, particular styles may |
| 19 | be set directly on DOM elements when Fossil generates its HTML, and |
| 20 |