1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-16 13:10:29 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/concepts/ColourPalettes.tid
Jermolene ca1daf5a4e First pass at switchable colour palettes
Fixes #410

Still some cleaning up to do, and we need a way for incomplete palettes
to inherit from a base palette.
2014-02-17 12:09:10 +00:00

44 lines
1.5 KiB
Plaintext

created: 20140216102454178
modified: 20140216102722184
tags: concepts
title: ColourPalettes
type: text/vnd.tiddlywiki
Colour palettes bind logical colour names (such as ''page-background'') to actual CSS colours (such as ''#fe0'').
Entire colour palettes are stored in a single [[data tiddler|DataTiddlers]].
The title of the tiddler containing the current colour palette is identified by the tiddler [[$:/palette]].
To retrieve a named colour from the current palette you can use the ''colour'' macro:
```
<<colour page-background>>
```
The ''colour'' macro is defined like this:
```
\define colour(name)
<$transclude tiddler={{$:/palette}} index="$name$"/>
\end
```
By convention, each theme provides a default colour palette in the tiddler [[$:/config/DefaultPalette]] tiddler. Thus, setting the tiddler [[$:/theme]] to the string `$:/config/DefaultPalette` will revert to the palette packaged with the current theme (as long as it hasn't been redefined, since it is a shadow tiddler).
Palette tiddlers should have the following fields:
|!Field |!Description |
|title |Any title can be used, typically a system title starting with "$:/" |
|type |`application/x-tiddler-dictionary` to identify this tiddler as a [[data tiddler|DataTiddlers]] |
|tags |`$:/tags/Palette` to identify this tiddler as a palette |
|description |Description to be displayed in palette browser |
|text |Colour definitions (see below) |
The text of a palette tiddler consists of name value pairs like this:
```
foreground: #000
background: #fff
```