博客使用指南
我们现在使用的博客框架是 Hexo,感兴趣的同学可以去了解下。
1 下载源码
从 GitHub 的仓库中下载博客工具源码到自己机器上
1 | git clone https://github.com/First-Jim/blog.git |
2 安装依赖
进入项目所在文件夹,执行
1 | # npm install -g hexo-cli |
3 新建帖子
1 | npx hexo new post '博客的名称' |
需要用到图片等资源都放进新生成的文件夹中,图片尽量是 JPG 格式。
使用以下语句来引入图片
1 | {% asset_img 你的图片名称.jpg %} |
4 删除帖子
直接在 source_posts 文件夹下删除对应的 md 文件和文件夹,再运行命令
1 | npx hexo clean |
5 运行博客
1 | npx hexo s |
执行成功后,在浏览器中输入 http://localhost:4000/
6 发布博客
前提是你有这个仓库的修改权限。
修改提交说明
运行命令
1 | npx hexo g |
第一次会要求输入你 Github 的用户名和密码。
如果部署以后发现 https://first-jim.github.io/ 博客没有更新,需要手动删除项目中的.deploy_git 文件夹,重新运行命令
1 | npx hexo clean |
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 安装最新的依赖,再发布