lib/PublicInbox/UserContent.pm

   1 # Copyright (C) 2019-2020 all contributors <meta@public-inbox.org>
   2 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
   3
   4 # Self-updating module containing a sample CSS for client-side
   5 # customization by users of public-inbox.  Used by Makefile.PL
   6 package PublicInbox::UserContent;
   7 use strict;
   8 use warnings;
   9
  10 # this sub is updated automatically:
  11 sub CSS () {
  12         <<'_'
  13         /*
  14          * CC0-1.0 <https://creativecommons.org/publicdomain/zero/1.0/legalcode>
  15          * Dark color scheme using 216 web-safe colors, inspired
  16          * somewhat by the default color scheme in mutt.
  17          * It reduces eyestrain for me, and energy usage for all:
  18          * https://en.wikipedia.org/wiki/Light-on-dark_color_scheme
  19          */
  20         * { background:#000 !important; color:#ccc !important }
  21
  22         /*
  23          * Underlined links add visual noise which make them hard-to-read.
  24          * Use colors to make them stand out, instead.
  25          */
  26         a { color:#69f !important; text-decoration:none !important }
  27         a:visited { color:#96f !important }
  28
  29         /* quoted text in emails gets a different color */
  30         *.q { color:#09f !important }
  31
  32         /*
  33          * these may be used with cgit <https://git.zx2c4.com/cgit/>, too.
  34          * (cgit uses <div>, public-inbox uses <span>)
  35          */
  36         *.add { color:#0ff !important } /* diff post-image lines */
  37         *.del { color:#f0f !important } /* diff pre-image lines */
  38         *.head { color:#fff !important } /* diff header (metainformation) */
  39         *.hunk { color:#c93 !important } /* diff hunk-header */
  40
  41         /*
  42          * highlight 3.x colors (tested 3.18) for displaying blobs.
  43          * This doesn't use most of the colors available, as I find too
  44          * many colors overwhelming, so the default is commented out.
  45          */
  46         .hl.num { color:#f30 !important } /* number */
  47         .hl.esc { color:#f0f !important } /* escape character */
  48         .hl.str { color:#f30 !important } /* string */
  49         .hl.ppc { color:#f0f !important } /* preprocessor */
  50         .hl.pps { color:#f30 !important } /* preprocessor string */
  51         .hl.slc { color:#09f !important } /* single-line comment */
  52         .hl.com { color:#09f !important } /* multi-line comment */
  53         /* .hl.opt { color:#ccc !important } */ /* operator */
  54         /* .hl.ipl { color:#ccc !important } */ /* interpolation */
  55
  56         /* keyword groups kw[a-z] */
  57         .hl.kwa { color:#ff0 !important }
  58         .hl.kwb { color:#0f0 !important }
  59         .hl.kwc { color:#ff0 !important }
  60         /* .hl.kwd { color:#ccc !important } */
  61
  62         /* line-number (unused by public-inbox) */
  63         /* .hl.lin { color:#ccc !important } */
  64 _
  65 }
  66 # end of auto-updated sub
  67
  68 # return a sample CSS
  69 sub sample ($$) {
  70         my ($ibx, $env) = @_;
  71         my $url_prefix = $ibx->base_url($env);
  72         my $preamble = <<"";
  73 /*
  74  * Firefox users: this goes in \$PROFILE_FOLDER/chrome/userContent.css
  75  * where \$PROFILE_FOLDER is platform-specific
  76  *
  77  * cf. http://kb.mozillazine.org/UserContent.css
  78  *     http://kb.mozillazine.org/Profile_folder_-_Firefox
  79  *
  80  * Users of dillo can remove the entire lines with "moz-only"
  81  * in them and place the resulting file in ~/.dillo/style.css
  82  */
  83 \@-moz-document url-prefix($url_prefix) { /* moz-only */
  84
  85         $preamble . CSS() . "\n} /* moz-only */\n";
  86 }
  87
  88 # Auto-update this file based on the contents of a CSS file:
  89 # usage: perl -I lib __FILE__ contrib/css/216dark.css
  90 # (See Makefile.PL)
  91 if (scalar(@ARGV) == 1 && -r __FILE__) {
  92         open my $ro, '<', $ARGV[0] or die $!;
  93         my $css = do { local $/; <$ro> } or die $!;
  94
  95         # indent one level:
  96         $css =~ s/^([ \t]*\S)/\t$1/smg;
  97
  98         # "!important" overrides whatever the BOFH sets:
  99         $css =~ s/;/ !important;/sg;
 100         $css =~ s/(\w) \}/$1 !important }/msg;
 101
 102         open my $rw, '+<', __FILE__ or die $!;
 103         my $out = do { local $/; <$rw> } or die $!;
 104         $out =~ s/^sub CSS.*^_\n\}/sub CSS () {\n\t<<'_'\n${css}_\n}/sm;
 105         seek $rw, 0, 0;
 106         print $rw $out or die $!;
 107         close $rw or die $!;
 108 }
 109
 110 1;