安装
Hexo依赖于Node和Git,所以在安装Hexo之前,你需要先安装Node和Git。如已安装,接下来我们就可以安装Hexo了
安装Hexo非常简单,只需要一条命令。我们打开Git Bash,输入下面的语句就可以成功的安装Hexo了
$ npm install -g hexo-cli // 安装Hexo
建站
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm install
这样我们一个站点就已经建立好了,这时我们可以运行hexo server
在本地打开我们的站点
新建完成后,指定文件夹的目录如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
接下来我们需要在_config.yml中设置我们的信息,你可以参考Hexo配置,因为我们接下来要把博客部署到网站上去,所以至少你要配置Site和URL的属性
因为我们需要使用git来部署博客到网上去,所以我们还需要安装一个插件
npm install hexo-deployer-git --save
然后在_config.yml文件中设置
deploy:
type: git
repo: <repository url>
branch: [branch] message: [message]
参数 | 描述 |
---|---|
repo |
库(Repository)地址 |
branch |
分支名称。如果您使用的是 GitHub 或 GitCafe 的话,程序会尝试自动检测。 |
message |
自定义提交信息 |
写作
当完成了以上步骤之后我们就可以开始写作了,因为写作的时候会使用Markdown语法,所以你如果不会使用Markdown的话建议你先学习一下Markdown基本语法,十分钟你就能快速上手Markdown 语法说明
在写作过程中我们可能会插入图片,如何直接使用链接是不能成功加载图片的,这时我们需要安装一个插件
在安装之前我们需要先在_config.yml中设置post_asset_folder:true
,当设置了之后,我们在新建一篇文章的时候Hexo
会自动建立一个与文章同名的文件夹,您可以把与该文章相关的所有资源都放到那个文件夹,如此一来,您便可以更方便的使用资源。
npm install https://github.com/CodeFalling/hexo-asset-image --save
好了,现在我们可以安心写作了
你可以执行下列命令来创建一篇新文章。
$ hexo new [layout] <title>
当你完成你的写作之后,你可以hexo server
来预览你的写作,或者在写作前打开服务,边写作边预览
生成部署
当你写好你的文章之后,我们需要把文章上传到网上,这时我们需要先生成静态文件
hexo generate
静态文件生成之后,我们就可以把新编写的文章部署到网上了
hexo deploy
主题
创建 Hexo 主题非常容易,您只要在 themes
文件夹内,新增一个任意名称的文件夹,并修改 _config.yml
内的 theme
设定,即可切换主题。
注意
在写这篇博客的时候我遇见了一个问题,当我在博客中写到
这条语句时,我当时是将它放在代码块里的,出现了以下的问题
当时怎么都找不出错误,也不知道是发生什么了,说实话,那个报错我没看懂(我以为是主题出错了)。现在我猜测应该是一句关于Hexo设置的语句,所以也请你以后注意不要写这样的语句在你的文章中。
其他
更多的内容你可以在Hexo官网里面找到