X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fdesign_www.txt;h=f15a55629745869ab34f4d0735c337d5b5035b31;hb=0acad050fe38033baedfed83f5976aeabebf3287;hp=514f8ff7d9596e3bbd10db5c21e9218c675e1118;hpb=34031de0b4d2b71cd33e36fdba773a828c620d49;p=public-inbox.git diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt index 514f8ff7..f15a5562 100644 --- a/Documentation/design_www.txt +++ b/Documentation/design_www.txt @@ -1,3 +1,5 @@ +PublicInbox::WWW (PSGI interface) design notes + URL and anchor naming --------------------- @@ -6,12 +8,15 @@ URL and anchor naming /$INBOX/new.atom -> Atom feed #### Optional, relies on Search::Xapian -/$INBOX/$MESSAGE_ID/t/ -> HTML content of thread +/$INBOX/$MESSAGE_ID/t/ -> HTML content of thread (nested) +/$INBOX/$MESSAGE_ID/T/ -> HTML content of thread (flat) anchors: #u location of $MESSAGE_ID in URL #m per-message links, where is of the Message-ID of each message (stable) #s relative numeric position of message in thread (unstable) + #i<...> diffstat location for patch emails + #Z?<...> per-file diff header location for patch emails /$INBOX/$MESSAGE_ID/t.atom -> Atom feed for thread /$INBOX/$MESSAGE_ID/t.mbox.gz -> gzipped mbox of thread @@ -107,8 +112,6 @@ browsers default to. CSS classes (for user-supplied CSS) ----------------------------------- -span.q - quoted text in email messages -TODO: consider using highlight(1) via libhighlight-perl in Debian, - optionally -... +See examples in contrib/css/ and lib/PublicInbox/WwwText.pm +(or https://public-inbox.org/meta/_/text/color/ soon)