]> Sergey Matveev's repositories - public-inbox.git/blobdiff - lib/PublicInbox/WWW.pm
$INBOX/_/text/color/ and sample user-side CSS
[public-inbox.git] / lib / PublicInbox / WWW.pm
index 3562e46c92a367a3ac318f8e0a79b7ac901f5448..406802a95767f409f49fb2247ee8e52e7328e512 100644 (file)
@@ -6,6 +6,7 @@
 # We focus on the lowest common denominators here:
 # - targeted at text-only console browsers (w3m, links, etc..)
 # - Only basic HTML, CSS only for line-wrapping <pre> text content for GUIs
+#   and diff/syntax-highlighting (optional)
 # - No JavaScript, graphics or icons allowed.
 # - Must not rely on static content
 # - UTF-8 is only for user-content, 7-bit US-ASCII for us
@@ -19,12 +20,14 @@ use URI::Escape qw(uri_unescape);
 use PublicInbox::MID qw(mid_escape);
 require PublicInbox::Git;
 use PublicInbox::GitHTTPBackend;
+use PublicInbox::UserContent;
 
 # TODO: consider a routing tree now that we have more endpoints:
 our $INBOX_RE = qr!\A/([\w\-][\w\.\-]*)!;
 our $MID_RE = qr!([^/]+)!;
 our $END_RE = qr!(T/|t/|t\.mbox(?:\.gz)?|t\.atom|raw|)!;
 our $ATTACH_RE = qr!(\d[\.\d]*)-([[:alnum:]][\w\.-]+[[:alnum:]])!i;
+our $OID_RE = qr![a-f0-9]{7,40}!;
 
 sub new {
        my ($class, $pi_config) = @_;
@@ -117,7 +120,14 @@ sub call {
                r301($ctx, $1, $2);
        } elsif ($path_info =~ m!$INBOX_RE/_/text(?:/(.*))?\z!o) {
                get_text($ctx, $1, $2);
-
+       } elsif ($path_info =~ m!$INBOX_RE/([\w\-\.]+)\.css\z!o) {
+               get_css($ctx, $1, $2);
+       } elsif ($path_info =~ m!$INBOX_RE/($OID_RE)/s/\z!o) {
+               get_vcs_object($ctx, $1, $2);
+       } elsif ($path_info =~ m!$INBOX_RE/($OID_RE)/s/([\w\.\-]+)\z!o) {
+               get_vcs_object($ctx, $1, $2, $3);
+       } elsif ($path_info =~ m!$INBOX_RE/($OID_RE)/s\z!o) {
+               r301($ctx, $1, $2, 's/');
        # convenience redirects order matters
        } elsif ($path_info =~ m!$INBOX_RE/([^/]{2,})\z!o) {
                r301($ctx, $1, $2);
@@ -129,6 +139,7 @@ sub call {
 
 # for CoW-friendliness, MOOOOO!
 sub preload {
+       my ($self) = @_;
        require PublicInbox::Feed;
        require PublicInbox::View;
        require PublicInbox::SearchThread;
@@ -141,6 +152,9 @@ sub preload {
                        PublicInbox::NewsWWW)) {
                eval "require $_;";
        }
+       if (ref($self)) {
+               $self->stylesheets_prepare($_) for ('', '../', '../../');
+       }
 }
 
 # private functions below
@@ -259,6 +273,18 @@ sub get_text {
        PublicInbox::WwwText::get_text($ctx, $key);
 }
 
+# show git objects (blobs and commits)
+# /$INBOX/_/$OBJECT_ID/show
+# /$INBOX/_/${OBJECT_ID}_${FILENAME}
+# KEY may contain slashes
+sub get_vcs_object ($$$;$) {
+       my ($ctx, $inbox, $oid, $filename) = @_;
+       my $r404 = invalid_inbox($ctx, $inbox);
+       return $r404 if $r404;
+       require PublicInbox::ViewVCS;
+       PublicInbox::ViewVCS::show($ctx, $oid, $filename);
+}
+
 sub ctx_get {
        my ($ctx, $key) = @_;
        my $val = $ctx->{$key};
@@ -446,4 +472,128 @@ sub get_attach {
        PublicInbox::WwwAttach::get_attach($ctx, $idx, $fn);
 }
 
+# User-generated content (UGC) may have excessively long lines
+# and screw up rendering on some browsers, so we use pre-wrap.
+#
+# We also force everything to the same scaled font-size because GUI
+# browsers (tested both Firefox and surf (webkit)) uses a larger font
+# for the Search <form> element than the rest of the page.  Font size
+# uniformity is important to people who rely on gigantic fonts.
+# Finally, we use monospace to ensure the Search field and button
+# has the same size and spacing as everything else which is
+# <pre>-formatted anyways.
+our $STYLE = 'pre{white-space:pre-wrap}*{font-size:100%;font-family:monospace}';
+
+sub stylesheets_prepare ($$) {
+       my ($self, $upfx) = @_;
+       my $mini = eval {
+               require CSS::Minifier;
+               sub { CSS::Minifier::minify(input => $_[0]) };
+       } || eval {
+               require CSS::Minifier::XS;
+               sub { CSS::Minifier::XS::minify($_[0]) };
+       } || sub { $_[0] };
+
+       my $css_map = {};
+       my $stylesheets = $self->{pi_config}->{css} || [];
+       my $links = [];
+       my $inline_ok = 1;
+
+       foreach my $s (@$stylesheets) {
+               my $attr = {};
+               local $_ = $s;
+               foreach my $k (qw(media title href)) {
+                       if (s/\s*$k='([^']+)'// || s/\s*$k=(\S+)//) {
+                               $attr->{$k} = $1;
+                       }
+               }
+
+               if (defined $attr->{href}) {
+                       $inline_ok = 0;
+               } else {
+                       open(my $fh, '<', $_) or do {
+                               warn "failed to open $_: $!\n";
+                               next;
+                       };
+                       my ($key) = (m!([^/]+?)(?:\.css)?\z!i);
+                       my $ctime = 0;
+                       my $local = do { local $/; <$fh> };
+                       if ($local =~ /\S/) {
+                               $ctime = sprintf('%x',(stat($fh))[10]);
+                               $local = $mini->($local);
+                       }
+                       $css_map->{$key} = $local;
+                       $attr->{href} = "$upfx$key.css?$ctime";
+                       if (defined($attr->{title})) {
+                               $inline_ok = 0;
+                       } elsif (($attr->{media}||'screen') eq 'screen') {
+                               $attr->{-inline} = $local;
+                       }
+               }
+               push @$links, $attr;
+       }
+
+       my $buf = "<style>$STYLE";
+       if ($inline_ok) {
+               my @ext; # for media=print and whatnot
+               foreach my $attr (@$links) {
+                       if (defined(my $str = delete $attr->{-inline})) {
+                               $buf .= $str;
+                       } else {
+                               push @ext, $attr;
+                       }
+               }
+               $links = \@ext;
+       }
+       $buf .= '</style>';
+
+       if (@$links) {
+               foreach my $attr (@$links) {
+                       delete $attr->{-inline};
+                       $buf .= "<link\ntype=text/css\nrel=stylesheet";
+                       while (my ($k, $v) = each %$attr) {
+                               $v = qq{"$v"} if $v =~ /[\s=]/;
+                               $buf .= qq{\n$k=$v};
+                       }
+                       $buf .= ' />';
+               }
+               $self->{"-style-$upfx"} = $buf;
+       } else {
+               $self->{-style_inline} = $buf;
+       }
+       $self->{-css_map} = $css_map;
+}
+
+# returns an HTML fragment with <style> or <link> tags in them
+# Called by WwwStream by nearly every HTML page
+sub style {
+       my ($self, $upfx) = @_;
+       $self->{-style_inline} || $self->{"-style-$upfx"} || do {
+               stylesheets_prepare($self, $upfx);
+               $self->{-style_inline} || $self->{"-style-$upfx"}
+       };
+}
+
+# /$INBOX/$KEY.css endpoint
+# CSS is configured globally for all inboxes, but we access them on
+# a per-inbox basis.  This allows administrators to setup per-inbox
+# static routes to intercept the request before it hits PSGI
+sub get_css ($$$) {
+       my ($ctx, $inbox, $key) = @_;
+       my $r404 = invalid_inbox($ctx, $inbox);
+       return $r404 if $r404;
+       my $self = $ctx->{www};
+       my $css_map = $self->{-css_map} || stylesheets_prepare($self, '');
+       my $css = $css_map->{$key};
+       if (!defined($css) && $key eq 'userContent') {
+               my $env = $ctx->{env};
+               $css = PublicInbox::UserContent::sample($ctx->{-inbox}, $env);
+       }
+       defined $css or return r404();
+       my $h = [ 'Content-Length', bytes::length($css),
+               'Content-Type', 'text/css' ];
+       PublicInbox::GitHTTPBackend::cache_one_year($h);
+       [ 200, $h, [ $css ] ];
+}
+
 1;