我如何用 Maverick来搭建自己的博客？

本文最后更新于：6 天前

为什么要使用Maverick来搭建博客？什么是Maverick？使用它搭建博客有什么好处？

关于为什么要使用Mavrick的大致原因是：用hexo手动部署博客以及后续添加博客、修改博客的过程很繁琐，写博客最重要的是「写」，而不是花大把的时间去研究如何搭建博客，就像有的朋友调侃道：「总是折腾，但从来不写」。而Maverick可以帮助你省去这些繁琐的过程，只需要你写文章、修改文章，剩下的生成、发布、部署这些事都交给Maverick去完成。

如果还想了解更多Maverick的内容，可以看这篇文章：用 GitHub 搭建静态博客太繁琐？用这个小工具实现「傻瓜式」发布。

本文中的操作默认都是在master（后面改名为source）分支下进行。

1 搭建过程

1.1 准备好下列文件/文件夹

  • .github（先用复制的，后期自己改）
  • assets
  • src（这里放博客文章，请至少准备一篇文章（md格式）放在这里）
    • images
    • static
  • config.py（先用复制的，后期自己修改）
  • Makefile（先用复制的，后期自己修改）
  • README.md

1.2 修改master分支名

（1）在github修改master分支名为source。

（2）在本地执行以下命令：

1
2
3
git branch -m master source
git fetch origin
git branch -u origin/source source

1.3 操作cache分支

（1）创建cache分支。

1
git branch cache

（2）在cache分支下创建文件 sizeinfo.json。

（3）把分支提交到github

1
2
# 此时处于cache分支
git push origin HEAD -u

1.4 操作gh-pages分支

（gh-pages分支是用来展示的）

（1）创建gh-pages分支，并提交到github

1
2
3
4
5
6
git branch gh-pages
git checkout gh-pages

# 可以修改一些文件，并提交commit

git push origin HEAD -u

（2）在github，进入仓库 settings，在 Github Pages选项下把 Source换成gh-pages分支。

1.5 准备一个token，并为这个仓库添加token

准备token的过程省略，现在假设已经得到一个token。

（1）进入 settings-Secrets，选择 New repository secret，创建一个secret。

  • Name填 PERSONAL_TOKEN。
  • Value填得到的token。

（2）选择「添加」。

1.6 使用Maverick和Galileo

Galileo是Maverick的一个主题。

1.创建一个文件 .gitmodules，不填内容。

2.执行命令

1
2
3
4
5
6
7
#现在在source分支，如果不是请切换到source

# 添加子模块——Maverick
git submodule add https://github.com/AlanDecode/Maverick.git

# 添加子模块——Galileo主题的latest分支
git submodule add -b latest https://github.com/AlanDecode/Maverick-Theme-Galileo.git ./Galileo

3.提交到github。

1.7 自定义配置来适配自己的博客

1.编辑 conf.py，修改以下内容（只挑出现在最必要改的）

  • site_prefix：改成自己博客的名字

至此博客已经可以正常运行了。在浏览器中输入网址 https://username.github.io/repo/，查看是否成功。

2 自定义步骤

2.1 自动化上传博客流程

复制两个文件

  • update_site.bat（windows下使用）
  • update_site.sh（linux/macos下使用）

2.2 修改博客的一些信息/配置

  • conf.py
    • template：可以切换主题
      • 可选的主题有：Galileo、
    • site_name
    • site_logo
      • 要求
    • site_build_date
    • author
    • email
    • author_homepage
    • description
    • key_words
    • external_links
    • nav
    • social_links

2.3 写文章的注意事项

  • 支持的格式是 markdown。

  • 在文章的首部位置，需要写上文章的元数据，其中必须要填的有如下

    • layout
    • title
    • slug（文章的链接）
    • date

  • 元数据使用的数据格式是YAML，注意使用规则，比如空格有严格的要求。

  • 如果想要了解更详细的要求，看这里。

参考文章