Comment utiliser mon propre modèle HTML avec make4ht?
Voici mon fichier 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}
Je le convertis en HTML comme ceci:
$ make4ht foo mathjax
[STATUS] make4ht: Conversion started
[STATUS] make4ht: Input file: foo
[STATUS] make4ht: Conversion finished
Voici la sortie 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>
Jusqu'ici tout va bien. Cependant, ce que je veux faire, c'est utiliser mon propre modèle HTML qui décide de l'en-tête et du pied de page. Je veux que seul le contenu principal soit généré par make4ht.
Voici mon modèle 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>
Existe-t-il un moyen de demander à make4htutiliser ce modèle au lieu d'utiliser son propre modèle pour générer le HTML de sortie?
Réponses
Le moyen le plus simple est d'utiliser les hooks configurables fournis par TeX4ht pour la configuration HTML de base. Voici les informations de base qui sont placées dans le .logfichier lorsque vous utilisez l' infooption pour 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>.
Ainsi, vous devrez utiliser \Configure{HTML}pour supprimer des attributs de l' <html>élément, \Configure{TITLE+}pour définir votre propre titre, \Configure{@HEAD}pour insérer la plupart des éléments dans l' <head>élément et \Configure{@BODY}et \Configure{@/BODY}pour insérer l' <main>élément.
Voici un .cfgfichier complet qui montre comment cela peut être fait:
\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
La première utilisation de \Configure{@HEAD}{}supprime simplement les éléments habituels que TeX4ht insère dans l'en-tête. Nous insérons toutes vos balises dans la deuxième invocation de cette configuration. Notez l'utilisation de la \Hnewlinemacro, elle sert à insérer un saut de ligne dans le fichier HTML généré.
Parce que \Configure{@BODY}et \Configure{@/BODY}sont utilisés lorsque le texte du document est déjà composé, nous devons traiter les paragraphes. \ifvmode\IgnorePar\fi\EndPest utilisé pour éviter la non-correspondance des balises.
Voici le HTML résultant
<!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>
Et voici à quoi ça ressemble:
