美文网首页
Hexo 搭建个人博客

Hexo 搭建个人博客

作者: AstraLin | 来源:发表于2020-01-05 16:57 被阅读0次

安装

首先需要安装 node.js,node.js 安装教程可参看 https://www.runoob.com/nodejs/nodejs-install-setup.html
然后执行npm install -g hexoyarn global add hexo 安装 Hexo。

建站

安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

$ hexo init <folder>
$ cd <folder>
$ npm i 或 yarn install

目录结构如下:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

在执行 hexo init 的时候可能git会报错,可以到 https://github.com/hexojs/hexo-starter.git 这个地址直接把 Hexo 项目下载下来,然后改成自己项目名字。

scaffolds

模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo 的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改 scaffold/post.md 中的 Front-matter 内容,那么每次新建一篇文章时都会包含这个修改。

_config.yml

网站的配置信息,可以配置网站名称、关键字、语言、作者、时区等信息。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

themes

主题文件夹。可以去 https://hexo.io/themes/ 寻找喜欢的主题。

安装主题

我使用的主题是 pure

启用主题

在你的 hexo 项目文件夹下执行:

git clone https://github.com/cofess/hexo-theme-pure.git themes/pure

修改配置文件 hexo/_config.ymlthemepure

gitalk 评论

Gitalk 是一个基于 Github Issue 的评论插件,每增加一条评论相应的在 GitHub 项目增加一条 Issue。

注册 GitHub Application

https://github.com/settings/applications/new 注册 GitHub Application
填写 Application name(项目名称),Homepage URL(博客链接),Application description(描述),authorization callback URL(回调地址,博客链接)等信息,完成注册,获取到 Client ID 和 Client Secret。
如果项目在 Organization 下,需要进入到相应的 Organization,点击 Settings > OAuth Apps,注册 GitHub Application。

配置 _config.yml

配置文件位置 themes/pure/_config.yml。
修改 comment > type 为:gitalk,将 Client ID 和 Client Secret 填写的相应位置,并填写 owner,admin,repo。owner 为项目所有者,如果是 Organization,这填写 Organization 名称。admin 为你的用户名,repo 对应 GitHub 中的项目名。

常用命令

创建一个新网站
hexo init [folder]
新建一篇文章
$ hexo new [layout] <title>

layout 可选,如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。如:

$ hexo new "post title with whitespace"
参数 描述
-p, --path 自定义新文章的路径
-r, --replace 如果存在同名文章,将其替换
-s, --slug 文章的 Slug,作为新文章的文件名和发布后的 URL

默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:

hexo new page --path about/me "About me"
生成静态文件
$ hexo generate 或 g
参数 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动

示例
检测文件变动实时预览:

$ hexo g -w

生成文件自动部署:

$ hexo g -d
启动服务器
$ hexo server 或 s

默认情况下,访问网址为: http://localhost:4000/

部署
$ hexo deploy

部署方式请看 https://hexo.io/zh-cn/docs/one-command-deployment

清除缓存文件
$ hexo clean

相关文章

网友评论

      本文标题:Hexo 搭建个人博客

      本文链接:https://www.haomeiwen.com/subject/tnccactx.html