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

Clarify the point of using HTML->md convertors

Browse source 
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
Show stats Download patch file Download diff file Expand all files Collapse all files

7
content/posts/website-best-practices.gmi
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:
* 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 cookies
* 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://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
@ -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:
```
@media (prefers-color-scheme: dark).
@media (prefers-color-scheme: dark)
```
## Other places to check out

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

@ -21,8 +21,10 @@ non-exhaustive, highly-opinionated list of best practices for websites that focu
primarily on text:
- 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 cookies
- 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.
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
-----------