博客使用指南

博客使用指南

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

1 下载源码

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

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

2 安装依赖

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

1
2
# npm install -g hexo-cli
npm install

3 新建帖子

1
npx hexo new post '博客的名称'

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

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

4 删除帖子

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

1
2
npx hexo clean
npx hexo g

5 运行博客

1
npx hexo s

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

6 发布博客

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

运行命令

1
2
npx hexo g
npx hexo deploy

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

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

1
2
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 安装最新的依赖,再发布

作者

天下布武

发布于

2020-04-24

更新于

2021-08-04

许可协议

CC BY-NC-SA 4.0

评论