1
0
Fork 0
mirror of https://git.sr.ht/~seirdy/seirdy.one synced 2024-11-23 21:02: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:
rohan kumar 2020-11-24 01:59:22 -08:00
parent e538b0df8e
commit 6f937ac5a8
No known key found for this signature in database
GPG key ID: 1E892DB2A5F84479
2 changed files with 9 additions and 6 deletions

View file

@ -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

View file

@ -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
----------- -----------