fmaury/seirdy.one
1
0
Fork 0
mirror of https://git.sr.ht/~seirdy/seirdy.one synced 2024-11-23 21:02:09 +00:00
Code Issues Projects Releases Wiki Activity

Add bit about alt-text, clarify page size

Browse source
This commit is contained in:
rohan kumar 2020-11-30 12:04:21 -08:00
parent 349ba15f38
commit 4907336d96
No known key found for this signature in database
GPG key ID: 1E892DB2A5F84479
2 changed files with 6 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
content/posts/website-best-practices.gmi
View file

@ -6,7 +6,7 @@ This is a "living document" that I add to as I receive feedback.
I realize not everybody's going to ditch the Web and switch to Gemini or Gopher today (that'll take, like, a month at the longest). Until that happens, here's a non-exhaustive, highly-opinionated list of best practices for websites that focus primarily on text: I realize not everybody's going to ditch the Web and switch to Gemini or Gopher today (that'll take, like, a month at the longest). Until that happens, here's a non-exhaustive, highly-opinionated list of best practices for websites that focus primarily on text:
* Final page weight under 50kb without images, and under 200kb with images. * Final page weight under 50kb without images, and under 200kb with images. Page weight should usually be much smaller; these are upper-bounds for exceptional cases.
* Works in Lynx, w3m, links (both graphics and text mode), Netsurf, and Dillo * Works in Lynx, w3m, links (both graphics and text mode), Netsurf, and Dillo
* Works with popular article-extractors (e.g. Readability) and HTML-to-Markdown converters. This is a good way to verify that your site uses simple HTML and works with most non-browser article readers (e.g. ebook converters, PDF exports). * Works with popular article-extractors (e.g. Readability) and HTML-to-Markdown converters. This is a good way to verify that your site uses simple HTML and works with most non-browser article readers (e.g. ebook converters, PDF exports).
* No scripts or interactivity (preferably enforced at the CSP level) * No scripts or interactivity (preferably enforced at the CSP level)
@ -22,7 +22,8 @@ I realize not everybody's going to ditch the Web and switch to Gemini or Gopher
* Server configured to support compression (gzip, optionally zstd as well). It's a free speed boost. * Server configured to support compression (gzip, optionally zstd as well). It's a free speed boost.
* Supports dark mode via a CSS media feature and/or works with most "dark mode" browser addons. More on this below. * Supports dark mode via a CSS media feature and/or works with most "dark mode" browser addons. More on this below.
* A good score on Mozilla's HTTP Observatory * A good score on Mozilla's HTTP Observatory
* Optimized images. More on this below. * Optimized images. More on image optimization below.
* All images labeled with alt-text. The page should make sense without images.
* Maybe HTTP/2. There are some cases in which HTTP/2 can make things slower. Run some tests to find out. * Maybe HTTP/2. There are some cases in which HTTP/2 can make things slower. Run some tests to find out.
=> https://observatory.mozilla.org/ HTTP Observatory => https://observatory.mozilla.org/ HTTP Observatory

5
content/posts/website-best-practices.md
View file

@ -23,7 +23,7 @@ I realize not everybody's going to ditch the Web and switch to Gemini or Gopher
non-exhaustive, highly-opinionated list of best practices for websites that focus non-exhaustive, highly-opinionated list of best practices for websites that focus
primarily on text: primarily on text:
- Final page weight under 50kb without images, and under 200kb with images. - Final page weight under 50kb without images, and under 200kb with images. Page weight should usually be much smaller; these are upper-bounds for exceptional cases.
- Works in Lynx, w3m, links (both graphics and text mode), Netsurf, and Dillo - Works in Lynx, w3m, links (both graphics and text mode), Netsurf, and Dillo
- Works with popular article-extractors (e.g. Readability) and HTML-to-Markdown - Works with popular article-extractors (e.g. Readability) and HTML-to-Markdown
converters. This is a good way to verify that your site uses simple HTML and works converters. This is a good way to verify that your site uses simple HTML and works
@ -45,7 +45,8 @@ primarily on text:
- Supports dark mode via a CSS media feature and/or works with most "dark mode" - Supports dark mode via a CSS media feature and/or works with most "dark mode"
browser addons. More on this below. browser addons. More on this below.
- A good score on Mozilla's [HTTP Observatory](https://observatory.mozilla.org/) - A good score on Mozilla's [HTTP Observatory](https://observatory.mozilla.org/)
- Optimized images. - Optimized images. More on image optimization below.
- All images labeled with alt-text. The page should make sense without images.
- Maybe HTTP/2. There are some cases in which HTTP/2 can make things slower. Run some - Maybe HTTP/2. There are some cases in which HTTP/2 can make things slower. Run some
tests to find out. tests to find out.