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

276 commits

Author SHA1 Message Date
Rohan Kumar
29b01ed1a5
Remove unnecessary title attributes 2022-05-12 18:57:00 -07:00
Rohan Kumar
8a2154e5ab
Make transcript headings more unique 2022-05-12 18:56:16 -07:00
Rohan Kumar
a42a0f95d3
Fix list semantics 2022-05-12 18:41:32 -07:00
Rohan Kumar
7b236f003c
Use WAI-ARIA 1.3's "comment" role on webmentions 2022-05-12 18:39:34 -07:00
Rohan Kumar
a9039e1bde
Adjust image transcript approach
- Use section instead of nested article
- Adjust stylesheets to match above markup changes
- Mention upcoming aria-details
2022-05-12 17:33:12 -07:00
Rohan Kumar
5a1782f1ee
HEAD: Fix outdated theme-color, missing whitespace 2022-05-11 10:02:15 -07:00
Rohan Kumar
a96b77793b
More CSS containment, adopt shortcodes
- Adopt more shortcodes in older posts.
- Contain figures, excluding images. Slightly decreases paint times.
- Fix spacing issues for nested articles.
- Always enable vertical scrollbar, since pretty much all pages are
  taller than the viewport. Eliminates a layout shift.
- Moar microdata
- Set fixed updated dates for some posts so they don't get new
  date-updated values until I actually change the content significantly
2022-05-11 23:32:35 -07:00
Rohan Kumar
8f4e1b7468
Disable resume post-meta, only use .gmi changelog
- Only show changelogs for gemtext since they only include changes to
  content rather than semantics
- Disable useless post meta on resume.
2022-05-11 21:29:47 -07:00
Rohan Kumar
fb84eb5d12
Minor microdata/whitespace fixes 2022-05-10 16:05:22 -07:00
Rohan Kumar
4f177f5536
Use less harsh colors in a screenshot
Make the dark link underlines screenshot less prone to overstimulation
2022-05-09 08:25:13 -07:00
Rohan Kumar
7bd796a44c
Floating block examples, Tkhtml, semantics, other
- Change a quote of a code snippet to a code snippet with a citation
- Mention tkhtml
- Mention pandoc and printfriendly as exmples of moving figure elements
  like floating blocks.
- Make TPGi a publisher, not an author.
- Use brackets to clarify a reference in a quotation.
- Add personal example of why it's important to test both low- and
  high-end displays.
2022-05-08 21:08:08 -07:00
Rohan Kumar
80317aa256
a11y: more descriptive noteref link names 2022-05-06 22:21:31 -07:00
Rohan Kumar
f3c23c5d36
Typo 2022-05-06 16:31:21 -07:00
Rohan Kumar
f5f0785e65
Microdata: add itemid attributes 2022-05-06 10:33:42 -07:00
Rohan Kumar
372589a57a
Improve image transcript navigation
- Identify the transcript with a subheading, ending in a period so that
  the aria-description separates the identifier from the concept.
- Put the transcript in a <section>
- Snuck in a trivial syntax fix for the generator element.
2022-05-06 10:31:52 -07:00
Rohan Kumar
8579559978
Fix posts description 2022-05-06 10:31:45 -07:00
Rohan Kumar
6f02550253
Remove unused classes 2022-05-06 10:31:26 -07:00
Rohan Kumar
6ebbd739fd
Fix image structured data 2022-05-06 10:30:11 -07:00
Rohan Kumar
155ff8290d
Put TOC in a <details> element. 2022-05-05 20:07:59 -07:00
Rohan Kumar
89b0e01e66
Fix microdata nesting
Make sure separate elements are part of each other so only a single
element is at the top level.
2022-05-05 19:57:27 -07:00
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