Ledge Jekyll Theme with Style Demo

Ledge Framework is a documentation as code framework, it build custom markdown render to render chart, kankban, graphics and others.

 - 持续交付
   - 配置管理: 3
     - 版本控制
     - 变更管理
   -  持续构建与持续集成: 3
     - 构建实践
     - 持续集成
   - 测试管理: 3
     - 测试分层策略
     - 代码质量管理
     - 自动化测试
   - 部署与发布管理: 3
     - 部署与发布管理
     - 部署流水线
   - 环境管理: 3
   - 数据管理: 3
     - 测试数据管理
     - 数据变更管理
   - 度量与反馈: 3
     - 度量指标
     - 度量驱动改进
 - CI 建设
  - 开发阶段准备
    - 拉 Aimeituan 工程的开发分支
    - 修改开发分支版本号
    - Aimeituan 工程独立编译自动配置
  - PR 检测
    - 静态检测
    - 增量检测
      - SDK
      - 包大小
    - 单测
  - 开发阶段
    - 定时检测壳工程是否有更新,触发自动打包
    - 每日最新版本号提醒
  - 提测阶段
    - 冒烟提醒
    - 自动拉提测分支
    - 业务库检测是否有 PR 未合入
    - 提测打包、发提测邮件
  - 发版阶段
    - 分支合并
    - 外卖业务库合入 Aimeituan 提测分支
    - 全量提醒

config: {"collapse": true, "height": 400, "width": 800}
 - 敏捷成熟度模型
   - 组织治理: 3
   - 需求管理: 4
   - 交流协作: 5
   - 构建管理: 2
   - 简单设计: 3
   - 测试策略: 3
   - 快速响应: 5
   - 职责共享: 3
   - 精益思考: 2
 - 代码检出
   - 代码检出:success
 - 安装依赖
   - 安装依赖:success
 - 构建
   - 构建:success
 - 构建服务端渲染
   - 构建服务端渲染:success
 - 部署
   - 部署:success
 - Path to Production
   - Feat
   - Design
     - Pair Review
   - Dev
     - PrePush
     - Code Review
   - Test
     - Desk Check
   - Build
   - Deploy
   - Operatino

config: {"height": 600, "width": 800}

读书雷达

 - 文化
   - adopt
     - 《第五项修炼: 学习组织的技术和实践》
     - 《奈飞文化手册》
     - 《管理 3.0: 培养和提升技术领导力》
   - trail
     - 《团队协作的五大障碍》
     - 《团队之美》
     - 《精益企业》
   - assess
     - 《丰田模式:精益制造的 14 项管理原则》
   - hold
     - 《凤凰项目:一个IT运维的传奇故事》
 - 流程
   - adopt
     - 《持续交付》
     - 《精益软件度量:实践者的观察与思考》
   - trail
     - 《Jenkins 权威指南》
     - 《持续交付 2.0: 业务引领的DevOps精要》
   - assess
   - hold
     - 《发布!软件的设计与部署》
     - 《发布!设计与部署稳定的分布式系统(第2版)》
 - 实践
   - adopt
     - 《基础设施即代码:云服务器管理》
     - 《测试驱动开发:实战与模式解析》
     - 《微服务架构设计》
     - 《领域驱动设计模式、原理与实践》
     - 《SRE:Google 运维解密》
   - trail
     - 《演进式架构》
   - assess
     - 《修改代码的艺术》
   - hold
     - 《重构:改善既有代码的设计》
     - 《看板实战》
     - 《敏捷软件测试:测试人员与敏捷团队的实践指南》
 - 实施
   - adopt
    - 《Effective DevOps》
    - 《DevOps实践指南》
    - 《Java 持续交付》
    - 《DevOps实施手册 在多级 IT 企业中使用 DevOps》
    - 《领域驱动设计:软件核心复杂性应对之道》
   - trail
    - 《Accelerate》
    - 《DevOps 最佳实践》
    - 《学习敏捷开发》
   - assess
    - 《SRE:Google 运维解密》
   - hold
    - 《DevOps 实践》

config: {"hiddenLegend": true}

组件

checklist

- [x] Eating
  - [ ] Today
    - [x] breakfast
    - [ ] brunch
    - [ ] elevenses
    - [ ] lunch
    - [ ] tea
    - [ ] supper
    - [ ] dinner:the main meal of the day, eaten either in the middle of the day or in the evening

kanban

 - Kanban Name
   - Todo
     - done basic feature
     - write document
   - Doing
     - create componet
     - add testing
   - Done
     - create card
   - Done

tech-radar

 - 框架
   - adopt
     - Angular
     - D3.js
   - trail
     - Echarts
   - assess
     - Stencil.js
     - Ionic
   - hold
     - react
 - 平台
   - adopt
     - GitHub
   - trail
   - assess
   - hold
 - 语言
   - adopt
     - TypeScript
   - trail
   - assess
   - hold
     - JavaScript
 - 技术
   - adopt
   - trail
     - Web Components
   - assess
   - hold

list-style

配置图形为圆形

 - 开源工具采用
 - 商业采购
 - 自研研发交通平台

config: {"type": "circle"}

配置图形为方形组

 - 基于开源方案遇到困难
   - 性能瓶颈
   - 业务需求⽇益多元化,但团队规模有限
 - 扩展更多的能力
   - 更多元化的代码质量检查
   - 审计需求
   - 二进制、镜像安全扫描

config: {"type": "group-square"}

echarts

{
"series": [
    {
        "type": "treemap",
        "breadcrumb": {"show": false},
        "roam": "move",
        "data": [{
            "name": "nodeA","value": 10,
            "children": [
              {"name": "HealthController.java", "value": 4 },
              {"name": "HealthService.java", "value": 6}
            ]},
            {"name": "HealthModel.java", "value": 20}
        ]
    }
]
}

graphviz

绘制流程图

digraph {
  rankdir=LR;
  "红" -> "绿"[label="写一个失败的测试"];
  "绿" -> "重构"[label="让代码可以工作"];
  "重构" -> "红"[dir="back" label="重构"];
}

mermaid

支持 mermaid 图表和流程图

graph LR
    A[Hard edge] -->|Link text| B(Round edge)
    B --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]

甘特图,语法描述见 mermaid/gantt

gantt
    title A Gantt Diagram
    dateFormat  YYYY-MM-DD
    section Section
    A task           :a1, 2014-01-01, 30d
    Another task     :after a1  , 20d
    section Another
    Task in sec      :2014-01-12  , 12d
    another task      : 24d

toolset

type 为 slider

 - 用户体验
 - 时间
 - 成本
 - 安全
 - 范围

config: {"type": "slider"}

type 为 line-chart

|  Challenge;Skill/Ability   | low | high |
|-|-|-|
| low  |      | boredom |
| high | anxiety | flow |

config: {"type": "line-chart"}

quadrant

 - 技术债墙
     - 快速解决
       - ……
       - ……
       - ……
     - 分解并计划
       - ……
       - ……
       - ……
     - 在可能的时候提升
       - ……
       - ……
     - 暂时不管
       - ……
       - ……
       - ……

config: {"left": "简单", "right": "困难", "bottom": "不重要", "top": "重要"}

radar

 - 质量属性网络
   - 可靠性
   - 可修改性
   - 安全性
   - 可测试性
   - 性能
   - 可用性

有图例和数据

 - 质量成熟度评估模型
  - 质量内建: 3 -> 4
  - 优化业务价值: 2 -> 2
  - 质量统一,可视化: 1 -> 5
  - 全员参与: 3 -> 4
  - 快速交付: 4 -> 5
  - 测试作为资产: 2 -> 3
  - 快速反馈: 5 -> 5

config: {"legend": ["当前", "未来"]}

pyramid

 - 寻找价值
   - 价值:、
   - 质量:零缺陷、设计良好
   - 划分:小、完整
   - 构建:价值优先、逐渐完善产品
   - 计划:持续、接下来做什么?
   - 组织:团队、人员与技能
   - 指导:何物、何时

mindmap

 - CI 建设
  - 开发阶段准备
    - 拉 Aimeituan 工程的开发分支
    - 修改开发分支版本号
    - Aimeituan 工程独立编译自动配置
  - PR 检测
    - 静态检测
    - 增量检测
      - SDK
      - 包大小
    - 单测
  - 开发阶段
    - 定时检测壳工程是否有更新,触发自动打包
    - 每日最新版本号提醒
  - 提测阶段
    - 冒烟提醒
    - 自动拉提测分支
    - 业务库检测是否有 PR 未合入
    - 提测打包、发提测邮件
  - 发版阶段
    - 分支合并
    - 外卖业务库合入 Aimeituan 提测分支
    - 全量提醒

process-step

 - 平台层
   - 运维平台
   - 小米私有云
   - 小米生态云
 - 能力层
   - 团队注册
   - 一键接入
   - 检测扫描工具集成
   - 发布部署
   - 标准化工具接入
 - 工具层
   - Gitlab
   - Phabricator
   - Jenkins on K8s
   - 代码质量扫描
   - 安全/法律合规扫描
   - 二进制&产出物存储
   - 二进制安全扫描
   - 二进制法务审计扫描
   - 部署服务
 - 数据层
   - 数据智能应用
   - 研发效能数据仓库

process-table

| 源码管理 | 代码质量 | 制品管理  | 测试 | 持续集成 | 分析 | 协作  |
|-|-|-|-|-|-|-|
| Git | TSLint | Git (history) | Jasmine | GitHub Action | GitHub Traffic | GitHub Projects |
| GitHub | Code Climate | |  Jest | | Google Analysis |  |

chart

采用 DevOps 的行业

| 行业 | 占比 |
|-|-|
| 技术 | 38% |
| 金融服务 | 12% |
| 零售/消费/电子商务 | 9% |
| 其它 | 9% |
| 医疗保健和制药 | 5% |
| 政府 | 5% |
| 媒体/娱乐 | 4% |
| 保险 | 4% |
| 教育 | 4% |
| 工业和制造业 | 4% |
| 电信 | 3% |
| 能源 | 3% |
| 非营利 | 1% |

组织所使用的操作系统

配置项 config: {"type": "bar", "multiset": true}

| 操作系统  |  2018 | 2019 |
|-|-|-|
| Windows 2003/2003R2 | 12% | 6% |
| Windows 2008/2008R2 | 33% | 26% |
| Windows 2012/2012R2 | 56% | 52% |
| Other Windows      | 22% | 25% |
| Linux Debian/Ubuntu variants  | 36% | 43% |
| Linux Enterprise variants (RHEL, Oracle, CentOS) | 48% | 49% |
| Linux Fedora        | 5% | 4% |
| SUSE Linux Enterprise Server  | 8% | 5% |
| Linux OpenSUSE | 4% | 4% |
| Linux Arch    | 2% | 2% |
| Other Linux  |  13% | 11% |
| Other UNIX  | 8% | 4% |
| FreeBSD/NetBSD/OpenBSD   | 3% | 3% |
| AIX                | 10% | 7% |
| Solaris OS         | 12% | 5% |
| Other              | 12% | 8% |

config: {"type": "bar", "multiset": true}

pie

 - Some & < > " title
   - a: 4
   - b: 12
   - c: 21
   - d: 19

process-card

支持样式颜色配置 "colors": [{"bg":"#e55852","font":"#b71a09"}]bg 为背景色,font 为字体颜色。

| 缺陷收集 | 缺陷分析 | 缺陷预防  |
|-|-|-|
| 缺陷模板 | 缺陷分类 | 可测性 |
| 生命周期| 缺陷统计 | 缺陷响应力 |
| 管理工具 | 缺陷分布 | 敏捷过程 |
| 缺陷扫除 | 缺陷报告 | 二八法则 |

config: {"colors": [{"bg":"#e55852","font":"#b71a09"},{"bg":"#e98832","font":"#c85113"},{"bg":"#f0d668","font":"#b88d0f"},{"bg":"#a4c9cf","font":"#598893"},{"bg":"#47c0af","font":"#175a54"},{"bg":"#387fd5","font":"#9ac9f5"},{"bg":"#7753df","font":"#cbb5f8"}]}

step-line

 - 源码管理
 - 制品管理
 - 配置管理
 - 数据库自动化
 - 测试
 - 持续集成
 - 监控
 - 分析
 - 智能运维
 - 协作

table-step

支持配置的属性有:

  • rowHeight 行高
  • colors 颜色配置参考 process-card
  • column 设置每行多少列(默认自适应,默认最少 4 列)
| 项目 / 过程管理 | 配置管理 | 构建  | 测试 / 质量 | 制品 / 部署 | 基础设施 | 沟通协作 | 可视化   |
|---|----|---|---|----|----|----|----|
| Jira          | Gitee   | Maven | Junit      | Ubran code | VMWare  | 招呼     | Tableau |
| Tracker       | Rational ClearCase |  Gradle | Cucumber | Fit2Cloud | OpenShift | 移事通 | Grafana |
| VP            | CMDB | NPM | JMeter     | B9         | Cloud Foundry | | Kibana |
| Confluence    |   Firefly    | Ant   | RobotFramework | JFrog Artifactory | | |  Prometheus |
| ITIL          |    | MSBuild | Protractor | | | | ElasticSearch |
|               |           |  Docker  | Sonar | | | | X-Pack |
|               |           |        | BlackDuck | | | | |

config: {"rowHeight": "340px" ,"colors": [{"bg":"#e55852","font":"#b71a09"},{"bg":"#e98832","font":"#c85113"},{"bg":"#f0d668","font":"#b88d0f"},
{"bg":"#a4c9cf","font":"#598893"},{"bg":"#47c0af","font":"#175a54"},
{"bg":"#387fd5","font":"#9ac9f5"},{"bg":"#7753df","font":"#cbb5f8"},{"bg":"#485cde","font":"#a0b1f3"}]}

Pipeline

# Syntax
- Stage1 label
  - Job1 label:Job1 state
- Stage2 label
  - Job1 label:Job1 state
  - Job2 label:Job2 state

Job State

  • success
  • error
  • untouched
  • processing [Unsupported]
  • current [Unsupported]
  • pending [Unsupported]
- Initialize
  - Initialize:success
- Build
  - Pull code:success
  - Test:error
  - Build:current
- Deploy
  - QA:pending
  - UAT:processing
  - STAGING:processing
  - PROD:untouched
- Finish
  - Finish:untouched

config: {
  "connectionStrokeWidth": 4,
  "stateStrokeWidth": 4,
  "stateRadius": 16,
  "stageSpace": 60,
  "stageLabelHeight": 30,
  "stageLabelSize": "16px",
  "jobHeight": 60,
  "jobLabelSize": "12px",
  "startNodeRadius": 12,
  "startNodeSpace": 40,
  "endNodeRadius": 12,
  "endNodeSpace": 40
}

其他 Markdown 语法

console.log('hello, world');
normal table
  • list
  • item

spliqt

  • a
    • a
      • a
      • b

这是一个正常无比的段落。

blockquote

phodal.com

updatet build

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer