mirror of
https://github.com/imfing/hextra.git
synced 2025-06-18 21:03:35 -04:00
7031718449
* feat: add MathJax option * docs: move math engine note * refactor: update LaTeX documentation and improve MathJax integration - Adjusted LaTeX documentation for clarity and formatting. - Enhanced MathJax configuration in the templates to support both KaTeX and MathJax rendering. - Removed deprecated comments and streamlined the script loading process for MathJax. - Updated the passthrough extension settings in the Hugo configuration for better compatibility with LaTeX math expressions. * docs: simplify LaTeX documentation and clarify configuration steps - Updated LaTeX documentation to reflect that KaTeX is enabled by default, removing the need for manual activation. - Added examples for using LaTeX math expressions and clarified the configuration for the passthrough extension in Hugo. - Enhanced MathJax section to emphasize its use as an alternative rendering engine.
113 lines
4.6 KiB
HTML
113 lines
4.6 KiB
HTML
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
{{- $noindex := .Params.noindex | default false -}}
|
||
{{ if and (hugo.IsProduction) (not $noindex) -}}
|
||
<meta name="robots" content="index, follow" />
|
||
{{ else -}}
|
||
<meta name="robots" content="noindex, nofollow" />
|
||
{{ end -}}
|
||
{{ partialCached "favicons.html" . -}}
|
||
<title>
|
||
{{- if .IsHome -}}
|
||
{{ .Site.Title -}}
|
||
{{ else -}}
|
||
{{ with .Title }}{{ . }} – {{ end -}}
|
||
{{ .Site.Title -}}
|
||
{{ end -}}
|
||
</title>
|
||
<meta name="description" content="{{ partial "utils/page-description.html" . }}" />
|
||
|
||
{{- with .Params.canonical -}}
|
||
<link rel="canonical" href="{{ . }}" itemprop="url" />
|
||
{{- else -}}
|
||
<link rel="canonical" href="{{ .Permalink }}" itemprop="url" />
|
||
{{- end -}}
|
||
|
||
{{- partial "opengraph.html" . -}}
|
||
{{- partial "schema.html" . -}}
|
||
{{- partial "twitter_cards.html" . -}}
|
||
|
||
{{- $mainCss := resources.Get "css/compiled/main.css" -}}
|
||
{{- $customCss := resources.Get "css/custom.css" -}}
|
||
{{- $variablesCss := resources.Get "css/variables.css" | resources.ExecuteAsTemplate "css/variables.css" . -}}
|
||
|
||
{{- /* Production build */ -}}
|
||
{{- if hugo.IsProduction }}
|
||
{{- $styles := slice $variablesCss $mainCss $customCss | resources.Concat "css/compiled/main.css" | minify | fingerprint }}
|
||
<link rel="preload" href="{{ $styles.RelPermalink }}" as="style" integrity="{{ $styles.Data.Integrity }}" />
|
||
<link href="{{ $styles.RelPermalink }}" rel="stylesheet" integrity="{{ $styles.Data.Integrity }}" />
|
||
|
||
{{- /* Theme development mode (non-production + theme environment) */ -}}
|
||
{{- else if eq hugo.Environment "theme" }}
|
||
{{- $devStyles := resources.Get "css/styles.css" | postCSS (dict "inlineImports" true) }}
|
||
<link href="{{ $devStyles.RelPermalink }}" rel="stylesheet" />
|
||
<link href="{{ $variablesCss.RelPermalink }}" rel="stylesheet" />
|
||
<link href="{{ $customCss.RelPermalink }}" rel="stylesheet" />
|
||
|
||
{{- /* User local development */ -}}
|
||
{{- else }}
|
||
{{- $styles := resources.Get "css/compiled/main.css" -}}
|
||
<link href="{{ $styles.RelPermalink }}" rel="stylesheet" />
|
||
<link href="{{ $variablesCss.RelPermalink }}" rel="stylesheet" />
|
||
<link href="{{ $customCss.RelPermalink }}" rel="stylesheet" />
|
||
{{- end }}
|
||
|
||
|
||
<!-- Google Analytics -->
|
||
{{- if and hugo.IsProduction .Site.Config.Services.GoogleAnalytics.ID }}
|
||
<link rel="preconnect" href="https://www.googletagmanager.com" crossorigin />
|
||
{{ partial "google-analytics.html" . -}}
|
||
{{- end }}
|
||
|
||
<script>
|
||
/* Initialize light/dark mode */
|
||
const defaultTheme = '{{ site.Params.theme.default | default `system`}}';
|
||
|
||
const setDarkTheme = () => {
|
||
document.documentElement.classList.add("dark");
|
||
document.documentElement.style.colorScheme = "dark";
|
||
}
|
||
const setLightTheme = () => {
|
||
document.documentElement.classList.remove("dark");
|
||
document.documentElement.style.colorScheme = "light";
|
||
}
|
||
|
||
if ("color-theme" in localStorage) {
|
||
localStorage.getItem("color-theme") === "dark" ? setDarkTheme() : setLightTheme();
|
||
} else {
|
||
defaultTheme === "dark" ? setDarkTheme() : setLightTheme();
|
||
if (defaultTheme === "system") {
|
||
window.matchMedia("(prefers-color-scheme: dark)").matches ? setDarkTheme() : setLightTheme();
|
||
}
|
||
}
|
||
</script>
|
||
|
||
<!-- KaTeX-->
|
||
{{ $noop := .WordCount -}}
|
||
{{- $engine := site.Params.math.engine | default "katex" -}}
|
||
{{ if and (.Page.Store.Get "hasMath") (eq $engine "katex") -}}
|
||
<!-- TODO: make url configurable -->
|
||
{{ $katexBaseUrl := "https://cdn.jsdelivr.net/npm/katex@latest/dist" }}
|
||
{{ $katexCssUrl := printf "%s/katex%s.css" $katexBaseUrl (cond hugo.IsProduction ".min" "") -}}
|
||
{{ $katexFontPattern := "url(fonts/" }}
|
||
{{ $katexFontSubstituted := printf "url(%s/fonts/" $katexBaseUrl }}
|
||
|
||
{{ with try (resources.GetRemote $katexCssUrl) -}}
|
||
{{ with .Err -}}
|
||
{{ errorf "Could not retrieve KaTeX css file from %s. Reason: %s." $katexCssUrl . -}}
|
||
{{ else with .Value -}}
|
||
{{ $katexCssContent := strings.Replace .Content $katexFontPattern $katexFontSubstituted }}
|
||
{{ with resources.FromString (printf "css/katex%s.css" (cond hugo.IsProduction ".min" "")) $katexCssContent -}}
|
||
{{ $cssHash := . | fingerprint "sha512" -}}
|
||
<link rel="stylesheet" href="{{- .RelPermalink -}}" integrity="{{- $cssHash.Data.Integrity -}}" crossorigin="anonymous" />
|
||
{{ end -}}
|
||
{{ end -}}
|
||
{{ end -}}
|
||
{{ else if and (.Page.Store.Get "hasMath") (eq $engine "mathjax") -}}
|
||
{{ partialCached "scripts/mathjax.html" . -}}
|
||
{{ end -}}
|
||
|
||
{{ partial "custom/head-end.html" . -}}
|
||
</head>
|