知识体系 / 博客 规范

2021-07-15 76

我的知识体系摸索了3次,现在慢慢统一规范了

术语定义:
默认:以下术语均使用在 baklib 博客 里面,默认不加博客前缀了
【文章】:baklib 里面的文章
【博客】:作者角度,指的是在后台管理众多文章的界面
【标签】:baklib 文章都有可选的标签
【转义】:文章(特别是教程类)编辑过程中,有不少需要代码需要避开 markdown 的渲染而直接输出代码,因此就有转义符号/
【】:

文章写作规范

  1. 博客整理相关
  • 文章标题
  • 标签
  1. 文章相关
  • 段头

    • 段头空格
  • 段中

    • 转义写
    • 列表
  • 段尾


博客整理相关

文章标题

  • 顶级栏目:【大分类】(比如小玩具)
    • 二级栏目
      • 【大分类】(比如小玩具)栏目归档

(特殊的是)

  • 沉淀
    • 归档文件夹
      • (标签)

例子:

  1. 文章名:2020zxdx-1沟通方案选择
  • 命名格式:[年份]+[标签名字拼音缩写]+“-”+“数字”+[简介]

标签:2020招新短信

  • 标签名字:[年份]+[标签名字缩写]

列表

  • 有固定数目的用 有序列表
  • 不确定的用 无序列表,
    • 顺序参照 - + * * *
    • 每行隔多两个空格
    • 第四级列表以后都用 *

例子:

  • 这是一级列表
    • 这是二级列表
      • 这是三级列表
        • 这是四级列表
          • 这是五级列表

- 这是一级列表
    + 这是二级列表
        * 这是三级列表
           * 这是四级列表

标题格式

博客规范用

就拿严格解释的现代刑法举例:结构是“编”、章、节、条、款、项

因此得出格式规范:

(现实)书本里头 (网站)文章目录 (网站)markdown 格式
一级标题 # 第五编 1500年以前
二级标题 ## 第21章
三级标题 ### 经济发展
自定义标题1 四级标题 #### 900~1300: 增长
自定义标题2 五级标题 ##### 【标题内容】
自定义标题3 六级标题 ###### 【标题内容】

段头

空格 (段头的空格使用两个单空格,而不是两个空格)

插入两个空格 (non-breaking space)

  这是一段文字的开头

效果:
   这是一段文字的开头

段中

转义字符 \

  • 不加转义字符,最后一个括号就包含不进去

    [[show]](Thislinkhave())

    效果:[show])

  • 加了转义字符:

    [[show]](This_link_have())

    效果:[show]

段尾

知识体系构建:https://pdai.tech/md/about/me/about-arch.html