about summary refs log tree commit homepage
path: root/lib
DateCommit message (Collapse)
2016-02-25remove direct CGI.pm support
Relying on Plack::Handler::CGI is much easier for long-term maintenance and development. Nowadays, we even include our own httpd implementation to facilitate easier deployment with PSGI/Plack.
2016-02-24www: support $MESSAGE_ID/R/ endpoint for replies
Setting the "In-Reply-To:" header via mailto: links is not well-supported and should probably not be encouraged unless the client situation improves. So instead, teach users more widely-supported ways of setting the In-Reply-To: header to ensure proper threading of replies.
2016-02-24view: capture header object early
For future changes, this will allow us to more quickly notice if we keep the heavy Email::MIME object around too long. It has the side effect of avoiding extra method calls with Email::MIME which forwards header calls to the header_obj.
2016-02-23initial public-inbox-httpd implemenation
This is meant to provide an easy starting point for server admins. It provides a basic HTTP server for admins unfamiliar with configuring PSGI applications as well as being an identical interface for management as our nntpd implementation. This HTTP server may also be a generic Plack/PSGI server for existing Plack/PSGI applications.
2016-02-22extmsg: support "//" protocol-relative URLs
Avoid unintentionally switching protocols if the external site we're linking to supports both HTTP and HTTPS. We do not want to force HTTPS everywhere because potential bugs and performance problems in the TLS stack may outweigh the privacy benefits. Leave up to site authors and users to decide whether they want HTTPS or plain old HTTP.
2016-02-13www: document "git clone --mirror" usage
Not everybody is willing to install or run ssoma; but at least document "git clone --mirror" usage to promote data distribution. It's wasteful to clone without "--mirror", so we'll suggest that to avoid wasting disk space and inodes.
2016-02-13www: advertise clone-ability over http/https
All public-inbox instances shall be clone-able.
2016-02-13feed: favor relative URL to Atom feed in HTML
Normal browsers should understand relative path names. Atom feeds may be hosted externally and seems to need full URLs.
2016-02-08view: fix link to top-level ghost parent
In an single-message thread with a ghost parent, we need to go up level from the current Message-ID before appending the parent message to us.
2016-02-08view: simplify topic handling based on subjects
Dropping "[FOO]" prefixes for the purposes of summarization is tricky and we end up with odd display behavior. Just show Subject line changes as the writer intended (with the exception of normalization to strip the "Re: ")
2016-02-08feed: declare alternate link to HTML interface
It seems we need to declare "alternate" and "text/html" at least for feed readers.
2016-02-07support smart HTTP cloning
This requires POST and (small file) upload support from the PSGI/Plack web server. CGI.pm is currently not supported with this feature. We'll serve everything git can handle by default for performance in the general case. To avoid introducing cognitive overhead for sysadmins managing existing HTTP backends, we do not introduce new configuration directives. Thus, setting http.uploadpack=false in the relevant git config file for each public-inbox (ssoma) git repo will disable smart HTTP for CPU/memory-constrained systems. Technically we could support http.receivepack to allow posting messages to a public-inbox over HTTP(S), but that breaks the public-inbox model of encouraging users to Cc: everyone. Again, we encourage users to Cc: everyone to reduce the chance of a public-inbox becoming a centralized point of failure/censorship.
2016-02-02www: support git cloning via dumb HTTP
This is enabled by default, for now. Smart HTTP cloning support will be added later, but it will be optional since it can be highly CPU and memory intensive.
2016-02-01view: reference ghost parent in permalink view
We should not hide the parent Message-ID in this view; give the user the option to find the message in other archives.
2016-01-30view: cleanup permalink Thread: header display
The word "skip" can be confusing. Instead, spell out "scroll down" for the user to read and only display that text when the thread is sufficiently long.
2016-01-30view: do not kill whitespace in permalink thread timestamp
There's no need to HTML escape a timestamp we generate ourselves. We need to preserve the leading space and can't use the "oneline" semantics to preserve alignment.
2016-01-18view: explain why we do not use blockquote
Inevitably, somebody will care about semantic HTML; but preserving the original intent of the email author is important.
2016-01-09www: fix redirection loops
Sometimes users forget trailing slashes; but we should not punish them with infinite loops.
2016-01-09view: fix Atom feed link in full message view page
Oops :x
2016-01-09hval: new should not strip leading spaces
We should be able to use this for ASCII art and paragraphs
2016-01-09hval: use more appropriate hvals for documentation
Not needed, but this is good documentation. Some of these values should never have newlines.
2016-01-04listener: pass accepted address to post_accept
We can avoid making getpeername syscalls this way.
2016-01-04view: label "relevance" in threaded search view
The threaded search view is somewhat alien to new users, so ensure we label the word "relevance" for them.
2016-01-03www: comments for denoting Plack::Request vs CGI
We'll probably want to continue supporting CGI for mod_perl compatibility.
2016-01-02www: redirect with query string
We use query strings for search and index pages, so we should not drop them if somebody types a URL by hand and omits the trailing slash.
2015-12-31view: fixup indentation nesting in search
Oops, the rarely-accessed threaded search view was completely broken. Additionally, the normal threading depths were broken when we attempted to go up-thread and replies got nested improperly Followup to commit be984ce279776d4513b4ca1bff05ebecafdd1bad ("view: thread using <ul> instead of <table>")
2015-12-30view: "thread" in per-message view goes back to /t/
Linking to the expanded thread page probably makes more sense as it avoid unnecessary scanning for the thread summary.
2015-12-30view: avoid excessive indentation in thread summary
We already use "` " (backtick + space) to denote one indentation level, so do not excessively indent and always pad with one level less of spaces. The 'x' operator in Perl handles negative values, so subtracting one from level=0 will result in an empty string without spaces.
2015-12-30view: thread using <ul> instead of <table>
On second viewing, this does render small cues which makes the output more pleasant for lynx users. We avoid injecting the root (level=0) message into a list since it still wastes precious horizontal whitespace on small displays. This also results in small reductions in bandwidth usage as it takes fewer tags/whitespace to render unordered lists.
2015-12-26use "Atom feed" consistently in headers/footers
While having the extra " feed" is noisy in the main topic landing page, it is useful in headers/footers which have plenty of space to be more descriptive.
2015-12-26searchview: fix unclosed tags in threaded search results
Oops, we've had this forever and we also lacked a space between the this was noticed while adding an extra line between the "Search results ordered by" header and actual messages.
2015-12-26view: reduce main landing page weight
Hopefully, "mbox.gz" is sufficiently understandabe that we can get rid of the "title" attribute in <a> tags (we already omitted the title in other pages). Additionally, drop the '@' in front of the date. The date should be obvious and is not necessary for headers without author attribution.
2015-12-26searchview: fix up Atom feed in search results
Oops :x We need better testing... Fixes: commit 4c2c2325d2948ec5340e2fcafbee798cf568f5fd ("rename 'GitCatFile' package to 'Git'")
2015-12-26searchview: fixup stupid syntax error
Fixes: commit 398e29344ecc43548a7d3998bb5d2fcee62d66cd ("view: favor whitespace wrap in <head>") Oops.
2015-12-25view: favor whitespace wrap in <head>
If we bite the bullet and rely on inline CSS, we might as well only specify it once per page instead of inline in every <pre> tag which may handle UGC. So this actually saves us a small amount of bandwith on most pages which have multiple <pre> start tags.
2015-12-25view: fixup ghost message errors from threading tweaks
Ghost message links didn't show up too well after commit bc067a7562a586bed92401fe1084bbe423b9451a ("view: move thread info near top of single view") Additionally, attribution lacked a space when subjects changed mid-thread.
2015-12-25extmsg: fixup comparison for unknown message types
Fixes commit 4c2c2325d2948ec5340e2fcafbee798cf568f5fd ("rename 'GitCatFile' package to 'Git'")
2015-12-25view: move thread info near top of single view
Most framed mail viewing software has message ancestry information near the top instead of bottom (mutt, gmane, sylpheed, thunderbird) as it can help improve context. Traditional netiquette also favors writing replies below quoted (older) text for this reason; so move the thread summary to the top of the message for context. Since threads may be long, add a "skip" anchor link to jump to the message body quickly, and align the date to the left column so it's easier to tell the relative age of messages. While we're at it, remove quotes from "id" attributes to improve ease-of-grep-ability.
2015-12-24view: fix wording for empty topics display
Users may be iterating through lists and come up with nothing
2015-12-22rename 'GitCatFile' package to 'Git'
We'll be using it for more than just cat-file. Adding a `popen' API for internal use allows us to save a bunch of code in other places.
2015-12-22git: cat-file wrapper enhancements
The "cat_file" sub now allows a block to be passed for partial processing. Additionally, a new "check" method is added to retrieve only object metadata: (SHA-1 identifier, type, size)
2015-12-22hval: move PRE constant for wrapping UGC here
User-generated content (UGC) may have excessively long lines which screw up rendering. This is the only bit of CSS we use.
2015-12-22config: hoist out common functions
These will be reused elsewhere.
2015-12-08extmsg: try to fixup common errors
Sometimes users (me :x) blindly append "raw" to a /t/ URL...
2015-12-06view: fix message truncation logic
Avoid truncating messages if we requested the root anchor. This regression appeared in commit 62ee3cb36dd08f17e444e96dc80108464ee10cba ("view: do not shorten top-level messages in thread view") Also, make the "More..." link more prominent, as readers should be made aware they're not reading the full message.
2015-12-05*view: avoid leading zero in time display of the hour
Avoid the visual noise entirely by using a space instead. I sometimes have difficulty distinguishing '0' from '8' while other users may mistake it for an 'O' character. Most digital clocks I've seen will omit displaying a leading zero for the hour, too. This may also save transfer time by allowing better compression (since there is a space between the date and time anyways) and perhaps reduce client rendering time on some displays. We'll leave the leading zero for minutes since that seems pretty standard for digital clocks.
2015-12-04view: avoid truncating topic at 30 chars
It's potentially unsafe (leading to hidden messages) at any level.
2015-12-02view: consistent links for per-message views
Just because a message is currently alone does not mean the links won't be valid in the future when more messages show up.
2015-12-02view: don't kill topic summarization for level==0
Unlinked threads with similar (but not identical) subjects could be hidden as a result.
2015-11-21config: allow underscore in section names
Apparently git allows them, and they're definitely alright in email addresses.