博客维护手册

保护私人版权，尊重他人版权。转载请注明出处并附带页面链接

本博客代码及内容由梅沙科技后端团队维护并保留一切权利

网站访问：MeishaBex

Caption

博客框架基于hexo搭建，主题使用 theme-yilia ，并有少量改动，如有侵权请及时联系

Guide

本地初始化项目

搭建hexo环境

1. 确保电脑已安装git

   • mac: 命令行 brew install git
   • windows: 下载并安装 git
   • Linux (Ubuntu, Debian)：sudo apt-get install git-core
   • Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

2. 确保电脑已安装Node.js

   curl或wget从 https://raw.github.com/creationix/nvm/v0.33.11/install.sh 拉取安装文件，并使用 sh 命令执行

   安装完成后，重启终端并执行下列命令即可安装Node.js

   nvm install stable

3. 执行下述命令，全局下载hexo

   npm install -g hexo-cli

   mac用户若编译遇到问题，请先从AppStore安装Xcode
   完成后启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

拉取项目

从git拉取项目到本地

https: https://github.com/meishabex/blog-src.git

ssh: git@github.com:meishabex/blog-src.git

注意：出于安全考虑，该项目被设为私有项目，如需参与，请联系管理员并提供github账号

下载依赖

下载hexo发布工具

npm install hexo-deployer-git --save

下载gitalk

npm i --save gitalk

日常维护

注意：相关配置已完善，请不要随意修改配置，相关环境搭建好后直接可用

发布文章

1. 执行命令新建

   hexo new HelloWorld

   执行成功后会在目录 ./source/_posts/ 下生成 HelloWorld.md

2. 编写markdown

   正常编写文件即可，但是为了文章索引方便，建议在文章头部打上tags标签

   语法参考：(简明语法手册)[https://hyxxsfwy.github.io/2016/01/15/Hexo-Markdown-%E7%AE%80%E6%98%8E%E8%AF%AD%E6%B3%95%E6%89%8B%E5%86%8C/]

3. 生成静态文件并发布

   根目录下直接执行下述命令

   hexo g -d

   注意：严禁执行hexo clean这会导致所有静态文件被清除，此后再执行生成静态文件命令，会导致重新生成所有文件，
   部分文章的发布时间也会被更新为当前时间，且可能导致其他不确定的意外情况。

可能的问题

1. 私人域名失效

   如，博客设置域名bex.meishakeji.com后，可以正常访问。过了一段时间，再访问该域名，弹出了github的404页面。
   说明域名在github处失效。此时，请确认项目下CNAME文件是否被意外删除

2. gitalk失效
   gitalk需要 OAuth application，如果github的user接口提示401，应确认是否OAuth失效，点击这里重新申请

Reference

1. Hexo
2. yilia
3. gitalk中文说明

Sub

扫码关注微信公众号，随时随地，掌握最新技术资讯

微信