用Hugo+码云搭建支持Markdown+LaTeX的云笔记

# 初始化本地站点
hugo new site notes
cd notes

# 克隆主题到themes/book
git clone https://github.com/alex-shpak/hugo-book themes/book

# 复制主题范例站点和配置
cp -a themes/book/exampleSite/config.toml .
cp -a themes/book/exampleSite/content .

<!--
原始位置：
	themes\book\layouts\shortcodes\katex.html
也可以将其独立出来放在站点根目录下：
	layouts\shortcodes\katex.html
-->
{{ if not (.Page.Scratch.Get "katex") }}
  {{ if and (isset .Site.Params "katex") (eq .Site.Params "mathjax" ) }} 
    <!-- Include mathjax only first time -->
    <script type="text/x-mathjax-config">
      MathJax.Hub.Config({
          showProcessingMessages: false,
          messageStyle: "none",
          extensions: ["tex2jax.js"],
          jax: ["input/TeX", "output/HTML-CSS"],
          tex2jax: {
              inlineMath:  [ ["$", "$"], ["\(", "\)"] ],
              displayMath: [ ["$\n","\n$"], ["\\[","\\]"] ],
              skipTags: ['script', 'noscript', 'style', 'textarea', 'pre','code','a'],
              ignoreClass:"comment-content"
          },
          "HTML-CSS": {
              availableFonts: ["STIX","TeX"],
              showMathMenu: false
          }
      });
      MathJax.Hub.Queue(["Typeset",MathJax.Hub]);
    </script>
    <script src="https://cdn.bootcss.com/mathjax/2.7.6/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
  {{ else }}
    <!-- Include katext only first time -->
    <link rel="stylesheet" href="https://cdn.bootcss.com/KaTeX/0.11.1/katex.min.css" integrity="sha384-zB1R0rpPzHqg7Kpt0Aljp8JPLqbXI3bhnPWROx27a9N0Ll6ZP/+DiW/UqRcLbRjq" crossorigin="anonymous">
    <script defer src="https://cdn.bootcss.com/KaTeX/0.11.1/katex.min.js" integrity="sha384-y23I5Q6l+B6vatafAwxRu/0oK/79VlbSz7Q9aiSZUvyWYIYsd+qj+o24G5ZU2zJz" crossorigin="anonymous"></script>
    <script defer src="https://cdn.bootcss.com/KaTeX/0.11.1/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous"
            onload="renderMathInElement(document.body,
                {delimiters: [{left: '$\n', right: '\n$', display: true}, {left: '$', right: '$', display: false}, 
                              {left: '\\[', right: '\\]', display: true}, {left: '\\(', right: '\\)', display: false}]});"></script>
  {{ end }}
{{ .Page.Scratch.Set "katex" true }}
{{ end }}


<span class="katex{{ with .Get "class" }} {{ . }}{{ end }}">
  {{ if in .Params "display" }}\[{{ else }}\({{ end -}}
  {{ $.Inner }}
  {{- if in .Params "display" }}\]{{ else }}\){{ end }}
</span>

  #######################################
  # (Optional, default none) 选择数学公式渲染引擎
  # 默认就是katex引擎,  另外的选择就是 mathjax引擎 (即使改了引擎，标签也继续沿用katex)
  # 优先使用$$作为公式界定符号
  #  1. 内联公式，比如： $a^2$
  #  2. 块公式，比如：
  #     $$
  #     a^2
  #     $$
  # 如果渲染失败时（hugo和引擎的冲突），首先作如下2个置换 
  #  1. 内联公式:\$\$(.*?\\[\\\}\{].*?)\$\$ => {{< katex >}}$1{{< /katex >}}
  #  2. 块公式:\$\$(\n.*?\\[\\\}\{].*?\n)\$\$ => {{< katex display >}}$1{{< /katex >}}
  # 如果还是失败，则修改公式。
  #######################################
  # katex = "mathjax"

#!/bin/bash

# 执行后确保用Typora打开本地md文件可以正常渲染，特别是数学公式。
# 将`{{< katex [display] >}}latex{{< /katex >}}`
# 转换成$$格式
# ./fortypora

# md文件递归
function action(){
    for file in `ls $1` 
    do
        if [ -d $1"/"$file ] 
        then
            action $1"/"$file
        elif [ "${file#*.}"x = "md"x ]
        then
            # 方便用typora阅读
            sed -i 's/{{<\s*katex\s*>}}/$/g; s/{{<\s*katex\s*display\s*>}}/$/g; s/{{<\s*\/katex\s*>}}/$$/g; s/!\[.*\](\.\.\/\.\.\/images\//![](..\/images\//g; '  $1"/"$file
        fi
    done
} 

action ./content

#!/bin/bash

# 执行后确保用Hugo生成的站点可以正常渲染，特别是数学公式。
# 先将`$$`
# 转换成`{{< katex [display] >}}latex{{< /katex >}}`
# 再执行 hugo [servere] -D 命令
# ./forgitee       # 站点发布（生成静态文件）
# ./forgitee server  # 站点预览

# md文件递归
function action(){
    for file in `ls $1` 
    do
        if [ -d $1"/"$file ] 
        then
            action $1"/"$file
        elif [ "${file#*.}"x = "md"x ]
        then
            # 方便发布到gitee
            sed -i '/```/ { :begin1; /```.*```/! { $! { N; b begin1 }; }; n; }; /\$\$/ { :begin2; /\$\$[^$]*\$\$/! { $! { N; b begin2 }; }; }; s/\$\$\(\n[^$]*\n\)\$\$/{{< katex display >}}\1{{< \/katex >}}/g; s/\$\$\([^$]*\)\$\$/{{< katex >}}\1{{< \/katex >}}/g; s/!\[.*\](\.\.\/images\//![](..\/..\/images\//g;'  $1"/"$file
        fi
    done
} 

action ./content

if [ "$1"x = "server"x ] 
then
    # 本地预览
    hugo server --disableFastRender -D
else
    rm -rf public 
    # 生成待发布的静态文件，生成的目录 public
    hugo -D
    # 方便用typora阅读
    ./fortypora
fi