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

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

HEXO+GitHub:pages

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

安装与配置


什么是Hexo

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

安装前提

  • 安装Node.js
  • 安装Git

    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

      生成第一篇博客

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

    Windows 的路径中的 \ 需要变成 / 才行

  2. 进入然后返回myBlog目录,执行start _config.yml,编辑网站配置

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

增加新博客

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