lib/PublicInbox/UserContent.pm

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