Hugo

工作流

emacs + orgmode + ox-hugo + hugo + githubApi + githubWorkflow

工具介绍

=easy-hugo 用来管理 Hugo 的文章， ox-hugo 用来将 org mode 文章转化为 markdown 格式

快速上手用ox-hugo写博客

安装hugo和ox-hugo

#debian
sudo apt install hugo -y
#arch
sudo pacman -S hugo

;; 打开init.el
(org +hugo)               ; organize your plain life in plain text

快速上手使用

hugo new site my-hugo-site
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'hugo-theme-cleanwhite'" >> config.toml
#hugo-theme-cleanwhite theme
git submodule add https://github.com/zhaohuabing/hugo-theme-cleanwhite.git themes/hugo-theme-cleanwhite
cp -r hugo-theme-cleanwhite/exampleSite/** ../
hugo server -D

emacs

新建helloworld.org文件

参数解释

 #+hugo_base_dir: ~/Blog/ 指定了 hugo 博客文件夹的位置
 #+hugo_front_matter_format: yaml 指定了 front matter 的格式
 #+hugo_auto_set_lastmod: t 会让 ox-hugo 自动更新博客的修改时间
 #+hugo_section: post 指定了这篇博客会发布到的目录，比如 post 或者 posts
 # :EXPORT_FILE_NAME: hugo_ox-hugo
 # :EXPORT_DESCRIPTION: ox-hugo初体验!
 # :EXPORT_HUGO_BUNDLE: emacs/ox-hugo

C-c C-e H h 导出到hugo目录中

自动保存 org-hugo-auto-export-mode

 添加.dir-locals.el到org目录下，内容为
 ((org-mode . ((eval . (org-hugo-auto-export-mode)))))
 添加下面内容到文件结尾
 x Footnotes
 x COMMENT Local Variables :ARCHIVE:
 # Local Variables:
 # eval: (org-hugo-auto-export-mode)
 # End:

latex不显示

主题需要添加math, 如:~/blog/themes/hugo-theme-cleanwhite/layouts/partials/head.html

<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
tex2jax: {
inlineMath: [['$','$'], ['\\(','\\)']],
displayMath: [['$$','$$'], ['\\[','\\]']],
processEscapes: true
}
});
</script>

attachment 图片无法导出

https://www.karlcw.top/posts/2024/07/05/%E8%AE%A9-hugo-%E8%83%BD%E6%8A%8A-attach-%E6%96%B9%E5%BC%8F%E5%AF%BC%E5%85%A5%E7%9A%84%E8%B5%84%E6%BA%90%E5%8F%91%E5%B8%83%E5%88%B0-public/

GitHub Pages的Jekyll限制忽略以下划线开头的文件

GitHub Pages 默认使用 Jekyll 引擎构建静态站点，而 Jekyll 会进一步忽略以下划线开头的文件（如 `_images` 目录或 `_pic.jpg` 文件），即使 Hugo 生成了这些文件，Jekyll 仍会过滤它们。解决方案禁用 Jekyll 处理（关键步骤）在 GitHub 仓库根目录中创建一个名为 `.nojekyll` 的空文件，以禁用 Jekyll 的过滤规则：在 Hugo 项目的根目录下执行命令：

touch static/.nojekyll  # 将文件放在 static 目录，确保构建时被复制到 public

「真诚赞赏，手留余香」