参考教程

详细步骤(有图解)

步骤

1. 安装node.js (选择长期支持版本)
2. 安装git
3. 安装Hexo: 在cmd或者git bash中输入npm install hexo-cli -g #Hexo 的命令行工具
4. 创建博客:
新建文件夹并命名为blog
在空白的文件夹内按右键,选择Git Bash Here
在弹出的Git Bash命令行中依次输入hexo init,hexo g,hexo s,打开提供的链接http://localhost:4000/ ,预览网页效果。
预览完成后,可按下"ctrl+c"退出网页预览部署。
5. 部署到GitHub:
在git bash中输入npm install hexo-deployer-git --save #将 Hexo 生成的静态网站文件部署到 Git 仓库中
在GitHub中新建一个仓库,仓库命名格式为:你的github用户名.github.io
下载vscode
创建完成后,复制仓库网址,用vscode打开_config.yml文件,将网址粘贴到deploy栏目下的repo处。

在git bash中依次输入hexo g,hexo d
完成部署啦!可以通过http://你的github用户名.github.io访问你的博客啦!!


开始写第一篇博客吧~

  1. 在git bash中输入hexo new post 博客名,可以在blog/source/_posts路径下找到新的博客。
  2. 学习使用Markdown格式
  3. 写完博客后hexo s预览,hexo g保存并生成静态文件,hexo d部署网页。
  4. 更便捷地编辑博客并通过gitbash部署: “ctrl+~“呼唤控制台,点击terminal的右上角”+”,添加git bash作为常用命令行。这样就可以不用频繁切屏了hhh
    便捷

想让博客变得更好看~

以butterfly主题为例

  1. 输入命令安装依赖: npm install hexo-renderer-pug hexo-renderer-stylus #生成HTML模板引擎和CSS预处理器
  2. 克隆主题到自己的blog中git clone -b master https://github.com/example/repository.git local_folder。例:git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
  3. 将config.yml里的theme改为theme: 主题名。 例:theme: butterfly
  4. hexo s,hexo g,hexo d完成部署。
  5. 完善butterfly主题的其它配置

这儿有很多好看的主题!


可能出现的问题

一般的错误都可以通过命令行的提示进行修改

  • 之后每次使用git bash都要先进入到blog所在目录才能操作。例如,cd D:\blog
  • unable to access 连接不上,需要代理:
    网络问题
    在git bash中输入:
git config --global http.proxy http://127.0.0.1:58904  
git config --global https.proxy https://127.0.0.1:58904
git config --global http.proxy socks5://127.0.0.1:58904
git config --global https.proxy socks5://127.0.0.1:58904

其中,58904可根据clash for Windows提供的端口进行改变。


常用命令行

hexo

  • hexo init:初始化博客。
  • hexo s: 提供“预览” 功能。启动一个本地的 Web 服务器(http://localhost:4000/),用于预览你在 Hexo 项目中编辑的内容,包括文章、页面和主题的更改。注意:hexo s启动后可以监视内容变化,根据内容的变化进行实时更新,不用退出再重新启动。
  • hexo clean: 提供“清空回收站” 功能,清除缓存文件以及已生成的静态文件,例如使不用的tag不再出现在tag栏里(注意:需要先终止hexo s)
  • hexo g: 提供“转化” 功能。将Markdown格式的文章(博客为.md格式文件)以及配置文件转化为HTML文件,并应用主题,生成静态文件并进行保存,便于后续发布。
  • hexo d: 提供“部署” 功能。该命令用于将博客内容部署到远程服务器或者其他托管服务上。
  • hexo new post 博客名: 创建一篇新博客。
  • hexo n page 网页名: 创建一个新页面。

git

  • git clone -b master https://github.com/example/repository.git local_folder : git clone,复制一个远程仓库到本地;-b master,复制仓库的主分支;https://github.com/example/repository.git仓库网址;local_folder克隆到本地的目标文件夹路径,如themes/butterfly