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

1954 commits

Author SHA1 Message Date
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
97d9cdeb63
CSS: more browser default colors for borders. 2022-04-10 20:41:35 -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
e63e856c9a
Typo, mention problematic Immersive Reader css 2022-04-09 12:22:51 -07:00
Rohan Kumar
dc8a635cf9
Fix hole in privacy policy
I hope nobody noticed
2022-04-08 21:03:02 -07:00
Rohan Kumar
9e2d7aa615
CSS: margin only on image figcaptions, not figures
Keeps images from getting shrunk to the point at which pictures of text
are unreadable.
2022-04-08 21:02:06 -07:00
Rohan Kumar
a3b8eb87b7
Add image of hidden search matches, wrapping fixes
- Add ugly screenshot of reddit redesign
- Fix wrapping on narrow viewports
2022-04-08 21:01:08 -07:00
Rohan Kumar
91eef19a8e
Add "in-page search" sec, other additions
- New section on in-page search
- Mention most alt search indexes don't support JS
- Background images bad
- More sample tests: word processors that support HTML
2022-04-08 17:18:45 -07:00
Rohan Kumar
9ba563d868
Rephrasings, inc. more clear link names
Minor rephrasings of some stuff, partially to improve link names (a11y)
2022-04-07 15:42:09 -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
93c394a57b
CSS: fix print, compat with older browsers
- Fix print directive i accidentally deleted
- Switch from inline-start to "left" since old browsers prolly outnumber
  the number of poeple using Eng-Arabic machine translation engines that
  also alter the text direction.
2022-04-07 15:19:34 -07:00
Rohan Kumar
069dca0a06
New subsection on cache, semantic code snippets
Add "Don't count on the cache" under the "Optimal loading" section.

Some semantics for code snippets, including switching some from <code>
to <samp>.
2022-04-06 23:42:10 -07:00
Rohan Kumar
89f04e2f31
Fix structured data 2022-04-06 23:14:13 -07:00
Rohan Kumar
fb3312eaed
Update bloopish URL 2022-04-06 22:02:24 -07:00
Rohan Kumar
c0d511b7c9
Mark up and widen code snippets 2022-04-06 19:02:17 -07:00
Rohan Kumar
bbe9ff458e
CSS: better margins, contrast
- Allow figures that are *not* quotations to keep their old default
  margins.
- Improve the contrast of links just a little bit more.
2022-04-06 17:50:11 -07:00
Rohan Kumar
47106441f7
Remove deprecated ARIA, unused classes 2022-04-06 17:49:25 -07:00
Rohan Kumar
aab9356cf2
New section on spacing, other additions
- Mention checking privacy policies for 3p content
- Elaborate on more mainstream examples of color overrides
- Link to CSS WG docs instead of MDN for prefers-contrast since they're
  more detailed.
- Specify that I'm just removing margins in <figure> elements for
  quotations.
2022-04-06 17:49:19 -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
0666dcd715
Revert to default font size, reduce body padding
It was getting annoying to fit stuff in a small viewport and the default
size isn't so bad tbh.
2022-04-05 20:20:56 -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
27ccfaca7b
Add info on non-breaing spaces. 2022-04-04 19:17:52 -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
48a18e22c5
Improve narrow-screen and mobile compat
Add soft hyphens to search engines and homepage.

But search engine list items in paragraphs to use the user-agent's
preferred paragraph spacing.
2022-04-04 19:12:46 -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
2f960ca7ec
Better linking, mention DPUB-ARIA, more infscroll
- Annotate links to PDFs and JS-mandatory content
- Add note on dpub-aria to the reading-mode section
- Fix a bad link
2022-04-04 18:11:50 -07:00
Rohan Kumar
8e2e1f9cc5
More information on image transcripts
- Add quote describing how blind readers struggle to find non-semantic context
- Mention that longdesc is deprecated by simple hyperlinks. Describe an alternative.
- Transcripts are necessary for machine translation
- Improve alt-text used alongside an image transcript
2022-04-04 15:46:04 -07:00
Rohan Kumar
f3b2c3ffa6
Rephrasing: better + inclusive use of prepositions
Follow
https://www.gov.uk/government/publications/inclusive-communication/inclusive-language-words-to-use-and-avoid-when-writing-about-disability
to mention disabilities directly with adjectives rather than
prepositions.

Fix my over-use of "with" by using more appropriate prepositions.
2022-04-03 21:10:16 -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
e5b0963d4f
Typos 2022-04-03 19:18:33 -07:00
Rohan Kumar
05a71fec3d
More accessible article layout
- Make sure that headings don't have the same name as any links, to
  avoid creating links with similar names but different purposes
- Remove useless <aside> elements that wrap landmarks.
- Move TOC down a bit, after the intro.
2022-04-03 16:03:22 -07:00
Rohan Kumar
cef17cef0f
Expand image optimization section
- Elaborate on each image optimization tool
- Mention using GNU Parallel or squoosh.app
- Describe libavif with libaom+butteraugli and the YUV400 color space
- Why you should avoid srcsets based on viewport or display properties
- Fix code snippet for <picture> sample

Threw in some formatting and very minor phrasing fixes.
2022-04-03 13:48:34 -07:00
Rohan Kumar
ec80c3b000
Reflect this site's CSS improvements
See parent commit 60bf9110b9
Link: 60bf9110b9
2022-04-03 23:55:04 -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
85523c90e5
Add info to color contrast and img optim
- Elaborate on how contrast needs to be maintained under different
  conditions like different screens, gamma adjustments, and color
  blindnesses
- Add my skepticism about progressive decoding.
2022-04-02 17:46:35 -07:00
Rohan Kumar
1a70b01374
Aria-current, shorter titles 2022-04-01 22:21:00 -07:00
Rohan Kumar
1ecf099145
Elaborate on motivation in intro 2022-04-01 18:59:21 -07:00
Rohan Kumar
cd009197a9
Elaborate on speculative preloading with note on analytics 2022-03-31 18:42:50 -07:00
Rohan Kumar
9fbf3f5138
Mention BBR congestion, streamline quotation citations. 2022-03-31 18:42:13 -07:00
Rohan Kumar
6bb659b2cf
Add TCP-aware opim, reorg
Describe round-trip aware optimization

Move some sections around to flow better.
2022-03-31 18:34:53 -07:00
Rohan Kumar
eb8bb710fc
Layout-shift-avoidance, mention zoom and size-adjustment.
- Describe how to calculate intrinsic side to avoid layout-shifts caused
  by CSS Containment
- Mention use of relative font sizes.
- Replace incorrect use of the word "inline" when describing images.
2022-03-31 18:09:40 -07:00
Rohan Kumar
a5b8b5acc9
Introduce css containment for deferring rendering
As alternative to lazy loading.
2022-03-31 17:48:58 -07:00
Rohan Kumar
c21a21ea99
Add acknowledgements, note on justified text
- Say justified alignment is bad
- Add acknowledgements to the further-reading section
- Formatting in intro
2022-03-30 22:12:16 -07:00
Rohan Kumar
4d0851969e
Fix some invalid HTML 2022-03-30 21:02:39 -07:00
Rohan Kumar
5a4510765c
Elaborate on dark themes, cite WAI, cleanup
- Cite WAI more
- Mention merit of dark image variants
- Fix shitty ARIA
- use a <dl> list in one place.
- Describe use of `prefers-contrast: less`
- Narrow screen fixes.
2022-03-30 17:47: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
02b1a8421e
Support reduced-contrast + RTL in dark mode
Use -inline-start instead of -left for machine translators that change
direction. Wrap that in a feature query so browsers that don't support
these rules can fall back to default styling. Those browsers are desktop
browsers anyway, where this doesn't relaly make a huge difference.

Add reduced-contrast for dark mode, for readers with severe astigmatism.
Reduced-contrast is the same as regular dark mode, except that the
background is lighter.

Somehow fit all of this in <1kb, any bigger and I'll have to stop
inlining.
2022-03-30 17:44:39 -07:00