cdn0x12/hugo-theme-minima
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

update example content

Browse source
This commit is contained in:
Mivinci 2022-11-10 15:09:45 +08:00
parent 37351acf91
commit bab2a8c602
5 changed files with 80 additions and 68 deletions
Download patch file Download diff file Expand all files Collapse all files

62
exampleSite/content/math-typesetting.md
View file

@ -1,55 +1,43 @@
---
author: Hugo Authors
author: Mivinci
title: Math Typesetting
date: 2021-07-18T10:52:59+08:00
description: A brief guide to setup KaTeX.
description: A brief guide to write mathematical notation.
math: true
tags:
- KaTex
---
Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries.
Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries like [KaTeX](https://katex.org) the one that Minima uses. Here's what you can do in the configuration file to enable it.
<!--more-->
In this example we will be using [KaTeX](https://katex.org/)
- Create a partial under `/layouts/partials/math.html`
- Within this partial reference the [Auto-render Extension](https://katex.org/docs/autorender.html) or host these scripts locally.
- Include the partial in your templates like so:
```bash
{{ if or .Params.math .Site.Params.math }}
{{ partial "math.html" . }}
{{ end }}
```
math:
enable: false
provider: katex
```
- To enable KaTex globally set the parameter `math` to `true` in a project's configuration
- To enable KaTex on a per page basis include the parameter `math: true` in content files
## Examples
**Note:** Use the online reference of [Supported TeX Functions](https://katex.org/docs/supported.html)
The following are some examples of mathematical notations with KaTeX that are pretty much like LaTeX's.
{{< math.inline >}}
{{ if or .Page.Params.math .Site.Params.math }}
### Block
<!-- KaTeX -->
```
\varphi = 1+\frac{1}{1+\frac{1}{1+\frac{1} {1+\cdots}}}
```
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.css" integrity="sha384-zB1R0rpPzHqg7Kpt0Aljp8JPLqbXI3bhnPWROx27a9N0Ll6ZP/+DiW/UqRcLbRjq" crossorigin="anonymous">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.js" integrity="sha384-y23I5Q6l+B6vatafAwxRu/0oK/79VlbSz7Q9aiSZUvyWYIYsd+qj+o24G5ZU2zJz" crossorigin="anonymous"></script>
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script>
{{ end }}
{{</ math.inline >}}
wiil be rendered as:
### Examples
{{< math.inline >}}
<p>
Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…\)
</p>
{{</ math.inline >}}
Block math:
$$
\varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } }
\varphi = 1+\frac{1}{1+\frac{1}{1+\frac{1} {1+\cdots}}}
$$
### Inline
```
Pythagorean theorem can be written as $a^2+b^2=c^2$ where *a*, *b* and *c* are the length of legs of a triangle.
```
will be rendered as:
Pythagorean theorem can be written as $a^2+b^2=c^2$ where *a*, *b* and *c* are the length of legs of a triangle.