mirror of
https://git.savannah.gnu.org/git/emacs/org-mode.git
synced 2024-08-26 14:32:52 +00:00
Export: Improve documentation about htmlize-output-style.
This commit is contained in:
parent
ae2cf50782
commit
8d29f3d427
|
@ -793,10 +793,18 @@ to a file."
|
|||
|
||||
(defcustom org-export-htmlize-output-type 'inline-css
|
||||
"Output type to be used by htmlize when formatting code snippets.
|
||||
Normally this is `inline-css', but if you have defined to appropriate
|
||||
classes in your css style file, setting this to `css' means that the
|
||||
fontification will use the class names.
|
||||
See also the function `org-export-htmlize-generate-css'."
|
||||
We use as default `inline-css', in order to make the resulting
|
||||
HTML self-containing.
|
||||
However, this will fail when using Emacs in batch mode for export, because
|
||||
then no rich font definitions are in place. It will also not be good if
|
||||
people with different Emacs setup contribute HTML files to a website,
|
||||
because the fonts will represent the individual setups. In these cases,
|
||||
it is much better to let Org/Htmlize assign classes only, and to use
|
||||
a style file to define the look of these classes.
|
||||
To get a start for your css file, start Emacs session nnd make sure that
|
||||
all the faces you are interested in are defined, for example by loading files
|
||||
in all modes you want. Then, use the command
|
||||
\\[org-export-htmlize-generate-css] to extract class definitions."
|
||||
:group 'org-export-htmlize
|
||||
:type '(choice (const css) (const inline-css)))
|
||||
|
||||
|
|
Loading…
Reference in a new issue