to answer my own question:
> hi. i'm wondering what the reference to "style blocks" means in the
> "CSS Support" section of the manual:
> ----
> For longer style definitions, either use several ‘HTML_HEAD’ and
> ‘HTML_HEAD_EXTRA’ keywords, or use ‘<style> ... </style>’ blocks around
> them. Both of these approaches can avoid referring to an external file.
> ----
>
> can anyone provide enlightenment? thanks!
i can't say what the original author meant. but, one can do this to get
CSS into a file:
----
#+begin_export html
<style> p { margin: 10px; }</style>
#+end_export
----
below is a small patch with clarification in the manual, if deemed
appropriate.
cheers, Greg
>From 46306f25fa1171fad94b7e70690c40f7db35a018 Mon Sep 17 00:00:00 2001
From: Greg Minshall <minsh...@umich.edu>
Date: Mon, 29 Mar 2021 20:20:05 +0300
Subject: [PATCH] Clarify use of <style>...</style> for CSS in HTML export
---
doc/org-manual.org | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index efe956877..10eefc978 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -13138,9 +13138,9 @@ line in the Org file.
: #+OPTIONS: html-style:nil
For longer style definitions, either use several =HTML_HEAD= and
-=HTML_HEAD_EXTRA= keywords, or use ~<style> ... </style>~ blocks
-around them. Both of these approaches can avoid referring to an
-external file.
+=HTML_HEAD_EXTRA= keywords, or embed them between ~<style>
+... </style>~ in a =#+BEGIN_EXPORT html= block. Both of these
+approaches can avoid referring to an external file.
#+cindex: @samp{HTML_CONTAINER_CLASS}, property
#+cindex: @samp{HTML_HEADLINE_CLASS}, property
--
2.31.0
