1
0
Fork 0
mirror of https://git.sr.ht/~seirdy/seirdy.one synced 2024-11-23 21:02:09 +00:00
Commit graph

256 commits

Author SHA1 Message Date
Rohan Kumar
d97481f381
Homepage refactor
- Make webring links touch-friendly and accessible by using spaced-out
  details elements.
- Make details elements touch-friendly by indicating interactive region
  area and making summary padded.
- Sort featured posts by featured order.
- Ensure that at least one non-interactive tappable region exists on the
  screen at all times, 48x48 px.
2022-05-04 22:22:38 -07:00
Rohan Kumar
2dd338ea13
Add <main> to posts page. Replaces <section> 2022-05-03 22:02:04 -07:00
Rohan Kumar
e54fc42286
Improve webring link labels
"aria-label" doesn't translate well, so use "labelledby" instead. Source
the label from a new informational paragraph.
2022-05-03 21:58:52 -07:00
Rohan Kumar
781f910f99
POSH: replace some divs with <section>s, add <p>
- Put webmention list items in <p>
- make doc-endnotes a section again
- make doc-preface a section with a heading apart from the TOC.
2022-05-03 21:30:20 -07:00
Rohan Kumar
978b4b2b1a
Improve tap target + font size for WCAG AAA
Increased font size to decrease chars-per-line (SC 1.4.8) and increase
tap target size.

Pad the nav links more and add some extra space between them to meet SC
2.5.5.
2022-05-03 17:05:47 -07:00
Rohan Kumar
992ba534af
restricted enhancement, rename article, narrow vp
- Define term "restricted enhancement"
- Rename article (shorter title)
- Better support for narrow viewports
2022-05-02 21:13:50 -07:00
Rohan Kumar
abc7b57e95
Improve print stylesheets
- Don't pad nav on print
- Link underlines in the TOC are not necessary in print
- Show home link on print
2022-05-02 15:42:57 -07:00
Rohan Kumar
8bcfa63859
Webmentions: trim displayed URLs
When a title is unavailable, we fall back to displaying the URL. Trim
the https://(www.)? prefix and trailing slashes.
2022-05-01 21:47:09 -07:00
Rohan Kumar
88689a9676
Fix bad quotes 2022-05-01 21:33:51 -07:00
Rohan Kumar
623aff9eab
Fix headings for posts section on homepage 2022-05-01 21:14:06 -07:00
Rohan Kumar
0a5643ce1d
Add missing <main> landmark 2022-05-01 21:04:49 -07:00
Rohan Kumar
2d260b7d84
Fix caching 2022-05-01 13:36:02 -07:00
Rohan Kumar
6079273811
Fix canonical URL redirects 2022-04-29 08:59:14 -07:00
Rohan Kumar
543bbbc502
Fix some url redirects 2022-04-29 08:54:36 -07:00
Rohan Kumar
f4e4128d92
Give repeated footnote backrefs an accessible name 2022-04-28 17:41:13 -07:00
Rohan Kumar
aad8b11a70
Shortcode improvements
- New shortcode for quotation. Not using this yet.
- Make picture shortcode round image dimensions to integer values.
- Make quotecaption support code snippets borrowed from other places.
  Not using this yet.
2022-04-27 17:20:16 -07:00
Rohan Kumar
371253c2dc
Improve code blocks
- Support defining text in a codeblock that can be translated
- Shrink some blocks to prevent page breaks on print
2022-04-27 08:53:39 -07:00
Rohan Kumar
cffa22e79e
Internal: re-org templates a bit
Split up some verbose and repetitive templates to use nested templates.
Cache some templates that don't need to be re-built every time.

Reading time: switch "a" to "an" when followed by the number "8".

Improve whitespace alignment a bit.
2022-04-27 08:44:13 -07:00
Rohan Kumar
8597e50a59
Stylesheet: better print theme, simpler dark theme
- Better print stylesheet, now with a file dedicated just for print
  style improvements.
- Hide extra stuff in print.
- Bring back navbar for print because it also tells users the current
  section and the site name.
- Dark theme: make superscripts bold instead of using a higher-contrast
  color.
2022-04-27 08:41:36 -07:00
Rohan Kumar
f964152072
Add SerenityOS screenshot
obv gotta show off that awesome retro desktop
2022-04-26 22:39:12 -07:00
Rohan Kumar
c26a6d6cc8
Re-introduce conservative minificaiton
- Don't auto-minify HTML but minify other resources, inc. the RSS feed
- Manually optimize whitespace a little to balance readability and
  compressed size
2022-04-26 17:15:42 -07:00
Rohan Kumar
a1a89ed3d3
Remove unused class
Now the only non-microformats class is .unstyled-list.
2022-04-26 09:22:18 -07:00
Rohan Kumar
5989b2e725
Use doc-tip for timestamp format notice 2022-04-25 16:52:03 -07:00
Rohan Kumar
ec5d613ffc
Only render anchor links in post pages 2022-04-25 17:35:14 -07:00
Rohan Kumar
4d5c725147
Fix bad use of <section>
Sections should have headings.
2022-04-25 17:34:21 -07:00
Rohan Kumar
3d5f9ad1e3
Add anchor links, attempt #1. 2022-04-25 17:29:34 -07:00
Rohan Kumar
b1efab7def
More markup formatting, remove unnecessary div
- Decrease the article dom depth by 1 by replacing <main><div> with just
  <main>.
- Fix some whitespace so the HTML output looks better.
2022-04-25 17:28:13 -07:00
Rohan Kumar
87a89ce514
Fix skipped heading level 2022-04-25 08:54:42 -07:00
Rohan Kumar
eb8ca07b9f
Goldmark 1.4.12, switch to good unminified output
- Goldmark 1.4.12 switches footnotes from a <section> to a <div>; update
  regexes and stylesheet to account for this.
- Goldmark 1.4.12 allows multiple footnotes with the same reference; use
  that.
- Clean up templates for unminified output. Also delete an unused class.
- Switch to unminified output by default.
2022-04-25 08:49:13 -07:00
Rohan Kumar
f23b4f1975
Update theme color 2022-04-25 08:39:13 -07:00
Rohan Kumar
f3a77025fa
Add periods to post metadata
Helps screenreaders add pauses appropriately.
2022-04-24 21:51:52 -07:00
Rohan Kumar
bd7c76044a
Give section a label 2022-04-24 16:53:29 -07:00
Rohan Kumar
4e48237647
Prepare for goldmark v1.4.12
Goldmark v1.4.12 switched footnotes to a div. Make them a <section>
again, since I do insert a heading.
2022-04-24 12:35:07 -07:00
Rohan Kumar
baa84af0c5
Remove skip link, typo.
The skip link is unnecessary on my site since landmarks and headings
both allow skipping repeated content.
2022-04-23 20:21:02 -07:00
Rohan Kumar
8ddc2ec879
Make transcript the description of the image. 2022-04-22 11:48:22 -07:00
Rohan Kumar
bec97543aa
Remove redundant "Contact" section article footer
There's a contact link in the site footer now, no need to include it in
the article footer.
2022-04-22 11:40:34 -07:00
Rohan Kumar
f10de9f2e2
Improve semantics/a11y of site header/footer
- Make footer links a list element
- Make header aria-label less redundant
- Give footer links a label
2022-04-22 08:49:27 -07:00
Rohan Kumar
6aa7656411
Remove aria-description from figures
Causes repetition in some screen readers.
2022-04-22 08:48:20 -07:00
Rohan Kumar
c939afbc0a
Elaborate on focus indicators + fix anchors 2022-04-21 21:40:40 -07:00
Rohan Kumar
2c87b6269f
Revert "Microdata: don't replace "name" with "nickname""
This reverts commit 50d4c9435d.
2022-04-21 21:40:17 -07:00
Rohan Kumar
50d4c9435d
Microdata: don't replace "name" with "nickname" 2022-04-21 18:03:14 -07:00
Rohan Kumar
d89de5db68
Give code figures both a label and description 2022-04-20 17:56:06 -07:00
Rohan Kumar
120232a403
Re-do my approach to image transcripts.
Way better now. Also introduce a way to emphasize some keywords in code
blocks without going full syntax-highlighting.
2022-04-20 17:55:13 -07:00
Rohan Kumar
02bf9e6a6b
Site structure: emphasize current on home, meta
- microdata for CompleteDataFeed on /posts.html instead of DataFeed
- make the home link <strong> when it's the current page, just like the
  other navlinks.
2022-04-19 20:16:20 -07:00
Rohan Kumar
8e8512290b
Fix invalid HTML 2022-04-19 20:07:30 -07:00
Rohan Kumar
01e52bad16
Split up figcaption partial, add some fignos
- give code blocks their own figure numbers/names/ID
- Split figcaption into quotecaption and codecaption
- create codefigure partial to reduce markup for SoftwareSourceCode
  figures
2022-04-19 18:06:57 -07:00
Rohan Kumar
84cde2e97f
Internal: create + use figure shortcodes + hooks
Create a for <figcaption> and a render hook for code snippets inside
figures, replacing some ugly and complex inline HTML in my markdown
sources.

The only visible change is slightly worse HTML alignment and programming
language indicators (with microdata).

This removed the need to use one of the regex replacements in the
processed_content.html shortcode, and increased the minimum required
Hugo version to 0.93.
2022-04-18 21:15:29 -07:00
Rohan Kumar
84c77b62f0
Screen readers: don't speak redundant © 2022-04-18 21:05:34 -07:00
Rohan Kumar
3490f630cc
Switch bad use of <footer> to <section>
Thanks to @eslerm@mastodon.social for asking some good questions that
got me to re-evaluate my use of <footer>.
2022-04-18 21:04:37 -07:00
Rohan Kumar
c94a846730
Re-order article footer elements
Add headings and re-order the items in the article footers to improve
heading-based navigation. Now all sections should have a landmark
recognized by most AT, or a heading.
2022-04-18 19:58:09 -07:00
Rohan Kumar
83b4f32d0b
Emphasize current section in navbar
WCAG recommends telling visitors about their current place in a site's
hierarchy. All pages are exactly zero or one level below a section, so
simply emphasizing a member of the navigation links should be
sufficient.
2022-04-18 19:54:40 -07:00
Rohan Kumar
1391b93dd0
Add aria labels to footnote backlinks 2022-04-18 08:59:43 -07:00
Rohan Kumar
070ad7c14d
Correct use of landmarks
- No content outside landmarks
- Remove bad use of <aside>
2022-04-18 08:56:22 -07:00
Rohan Kumar
92f1d70128
Fix TOC aria labels, avoid bad spatial word choice 2022-04-18 01:29:05 -07:00
Rohan Kumar
addcf78292
Add missing aria label 2022-04-18 00:51:07 -07:00
Rohan Kumar
9d34f82f5d
Limit homepage posts to featured posts 2022-04-18 00:31:19 -07:00
Rohan Kumar
b5ebca64cd
Switch back to using a <hr>
The thematic break is appropriate here and having it announced by screen
readers actually helps.
2022-04-17 22:59:49 -07:00
Rohan Kumar
ca3e997c61
Remove redundant link and trailing whitespace. 2022-04-17 13:03:39 -07:00
Rohan Kumar
3affd1f97a
Fix missing h1 on bookmarks page 2022-04-17 12:49:21 -07:00
Rohan Kumar
4650a88024
Fix missing h1 on posts page 2022-04-17 12:48:33 -07:00
Rohan Kumar
c2e146e7bc
More narrow screen optim for old browsers
Some old browser engines don't fully support hyphenation, so they need
some extra help. Now, the entire site should fit in a 150 CSS-pixel wide
viewport.

Clean up some link text too so the text alone is more useful.
2022-04-15 21:06:28 -07:00
Rohan Kumar
00da18b36e
Add skip link
Should now be full wcag AA with some AAA.
2022-04-14 22:15:54 -07:00
Rohan Kumar
401837952f
Make all pages look good in 150px viewports
All pages except bookmarks can now fit on your smartwatch without any
adjustments, so we can disable the auto-zoom-out-to-match-mobile
wizardry that watch browsers do (comparable to the
zoom-out-to-match-desktop stuff that early mobile browsers did).

Yay.
2022-04-13 18:43:12 -07:00
Rohan Kumar
e29aa8c9ca
Fix whitespace 2022-04-13 18:21:48 -07:00
Rohan Kumar
1938aa2246
Remove redundant section 2022-04-13 18:21:39 -07:00
Rohan Kumar
eaa8023af8
CSS: apply improvements described in WBP article
- Use borders instead of <hr>
- Distinguish <kbd> from <code> and body text with boldness
- Improve dark contrast and make dark visited links look distinct from
  regular text
- Improve focus indicators
2022-04-13 18:19:49 -07:00
Rohan Kumar
3200333424
Shorter alts, formatting, redundant links, cleanup
- Shrink some excessive alt text
- Remove some redundant links
- Screenreaders that split elements up aren't just on touchscreens
- Mention ChromeVox in list of screen readers
- Move TOC higher in page
- Spelling
- Drop more unused classes
2022-04-09 08:59:12 -07:00
Rohan Kumar
8be0fae481
Templates: drop unused class, support img scaling
- The .footnote-ref  class was unused, drop it.
- Support supplying a scale-factor property to the picture shortcode, to
  upscale small images.
2022-04-09 08:54:58 -07:00
Rohan Kumar
41b66d8ceb
Put TOC heading inside the TOC <nav>
Putting the heading in the navigation element makes the structure more
logical and matches the behavior of most other websites.

Move it before the introduction in my web best practices post.
2022-04-09 08:51:10 -07:00
Rohan Kumar
072ab1dfff
Add + comply with notes on screen reader support
- Replace hashes in code snippets with variables for screen-readability
- Use hyphens where valid instead of combined words for screen reader
  pronunciation
- Typo
- Add WIP section on screen reader support tips not already covered.
2022-04-10 17:24:59 -07:00
Rohan Kumar
76a1d8a7ca
Fix tab-selection of <pre> blocks
Turns out some browsers do skip tab-selection of scrollable <pre> blocks
2022-04-07 15:39:06 -07:00
Rohan Kumar
89f04e2f31
Fix structured data 2022-04-06 23:14:13 -07:00
Rohan Kumar
47106441f7
Remove deprecated ARIA, unused classes 2022-04-06 17:49:25 -07:00
Rohan Kumar
de882addcf
Typo 2022-04-04 21:40:36 -07:00
Rohan Kumar
613eba7ccf
Remove deprecated "doc-endnote" DPUB-ARIA role
Temporary measure for use with Goldmark till it drops this

see https://github.com/yuin/goldmark/issues/258
2022-04-05 21:41:08 -07:00
Rohan Kumar
ba637cf1db
Add obligatory privacy policy
TLDR: I don't collect anything except for default access logs purged
every other day
2022-04-04 19:20:14 -07:00
Rohan Kumar
37b9063186
Semantics: TOC and post-list <ol>
Order is significant for the ToC and post list so make them ordered.

I opted to make post-lists a reversed list, so I don't end up having
every post change its number every time I post.
2022-04-04 19:13:07 -07:00
Rohan Kumar
e455703209
Remove "last deployed" date
Visitors can see that on post update dates; I can see that in
builds.sr.ht.

This results in not having to upload every page on a trivial change. Add
the "-c" rsync flag to take advantage of that. Doing so should also
result in longer-lived cached copies, with etags and last-modified
headers.
2022-04-04 19:00:07 -07:00
Rohan Kumar
73215343ca
Remove obsolete longdesc 2022-04-03 20:53:13 -07:00
Rohan Kumar
b1e7b65e02
Re-organize and clarify some things
- Re-phrase a line referring to a previous section; after some
  re-arrangements, that section is no longer a "previous" section.
- Replace spatial terminology ("bottom") with sequential terminology
  ("end")
- Add note on font enumeration without the Font Access API
- Acknowledge testing in grayscale but emphasize that it isn't enough.
- Move defense of link underlines to just after the section on custom
  colors, since it's more relevant to it.
- Add xkcd image into the page instead of just linking, since the linked
  page content is an image that doesn't include a transcript or
  descriptive alt-text.
- Trivial rephrasings
2022-04-03 19:34:45 -07:00
Rohan Kumar
60bf9110b9
A11y and perf improvements
- Even less halation for dark theme
- More contrast for borders
- Slightly larger font, fixes APCA contrast issue for <small>
- Make responsive navbar work in NetSurf
- Make aria-current page bold
- Use content-visibility to unload footers and endnotes
- Add aria-labels to unclear webring link text
- Replace <hr> elements with css borders; the semantic meaning of <hr>
  was unnecessary with section breaks.
2022-04-02 23:54:39 -07:00
Rohan Kumar
1a70b01374
Aria-current, shorter titles 2022-04-01 22:21:00 -07:00
Rohan Kumar
9fbf3f5138
Mention BBR congestion, streamline quotation citations. 2022-03-31 18:42:13 -07:00
Rohan Kumar
eb2348a633
Make TOC a normal section, not a <details>
The TOC should be a normal section and a change to visibility isn't
necessary. Avoids the complexity of buttons (<summary> is a button).
2022-03-30 17:46:43 -07:00
Rohan Kumar
cd622cc85c
Clean up introduction and some phrasing.
- Give the intro a heading
- Make the preface an <aside> with a "doc-preface" DPUB-ARIA role
- Move the TOC before the intro
- Give the TOC a "doc-toc" DPUB-ARIA role
- Provide a TLDR
2022-03-29 19:43:07 -07:00
Rohan Kumar
886134d1f9
Remove meta keywords 2022-03-27 17:24:22 -07:00
Rohan Kumar
eb25804244
Add anchor links to posts list 2022-03-27 11:14:33 -07:00
Rohan Kumar
c40dc58bac
Fix some validator issues
- Typo in CSS
- improper use of <section>
2022-03-26 16:36:39 -07:00
Rohan Kumar
82a63d9662
Optimal line length 2022-03-26 12:33:01 -07:00
Rohan Kumar
fd576c9175
Prepare a TOC template 2022-03-26 12:32:22 -07:00
Rohan Kumar
98ee735dac
Make headings follow sequential order 2022-03-20 16:27:11 -07:00
Rohan Kumar
e4429156fb
Remove redundant aria-labelledby
No need to specify that a section is labelled by a heading if the
heading is the first element in the section.
2022-03-17 23:35:39 -07:00
Rohan Kumar
829c295ae2
Whitespace fix 2022-03-17 23:32:19 -07:00
Rohan Kumar
35b6c2eeae
Exclude dark image variants from print media
Save some ink, yo
2022-03-17 23:30:46 -07:00
Rohan Kumar
66833dc93e
Improve narrow screen compat
- Replace long <code> snippets
- Add some soft hyphens.
- Make one image of text look better on a narrow viewport.
2022-03-16 16:52:03 -07:00
Rohan Kumar
1bff1052de
Stop "public" from showing up in bookmark tags 2022-03-16 16:42:29 -07:00
Rohan Kumar
dab11a7abc
Typo 2022-03-15 17:17:41 -07:00
Rohan Kumar
4491154cd8
Webrings: add referrers, hotline, and criteria
- Some webrings I might eventually join require sending the origin via
  referrer. Make per-link exceptions to my "no-referrer" policy sent via
  HTTP header.
- Add hotline webring
- Add criteria for me to join a webring.
2022-03-15 13:48:12 -07:00
Rohan Kumar
dcbace64a3
Fix: properly use "site" function instead of var
This fixes the logic to use PNGs instead of SVGs for the hidden service.
2022-03-15 13:47:42 -07:00
Rohan Kumar
c0666aa259
Refactor: add webring data from a CSV
The webring list was getting repetitive.
2022-03-15 13:45:21 -07:00