Build a Github && Hexo Blog
参考教程
步骤
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
访问你的博客啦!!
开始写第一篇博客吧~
- 在git bash中输入
hexo new post 博客名
,可以在blog/source/_posts路径下找到新的博客。 - 学习使用Markdown格式
- 写完博客后
hexo s
预览,hexo g
保存并生成静态文件,hexo d
部署网页。 - 更便捷地编辑博客并通过gitbash部署: “ctrl+~“呼唤控制台,点击terminal的右上角”+”,添加git bash作为常用命令行。这样就可以不用频繁切屏了hhh
想让博客变得更好看~
以butterfly主题为例
- 输入命令安装依赖:
npm install hexo-renderer-pug hexo-renderer-stylus #生成HTML模板引擎和CSS预处理器
- 克隆主题到自己的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
- 将config.yml里的theme改为
theme: 主题名
。 例:theme: butterfly
hexo s
,hexo g
,hexo d
完成部署。- 完善butterfly主题的其它配置
可能出现的问题
一般的错误都可以通过命令行的提示进行修改
- 之后每次使用git bash都要先进入到blog所在目录才能操作。例如,
cd D:\blog
。 unable to access
连接不上,需要代理:
在git bash中输入:
git config --global http.proxy http://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
。
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Bubbles!