about summary refs log tree commit homepage
path: root/lib/PublicInbox/View.pm
DateCommit message (Collapse)
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-09view: fix Atom feed link in full message view page
Oops :x
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-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.
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-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-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-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-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-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-20various internal documentation updates
Hopefully this gives new hackers a better overview of how the components relate to each other.
2015-11-18view: further reduce size of attribution/timestamp
The "by" on the message page and "-" in the index are unnecessary and readers should have no trouble figuring out what the attribution/timestamp line means.
2015-11-18view: remove "created" and "updated" noise words
They increase HTML size and add to visual noise without telling enough useful information.
2015-10-08view: fixup bad comparison
Oops, there is no longer a 3rd element. Fixes: 759efc037728a766ee80f1b0d3c1fd7b8c76a05f ("view: remove attribution for topics in top-level view")
2015-10-08view: remove attribution for topics in top-level view
It clutters up the page unnecessarily, as identity of the topic starter/updater probably doesn't matter if there's no exact message to attribute the message to.
2015-10-04view: add links for mbox and atom feeds in homepage
Having per-thread Atom feeds and downloadable mboxen is powerful and should be more easily visible/accessible to casual readers.
2015-10-02rename mid_compress to id_compress
We use it as a general compressor for identifiers such as subject paths, so using the "mid_" prefix probably is not appropriate.
2015-10-01view: correctly pick latest in index anchor links
The last message in a thread _display_ is not necessarily the latest message in the thread. We must go by the Date: header on the messages themselves as a best-guess. Of course Date: headers may lie, but most mail clients trust them by default, so we will, too.
2015-09-30view: use '+' instead of '%20' to escape spaces in mailto:
'+' is more shoter and more readable in query parameters than '%20'
2015-09-16view: do not shorten top-level messages in thread view
The thread root is usually the most important, and should be displayed in full.
2015-09-13view: jump to anchor of current message on References
Otherwise it could be a bit disorienting to jump to the first message in the thread without navigation context.
2015-09-13view: do not show References unless a message has them
It's a waste of space and potentially confusing.
2015-09-13view: use header_obj to avoid extra method calls
Email::MIME will call the header_obj each time anyways, avoid the extra method lookups and hit header_obj directly for the header lookup.
2015-09-13view: extra Atom feed link in standalone message view
It might be helpful if user agents do not display the <link> element in <head>.
2015-09-13view: add Atom links in headers for per-message links
Some user agents will advertise the presence of a feed this way for users to subscribe to individual topics.
2015-09-12searchview: support displaying entire threads
This hopefully makes it easy to perform queries to display an entire thread. Raise the limit in the threaded view to display more results and hopefully improve the output of thread display.
2015-09-12view: more consistent prefix for ghost links
This will be reused for search views.
2015-09-10constent X?HTML MIME type filtering
Filter and View should reject X?HTML the same way.
2015-09-07view: change References link to expand thread
The expanded thread view is generally more useful. Having links to more links at the bottom seems to a waste of navigation time. However, keep the '#r' anchor in case people rely on it for links.
2015-09-06update copyright headers and email addresses
In the future, it should be possible to use this: git ls-files | UPDATE_COPYRIGHT_HOLDER='all contributors' \ UPDATE_COPYRIGHT_USE_INTERVALS=2 \ xargs /path/to/gnulib/build-aux/update-copyright
2015-09-04view: fix broken link to ghost fallback
Once again, the regression was introduced in commit 16ca6b7a57266fcb466ffff005bc1d644bad14c1 (view: avoid attempting to find "subject dummy")
2015-09-04view: thread view expands focused message
Non-top-level messages still deserve to be shown in full if they're the message in the URL.
2015-09-04view: indentation adjustments for collapsed headers
This makes the layout between the permalink threads and index threads more consistent; hopefully.
2015-09-04view: reduce redundant attributions in permalink refs
No point in repeating authorship when PATCH messages are threaded and it's obvious from the top message who the author is of the series: [this message] - John Smith @ 2015-09-04 00:04:20 UTC ` [PATCH 1/4] view: eliminate redundant [threaded|flat] link ` [PATCH 2/4] view: one line for thread subjects ` [PATCH 3/4] view: adjust spacing and indentation of index threads ` [PATCH 4/4] view: add missing newline to inline dump
2015-09-04view: add missing newline to inline dump
This fixes a regression introduced in commit 16ca6b7a57266fcb466ffff005bc1d644bad14c1 (view: avoid attempting to find "subject dummy")
2015-09-04view: adjust spacing and indentation of index threads
Avoid wasting precious horizontal space by indenting children excessively relative to the top-level parent.
2015-09-04view: one line for thread subjects
We truncate subjects in the Xapian document anyways, so lines should not be too long and it hopefully won't throw off the vertical display.
2015-09-04view: eliminate redundant [threaded|flat] link
We do not need to waste space with that link when we have it conveniently placed where every message is located.
2015-09-04view: do not generate anchors in thread views
They're unused, and they can have namespace conflicts if there's multiple full messages in the thread view.
2015-09-04view: avoid attempting to find "subject dummy"
This is an internal Message-ID used by Mail::Thread, to group messages with identical subjects but common parent. Don't attempt to redirect users to external sites when we cannot find it.