-
Notifications
You must be signed in to change notification settings - Fork 452
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
7893975
commit 5f9697b
Showing
1 changed file
with
51 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,27 +1,46 @@ | ||
# rcore-os Blog | ||
|
||
## 发布博客的流程 | ||
1. 将本仓库 clone 或者 fork 到本地,并进入 `blog` 目录下; | ||
2. 安装 Hexo | ||
``` | ||
npm install hexo-cli -g | ||
npm install hexo --save | ||
``` | ||
|
||
1. 将本仓库 ([email protected]:rcore-os/blog.git)fork 之后,clone 到本地,并进入 `blog` 目录下; | ||
|
||
2. 切换到root权限,安装 Hexo | ||
|
||
``` | ||
npm install hexo-cli -g | ||
npm install hexo --save | ||
``` | ||
|
||
3. 创建新博客: `hexo n "<blog-title>"`,其中 `<blog-title>` 为博客标题; | ||
|
||
4. 此时在 `blog/source/_posts/` 目录下会看到 `<blog-title>.md` 以及一个名为 `<blog-title>` 的文件夹,我们需要将博客的内容放在 `<blog-title>.md` 中,并将这篇博客相关的图片放在 `<blog-title>` 文件夹中。注意,请不要修改其他文件; | ||
5. 写完博客后,若该repo对应的本地文件夹根目录存在`package-lock.json`文件,请手动删除,可用`git rm -f package-lock.json`,之后再`commit`; | ||
6. 修改之后,通过 push 或者提 pr 的形式将博客推送到远程仓库,Github 会自动重新构建静态网页并部署到 Github Pages。 | ||
## 博客分类/标签信息 | ||
打开 Hexo 为我们建好的 `<blog-title>.md`,我们会看到这样的开头: | ||
``` | ||
|
||
5. 写完博客后,若该 blog/ 目录下存在`package-lock.json`文件,请手动删除,可用`rm -f package-lock.json`,之后再 `commit`; | ||
|
||
6. 修改之后,通过 提 pr 的形式将博客推送到远程仓库,pr通过后,Github 会自动重新构建静态网页并部署到 Github Pages:[rcore-os Blog](https://rcore-os.cn/blog/)。 | ||
|
||
## 博客分类/标签信息 | ||
|
||
打开 Hexo 为我们建好的 `<blog-title>.md`,我们会看到这样的开头: | ||
|
||
``` | ||
``` | ||
|
||
--- | ||
|
||
title: <blog-title> | ||
date: 2020-07-15 16:40:28 | ||
tags: | ||
|
||
--- | ||
|
||
``` | ||
我们在其中加入分类/标签/作者信息: | ||
``` | ||
|
||
--- | ||
|
||
title: <blog-title> | ||
date: 2020-07-15 16:40:28 | ||
categories: | ||
|
@@ -32,18 +51,31 @@ tags: | |
- <other_tag_0> | ||
- <other_tag_1> | ||
- ... | ||
|
||
--- | ||
|
||
``` | ||
* 分类:目前没有对嵌套分类进行处理,希望大家最多只分一类,不要有多种类型; | ||
* 标签:博客默认只有一个作者,所以目前想到用不同的标签对作者以及本篇博客相关工作所在的仓库进行区分。至于其他的标签可以自由发挥,但是当已经存在类似的标签时应该沿用已有的而不是新建另外一个。 | ||
> 注意: | ||
> | ||
> - 注意,"author:" 与你的 githubID之 间不要留有空格。 | ||
> - 文中出现的'<'和'>'只是为了标识变量,实际操作时候应该移除它们。 | ||
## 数学公式支持 | ||
只需在博客开头区打开 mathjax 开关即可: | ||
``` | ||
|
||
mathjax: true | ||
|
||
``` | ||
## 插入本地图片 | ||
|
@@ -53,7 +85,9 @@ mathjax: true | |
假设你要插入一张 `<image-file>`,那么首先你应该把它放在 `blog/source/_post/<blog-title>` 文件夹中,然后在需要插入图片的位置,用如下的 tag 来插入图片(注意:这里的'<'和'>'只是为了标识变量,插入图片的时候应该移除它们): | ||
``` | ||
|
||
{% asset_img <image-file> <image-title> %} | ||
|
||
``` | ||
其功能等同于 `![<image-title>](<image-file>)`。 | ||
|
@@ -65,12 +99,17 @@ mathjax: true | |
特殊:紧跟开头加入标记(如下所示),会在Github Pages的首页全片幅展示你的博客 | ||
``` | ||
|
||
--- | ||
|
||
title: <blog-title> | ||
date: 2020-07-15 16:40:28 | ||
tags: | ||
|
||
--- | ||
|
||
<!-- more --> | ||
|
||
``` | ||
## Log | ||
|
@@ -83,3 +122,4 @@ tags: | |
* https://ming.theyan.gs/2019/10/hexo-github_action-github_pages/ | ||
* 目前已经实现在 pr/push 后自动更新博客,现在测试一下标签/分类功能以及图片功能是否正常,如果正常的话更新博客发布教程。 | ||
* 经过一番折腾这些功能都比较正常了... | ||
``` |