public-inbox.git  about / heads / tags
an "archives first" approach to mailing lists
blob d0ba3befaa6299f1297778a889cb02afc98c4455 1752 bytes (raw)
$ git show v1.4.0:contrib/css/README	# shows this blob on the CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
Example CSS for use with public-inbox.

CSS::Minifier or CSS::Minifier::XS will be tried for minimizing
CSS at startup if available(*).

Multiple CSS files may be configured for user-selectability via
the "title" attribute or for different media.  Local CSS files
are read into memory once at startup.

If only one CSS file is given without "title", it will be inlined.

Snippet from ~/.public-inbox/config, order matters to browsers.
-----8<-----
[publicinbox]
	; Depending on the browser, the first entry is the default.
	; So having "/dev/null" at the top means no colors by default.
	; Using the "title" attribute enables `View -> "Page Style"'
	; choices in Firefox.
	css = /dev/null title=default

	; git-config supports backslash to continue long lines
	; Attributes ('media', 'title') must use single quotes(')
	; or no quotes at all, but not double-quotes, as git-config(1)
	; won't preserve them:
	css = /path/to/public-inbox/contrib/css/216dark.css \
		title=216dark \
		media='screen,(prefers-color-scheme:dark)'

	; for tree haters who print web pages :P
	css = /path/to/public-inbox/contrib/css/216light.css \
		title=216light \
		media='screen,print,(prefers-color-scheme:light)'

	; external CSS may be specified with href.
	; Using "//" (protocol-relative) URLs is allowed, as is
	; "https://" or "http://" for hosts which only support one protocol.
	css = href=//example.com/fugly.css title=external

All files in these example directory are CC0-1.0 (public domain):
To the extent possible under law, Eric Wong has waived all copyright and
related or neighboring rights to these examples.
https://creativecommons.org/publicdomain/zero/1.0/legalcode

(*) "libcss-minifier-perl" or "libcss-minifier-xs-perl"
    on Debian-based systems

git clone https://public-inbox.org/public-inbox.git
git clone http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/public-inbox.git