mirror of
https://git.sr.ht/~seirdy/seirdy.one
synced 2024-11-10 00:12:09 +00:00
Clarify the point of using HTML->md convertors
Thanks to some IRC users for pointing out how the rationale wasn't very obvious
This commit is contained in:
parent
e538b0df8e
commit
6f937ac5a8
2 changed files with 9 additions and 6 deletions
|
@ -3,7 +3,8 @@ The following applies to minimal websites that focus primarily on text. It does
|
||||||
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.
|
||||||
* Works in Lynx, w3m, links (both graphics and text mode), Netsurf, Dillo, and most HTML-to-markdown converters
|
* 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).
|
||||||
* No scripts or interactivity (preferably enforced at the CSP level)
|
* No scripts or interactivity (preferably enforced at the CSP level)
|
||||||
* No cookies
|
* No cookies
|
||||||
* No animations
|
* No animations
|
||||||
|
@ -20,7 +21,7 @@ I realize not everybody's going to ditch the Web and switch to Gemini or Gopher
|
||||||
=> https://observatory.mozilla.org/ HTTP Observatory
|
=> https://observatory.mozilla.org/ HTTP Observatory
|
||||||
=> https://github.com/shssoichiro/oxipng Oxipng
|
=> https://github.com/shssoichiro/oxipng Oxipng
|
||||||
|
|
||||||
Early rough drafts of this post generated some feedback I thought I should address below. Special thanks to the five IRC users who provided feedback!
|
Early rough drafts of this post generated some feedback I thought I should address below. Special thanks to the eight IRC users who provided feedback!
|
||||||
|
|
||||||
## About fonts
|
## About fonts
|
||||||
|
|
||||||
|
@ -68,7 +69,7 @@ It's got a grey background, a header with unreadable black/grey text, and unread
|
||||||
If you do explicitly set colors, please also include a dark theme using a media query:
|
If you do explicitly set colors, please also include a dark theme using a media query:
|
||||||
|
|
||||||
```
|
```
|
||||||
@media (prefers-color-scheme: dark).
|
@media (prefers-color-scheme: dark)
|
||||||
```
|
```
|
||||||
|
|
||||||
## Other places to check out
|
## Other places to check out
|
||||||
|
|
|
@ -21,8 +21,10 @@ non-exhaustive, highly-opinionated list of best practices for websites that focu
|
||||||
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.
|
||||||
- Works in Lynx, w3m, links (both graphics and text mode), Netsurf, Dillo, and most
|
- Works in Lynx, w3m, links (both graphics and text mode), Netsurf, and Dillo
|
||||||
HTML-to-markdown converters
|
- 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)
|
||||||
- No cookies
|
- No cookies
|
||||||
- No animations
|
- No animations
|
||||||
|
@ -45,7 +47,7 @@ primarily focus on text. If graphics, interactivity, etc. are an important part
|
||||||
your website, less (possibly none) of this article applies.
|
your website, less (possibly none) of this article applies.
|
||||||
|
|
||||||
Early rough drafts of this post generated some feedback I thought I should address
|
Early rough drafts of this post generated some feedback I thought I should address
|
||||||
below. Special thanks to the five IRC users who provided feedback!
|
below. Special thanks to the eight IRC users who provided feedback!
|
||||||
|
|
||||||
About fonts
|
About fonts
|
||||||
-----------
|
-----------
|
||||||
|
|
Loading…
Reference in a new issue