summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2018-01-13 12:19:29 -0800
committerJohn MacFarlane <jgm@berkeley.edu>2018-01-13 12:22:25 -0800
commite5e69e68c90b1afefa901df689aeee1924737741 (patch)
treeb8432572304d0b81dc6702efbf91ddb51b0da301
parentdca0032b0ebf99f374b3d8fc3942abfc3955de40 (diff)
MANUAL: recommend use of `raw_attribute` extension in header includes.
See #4253.
-rw-r--r--MANUAL.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 0153337f1..bedc6ae62 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -3037,6 +3037,17 @@ template:
$endif$
$endfor$
+Raw content to include in the document's header may be specified
+using `header-includes`; however, it is important to mark up
+this content as raw code for a particular output format, using
+the [`raw_attribute` extension](#extension-raw_attribute)), or it
+will be interpreted as markdown. For example:
+
+ header-includes:
+ - ```{=latex}
+ \let\oldsection\section
+ \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
+ ```
Backslash escapes
-----------------