From 86def57b1bcf967d2a766ba14e145ef3fe7dec7b Mon Sep 17 00:00:00 2001 From: Rohan Kumar Date: Sat, 23 Apr 2022 20:19:55 -0700 Subject: [PATCH] Fix some dated info Some changes on my site weren't reflected in the article content. --- content/posts/website-best-practices.gmi | 5 +++-- content/posts/website-best-practices.md | 7 +++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/posts/website-best-practices.gmi b/content/posts/website-best-practices.gmi index 01516c3..2f056c9 100644 --- a/content/posts/website-best-practices.gmi +++ b/content/posts/website-best-practices.gmi @@ -524,9 +524,10 @@ An image, alt-text, figure caption, and transcript combine to form a complex rel ```

Infinite scrolling

-
+
Comic: if books had infinite-scroll, we'd have to turn pages carefully or risk losing the page.
@@ -1001,7 +1002,7 @@ The HTML spec's blockquote section recommends placing a
element ins Browser default stylesheets typically give
elements extra margins on the left and right.
elements have a large indent. Combining these two properties gives the final quotation an excessive visual indent, wasting precious vertical screen space. When quoted text contains list elements (
    ,
    ,
      ), the indentation alone may fill most of a narrow viewport! -I chose to remove the margins in
      elements for quotations. If you're reading the Web version of this page with its own stylesheet enabled, in a CSS 3 compliant browser, you might notice that the blockquotes on it have a minimal indent and a thick gray border on the left rather than a full indent. These two adjustments allow blockquotes containing bulleted lists to fit on most narrow viewports, even when wrapped by a
      element. Browsers that do not support CSS 3 properties such as "padding-inline-start" will render quoted text using default stylesheets (probably with an indent), which are perfectly usable if a bit inconvenient. +I chose to remove the margins in
      elements for quotations. If you're reading the Web version of this page with its own stylesheet enabled, in a CSS 2 compliant browser, you might notice that the blockquotes on it have a minimal indent and a thick border on the left rather than a full indent. These two adjustments allow blockquotes containing bulleted lists to fit on most narrow viewports, even when wrapped by a
      element. Browsers that do not support CSS 3 properties such as "padding-inline-start" will render quoted text using default stylesheets (probably with an indent), which are perfectly usable if a bit inconvenient. Another example: outside the Web, I prefer indenting code with tabs instead of spaces. Tab widths are user-configurable, while spaces aren't. HTML pre-formatted code blocks, however, are best indented with two spaces. Default browser stylesheets typically represent tabs with an excessive indent, which can be annoying on narrow viewports. diff --git a/content/posts/website-best-practices.md b/content/posts/website-best-practices.md index 111d747..592e5f3 100644 --- a/content/posts/website-best-practices.md +++ b/content/posts/website-best-practices.md @@ -459,8 +459,6 @@ font: 100%/1.5 sans-serif; Beyond alt-text --------------- -Note: this section does not include examples of its own. If you wish to see examples, look at the figures in the official version of this web page. You're probably on it right now; if not, [here's the canonical location](https://seirdy.one/2020/11/23/website-best-practices.html). - Expect some readers to have images disabled or unloaded. Examples include: * Blind readers @@ -562,9 +560,10 @@ An image, alt-text, figure caption, and transcript combine to form a complex rel ```figure {var1="SRC" str1="figure" str2="img" str3="alt" str4="details" str5="article", str6="figcaption" str7="aria-label" str8="aria-describedby"}

      Infinite scrolling

      -
      +
      Comic: if books had infinite-scroll, we'd have to turn pages carefully or risk losing the page. @@ -975,7 +974,7 @@ The HTML standard's section 4.4.4 [covers blockquotes](https://html.spec.whatwg. Browser default stylesheets typically give `
      ` elements extra margins on the left and right. `
      ` elements have a large indent. Combining these two properties gives the final quotation an excessive visual indent, wasting precious vertical screen space. When quoted text contains list elements (`
        `, `
        `, `
          `), the indentation alone may fill most of a narrow viewport! -I chose to remove the margins in `
          ` elements for quotations and code snippets. If you're reading this page with its own stylesheet enabled, in a CSS 3 compliant browser, you might have noticed the blockquotes on it have a minimal indent and a thick gray border on the left rather than a full indent. These two adjustments allow blockquotes containing bulleted lists to fit on most narrow viewports, even when wrapped by a `
          ` element. Browsers that do not support CSS 3 properties such as `padding-inline-start` will render quoted text using default stylesheets (probably with an indent), which are perfectly usable if a bit inconvenient. +I chose to remove the margins in `
          ` elements for quotations and code snippets. If you're reading this page with its own stylesheet enabled, in a CSS 2 compliant browser, you might have noticed the blockquotes on it have a minimal indent and a thick border on the left rather than a full indent. These two adjustments allow blockquotes containing bulleted lists to fit on most narrow viewports, even when wrapped by a `
          ` element. Browsers that do not support CSS 3 properties such as `padding-inline-start` will render quoted text using default stylesheets (probably with an indent), which are perfectly usable if a bit inconvenient. Another example: outside the Web, I prefer indenting code with tabs instead of spaces. Tab widths are user-configurable, while spaces aren't. HTML pre-formatted code blocks, however, are best indented with two spaces. Default browser stylesheets typically represent tabs with an excessive indent, which can be annoying on narrow viewports.