4

Hexo+GitHub 搭建个人博客(一):安装、配置和第一篇博客


hexo+github-pages.jpg

  • 本文简单介绍Hexo+GitHub 搭建博客。本文主要目的是对学习内容进行总结以及方便日后查阅。
  • 详细教程和原理可以参考Hexo官方中文文档
  • 本文版权归马涛涛所有。
  • 本文所引用的图片和文字版权归原作者所有,侵权删。
  • 如有错误请在下方评论区指出,欢迎积极讨论。

安装与配置


什么是Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。——《Hexo官方中文文档

安装前提

Git可能需要科学地上网,没法下载的话,在Hexo文档——安装指南中有百度云Git同步下载地址。

安装步骤

  1. 进入一个安全的目录,比如 cd ~/Desktop 或者 cd ~/Documents,别在根目录 / 。养成进入一个安全的目录,别在根目录里乱存东西的习惯,只有 ~ 里面的目录才是安全的。
  2. 在 GitHub 上新建一个空 repo,repo 名称是「你的用户名.github.io」(一定你的用户名替换成真正的用户名
  3. GitBash上运行npm install -g hexo-cli,安装 Hexo。
  4. hexo init myBlog
  5. cd myBlog
  6. npm i

生成第一篇博客

  1. hexo new 开博大吉,开博大吉就是你的第一篇博客的标题,后面也可以改。运行完后你会看到一个 md 文件的路径。
    95peBR.png
  2. 首先用cd命令进入_posts的这个目录,再start 开博大吉.md,编辑这个 md 文件,内容自己写,先实验能否成功,后面再教如何编写以及美化博客(Ubuntu 系统用 xdg-open 开博大吉.md 命令)

    Windows 的路径中的 \ 需要变成 / 才行
  3. 进入然后返回myBlog目录,执行start _config.yml,编辑网站配置

    • 把第 6 行的 title 改成你想要的名字,这个就是网站的博客标题
    • 把第 9 行的 author 改成你的大名
    • 把最后一行的 type 改成 type: git
    • 在最后一行后面新增一行,左边与 type 平齐,加上一行 repo: 仓库地址 (请将仓库地址改为「你的用户名.github.io」对应的仓库地址,仓库地址以 git@github.com: 开头。
    • 上一步的 repo: 后面有个空格
  4. npm install hexo-deployer-git --save,安装 git 部署插件
  5. hexo deploy
  6. 进入「你的用户名.github.io」对应的 repo,打开 GitHub Pages 功能,如果已经打开了,就直接点击预览链接,链接是 [你的GitHub用户名.github.io]
  7. 你现在应该看到了你的博客!

增加新博客

  1. hexo new 第二篇博客标题
  2. 复制显示的路径,使用 start 路径 来编辑它,里面的内容支持MarkDown语法,编辑的内容就是博客的内容。
  3. hexo generate
  4. hexo deploy 部署,提交

然后去看你的博客,应该能看到第二篇博客了


风彻
1.5k 声望142 粉丝