hexo搭建github博客详解

hexo简介

• 快速、简洁且高效的博客框架
• 支持Markdown
• 丰富的插件，扩展性强
• 一键部署

使用操作步骤

注意事项:很多命令可以用cmd来完成，但是部分命令会有一些问题，为避免不必要的问题，建议全部使用git bash来执行 使用hexo搭建博客需安装node和git请先行安装(如果安装完成运行命令时出错,注意环境变量配置)

• 命令步骤

  // 全局安装
  npm install hexo-cli -g 
  
  // 在想要建立博客本地文件位置内打开命令运行建立一个叫初始化blog项目
  hexo init blog  
  
  cd blog
  //进入项目后安装依赖包
  
  npm install
  
  //启动本地化服务即可查看项目
  hexo server
  
  // 生成
  hexo g
  
  //启动本地服务并监听,修改了配置文件还是需要从新生成一遍才可以看到效果
  hexo s --watch
  
  //如果报一些奇怪的错误不知道怎么解决不妨清除一下重新生成发布
  hexo clean
  
  复制代码

• 更换主题

  • 官网上提供了很多主题找一个自己喜欢的主题然后找到github地址
  • 将主题克隆岛blog项目中

    > abc:为自定义文件夹名字
    git clone 地址 themes/abc
    复制代码

  • 下载后的主题可以根据自己的喜好做调整
  • 最后记得在_config.yml文件中修改配置

      theme: abc
  复制代码

• 绑定github

  • 在github上新建一个***.github.io的仓库
  • 获取ssh

      //任意窗口打开git bash
      cd ~/.ssh
  复制代码

  如果有这些文件表示已经生成过，没有则需要重新生成

      //创建ssh key
      ssh-keygen -t rsa -C  "***@**.com"
  复制代码

  运行完成后直接回车就可以看到你的key生成的文件位置了

  • 用编辑器打开并复制你的key
  • 登录github点击头像进入setting 可以看到SSH and GPG keys点击添加新的并保持
  • 测试

  ssh -T [email protected]
  复制代码

  • 此外还需要配置

      git config --global user.name "ABC"// 你的github用户名
      git config --global user.email  "***@**.com"// 填写你的github注册邮箱
  复制代码

• 上传github

  • 需要配置_config.yml(注意分号)

  deploy:
    type: git
    repository: [email protected]:用户名/用户名.github.io.git
    branch: master
  复制代码

  • 安装插件

      npm install hexo-deployer-git --save
  复制代码

  • 一键生成上传

  hexo d -g
  复制代码

• 写博客

  • 新建文件（会自动生成一个叫hello.md的文件）

  hexo new 'hello'
  
  复制代码

  • 打开文件有些一些配置

  ---
      title: {{title}} #文章页面上的显示名称，一般是中文
      date:{{data}} #文章生成时间，一般不改，当然也可以任意修改
      categories: js #分类
      tags: [tag1,tag2,tag3] #文章标签，可空，多个标签请用格式
      description: 附加一段文章摘要，字数最好在140字以内，会出现在meta的description里面
  ---
  复制代码

  • 可以将自己现有的mk文档直接修改使用上传