yzhang-gh / notes

Personal notes

Home Page:https://yzhang-gh.github.io/notes/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ADEPT Principle

Make explanations ADEPT: Use an Analogy, Diagram, Example, Plain-English description, and then a Technical description.

https://betterexplained.com/articles/adept-method/

排版

  • 括号,中英文混排:如果括号里全是英文,则用半角括号 (Parenthesis),此外则使用(全角括号)

  • 中文标点(破折号,省略号)样式修正1

    <span class="cn-font" lang="zh-CN">——……</span>
  • 相邻全角标点挤压2

    <span class="punct-halt"></span>
  • 考虑到 Markdown 语法的局限性,支持使用 markdown-it-attrs 来附加样式,比如居中 GFM 表格

    | header1 | header2 |
    | ------- | ------- |
    | column1 | column2 |
    
    {{.center}}
    

Asset Handling

图片

使用相对路径 ./relative/path

可选样式表 (CSS)

把 CSS 文件放到 .vuepress/public 目录下,该目录下的文件会被复制到网站的根目录,使用时路径为 {base}/foo.css (此处相当于 /notes/foo.css)

比如 KaTeX 数学环境样式

<link rel="stylesheet" href="/notes/katex.min.css">

Misc.

在新标签页打开链接,以及外链图标

<a href="" target="_blank" rel="noopener noreferrer" class="outbound"></a>

Some styles are based on Dev on Windows with WSL.

Footnotes

  1. https://www.thetype.com/2019/03/14918/

  2. https://www.bilibili.com/video/BV1Lr4y127qp/

About

Personal notes

https://yzhang-gh.github.io/notes/


Languages

Language:JavaScript 100.0%