Hugo

重装系统电脑没有备份，只能拉取远程代码然后本地运行调试了。 第一个坑：Hugo配置系统变量 拉起代码之后，本地运行命令： hugo server -D 报错： 无法将“hugo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。 原因：没有配置hugo环境 下载Hugo安装包，地址：https://github.com/gohugoio/hugo/releases 我使用extended(扩展版)是因为使用了PaperMod简约主题需要extended版来处理SCSS/SASS样式。 安装zip包解压缩，配置环境变量只想hugo.exe就OK了。 第二个坑：本地访问Page Not Found 运行本地项目后，访问http://localhost:1313/报错：Page Not Found。 原因：项目下themes/PaperMod是个空文件夹，相当于没有主题，也就没有加载出页面内容。 导致问题的原因：themes/PaperMod是通过git submodule的形式嵌套的，它也是一个单独的git仓库(是子项目)。 # 重装之后拉取代码使用的git clone xxxxxx只是拉取了主仓库 # 需要再进入到子项目目录进行拉取 cd themes/PaperMod git pull origin master git submodule各种问题 拉取submodule的时候各种报错： 错误地配置了代理： unable to access ‘https://github.com/qiuxiaolong1/qingkong-blog.git/': OpenSSL SSL_connect: SSL_ERROR_SYSCALL in connection to 127.0.0.1:7897 解决方案： # 查看git的代理配置，先删除 # 取消全局代理配置 git config --global --unset http.proxy git config --global --unset https.proxy # (可选) 如果你只想针对当前仓库清理 git config --unset http.proxy git config --unset https.proxy 不稳定网络环境下的负载传输失败： ...

之前搭过一个博客，想着做一个有登录有后台，前端页面看到啥酷炫的效果都想克隆一份，至于结果如何：只能说如何一个惨字了得(又卡又慢，优化不完)…… 本着内容至上的初心(说白了还是懒)，决定直接使用Hugo+PaperMod搭建一个极简风格的个人博客。(新手村背包Get) 为什么是 Hugo？因为快，且纯粹 很多新手玩家在起步时会纠结选择 WordPress 还是 Hugo。我的建议是：如果你想专注写作，且希望网站“秒开”，选 Hugo。 Hugo 是一个静态网站生成器。简单来说，它不像传统网站那样在你访问时才去查询数据库，而是提前把你写的 Markdown 文章“翻译”成 HTML 网页。这意味着你的网站没有后端漏洞，不需要维护数据库，而且速度快得惊人。 安装Hugo(快速方案不生效可以查看下文常规方案) Windows系统： choco install hugo -y （需要先安装Chocolatey） macOS系统： brew install hugo （需要先安装Homebrew） Linux系统：根据发行版使用相应的包管理器安装 快速入门：第一行命令 在你的电脑上安装好 Hugo 之后（macOS 用 brew install hugo，Windows 直接下载二进制包），打开终端，输入： hugo new site my-blog 这就是一切的开始。你会看到一个名为 my-blog 的文件夹，里面整整齐齐地躺着几个目录。此时它还是个毛坯房，没有灵魂，我们需要给它穿上一件“极简主义”的外套。 Git Submodule：管理主题的“优雅姿势” 这是本文的核心，也是很多新手玩家最容易卡壳的地方。 通常我们要换主题，最粗暴的方法是把主题包下载下来解压到 themes 文件夹。但这样做有个致命缺点：万一原作者更新了主题，修复了 Bug 或增加了新功能，你的本地代码很难同步更新。 Git Submodule（子模块） 就是为了解决这个问题而生的。它就像是在你的博客仓库里开了一扇“传送门”，直接连接到主题作者的远程仓库。 为什么要用它？ 保持整洁：你的主仓库只记录一个“引用”，不会把成千上万行主题代码塞进自己的提交记录里。 一键同步：原作者更新了？你只需一条命令，就能把最新的代码“拉”回来，而不会破坏你自己的配置。 操作演示 首先，在你的博客根目录初始化 Git： git init 然后，用 Submodule 的方式引入 PaperMod： git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod 这里的 --depth=1 是个小技巧，它表示只拉取最近的一次提交，不下载冗长的历史记录，速度极快。 ...