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

460 commits

Author SHA1 Message Date
Rohan Kumar
9f3d6b9df3
Re-introduce RSS discoverability alongside Atom
The RSS feeds use escaped HTML instead of XHTML, which improves
compatibility with certain feed readers (e.g. Microsoft Outlook).

Mention that Outlook uses its own weird engine for feed contents in my
web best practices article.
2022-06-17 08:51:53 -07:00
Rohan Kumar
10aa9551fd
Mention Busybox as an example 2022-06-13 17:03:42 -07:00
Rohan Kumar
69e5d38b2c
Mention vim, whatis, and apropos manpage integration 2022-06-13 08:34:42 -07:00
Rohan Kumar
da824ada96
Re-organize and expand recommendations
- Add recommendation to avoid ASCII-art
- Split recommendations into sub-sections
- Minor rephrasings
- Remove soft hyphen from gemtext
2022-06-13 08:32:20 -07:00
Rohan Kumar
6fc1a907b4
Add --dry-run and mention living article. 2022-06-13 08:24:45 -07:00
Rohan Kumar
c68fb1f2f8
Add privacy info to Petal 2022-06-12 21:52:47 -07:00
Rohan Kumar
d9bbdaf4b2
Add Apple and Amazon search engines 2022-06-12 16:04:16 -07:00
Rohan Kumar
65c6841f6a
Add note on borders and re-flow 2022-06-11 20:12:27 -07:00
Rohan Kumar
56c9054950
Add Daum and ALibw.com 2022-06-11 16:38:13 -07:00
Rohan Kumar
1c2cae096d
Add translation to gemini article 2022-06-11 13:29:35 -07:00
Alex
2ccf231931
Add German translation to WhatsApp and the domestication of users 2022-06-11 13:26:58 -07:00
Rohan Kumar
0fc9fe4de7
Markup fix: use paragraphs in bibliography 2022-06-11 13:24:47 -07:00
Rohan Kumar
00d3b170b2
Fix bad markup 2022-06-10 19:41:35 -07:00
Rohan Kumar
7833fcd15d
Revert changes to mention-work 2022-06-10 19:35:33 -07:00
Rohan Kumar
a502691c38
New post: CLI best practices 2022-06-10 19:24:54 -07:00
Rohan Kumar
666342d867
mention Brave SpeedReader 2022-06-10 17:25:16 -07:00
Rohan Kumar
603bbd8fa2
Minor clarification: required and optional perms 2022-06-07 11:16:21 -07:00
Rohan Kumar
a7cd9d94f7
Correction: uBO can only inject certain scripts 2022-06-07 11:02:47 -07:00
Rohan Kumar
3c914b4dd1
Support multiple <dt> that share a <dd>
- Make sure their tap targets do not overlap
- Use a regex to detect them in markup using an "OR" keyword
- Implement them in one article.
2022-06-06 21:42:32 -07:00
Rohan Kumar
f132e194ed
Typo 2022-06-06 16:51:12 -07:00
Rohan Kumar
b342b803e6
Remove draft status 2022-06-04 22:50:08 -07:00
Rohan Kumar
058344c83c
New post: "A layered approach to content blocking" 2022-06-04 22:47:00 -07:00
Rohan Kumar
29371ed1f8
Fairsearch -> Yep rename 2022-06-03 17:41:34 -07:00
Rohan Kumar
b557bb9474
Fix feed subtitles and descriptions 2022-06-01 09:59:52 -07:00
Rohan Kumar
a46b790a62
Remove microdata from feeds
It's useless and invalid in those contexts, and removing it
significantly trims the file sizes.

Edit a post featuring a microdata code snippet to avoid conflicts.
2022-05-31 20:52:16 -07:00
Rohan Kumar
1aed7a66d4
Switch to XHTML5 markup
The site now has polygot markup and can handle both XHTML5 and HTML5
parsing rules. My staging site will be XHTML but my main site will be
HTML5, just in case of parse errors.

If other tools (e.g. LightHouse) end up supporting XHTML5, I'll consider
switching the content-type to XHTML.
2022-05-30 17:39:45 -07:00
Rohan Kumar
1d44bc382d
Marginalia.nu has gone open source 2022-05-28 14:11:51 -07:00
Rohan Kumar
c84c8d4214
BREAKING: Prettify URLs, add Atom feeds
Adding a bunch of server configs to do the re-directs too.
2022-05-26 18:57:49 -07:00
Rohan Kumar
d123bd9a12
New shortcode: "mention-work".
Will be useful when I start posting reply notes.
2022-05-24 17:25:16 -07:00
Rohan Kumar
063ddbb8d9
Elaborate on single-col layout, make evergreen 2022-05-23 17:35:50 -07:00
Rohan Kumar
279d70810e
Support "evergreen" articles
"evergreen" articles don't get outdated and shouldn't be marked with a
published date in previews.
2022-05-23 08:39:24 -07:00
Rohan Kumar
2204ae8861
Microdata improvements
- Semantically link each blog posting to the greater blog
- Fix copyright bullshit
- Make some articles TechArticles
- Remove unnecessary markup
2022-05-20 18:32:21 -07:00
Rohan Kumar
9077660b9f
New section "visible interactive semantics"
Move "in defense of link underlines" to subsection of new "visible
interactive semantics" section. Add info on distinguishing between
buttons and links, and making non-interactive space look visually
distinct from interactive space.
2022-05-19 19:31:24 -07:00
Rohan Kumar
c5eb934555
Clarify horizontal line test, RT-tracking overkill
- round-trip-tracking is overkill for most use-cases
- clarify that horizontal line test is best used for landmarks and for
  multiple different grouping elements, rather than just any grouping
  element.
2022-05-18 18:31:55 -07:00
Rohan Kumar
831c54b4ab
Fix metadata/semantics, clarify alt text length 2022-05-18 11:38:16 -07:00
Rohan Kumar
6d066f8711
Support page-specific open graph images
Allow specifying open graph images for individual pages. Change default
site-wide open graph image alt-text to an empty string since the default
image only has visual value, and is better off hidden from assistive
technologies.

Set an open graph image for two articles.
2022-05-18 09:00:05 -07:00
Rohan Kumar
795e5fc58c
Add footnote about SC 2.4.8, fix gemtext footnotes
Some gemtext footnote refs were missing; some were out of order.
2022-05-17 17:17:20 -07:00
Rohan Kumar
f1867f4255
Add section: "Transfer size and user flows", fixes
- Add new subsection of "optimal loading" that connects WCAG SC 2.4.5
  with payload size.
- Remove/replace some inline formatting.
- Add some in-page-links to definitions and new section
- Replace "click" with "navigate" since not everyone navigates by click.
2022-05-17 08:54:25 -07:00
Rohan Kumar
d543f7a6b2
Limits of translation, hard-wrapped <pre>
Describe current limitations of machine translation for web content, and
encourage authors to hard-wrap <pre> text to limit horizontal scrolling
in widescreen desktop browsers.

Mention KaiOS Readout
2022-05-13 17:23:16 -07:00
Rohan Kumar
e523956ecd
Some additions and fixes
- Benefit of identical source/dom/visual order: layout consistency
- Expand the "horizontal-line test" to be a bit more precise.
- Elaborate on line-length issues in SC 1.4.8
- Add footnote mentioning uBlock Origin's support for blocking large
  media elements
- Update mention of border-colors: I don't set most border colors
  anymore.
- Switch "lighten them up" to "de-saturate them" regarding colors and
  overstimulation.
- Update references to my CSS color palette to reflect changes
- Reduce excessive inline formatting in a blockquote
- Re-phrasings and formatting
2022-05-13 17:14:16 -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
b5bf54ff45
Fix missing itemprop 2022-05-11 23:40:24 -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
fb84eb5d12
Minor microdata/whitespace fixes 2022-05-10 16:05:22 -07:00
Rohan Kumar
71dc86faf9
Fix non-interactive space section & impl
Improve non-interactive space on the homepage and use a better
screenshot to illustrate the concept.
2022-05-09 17:51:44 -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
88ca957941
add info on watches/translation/indentation/other
- Mention device-adjust
- translation tools don't always understand nested translate directives
- another pitfall of over-reliance on indentation: nested indented
  elements are ambiguous
- Fix some typos
- Update outdatead references to my site's CSS that I've since changed.
2022-05-07 22:17:27 -07:00
Rohan Kumar
3cd44b2ce5
Typos, grammar, descriptive names, etc. 2022-05-06 22:15:29 -07:00
Rohan Kumar
6ebbd739fd
Fix image structured data 2022-05-06 10:30:11 -07:00
Rohan Kumar
ee498b9745
Fix broken link 2022-05-05 20:39:23 -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
bf07611639
Update guidance on tap target and non-interactive size 2022-05-05 15:31:30 -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
aee6d9410c
Drop a featured article
Compensates for the text added to the homepage in the parent commit.
2022-05-03 22:01:18 -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
1863c65dce
Trivial rephrase, keeps a figure from overflowing 2022-05-03 17:09:21 -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
adcccad94e
Website tests: add test exclusions 2022-05-02 17:09:46 -07:00
Rohan Kumar
1502d59e59
Add automated testing tools, better link names
Split "testing" section up into two subsections, with one subsection for
automated testing tools.

Split "The Tor Browser" section into two subsections.

Make link names more descriptive.
2022-05-02 15:42:44 -07:00
Rohan Kumar
321f851431
Remove responsive navbar
It's mobile-friendly as-is. I made sure that tap-targets were even
bigger and more spaced-apart, just to be safe.

Hide unnecessary nav-links in print mode.
2022-05-01 17:04:20 -07:00
Rohan Kumar
cc59c9abf0
More about APCA, RCWN, allow-same-origin, typos 2022-04-29 17:37:24 -07:00
Rohan Kumar
ad42b30027
Fix some microdata 2022-04-29 09:01:40 -07:00
Rohan Kumar
cb2337fb0f
Typo 2022-04-29 08:57:06 -07:00
Rohan Kumar
543bbbc502
Fix some url redirects 2022-04-29 08:54:36 -07:00
Rohan Kumar
b22ec089f8
Rephrase, mention problems with role=text. 2022-04-28 17:43:46 -07:00
Rohan Kumar
fb6e91c820
Reduce accidental skips, add transcript, microdata
When a figure is in the middle of a section, mobile screen reader users
might not switch away from heading-based navigation. Instead, they might
just jump to the next heading.

Re-organize the page to put some skippable content closer to the end of
sections, and add a section describing the need for this.

Also add a transcript to the screenshot of BMFW, and adopt the new
quotecaption shortcode, and fix some structured data by using some
shortcodes properly.
2022-04-27 17:53:50 -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
048a8147cc
Fix broken link 2022-04-27 08:45:47 -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
f8cc34f37b
Phrasing 2022-04-26 17:22:18 -07:00
Rohan Kumar
447b8463bb
Elaborate on HPACK/QPACK, simplify code snippet 2022-04-26 17:16:29 -07:00
Rohan Kumar
4ed64cf96e
off-by-one error 2022-04-26 09:20:31 -07:00
Rohan Kumar
75e3e019c7
More on color overrides, some hyphens. 2022-04-25 22:12:53 -07:00
Rohan Kumar
5afbe2b108
Trivial typo 2022-04-25 20:04:07 -07:00
Rohan Kumar
3db1d6ca1b
Mention FoUC + WFoD, and more on ATs
- Mention the browser-AT relation.
- Mention symbol names versus appearance.
- Also throw in a doc-tip
2022-04-25 17:40:16 -07:00
Rohan Kumar
a5245b26fa
Remove broken link 2022-04-25 17:35:46 -07:00
Rohan Kumar
b12bdb543f
Remove unused class 2022-04-25 17:29:57 -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
4e65794972
Remove repetitive link. 2022-04-24 22:03:51 -07:00
Rohan Kumar
76bc44b9a2
Shorter alt-text, unique link names. 2022-04-24 21:53:19 -07:00
Rohan Kumar
715fb820ec
Rephrasings to make descriptions less spatial 2022-04-24 16:53:46 -07:00
Rohan Kumar
86def57b1b
Fix some dated info
Some changes on my site weren't reflected in the article content.
2022-04-23 20:20:17 -07:00
Rohan Kumar
a84a6d8520
Add indetdex engines 2022-04-23 20:13:22 -07:00
Rohan Kumar
8ddc2ec879
Make transcript the description of the image. 2022-04-22 11:48:22 -07:00
Rohan Kumar
d3806e630c
Shorten some unnecessarily verbose alt-text
The same necessary information is conveyed, but now it's shorter. Also
removed some extra redundant information.
2022-04-22 08:49:27 -07:00
Rohan Kumar
0dc6ee1258
New "contrast is complex" sub-section
Elaborate on how hues with good perceptual contrast can be
over-stimulating, so we should try to make them "washed-out" when
possible.
2022-04-21 23:01:35 -07:00
Rohan Kumar
c939afbc0a
Elaborate on focus indicators + fix anchors 2022-04-21 21:40:40 -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
50c3ec981c
Improve + talk about image transcripts some more 2022-04-20 17:36:02 -07:00
Rohan Kumar
8d1fa33d0c
Add more info on Windows High Contrast mode 2022-04-19 20:19:58 -07:00
Rohan Kumar
8e8512290b
Fix invalid HTML 2022-04-19 20:07:30 -07:00
Rohan Kumar
52a7b8a737
Fix overflow 2022-04-19 18:17:21 -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
e59f3b6e15
Expand "Accessible skimming" section
I've learned a lot about landmarks recently.
2022-04-18 21:20:50 -07:00
Rohan Kumar
78d9ddb749
Mention screen reader verbosity and noise 2022-04-18 21:06:21 -07:00
Rohan Kumar
8d34425e45
Markdown style, put some figcaptions in paragraphs
Figcaptions for code snippets should be in their own paragraphs, since
they're a bit more descriptive.
2022-04-18 08:57:33 -07:00
Rohan Kumar
92f1d70128
Fix TOC aria labels, avoid bad spatial word choice 2022-04-18 01:29:05 -07:00
Rohan Kumar
9d34f82f5d
Limit homepage posts to featured posts 2022-04-18 00:31:19 -07:00