如何投稿

贡献方案

技术博客贡献方案 http://confluence-hz.lonsid.cn/x/3aR

整个技术博客投稿活动，作为今后大家职业晋升的参考依据。

环境准备

• node http://nodejs.cn/download/current/
• vscode https://code.visualstudio.com/docs/?dv=win64user

获取文档库代码

git clone http://gitlab-hz.lonsid.cn/Techs-Preview/masa-blogs.git

构建文档

1. 采用 vscode 打开 masa-blogs 文档库代码目录，使用下面的命令，启动可视化文档写作：

   npm i
   npm start

2. 创建分支，分支名需要 姓名全拼加-加文档简述，比如 feature/zhurong-contributing；

3. 在 /source/_posts 中新建markdown类型的文件，并按照自己的想法命名，文件需要是一句话英文，并用-符号连接，比如 How-to-contributing.md；

4. 文档头需要遵循vuepress的标准格式：

   ---
   title: 烤鸭的做法
   cover: /gallery/covers/cover.jpg
   thumbnail: /gallery/thumbnails/thumbnail.jpg
   date: 2019-08-08 08:00:00
   updated: 2020-04-01 00:00:00
   toc: true
   categories:
    - 烹饪
    - 爱好
   tags:
    - 烤
    - 鸭子
   ---

• title：文章标题
• cover：文章封面图
• thumbnail：文章缩略图
• date：文章创建日期，格式 2019-08-08 或 2019-08-08 08:08:08
• updated：文章更新时间
• toc：否开启侧边栏
• categories：所属分类
• tags：所属标签

5. 正文创作需要遵循markdown标记语言，可以通过vscode插件markdownlint协助写作。

6. 在你的文章中添加<!-- more -->标签。 标签前面的文章内容会被标记为摘要，而其后的内容不会显示在文章列表上。

7. 文章内标题使用二级标题开始，不需要增加序号

8. 标题下最好跟有一句话描述

9. 补充类可以用引用”>”

10. 其他问题可参阅这里： https://ppoffice.github.io/hexo-theme-icarus/uncategorized/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98/