博客使用指南

我们现在使用的博客框架是 Hexo，感兴趣的同学可以去了解下。

1 下载源码

从 GitHub 的仓库中下载博客工具源码到自己机器上

git clone https://github.com/THS-FE/blog.git

2 安装依赖

进入项目所在文件夹，执行

# npm install -g hexo-cli
npm install

3 新建帖子

npx hexo new post '博客的名称'

需要用到图片等资源都放进新生成的文件夹中，图片尽量是 JPG 格式。
使用以下语句来引入图片

{% asset_img 你的图片名称.jpg %}

4 删除帖子

直接在 source_posts 文件夹下删除对应的 md 文件和文件夹，再运行命令

npx hexo clean
npx hexo g

5 运行博客

npx hexo s

执行成功后，在浏览器中输入 http://localhost:4000/

6 发布博客

前提是你有这个仓库的修改权限。
修改提交说明

运行命令

npx hexo g
npx hexo deploy

第一次会要求输入你 Github 的用户名和密码。

如果部署以后发现 https://ths-fe.github.io/ 博客没有更新，需要手动删除项目中的.deploy_git 文件夹，重新运行命令

npx hexo clean
npx hexo g -d

7 文章规范

7.1 多级标题要加上数字编号

标题最多分 6 级，即对应 h1 ~ h6。 如： 3.2 我的世界

7.2 段落之间要有空行

图片与图片，图片与段落、段落与段落前后都要留有空行。

7.3 中英文（数字）前后要留出空格

当数字、英文在句子开头，前面不需留空格；当数字、英文在句子末尾，后面亦不需留空格。

错误： 有些英文拼写要正确，比如说 iPhone 不要写成 iphone。虽然 2020 年已经奔 3 了，但还要继续学习。

正确： 有些英文拼写要正确，比如说 iPhone 不要写成 iphone。虽然 2020 年已经奔 3 了，但还要不断学习。

7.4 标识重点使用加粗，但首尾的标点符号不要加粗

被加粗的语句、短语前后，如果有标点符号，不要对它加粗，句子中间的标点符号可正常加粗。

错误：要学会如何使用加粗啊，兄弟。

正确：要学会如何使用加粗啊，兄弟。

7.5 正确拼写英文单词

英文的拼写，如 GraphQL 而不是 graphql，Node.js 而不是 nodejs，iPhone 而不是 iphone，Apple 而不是 apple，Java 而不是 java，Aliyun 而不是 aliyun，UED 而不是 ued，RDS MySQL 而不是 rds mysql，OSS 而不是 oss 等等，使用前，先网上查下正确使用。

8 注意事项

• 文章写完后别忘记先提交 github，然后再发布

• 上传的图片大小尽量不大于 50 KB，文章标题图片大小要为 760*325（小于的不用太调整），统一命名为 cover.jpg，其它无限制。在线压缩网址：https://www.yasuotu.com/

• 在 VS Code 中安装插件：markdownlint，用以检查 md 文件中，要保证上传的 md 中没有错误

• 在大前端技术体系的对应模块中添加该文章的链接

• 发现依赖有更新是，需先执行 npm i 或 yarn install 安装最新的依赖，再发布