这是您可以在 Quick Reference 备忘单上使用的样式参考,快速参与贡献!
将仓库克隆到本地调试页面。请参阅贡献指南了解如何开始
git clone git@github.com:jaywcjlove/reference.git
npm i # 安装依赖
npm run build # 编译输出 HTML
HTML 存放在仓库根目录下的 dist
目录中,将 dist/index.html
静态页面在浏览器中打开预览。
npm run start # 监听 md 文件编译输出 HTML
.
├── CONTRIBUTING.md # 贡献说明
├── Dockerfile
├── LICENSE
├── README.md # 🌐 Home(首页)内容
├── dist # 📦 编译后的静态资源目录
├── docs # 👈 Markdown 文档(速查表)
│ ├── bash.md
│ ├── ....
│ └── yaml.md
├── package.json
└── scripts # MD 转 HTML 的编译脚本
├── assets # LOGO 图标文件资源
├── ....
└── watch.mjs
一个简单的备忘清单包含 页面大标题<h1>
,放在大标题下面的 介绍
文本,<h2>
分类标题,<h3>
内容为 卡片
备忘清单 (页面大标题)
===
这是您可以在当前清单上使用的样式参考!备忘清单介绍
入门 (分类标题)
---
### 介绍 (卡片)
卡片内容
上面 markdown 内容存放到 docs
目录中,命名为 xxx.md
首页(README.md
)存放在仓库的根目录,通过这个 README.md
自动生成首页导航,下面是导航实例:
## Linux 命令
[Cron](./docs/cron.md)<!--rehype:style=background: rgb(239 68 68/var(\-\-bg\-opacity));-->
<!--rehype:class=home-card-->
首页导航图标存放在 scripts/assets
目录中,如果你的备忘清单定义为 docs/cron.md
,那么你的图标就定义为 cron.svg
存放到 scripts/assets
目录中,重新编译首页当行菜单就拥有了图标。
scripts/assets
目录中cron.md
-> cron.svg
(注意大小写)<svg height="1em" width="1em"
<svg fill="currentColor"
<!--rehype:class=home-card-->
标识卡片样式[Django](./docs/djiango.md)<!--rehype:style=background: rgb(12 75 51/var(\-\-bg\-opacity));&class=contributing-->
添加 contributing
类名,会在卡片下方默认添加 👆待完善需要您的参与
class=tag&data-info=👆看看还缺点儿什么?
上面示例将默认提示更改为: 👆看看还缺点儿什么?
[Django](./docs/djiango.md)<!--rehype:style=background: rgb(12 75 51/var(\-\-bg\-opacity));&class=tag&data-lang=Python-->
添加 class=tag&data-lang=Python
类名和参数,会在卡片右上角标记 Python
在备忘清单采用 HTML 注释语法
,标识网站布局和一些样式,目的是为了在 GitHub
中也是正常毫无瑕疵的预览 Markdown
。
### 卡片标题
<!--rehype:wrap-class=col-span-2-->
卡片 Markdown 内容展示,下面注释语法为文字内容改变样式
<!--rehype:style=color: red;-->
上面基础示例,使用 col-span-2
类标识,卡片占 2
列位置,参考现有备忘清单的源代码是一个好习惯!
Markdown
语法下方或者后面,添加 HTML注释<!--rehype:
开始,-->
结束,包裹参数内容<!--rehype:
+ key=value
+ &
+ key=value
+ -->
标识开始
+ 参数
+ 分隔符(&)
+ 参数
+ 标识结束
## H2 部分
<!--rehype:body-class=cols-2-->
### H3 部分
<!--rehype:wrap-class=row-span-2-->
### 标题
<!--rehype:wrap-class=row-span-3&style=color:red;-->
类 | 说明 |
---|---|
body-style | 包裹所有卡片外壳 的样式 |
body-class | 用于卡片栏布局,添加类 名 |
wrap-style | 卡片栏添加 CSS 样式 |
wrap-class | 用于卡片占位,添加类 名 |
_我是红色_<!--rehype:style=color: red;-->
**加粗红色**<!--rehype:style=color: red;-->
上面添加注释样式,文字 我是红色 文字变红
了
**加粗变大红色**
<!--rehype:style=color: red;font-size: 18px-->
上面添加注释样式,文字 加粗变大红色 变红
并且大
了
\```js
function () {}
\```
<!--rehype:className=wrap-text-->
如果代码块内容太长,使用强制换行类(wrap-text
)解决
| Key | value |
| ---- | ---- |
| `键` | 值 |
<!--rehype:className=show-header-->
注释配置添加 show-header
类,放置在表格下面,表头将被展示出来。
import React from "react";
import "./Student.css";
export const Student = (
<div className="Student"></div>
);
上面 {1,4-5}
行代码高亮,下面是 Markdown
代码示例
```jsx {1,4-5}
代码行高亮可以和代码行号一起使用。
添加注释配置 <!--rehype:tooltips-->
添加一个 Tooltips 提示。
### H3 部分(卡片)背景颜色
<!--rehype:wrap-style=background: #8dffd42e;-->
### 红色标题
<!--rehype:style=background:#e91e63;-->
在 H3 标题下面添加样式标注 <!--rehype:style=background:#e91e63;-->
Key | value |
---|---|
快捷键 | 说明 |
快捷键 | 说明 |
列表添加 <!--rehype:className=shortcuts-->
样式类,展示快捷键样式。
export const Student = <div>学生</div>;
const school = <div>学校</div>;
下面是 Markdown
代码示例
```jsx showLineNumbers
标记语言后面添加 showLineNumbers
标识
:- | - |
---|---|
shortcuts | 快捷键样式 |
wrap-text | 超出换行 |
show-header | 展示表头 |
style-none | 隐藏 <ul> 列表样式 |
style-list | <table> 单元格行展示 |
:- | - |
---|---|
<yel> | |
<red> | |
<pur> | |
<code> 或 `` | 绿 色 |
<del> 或 ~~删除~~ |
隐藏卡片标题,在 H3 标题下面添加注释样式
### 隐藏卡片标题
<!--rehype:style=display:none;&wrap-style=padding-top: 0;-->
类 | 说明 |
---|---|
<!--rehype:className=wrap-text--> | 强制换行 |
<!--rehype:className=show-header--> | 展示表格表头 |
<!--rehype:className=shortcuts--> | 快捷键 样式 |
<!--rehype:className=auto-wrap--> | 隐藏表头强制小尺寸自动换行 |
<!--rehype:className=style-list-arrow--> | 列表箭头 样式展示表格 |
<!--rehype:className=style-list--> | 列表 样式展示表格 |
<!--rehype:className=left-align--> | 表格末尾列左对齐 |
<!--rehype:className=style-none--> | <li> 没有标记样式 |
<!--rehype:className=style-timeline--> | 时间轴 样式 |
<!--rehype:className=style-arrow--> | 箭头 标记 |
H2 部分
---
### 卡片 1 (H3 部分)
### 卡片 2 (H3 部分)
### 卡片 3 (H3 部分)
上面实例 H2 部分
标题下面有三个卡片
,默认 3
栏布局。
H2 部分
---
<!--rehype:body-class=cols-2-->
### 卡片 1 (H3 部分)
### 卡片 2 (H3 部分)
### 卡片 3 (H3 部分)
使用注释配置为 H2 部分 添加 col-span-2
类,将 栏布局变成 3
2
栏布局。
类 | 说明 |
---|---|
cols-1 | 1 栏卡片布局 |
cols-2 | 2 栏卡片布局 |
cols-3 | 3 栏卡片布局 |
cols-4 | 4 栏卡片布局 |
cols-5 | 5 栏卡片布局 |
cols-{1~6} | 1~6 栏卡片布局 |
### H3 部分
<!--rehype:wrap-style=grid-row: span 2/span 2;-->
放在 ### H3 部分
下面的注释配置,与 <!--rehype:wrap-class=row-span-2-->
相同,设置 2 行占位布局。
## H2 部分
<!--rehype:body-style=grid-template-columns: repeat(2,minmax(0,1fr));-->
放在 ## H2 部分
下面的注释配置,与 <!--rehype:body-class=cols-2-->
相同,设置 2 栏布局。
### 卡片 1 (H3 部分)
<!--rehype:wrap-class=row-span-2-->
### 卡片 2 (H3 部分)
<!--rehype:wrap-class=col-span-3-->
### 卡片 3 (H3 部分)
:-- | -- |
---|---|
合并 列 布局 | |
col-span-2 | 2 列占位 |
col-span-3 | 3 列占位 |
col-span-4 | 4 列占位 |
col-span-{2~10} | {2~10} 列占位 |
合并 行 布局 | |
row-span-2 | 2 行占位 |
row-span-3 | 3 行占位 |
row-span-4 | 4 行占位 |
row-span-{2~10} | {2~10} 行占位 |
╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮
┆ H3 Title 1 ┆
╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 2 ┆ ┆ 3 ┆ ┆ 4 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### H3 Title 1
<!--rehype:wrap-class=col-span-3-->
### Title 2
### Title 3
### Title 4
第一标题添加 col-span-3
占位类
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆ ┆ 3 ┆
┆ ┆ ╰┈┈┈╯ ╰┈┈┈╯
┆ ┆ ╭┈┈┈╮ ╭┈┈┈╮
┆ ┆ ┆ 4 ┆ ┆ 5 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
<!--rehype:wrap-class=row-span-2-->
### Title 2
### Title 3
### Title 4
### Title 5
在 Title 1
标题添加 row-span-2
占位类
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆ ┆ 3 ┆
╰┈┈┈╯ ┆ ┆ ╰┈┈┈╯
╭┈┈┈╮ ┆ ┆ ╭┈┈┈╮
┆ 4 ┆ ┆ ┆ ┆ 5 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
### Title 2
<!--rehype:wrap-class=row-span-2-->
### Title 3
### Title 4
### Title 5
在 Title 2
标题添加 row-span-2
占位类
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆ ┆ 3 ┆
╰┈┈┈╯ ╰┈┈┈╯ ┆ ┆
╭┈┈┈╮ ╭┈┈┈╮ ┆ ┆
┆ 4 ┆ ┆ 5 ┆ ┆ ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
### Title 2
### Title 3
<!--rehype:wrap-class=row-span-2-->
### Title 4
### Title 5
在 Title 3
标题添加 row-span-2
占位类
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆ ┆ 3 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
╭┈┈┈╮ ╭┈┈┈┈┈┈┈┈┈╮
┆ 4 ┆ ┆ 5 ┆
╰┈┈┈╯ ╰┈┈┈┈┈┈┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
### Title 2
### Title 3
### Title 4
### Title 5
<!--rehype:wrap-class=col-span-2-->
在 Title 5
标题添加 col-span-2
占位类
╭┈┈┈╮ ╭┈┈┈┈┈┈┈┈┈╮
┆ 1 ┆ ┆ 2 ┆
╰┈┈┈╯ ╰┈┈┈┈┈┈┈┈┈╯
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 3 ┆ ┆ 4 ┆ ┆ 5 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
### Title 2
<!--rehype:wrap-class=col-span-2-->
### Title 3
### Title 4
### Title 5
在 Title 2
标题添加 col-span-2
占位类
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆ ┆ 3 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
╭┈┈┈┈┈┈┈┈┈╮ ╭┈┈┈╮
┆ 4 ┆ ┆ 5 ┆
╰┈┈┈┈┈┈┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
### Title 2
### Title 3
### Title 4
<!--rehype:wrap-class=col-span-2-->
### Title 5
在 Title 4
标题添加 col-span-2
占位类
╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮
┆ H3 Title 1 ┆
╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 2 ┆ ┆ 3 ┆ ┆ 4 ┆ ┆ 5 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
H2 部分
----
<!--rehype:body-class=cols-4-->
### Title 1
<!--rehype:wrap-class=col-span-4-->
### Title 2
### Title 3
### Title 4
### Title 5
在 H2 部分
标题添加 cols-4
,和 Title 1
添加 col-span-4
合并栏
╭┈┈┈┈┈┈┈┈┈╮ ╭┈┈┈╮
┆ 1 ┆ ┆ 2 ┆
┆ ┆ ╰┈┈┈╯
┆ ┆ ╭┈┈┈╮
┆ ┆ ┆ 3 ┆
╰┈┈┈┈┈┈┈┈┈╯ ╰┈┈┈╯
╭┈┈┈╮ ╭┈┈┈╮ ╭┈┈┈╮
┆ 4 ┆ ┆ 5 ┆ ┆ 6 ┆
╰┈┈┈╯ ╰┈┈┈╯ ╰┈┈┈╯
上面布局效果 Markdown 源码:
### Title 1
<!--rehype:wrap-class=col-span-2 row-span-2-->
### Title 2
### Title 3
### Title 4
### Title 5
### Title 6
在 Title 1
标题添加 col-span-2
和 row-span-2
占位类,使用 空格
间隔。
:- | :- |
---|---|
%m/%d/%Y | 06/05/2013 |
%A, %B %e, %Y | Sunday, June 5, 2013 |
%b %e %a | Jun 5 Sun |
:- | :- |
---|---|
%H:%M | 23:05 |
%I:%M %p | 11:05 PM |
标题为 H4
的基本表格。
:- | :- |
---|---|
V | Vector |
P | Pencil |
T | Text |
L | Line |
R | Rectangle |
O | Oval |
U | Rounded |
Prefix | Example | What |
---|---|---|
// | //hr[@class='edge'] | Anywhere |
./ | ./a | Relative |
/ | /html/body/div | Root |
<!--rehype:className=show-header-->
:- | :- |
---|---|
visualEffectState.inactive | 后台应一直显示为非激活状态。 |
titleBarStyle string (win/mac) | 窗口标题栏样式。默认值 (default) |
titleBarStyle.default | 分别返回 mac 或者 win 的标准标题栏 |
<!--rehype:className=style-list-->
:- | :- |
---|---|
visualEffectState.inactive | 后台应一直显示为非激活状态。 |
titleBarStyle string (win/mac) | 窗口标题栏样式。默认值 (default) |
titleBarStyle.default | 分别返回 mac 或者 win 的标准标题栏 |
<!--rehype:className=style-list-arrow-->
:- | :- |
---|---|
visualEffectState.inactive | 后台应一直显示为非激活状态。 |
titleBarStyle string (win/mac) | 窗口标题栏样式。默认值 (default) |
titleBarStyle.default | 分别返回 mac 或者 win 的标准标题栏 |
<!--rehype:className=auto-wrap-->
Prefix | What |
---|---|
// | Anywhere |
./ | Relative |
默认表格末尾列右对齐
,添加 <!--rehype:className=left-align-->
类让其左对齐
<!--rehype:className=cols-4-->
重命名为 new_name
$ git branch -m <new_name>
推送和重置
$ git push origin -u <new_name>
删除远程分支
$ git push origin --delete <old>
<!--rehype:className=style-timeline-->
<!--rehype:className=cols-3 style-none-->
<!--rehype:className=style-round-->
<!--rehype:className=style-arrow-->
...
...
...
...
...
...
<!--rehype:wrap-class=row-span-2-->
...
<!--rehype:wrap-class=col-span-2-->
...
<!--rehype:style=background:#e91e63;-->
...
<!--rehype:style=background:#d7a100;-->
...
每个部分可以有以下子项:
每个盒子(卡片)都是一个 H3
部分。 盒子将包含 H3
自身内的所有东西。
这是一个包含段落的基本部分。
注释配置:
`<!--rehype:wrap-style=background: #1b5064;-->`