
這是我的 LaTeX 檔foo.tex
:
\documentclass{article}
\usepackage{amsmath}
\title{Demo}
\begin{document}
\begin{align}
1 + 0 & = 1, \label{eq1} \\
1 + 1 & = 2, \label{eq2} \\
e^{i \pi} = -1. \label{eq3}
\end{align}
Equations \( \eqref{eq1} \), \( \eqref{eq2} \) and \( \eqref{eq3} \)
describe eternal truths.
The equation \( e^{i \pi} = -1 \) can also be rewritten as \( e^{i \pi}
+ 1 = 0 \) which is known as Euler's identity.
\end{document}
我將其轉換為 HTML,如下所示:
$ make4ht foo mathjax
[STATUS] make4ht: Conversion started
[STATUS] make4ht: Input file: foo
[STATUS] make4ht: Conversion finished
這是輸出foo.html
:
<!DOCTYPE html>
<html lang='en-US' xml:lang='en-US'>
<head><title></title>
<meta charset='utf-8' />
<meta name='generator' content='TeX4ht (https://tug.org/tex4ht/)' />
<meta name='viewport' content='width=device-width,initial-scale=1' />
<link href='foo.css' type='text/css' rel='stylesheet' />
<meta name='src' content='foo.tex' />
<script>window.MathJax = { tex: { tags: "ams", inlineMath: [ ["\\\(","\\\)"] ], displayMath: [ ['$$','$$'], ["\\[","\\]"] ], processEscapes: true, processEnvironments: true, packages: ['base', 'color', 'ams'] }, loader: { load: ['[tex]/color', '[tex]/ams'] } }; </script>
<script id='MathJax-script' async='async' type='text/javascript' src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js'></script>
</head><body>
<!-- l. 10 --><p class='noindent'>\begin{align} 1 + 0 & = 1, \label{eq1} \\ 1 + 1 & = 2, \label{eq2} \\ e^{i \pi } = -1. \label{eq3} \end{align}
</p><!-- l. 12 --><p class='noindent'>Equations \( \eqref{eq1} \), \( \eqref{eq2} \) and \( \eqref{eq3} \) describe eternal truths.
</p><!-- l. 15 --><p class='indent'> The equation \( e^{i \pi } = -1 \) can also be rewritten as \( e^{i \pi } + 1 = 0 \) which is known as Euler’s identity.
</p>
</body>
</html>
到目前為止,一切都很好。然而,我想做的是使用我自己的 HTML 模板來決定頁首和頁尾。我只想由 產生主要內容make4ht
。
這是我的模板template.html
。
<!DOCTYPE html>
<html>
<head>
<title>Test</title>
<meta charset='utf-8' />
<meta name='viewport' content='width=device-width,initial-scale=1' />
<style>
body {background: gray}
main {background: white; max-width: 40em; margin: 0 auto; padding: 1em}
</style>
<script>window.MathJax = {tex: {tags: "ams"}}</script>
<script src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js'></script>
</head>
<body>
<main>
<!-- HTML converted by make4ht goes here -->
</main>
</body>
</html>
有沒有辦法要求make4ht
使用這個模板而不是使用它自己的模板來產生輸出 HTML?
答案1
最簡單的方法是使用 TeX4ht 為基本 HTML 配置提供的可設定掛鉤。以下是.log
當您使用info
以下選項時放入文件中的基本資訊make4ht
:
\Configure{DOCTYPE}.........1
\Configure{HTML}............2
\Configure{HEAD}............2
\Configure{@HEAD}...........1
\Configure{BODY}............2
\Configure{TITLE+}..........1
\Configure{TITLE}...........2
\Configure{@TITLE}..........1
\Configure{Preamble}........2
<DOCTYPE>
<HTML 1>
<HEAD 1>
<TITLE 1>
<@TITLE>
<TITLE+>
<TITLE 2>
<@HEAD>
<HEAD 2>
<BODY 1>
......
<BODY 2>
<HTML 2>
The \Configure{@HEAD}{...} command is additive, concatenating the
content of all of its appearances. An empty parameter requests
the cancellation of the earlier contributions.
For instance,
\Configure{@HEAD}{A}
\Configure{@HEAD}{}
\Configure{@HEAD}{B}
\Configure{@HEAD}{C}
contributes `BC'.
The \Configure{TITLE+} provides the content for the title,
\Configure{TITLE} sets the envelop, and \Configure{@TITLE} acts as a
hook for introducing localized configurations. As is the case for
\Configure{@HEAD}, the contribution of \Configure{@TITLE} is also
additive.
These configurations should be introduced early enough in the
compilation. For instance, in the case of LaTeX, between \Preamble
and \begin{document} of a local configuration file.
\Preamble
%%% here %%%
\begin{document}
...
\EndPreamble
\Configure{@BODY}...........1
\Configure{@/BODY}..........1
Variants of \Configure{@HEAD} which contribute their content,
respectively, after <body> and before </body>.
因此,您將需要使用\Configure{HTML}
從元素中刪除屬性<html>
、\Configure{TITLE+}
設定自己的標題、\Configure{@HEAD}
將大部分內容插入<head>
元素以及\Configure{@BODY}
插入\Configure{@/BODY}
元素<main>
。
這是一個完整的.cfg
文件,展示瞭如何完成它:
\Preamble{xhtml}
\Configure{@HEAD}{} % remove default content in HTML header
\Configure{@HEAD}{%
\HCode{<meta charset='utf-8' /> \Hnewline
<meta name='viewport' content='width=device-width,initial-scale=1' /> \Hnewline
<style>\Hnewline
body {background: gray}\Hnewline
main {background: white; max-width: 40em; margin: 0 auto; padding: 1em}\Hnewline
</style>\Hnewline
<script>window.MathJax = {tex: {tags: "ams"}}</script> \Hnewline
<script src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js'></script> \Hnewline
}}
\Configure{TITLE+}{test}
\Configure{HTML}{\HCode{<html>\Hnewline}}{\HCode{\Hnewline</html>}}
\Configure{@BODY}{\ifvmode\IgnorePar\fi\EndP\HCode{<main>\Hnewline}}
\Configure{@/BODY}{\ifvmode\IgnorePar\fi\EndP\HCode{\Hnewline</main>}}
\begin{document}
\EndPreamble
第一次使用\Configure{@HEAD}{}
只是刪除 TeX4ht 插入標頭的常用內容。我們在該配置的第二次呼叫中插入您的所有標籤。注意巨集的使用\Hnewline
,它用於在生成的 HTML 檔案中插入換行符。
因為\Configure{@BODY}
和\Configure{@/BODY}
是在文件文字已經排版時使用的,所以我們需要處理段落。\ifvmode\IgnorePar\fi\EndP
用於避免標籤不匹配。
這是生成的 HTML
<!DOCTYPE html>
<html>
<head> <title>test</title>
<meta charset='utf-8' />
<meta content='width=device-width,initial-scale=1' name='viewport' />
<style>
body {background: gray}
main {background: white; max-width: 40em; margin: 0 auto; padding: 1em}
</style>
<script>window.MathJax = {tex: {tags: "ams"}}</script>
<script src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js'></script>
</head><body>
<main>
<!-- l. 11 --><p class='indent'> \begin{align} 1 + 0 & = 1, \label{eq1} \\ 1 + 1 & = 2, \label{eq2} \\ e^{i \pi } = -1. \label{eq3} \end{align}
</p><!-- l. 13 --><p class='indent'> Equations \( \eqref{eq1} \), \( \eqref{eq2} \) and \( \eqref{eq3} \) describe eternal truths.
</p><!-- l. 16 --><p class='indent'> The equation \( e^{i \pi } = -1 \) can also be rewritten as \( e^{i \pi } + 1 = 0 \) which is known as Euler’s identity.
</p>
</main>
</body>
</html>
它看起來是這樣的: