关于Hexo
Hexo是一个快速、简洁且高效的博客框架,Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
MarkDown介绍
Markdown
是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。
关于markdown简单几句话说不清,可以点此进入markdown中文介绍页面了解详情
搭建前的准备
GitHub账号
GitHub是一个面向开源及私有软件项目的托管平台,也是全球最大的开源协作社区,通过GitHub,既可以让别人参与你的开源项目,也可以参与别人的开源项目。
而我们此次要介绍的搭建博客的方法,依赖于GitHub为其用户免费提供的GitHub Pages服务。以下是官方对于GitHub Pages的介绍
GitHub Pages是一种静态站点托管服务,旨在直接从GitHub存储库托管您的个人,组织或项目页面。
既然是免费的,肯定有着一些限制:
- GitHub Pages源存储库的 建议限制为1GB。
- 发布的GitHub Pages网站可能不超过1 GB。
- GitHub的网页的网站有一个每月100GB的带宽限制。
- GitHub Pages网站的限制为每小时10个版本。
安装环境
以下配置只在我自己电脑中(Windows10 64位)安装过,不保证在其他环境也能成功。
安装 Hexo 相当简单。然而在安装前,必须检查电脑中是否已安装下列应用程序:
安装 Hexo
必要的环境安装完成后,即可使用 npm 全局安装 Hexo。
npm install -g hexo-cli
安装hexo
检查是否安装Hexo完成,查询是否成功,显示
hexo-cli
版本就说明成功了hexo -v
建站
安装一切所需的环境后,我们可以开始建站了 新建一个文件夹,用来管理我们的博客项目,
打开命令行工具,分别运行以下命令。
hexo init <folder>
用hexo-cli工具初始化项目文件夹
cd <folder>
进入刚新建的文件夹
npm install
// 安装依赖
太长了就不截图了
访问URL
我们可以运行看看Hexo创建的博客站是什么样的,运行以下命令
hexo server
/*
选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式
*/
或者
hexo s
在地址栏输入http://localhost:4000/
访问本地Hexo服务器,按crtl+C停止运行hexo服务器
好了,到这里我们已经学会了通过Hexo创建本地博客了,接下来将介绍如何将我们的博客上传到我们的GitHub服务器上
上传到GitHub
GitHub创建repositories
进入GitHub官网,或者在浏览器输入https://github.com/
,如果还没有账号就创建一个账号就好了,这里不教大家怎么注册账号了。登录自己的账号,直接点击new repositories
或者进入You repositories
再new repositories
进入到创建repositories
页面来,这里很重要,一定要注意哦!必须将新建的repository
的名字为: 你的GitHub账户名.github.io,其他默认就好了。这里注意在创建GitHub用户名时一定要慎重考虑,因为这将决定你的GitHub Pages的域名
配置
GitHub的Repository创建好后。我们在回到本地的Hexo的Myblog
项目中,我们用代码编辑器工具打开,notepad++就可以,找到在项目的根目录下_config.yml找到 deploy标签
在该文件下面添加
deploy:
type: git
repository: https://github.com/jiaiqi/jiaiqi.github.io.git # 复制过来
branch: master
注:repository: https://github.com/jiaiqi/jiaiqi.github.io.git 是自己刚刚创建的你的GitHub账户名.github.io的repository,在Clone with HTTPS里面,复制粘贴就好咯。冒号后面记得空格哦。branch后面是master就好了。
在_config.yml找到url进行修改为:
url: http://jiaiqi.github.io # jiaiqi是我的github用户名,修改为自己的用户名
写文章
hexo new [layout] <title>
如果没有设置 layout
的话,默认使用 _config.yml 中的 default_layout
参数代替。如果标题包含空格的话,要用引号括起来。如:
hexo new "post title with whitespace"
部署
到这里就差不到了,接下来我们需要执行一些命令,将我们的博客部署到GitHub上了,惊喜将会到来了。 打开Git Bash Here进入blog
根目录下,首先我们需要安装一下hexo-deployer-git不然可能出现错误,无法部署成功,执行命令行。
npm install hexo-deployer-git --save
然后在执行以下命令
注:每次提交时必须执行这三个命令
1. hexo clean
// 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
2. hexo generate # 生成静态文件。
// 选项
-d, --deploy # 文件生成后立即部署网站
-w, --watch # 监视文件变动
3. hexo deploy # 部署
// 参数 描述
-g, --generate 部署之前预先生成静态文件
或者简写方式
hexo clean
hexo g
hexo d
第一次执行hexo deploy命令后可能会弹出github登录页面,千万不要没登录就直接关掉了。
测试
我们进行访问https://jiaiqi.github.io/ 和 http://localhost:4000/一样的页面说明是已经成功。第一篇博客是hexo创建的默认文章。
总结
到这里,我们已经从如何使用Hexo到部署上GitHub上,当然了,此时还未对Hexo进行一些我们对于博客的美化,hexo可以让我们自定义自己独特风格的博客,关于hexo的更多使用方法比如如何创建文章、文章分类之类的去Hexo官网自己看文档吧。如何修改以及配置主题,等我的下一篇博客(当然了,下一篇不知道什么时候了,看心情吧)或者自己Google吧~
网友评论