Index: README.md ================================================================== --- README.md +++ README.md @@ -68,35 +68,52 @@ For example, you can use `-D` to pass HTML color names to create a [“fire” themed variant][d2]: ./inskinerator -b default \ -D text-color=lightyellow \ + -D header-color=yellow \ -D background-color=black \ -D pri-accent-color=red \ -D sec-accent-color=darkorange + +Note that we don’t necessarily have to override any of the late-defined +colors, as they get the following defaults if not overridden: + +| Variable | Late-Defined Value | +|------------------|------------------------------| +| title-color | $pri-accent-color | +| header-color | $text-color | +| footer-color | $text-color + 40% lightness | +| ter-accent-color | inverse of $pri-accent-color | Or, you can use HTML RGB specs to create this [“PDP-11/70” theme][d3]: ./inskinerator -b default \ -D text-color=\#000 \ + -D header-color=\#B3003B \ + -D title-color=\#622A5A \ -D pri-accent-color=\#B3003B \ - -D sec-accent-color=\#AE98CD + -D sec-accent-color=\#AE98CD \ + -D ter-accent-color=\#B3003B Note that `background-color` isn’t needed: we got that from the default skin. We can’t do without “black” for the text color, since the default uses [a very dark gray](/file/skins/default/vars.scss), not black. But note also that we pass such strings through as-is, so that HTML’s allowance for the #000 shortcut works. -You may also mix HTML color names and RGB specs to create this [mint -green variant][d4] of the default skin: +You may also mix HTML color names and RGB specs to create this +[mint green variant][d4] of the default skin: ./inskinerator -b default \ -D text-color=\#003300 \ + -D header-color=darkgreen \ + -D title-color=green \ -D background-color=mintcream \ -D pri-accent-color=lightseagreen \ - -D sec-accent-color=\#CCFFE6 + -D sec-accent-color=\#CCFFE6 \ + -D ter-accent-color=darkgreen [Fizzbuck Light][d5]: ./inskinerator -b default \ -D text-color=black \ Index: inskinerator ================================================================== --- inskinerator +++ inskinerator @@ -53,13 +53,24 @@ [--output/-f OUTPUT] [--define/-D VAR=VALUE] All skins allow overriding at least these variables: -D text-color=COLOR - -D background-color=COLOR -D pri-accent-color=COLOR -D sec-accent-color=COLOR + -D background-color=COLOR + + -D title-color=COLOR + -D header-color=COLOR + -D footer-color=COLOR + -D ter-accent-color=COLOR + + The final group are late-defined variables, defined by default in + terms of the first group. If you don't override them, you get the + default definitions without duplicating their late definitions. + Thus, a "complete" variables-only override can be done by redefining + only variables in the first group. VALUEs for COLOR variables are any legal CSS color: 'white', '#abcdef', '#888', etc. Output goes to stdout if you don't give a file name via --output/-f. @@ -121,10 +132,16 @@ my $scss = $common_vars . $base_vars; $scss .= $override_vars if defined $override_vars; for my $vname (keys %vars) { $scss .= "\$$vname: $vars{$vname};\n"; } +$scss .= <