概述
查看更多:https://breezedawn.github.io/
搭建环境准备:
- 下载Node.js
- 安装Git
- 拥有github账号
下载完成后(全部按NEXT就好),按下WIN+R,调出运行窗口,打cmd回车进入命令行,验证node和Git是否安装正确,输入下面指令:
node -v
npm -v
git --version
如果都安装成功就会显示对应的软件版本号。
安装Hexo
进去你要放置博客文件夹的目录,点击鼠标右键,点击 Git Bash Here,然后依次输入并执行下面的代码。
$ npm install hexo-cli -g
$ hexo init Hexo
$ cd Hexo
$ npm install
$ hexo server
第一行是安装 hexo 扩展插件。
第二行是创建一个为 Hexo 的文件夹,我们要把 hexo 相应的代码下载到该文件中下。
第三行进入到新创建的文件夹内。
第四行是安装 hexo 相关的代码。
第五行启动本地服务,启动完成后,在浏览器输入 http://localhost:4000/ 就可以访问刚刚创建的博客了。
如果报错: 执行 npm cache clean --force
清缓存再安装
Hexo目录里会多出很多文件,此时的目录情况如下:
node_modules
npm 文件缓存目录
scaffolds
文夹件下存放文章和页面模版
scource
文夹件下存放资源文件
themes
文夹件下存放主题文件
package.json
站点版本和站点所需的依赖文件
_config.yml
站点配置文件
hexo 常用命令 :
$ hexo g 生成静态文件
$ hexo s 启动本地服务
$ hexo d 提交到远程仓库
$ hexo n page 创建页面
$ hexo n "" 创建文章
$ hexo d -g 生成静态并提交到远程仓库
$ hexo s -g 生成静态文件并启动本地预览
$ hexo clean 清除本地 public 文件
外网访问
第一步 - 创建仓库
在 Github 创建一个名字为 username.github.io 的仓库,这里的 username 必须是你的github用户名。
第二步 - 修改配置
**注意所有的命令都在git-bash里敲! 注意所有的命令都在git-bash里敲! 注意所有的命令都在git-bash里敲! **
**注意所有的配置冒号后都要有空格! 注意所有的配置冒号后都要有空格! 注意所有的配置冒号后都要有空格! **
修改depoly ,这里的 username 仍然是你的 Github 用户名:
deploy:
type: git
repo: git@github.com:username/username.github.io.git
// 后面对应的是仓库链接
branch: master
示例:
deploy:
type: git
repo: git@github.com:BreezeDawn/BreezeDawn.github.io.git
branch: master
修改 site 相关信息 :
title: xx
subtitle:
description: 中文最好用编辑器不要用记事本打开
keywords:
author: xx
language: zh-Hans
timezone:
注 :网站名称(title),作者 (author),语言 (language),签名(description)
第三步 - 给本地 Git 添加 ssh免密登陆
首先我们需要修改 Git 的全局配置 user.name 和user.email
git config –-global user.name “xxxxxx”
// 自己的 github 用户名
git config –-global user.email “xxxxxx” // 自己的 github 里绑定的邮箱
在这里 user 不需要替换成自己…只需要修改双引号里的内容
然后我们进入存放密匙的文件夹,检查本地是否有 SSH key
$ cd ~/.ssh
$ ls
如果 SSH key 存在,就会显示 id_rsa、id_rsa.pub、know_hosts 三个文件 。
没有的话我们就来创建 SSH key
$ ssh-keygen -t rsa -C "你的邮箱"
然后点击回车,接着会让你输入文件名,点击回车直接忽略,再然后会让设置密码并确认密码,我们点击两次回车,直接把密码设置为空,不用输入 。然后你会看到一堆泡泡,说明密匙创建成功。
创建成功后,可以通过如下命令拷贝 SSH key 的内容 :
clip < ~/.ssh/id_rsa.pub"
你也可以手动打开~/.ssh/
目录下的id_rsa.pub
文件进行拷贝,所有内容一字不漏的拷贝!
然后我们打开 GitHub 点击右上角头像进入个人资料,点击Settings -> 左边 SSH and GPG keys
,然后点击 New SSH key
,title
随便填,把之前拷贝的内容粘贴到 key 里面,然后点击 Add SSH key。
怎么去验证是否已经添加成功了呢 ?通过如下命令 :
$ ssh -T git@github.com
验证成功,你会看到 successfully !! 但是我们还差一步~
第四步 - 更新静态文件,提交到 github 仓库
执行 $ npm install hexo-deployer-git --save
- 安装关联 Github 的插件
执行 hexo d -g
- 更新静态文件并提交到你的 github 仓库。
然后使用浏览器打开 https://username.github.io.git ,是不是可以外网访问了呢? 记住一定是https的哦,不然访问不到
更换主题
下载主题
如果不喜欢现在的主题,我们可以在 github 中搜索 hexo theme 寻找自己喜欢的主题。
我用的是人气最高的 Next 主题,它提供非常详尽的官方文档,并且支持很多第三方插件,十分的友好。
Next Github:https://github.com/iissnan/hexo-theme-next/
Next 官方文档:http://theme-next.iissnan.com/
我们现在通过 git 方式下载 Next,命令如下 :
$ cd themes
$ git clone https://github.com/iissnan/hexo-theme-next next
hexo 的主题文件都放在 themes
文件夹下,所以我们要进入主题文件夹 下下载 Next。
下载完成后,我的博客 themes 下就多了一个 next 文件夹。
配置主题
首先我们要区分两个文件。
第一个是我们网站的 站点配置文件 _config.yml
,它在我们的博客根目录 Hexo/
下,Hexo 为 hexo init 初始化时自动创建的文件夹名称。
第二个是我们网站的 主题配置文件 _config.yml
,它在我们的主题目录 Hexo/themes/next
下。
然后我们修改 站点配置文件 :
theme : next
注 :把默认主题 landscape 切换成 next。
此时我们的博客主题已经修改为 Next 主题,但 Next 主题其实有四个风格,Muse、Mist、Pisces、Gemini,且这里默认为 Muse。
如果我们想要修改,就需要打开 主题配置文件,
修改 Schemes :
scheme: Muse
#scheme: Mist
#scheme: Pisces
#scheme: Gemini
根据自己的选择进行注释。
修改完毕后我们需要把静态文件按照新的配置重新生成,还记得重新生成静态文件的命令吗?
$ hexo g
然后我们就可以提交给远程仓库了
$ hexo d
完结
接下来我们就可以在 github 上看见我们提交的静态文件了,也可以通过 https://username.github.io/ 访问我们的博客了,username 改成你的github 用户名,一定要记得是https!!
如果你想发布文章、生成新页面、增加搜索或其他功能,在 Next 官方文档中你都能找到~
再放一下官方文档:
Next 官方文档:http://theme-next.iissnan.com/
当然还有一些不在官方文档上的骚操作,等我更新吧…
如果在进行操作时有 bug ,欢迎留言~~
最后
以上就是舒服大树为你收集整理的使用Hexo-Github搭建个人博客-详细的全部内容,希望文章能够帮你解决使用Hexo-Github搭建个人博客-详细所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复