@wulechuan/css-stylus-markdown-themes 7.4.2 → 7.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/ReadMe.md +87 -47
  2. package/package.json +32 -32
  3. package//346/226/207/346/241/243/351/233/206//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/225/210/346/236/234/347/244/272/344/276/213/351/233/206//345/216/237/345/247/213/347/232/204-markdown-/346/240/274/345/274/217/347/232/204/346/226/207/347/253/240/theming-example-article.zh-hans-CN.md +46 -9
  4. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206/javascript/table-of-contents-and-back-to-top-anchor-behaviors.js +20 -5
  5. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206/javascript/table-of-contents-and-back-to-top-anchor-behaviors.min.js +1 -1
  6. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown--firefox-addon.default.css +1973 -107
  7. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown--typora.default.css +1973 -107
  8. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown--vscode.default.min.css +1 -1
  9. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--no-toc.css +1973 -107
  10. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--no-toc.min.css +1 -1
  11. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--with-toc.css +2001 -149
  12. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--with-toc.min.css +1 -1
  13. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--wrapped--no-toc.css +1973 -107
  14. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--wrapped--no-toc.min.css +1 -1
  15. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--wrapped--with-toc.css +2001 -149
  16. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default--wrapped--with-toc.min.css +1 -1
  17. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--no-toc.css +1983 -118
  18. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--no-toc.min.css +1 -1
  19. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--with-toc.css +2011 -160
  20. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--with-toc.min.css +1 -1
  21. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--wrapped--no-toc.css +1983 -118
  22. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--wrapped--no-toc.min.css +1 -1
  23. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--wrapped--with-toc.css +2011 -160
  24. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.default-dark--wrapped--with-toc.min.css +1 -1
  25. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--no-toc.css +1973 -107
  26. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--no-toc.min.css +1 -1
  27. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--with-toc.css +2001 -149
  28. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--with-toc.min.css +1 -1
  29. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--wrapped--no-toc.css +1973 -107
  30. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--wrapped--no-toc.min.css +1 -1
  31. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--wrapped--with-toc.css +2001 -149
  32. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/226/207/347/253/240/346/216/222/347/211/210/344/270/216/351/205/215/350/211/262/346/226/271/346/241/210/351/233/206//345/261/202/345/217/240/346/240/267/345/274/217/350/241/250/wulechuan-styles-for-html-via-markdown.generic-default-light--atom-one-dark--wrapped--with-toc.min.css +1 -1
  33. package//346/272/220/344/273/243/347/240/201//345/217/221/345/270/203/347/232/204/346/272/220/344/273/243/347/240/201//346/234/254/345/267/245/345/205/267/344/275/234/344/270/272/345/205/266/344/273/226-javascript-/345/267/245/345/205/267/344/271/213/344/276/235/350/265/226/346/250/241/345/235/227/346/227/266/347/232/204/344/273/243/347/240/201/index.d.ts +35 -35
package/ReadMe.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  ## Multilingual Editions of this Article
12
12
 
13
- - [English version of this ReadMe](./文档集集/说明书/en-US/ReadMe.md)
13
+ - [English edition of this ReadMe](./文档集集/说明书/en-US/ReadMe.md)
14
14
 
15
15
 
16
16
 
@@ -31,15 +31,15 @@
31
31
 
32
32
  ## 此物何用
33
33
 
34
- 本工具用于构建一组层叠样式表(即 CSS )文件,本工具亦提供了一组现成的层叠样式表文件。凡这些样式表,均可用于美化采用超文本标记语言(即 HTML )格式存储的文章。且不必同时取用多个样式表文件,仅取其一足矣。
34
+ 本工具用于构建一组层叠样式表(即 CSS )文件。本工具亦提供了一组现成的层叠样式表文件。凡这些样式表,均可用于美化采用超文本标记语言(即 HTML)格式的文章。且不必同时取用多个样式表文件,仅取其一足矣。
35
35
 
36
36
  本品还额外提供了一个很小巧的 JavaScript 接口,使得其它 JavaScript 工具包亦可较方便地以程序化之方式使用这些层叠样式表( CSS )文件之内容。详见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》一节。
37
37
 
38
- **于开发者而言,本品亦是一个构件工具,用于相对方便地构建出新的 CSS 文件,以便诸君自定义 HTML 文章之样式。**
38
+ > 不妨强调,于开发者而言,本品可以是一个样式表构建工具,用以相对方便地构建出新的符合特定喜欢或需求的 CSS 文件。
39
39
 
40
40
 
41
41
 
42
- ## 文档集章节
42
+ ## 文档集
43
43
 
44
44
  > 以下章节均存在于单独的文件中,并非本文章之部分。
45
45
 
@@ -54,20 +54,53 @@
54
54
 
55
55
  ## 应用效果示例
56
56
 
57
- 一图胜千言。以下各图展示了一篇应用了本工具之默认 CSS 样式的文章之样貌。
57
+ 本工具配备了两篇范文,汉语一篇,英语一篇,均套用了本工具之默认样式,以示效果。
58
58
 
59
- > 以下各图较大,文件大小在 **百万字节** 级别。
59
+ 一图胜千言。以下为范文之截图。
60
+
61
+ > 以下各图较大,文件大小在**百万字节**级别。若网络不佳不便阅图,亦可下载 HTML 文件观察其面貌。
62
+ >
63
+ > HTML 范文
64
+ >
65
+ > - 《[HTML 范文(汉语版,浅色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.zh-hans-cn.default-light-colored-theme.html)》
66
+ > - 《[HTML 范文(汉语版,深色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.zh-hans-cn.default-dark-colored-theme.html)》
67
+ > - 《[HTML 范文(英语版,浅色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.en-us.default-light-colored-theme.html)》
68
+ > - 《[HTML 范文(英语版,深色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.en-us.default-dark-colored-theme.html)》
69
+
70
+
71
+ ### 范文富有特色的大幅截图
72
+
73
+
74
+ 1. 应用了**默认浅色主题**的范文之截图
75
+
76
+ - 《示例:简体中文范文配默认**浅色**主题,在宽大尺寸浏览器中的效果(目录已收叠)》
77
+
78
+
79
+ - [由(本说明书的)解析程序自动决定之存放地点的版本](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/示例:简体中文范文配默认浅色主题,1-在宽大尺寸浏览器中的效果(目录已收叠).png)
80
+
81
+ - [存放在 Gitee 中的版本,便于中国大陆地区查阅](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/blob/master/%E6%96%87%E6%A1%A3%E9%9B%86/%E6%96%87%E7%AB%A0%E6%8E%92%E7%89%88%E4%B8%8E%E9%85%8D%E8%89%B2%E6%95%88%E6%9E%9C%E7%A4%BA%E4%BE%8B%E9%9B%86/%E4%BB%A5-html-%E6%A0%BC%E5%BC%8F%E6%B8%B2%E6%9F%93%E5%A5%BD%E7%9A%84%E6%96%87%E7%AB%A0%E6%88%90%E5%93%81/%E5%90%84%E6%96%87%E7%AB%A0%E6%9C%80%E7%BB%88%E5%91%88%E7%8E%B0%E6%95%88%E6%9E%9C%E4%B9%8B%E6%88%AA%E5%9B%BE/%E7%A4%BA%E4%BE%8B%EF%BC%9A%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87%E8%8C%83%E6%96%87%E9%85%8D%E9%BB%98%E8%AE%A4%E6%B5%85%E8%89%B2%E4%B8%BB%E9%A2%98%EF%BC%8C1-%E5%9C%A8%E5%AE%BD%E5%A4%A7%E5%B0%BA%E5%AF%B8%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E7%9A%84%E6%95%88%E6%9E%9C%EF%BC%88%E7%9B%AE%E5%BD%95%E5%B7%B2%E6%94%B6%E5%8F%A0%EF%BC%89.png)
82
+
83
+
84
+ - 《示例:In default **light-colored** theme, in a wide window, with toc collapsed》。
85
+
86
+ - [由(本说明书的)解析程序自动决定之存放地点的版本](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/example_en-US_default-light-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
87
+
88
+ - [存放在 Gitee 中的版本,便于中国大陆地区查阅](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/blob/master/%E6%96%87%E6%A1%A3%E9%9B%86/%E6%96%87%E7%AB%A0%E6%8E%92%E7%89%88%E4%B8%8E%E9%85%8D%E8%89%B2%E6%95%88%E6%9E%9C%E7%A4%BA%E4%BE%8B%E9%9B%86/%E4%BB%A5-html-%E6%A0%BC%E5%BC%8F%E6%B8%B2%E6%9F%93%E5%A5%BD%E7%9A%84%E6%96%87%E7%AB%A0%E6%88%90%E5%93%81/%E5%90%84%E6%96%87%E7%AB%A0%E6%9C%80%E7%BB%88%E5%91%88%E7%8E%B0%E6%95%88%E6%9E%9C%E4%B9%8B%E6%88%AA%E5%9B%BE/example_en-US_default-light-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
60
89
 
61
- ### 应用默认浅色主题的范文截图
62
90
 
63
- - [示例:简体中文范文配默认浅色主题,在宽大尺寸浏览器中的效果(目录已收叠)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/示例:简体中文范文配默认浅色主题,1-在宽大尺寸浏览器中的效果(目录已收叠).png)
64
- - [Snapshot: In default light-colored theme, in a wide window, with toc collapsed](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/example_en-US_default-light-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
91
+ 1. 应用了**默认深色主题**的范文之截图
65
92
 
93
+ - 《示例:简体中文范文配默认**深色**主题,在宽大尺寸浏览器中的效果(目录已收叠)》
66
94
 
67
- ### 应用默认深色主题的范文截图
95
+ - [由(本说明书的)解析程序自动决定之存放地点的版本](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/示例:简体中文范文配默认深色主题,1-在宽大尺寸浏览器中的效果(目录已收叠).png)
68
96
 
69
- - [示例:简体中文范文配默认深色主题,在宽大尺寸浏览器中的效果(目录已收叠)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/示例:简体中文范文配默认深色主题,1-在宽大尺寸浏览器中的效果(目录已收叠).png)
70
- - [Snapshot: In default dark-colored theme, in a wide window, with toc collapsed](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/example_en-US_default-dark-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
97
+ - [存放在 Gitee 中的版本,便于中国大陆地区查阅](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/blob/master/%E6%96%87%E6%A1%A3%E9%9B%86/%E6%96%87%E7%AB%A0%E6%8E%92%E7%89%88%E4%B8%8E%E9%85%8D%E8%89%B2%E6%95%88%E6%9E%9C%E7%A4%BA%E4%BE%8B%E9%9B%86/%E4%BB%A5-html-%E6%A0%BC%E5%BC%8F%E6%B8%B2%E6%9F%93%E5%A5%BD%E7%9A%84%E6%96%87%E7%AB%A0%E6%88%90%E5%93%81/%E5%90%84%E6%96%87%E7%AB%A0%E6%9C%80%E7%BB%88%E5%91%88%E7%8E%B0%E6%95%88%E6%9E%9C%E4%B9%8B%E6%88%AA%E5%9B%BE/%E7%A4%BA%E4%BE%8B%EF%BC%9A%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87%E8%8C%83%E6%96%87%E9%85%8D%E9%BB%98%E8%AE%A4%E6%B7%B1%E8%89%B2%E4%B8%BB%E9%A2%98%EF%BC%8C1-%E5%9C%A8%E5%AE%BD%E5%A4%A7%E5%B0%BA%E5%AF%B8%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E7%9A%84%E6%95%88%E6%9E%9C%EF%BC%88%E7%9B%AE%E5%BD%95%E5%B7%B2%E6%94%B6%E5%8F%A0%EF%BC%89.png)
98
+
99
+ - 《示例:In default **dark-colored** theme, in a wide window, with toc collapsed》。
100
+
101
+ - [由(本说明书的)解析程序自动决定之存放地点的版本](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/各文章最终呈现效果之截图/example_en-US_default-dark-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
102
+
103
+ - [存放在 Gitee 中的版本,便于中国大陆地区查阅](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/blob/master/%E6%96%87%E6%A1%A3%E9%9B%86/%E6%96%87%E7%AB%A0%E6%8E%92%E7%89%88%E4%B8%8E%E9%85%8D%E8%89%B2%E6%95%88%E6%9E%9C%E7%A4%BA%E4%BE%8B%E9%9B%86/%E4%BB%A5-html-%E6%A0%BC%E5%BC%8F%E6%B8%B2%E6%9F%93%E5%A5%BD%E7%9A%84%E6%96%87%E7%AB%A0%E6%88%90%E5%93%81/%E5%90%84%E6%96%87%E7%AB%A0%E6%9C%80%E7%BB%88%E5%91%88%E7%8E%B0%E6%95%88%E6%9E%9C%E4%B9%8B%E6%88%AA%E5%9B%BE/example_en-US_default-dark-colored-theme_1-in-a-wide-window_with-toc-collapsed.png)
71
104
 
72
105
 
73
106
  ### 范文的所有截图
@@ -75,9 +108,9 @@
75
108
  两篇范文之截图不止于上文中提及的四幅。更多图例,见:
76
109
 
77
110
  - 《[应用效果示例(汉语版)](./文档集/说明书/汉语/关于文章排版与配色效果示例集的说明.md)》
78
- - 《[Application Examples (en-US)](./文档集/说明书/en-US/application-examples.md)》
111
+ - 《[应用效果示例(英语版)](./文档集/说明书/en-US/application-examples.md)》
79
112
 
80
- 另附《[示范文章之截图之制作指南](./文档集/说明书/汉语/示范文章之截图之制作指南.md)
113
+ 另,日常制作网页截图是很简单的事情,但本工具之范文篇幅巨大,为其截图确须一定经验和技巧。见《[示范文章之截图之制作指南](./文档集/说明书/汉语/示范文章之截图之制作指南.md)》。
81
114
 
82
115
 
83
116
 
@@ -94,23 +127,29 @@
94
127
 
95
128
  ## 使用说明
96
129
 
97
- - 本工具仅提供一组层叠样式表(CSS)文件,及配套的 JavaScript 文件(目前仅一个这样的 JavaScript 文件)。不难理解,本工具**并非**用于直接将 Markdown 文件转换为对应的 HTML 文件。本工具假定诸君另有方法,将 Markdown 内容转换成 HTML 内容,仅仅是希望借助本工具提供之 CSS 对 HTML 做进一步的排版美化。于此种情形,用法再简单不过——**自行取用**。
130
+ ### 使用须知
131
+
132
+ - 本工具提供的主体内容仅为一组层叠样式表(CSS)文件,及配套的 JavaScript 文件(目前仅一个这样的 JavaScript 文件)。
133
+
134
+ 换言之,本工具**并不能**将 Markdown 文件转换为对应的 HTML 文件。本工具假定诸君各自另有办法将 Markdown 内容转换成 HTML 内容,诸君采用本工具仅仅是希望取其中的 CSS 对诸君的 HTML 做进一步的排版美化。于此种情形,用法再简单不过——**自行取用那些 CSS 文件**即可。
98
135
 
99
136
 
100
137
  所谓自行取用,即是说诸君在本项目之发布文件夹中自行找到中意之 CSS 文件(及配套 JavaScript 文件),采用之。且于单一 HTML 文件,在本工具提供之所有 CSS 文件取用其任一足矣,不必取用多者。
101
138
 
102
- 又,取用本工具提供之 CSS 、 JavaScript 文件之内容时,若每每人为复制、粘贴,未免麻烦,且无从实现批量运用、自动化运用。在面对批量运用或自动化运用之要求时,开发人员当然希望能编写程序调集所需资源加以运用。巧了,本工具确实提供了专门的 JavaScript 编程接口,以 **JavaScript 字符串** 之形式提供各 CSS 、 JavaScript 文件之内容。
139
+ 又,取用本工具提供之 CSS 、 JavaScript 文件之内容时,若每每人为复制、粘贴,未免麻烦。尤其是在面对批量运用或自动化运用之要求时,开发人员当然希望能编写程序调集所需资源加以运用。刚巧本工具确实提供了专门的 JavaScript 编程接口,以 **JavaScript 文本(string)** 之形式提供各 CSS 、 JavaScript 文件之内容。见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》。
103
140
 
104
141
 
105
- > 诸君当然可以自行直接取用本工具中之 CSS 文件,或自行调用本工具之 JavaScript 接口。由此二种途径均可以在你构建 HTML 内容时,利用我的这些 CSS 来美化 HTML 内容。然此二种做法均并非易如反掌,更不能一蹴而就。即,要么须费些功夫,要么须专门学习并积累技术经验。
142
+ > 不过,不论是手工直接取用本工具中之 CSS 文件,还是调用本工具之 JavaScript 接口取用这些 CSS 文件,都没有解决一部分读者的困难:你们的初衷是要将手头的一些 Markdown 文件转换成 HTML 文件,而采用我提供的这些 CSS 只是锦上添花式的要求。临用之际,单单一个 CSS 文件显然不解燃眉之急。
143
+ >
144
+ > 此种情形下,诸君首先需要的是一款可以进行文件格式转换之工具,而后才考虑如何将本工具提供之 CSS 嵌入 HTML 之中。
106
145
  >
107
- > 如若诸君之初衷是要将手头的一些 Markdown 文件转换成 HTML 文件,临用之际单单一个 CSS 文件显然不解诸君燃眉之急。诸君首先需要的是一款可以进行文件格式转换之工具,而后才考虑如何将本工具提供之 CSS 嵌入 HTML 之中,可是?如此,则诸君面临新的问题,即要么无暇自行搭建工具链来将 Markdown 转换成 HTML,要么干脆不知所措。于此种情形,鄙人毛遂自荐,愿助诸君一臂之力!鄙人另行自创有三个 NPM 包,专用于轻松、快速地从 Markdown 内容构建对应之 HTML 内容。且三者均默认采用本工具发布之 CSS 之内容(和配套 JavaScript 内容)。我在[本说明书之尾部](#相关推广)亦对此三款软件包做了推广。阁下无需另起炉灶了!唯愿三者之任一能对诸君有所裨益!
146
+ > 那么新的问题来了,我能不能**顺便**推荐一款从 MarkDown 文件至 HTML 文件的转换工具呢?当然!鄙人毛遂自荐,愿助诸君一臂之力!鄙人另行自创有三个 NPM 包,专用于轻松、快速地从 Markdown 内容构建对应之 HTML 内容。且三者均默认采用本工具发布之 CSS 之内容(及配套 JavaScript 内容)。我在[本说明书之尾部](#相关推广)亦对此三款软件包做了推广。诸君无需另起炉灶了!唯愿三者之任一能对君有所裨益!
108
147
 
109
148
 
110
149
  - 如果阁下取用本工具中之 CSS 主题文件另有意图,即与将 Markdown 转换至 HTML 之事毫无干系,那么或许更应该了解如何编写程序调集所需的由本工具提供之 CSS 资源加以运用。见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》。
111
150
 
112
151
 
113
- ### 在何处手工取用本工具所生成的文件
152
+ ### 手工取用本工具的文件
114
153
 
115
154
  #### 取用 CSS 文件
116
155
 
@@ -127,11 +166,13 @@
127
166
 
128
167
  在面对批量运用或自动化运用之要求时,开发人员当然希望能编写程序调集所需资源加以运用。本工具确实提供了专门的 JavaScript 编程接口,以 JavaScript 字符串数据的形式提供各 CSS 、 JavaScript 文件之内容。
129
168
 
130
- > 本工具还额外提供了编程接口配套的 TypeScript 类型定义( `index.d.ts` )。
169
+ > 本工具还额外提供了编程接口配套的 TypeScript 类型定义:
170
+ >
171
+ > `源代码/发布的源代码/本工具作为其他-javascript-工具之依赖模块时的代码/index.d.ts`
131
172
 
132
- 以程序化之方式调用本工具之方法见下例。
173
+ #### 以程序化之方式取用本工具提供之内容之示范代码
133
174
 
134
- > 下例中代码之主体节选自《`测试集/用于测试本项目之-javascript-接口的测试代码集.js`》。
175
+ > 下例中代码之主体节选自本项目的<br>《`测试集/用于测试本项目之-javascript-接口的测试代码集.js`》。
135
176
 
136
177
  ```js
137
178
  const {
@@ -229,12 +270,12 @@ const 这还是目前唯一的Javascript文件之内容全文 = 获取某一已
229
270
  其 TypeScript 类型定义如下:
230
271
 
231
272
  ```typescript
232
- declare type 吴乐川用于美化文章的层叠样式表集之数据类型之文件简易描述项 = {
273
+ declare type 范_吴乐川用于美化文章的层叠样式表集_文件简易描述项 = {
233
274
  文件名称: string;
234
275
  文件之相对路径: string;
235
276
  文件之绝对路径: string;
236
277
  文件内容全文: string;
237
-
278
+
238
279
  // 以下为陈旧的采用外国字命名之诸接口。
239
280
 
240
281
  fileName: string;
@@ -244,55 +285,60 @@ declare type 吴乐川用于美化文章的层叠样式表集之数据类型之
244
285
  };
245
286
  ```
246
287
 
247
- #### 获取本工具发布之各排版与配色方案公用的、且目前唯一的 JavaScript 文件
288
+ #### 获取本工具发布之各排版与配色方案公用的(且目前唯一的) JavaScript 文件
248
289
 
249
- **须知本工具提供两类用途不同之 JavaScript 。**
290
+ 首先,**须知本工具提供两类用途不同之 JavaScript 。**
250
291
 
251
- 1. 一类是用于注入 HTML 文章以控制 HTML 文章之【纲要】的。
252
- 2. 另一类是本工具提供的程序化接口,它并不直接作用于你的任何 HTML,而仅仅是对外提供本 NPM 包之 CSS 以及第一类 JavaScript 。
292
+ 1. 一类是用于注入 HTML 文章以控制 HTML 文章之【纲要】的。
293
+ 1. 另一类是本工具提供的程序化接口,它并不直接作用于你的任何 HTML,而仅仅是对外提供本 NPM 包之 CSS 以及第一类 JavaScript 。
253
294
 
254
- 为方便指代,不妨称第一类 JavaScript 为所谓“**文章行为之 js** ”,而称第二类 JavaScript 为所谓“**本工具接口之 js** ”,简称“**接口 js** ”。
295
+ 为方便指代,不妨:
255
296
 
256
- 又,获取本工具发布之各色【文章排版与配色方案】公用的、且目前唯一的“文章行为之 js”时,**允许对该文件之内容进行些许临时定制**。故而,最终获得的内容字符串有异于本工具存储的原始版本。
297
+ 1. 称第一类 JavaScript 为所谓“**文章行为之 js** ”,简称“**文章 js**”。目前恰好仅有一个这样的 js 文件。它为本工具发布之各色【文章排版与配色方案】所公用。
298
+ 1. 而称第二类 JavaScript 为所谓“**本工具接口之 js** ”,简称“**接口 js** ”。
257
299
 
258
- 简而言之,你调用本工具的“接口 js ”中的某接口函数时,可以在接口函数某一项参数传入【配置项集】,以对“文章行为之 js ”之内容做些许定制。
300
+ 又,借助“**接口 js**”获取“**文章 js**”之内容时,“接口 js”还**允许对“文章 js”之内容进行些许临时定制**。故而,最终获得的内容字符串有异于本工具存储的原始版本。换言之,你调用本工具的“**接口 js**”中的某接口函数时,可在接口函数的某一项参数传入【配置项集】,以对 “**文章 js**”之内容做些许改变。
259
301
 
260
302
  > 有两个不同的接口函数各自可以接受该配置项集,但形参位置不同。
261
- > 1. 一个函数是 `总接口.获取某一已发布之文件之完整内容字符串` ,它在第 3 形参接受上述配置项集,
262
- > 2. 另一个函数是 `总接口.获取本项目官方选定之所谓默认Javascript之完整内容字符串` ,它在第 2 形参接受上述配置项集。
303
+ > 1. 第一个函数是 `总接口.获取某一已发布之文件之完整内容字符串` ,它在**第 3 形参**接受上述【配置项集】。
304
+ > 1. 第二个函数是 `总接口.获取本项目官方选定之所谓默认Javascript之完整内容字符串` ,它在**第 2 形参**接受上述【配置项集】。
263
305
 
264
306
  上述【配置项集】之 TypeScript 类型定义如下:
265
307
 
266
308
  ```typescript
267
- declare type 吴乐川用于美化文章的层叠样式表集之数据类型之拾取默认Javascript文件之函数之第二参数 = {
309
+ declare type 范_吴乐川用于美化文章的层叠样式表集_拾取默认Javascript文件之函数之第二参数 = {
268
310
  /**
269
311
  * 注意:
270
312
  * 【展开文章纲要列表面板】与【展开文章纲要列表的某一条目】不是一回事。
271
313
  */
272
314
 
273
315
  为求文章纲要列表简洁明了故意仅显示两层条目以至于较深层级条目形同作废?: boolean;
274
- 浏览器打开HTML文章最初之时文章纲要列表中凡层级深于该值之条目均应收叠?: boolean;
316
+ 浏览器打开HTML文章最初之时文章纲要列表中凡层级深于该值之条目均应收叠?: number;
275
317
  浏览器打开HTML文章最初之时若浏览器窗口足够宽大则直接展开文章纲要列表之面板?: boolean;
276
-
318
+
277
319
  // 以下为陈旧的采用外国字命名之诸接口。
278
320
 
279
321
  shouldShowOnlyTwoLevelsOfTOCItemsAtMost?: boolean;
280
- atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan?: boolean;
322
+ atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan?: number;
281
323
  atBeginingShouldExpandTOCWhenWindowIsWideEnough?: boolean;
282
324
  };
283
325
  ```
284
326
 
285
327
 
328
+ #### 接口重大变更记录
329
+
330
+ - 2022 年 04 月 27 日,本工具之版本从 `v7.4.2` 升迁至 `v7.5.0` 时, JavaScript 代码没有任何变动。**但针对 TypeScript 的类型定义全部更名。** 由原来的以“`类型定义之`”开头,统一变更为以“`范_`”开头。故而有此版本变动。
331
+
286
332
  -----
287
333
 
288
334
 
289
335
  ## 相关推广
290
336
 
291
- 鄙人另有一款 NPM 包,名为“[@wulechuan/generate-html-via-markdown](https://www.npmjs.com/package/@wulechuan/generate-html-via-markdown)”。为便于指称,暂将其叫做“**甲**”。调用甲之接口,可将传入甲的 Markdown 字符串转换成 HTML 字符串。此时,甲默认会采用本工具提供的 CSS 文件来装饰甲自身产生的 HTML 之内容。
337
+ 鄙人另有一款 NPM 包,名为“[@wulechuan/generate-html-via-markdown](https://www.npmjs.com/package/@wulechuan/generate-html-via-markdown)”。为便于指称,不妨暂称“**甲**”。调用甲之接口,可将传入该接口的 Markdown 字符串转换成 HTML 字符串。此时,甲默认会采用本工具提供的 CSS 文件来装饰甲自身产生的 HTML 之内容。
292
338
 
293
339
  鄙人还有一款 NPM 包,名为“[@wulechuan/gulp-markdown-to-html](https://www.npmjs.com/package/@wulechuan/gulp-markdown-to-html)”,且作“**乙**”。乙恰如甲的一个包覆层,使得甲中之功能特性可以适配 [Gulpjs](https://gulpjs.com) 任务流水线。
294
340
 
295
- 鄙人还有一款 NPM 包,名为“[@wulechuan/markdown-to-html-via-cli](https://www.npmjs.com/package/@wulechuan/markdown-to-html-via-cli)”,且作“**丙**”。丙恰如甲的另一个包覆层,使得任何人在安装丙后(**无须另行安装甲**),即可在命令行环境轻松使用甲之功能,实现从文件到文件的**批量转换**。且丙设计有多种命令行参数,以便定制输出之 HTML 之具体细节。且诸君毋需担心命令行参数记忆负担过重之问题,仅需“`--help`”一招,即可解君之忧。
341
+ 鄙人还有一款 NPM 包,名为“[@wulechuan/markdown-to-html-via-cli](https://www.npmjs.com/package/@wulechuan/markdown-to-html-via-cli)”,且作“**丙**”。丙恰如甲的另一个包覆层,使得任何人在安装丙后(**无须另行安装甲**),即可在命令行环境轻松使用甲之功能,实现从文件到文件的**批量转换**。且丙设计有多种命令行参数,以便定制输出之 HTML 之具体细节。诸君毋需担心命令行参数记忆负担过重之问题,仅需“`--help`”一招,即可解君之忧。
296
342
 
297
343
 
298
344
 
@@ -300,13 +346,7 @@ declare type 吴乐川用于美化文章的层叠样式表集之数据类型之
300
346
 
301
347
  ## 未来计划
302
348
 
303
- - 避免使用 `rem` 作为层叠样式表的长度单位,而改用 `em` ,特别是要避免输出的层叠样式表对 `rem` 进行配置。理由是倘若本工具产生之层叠样式表如果系用作美化某复杂 Web 应用之局部之文章,本工具提供的层叠样式表不应该粗暴篡改 `rem` 之取值。
304
-
305
- > 该项工作已经在进行,全靠业余之投入,截止 2021-03-13 仍未完成。
306
-
307
- - 考虑引入更多的 Stylus 变量,来控制主题。但我有疑虑。过分工程化可能反而导致源代码难以理解,不便定制。
308
-
309
- - 覆盖 Typora 中“纲要列表”的原有样式?
349
+ 暂无。
310
350
 
311
351
 
312
352
  ## 版本 6 及更旧版本之源代码业已删除
@@ -322,7 +362,7 @@ declare type 吴乐川用于美化文章的层叠样式表集之数据类型之
322
362
 
323
363
  WTFPL
324
364
 
325
- > 注意:
365
+ > ### 注意
326
366
  >
327
367
  > 我未研究过许可证的约束。因此姑且声明为 WTFPL 类型。但实际上该许可证类型可能与我采用的开源模块有冲突。
328
368
 
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@wulechuan/css-stylus-markdown-themes",
3
3
  "author": "吴乐川 <wulechuan@live.com>",
4
4
  "license": "WTFPL",
5
- "version": "7.4.2",
5
+ "version": "7.6.0",
6
6
  "description": "此为吴乐川的《HTML 文章排版与配色之方案集与相关制作工具》。本工具可用于构建一组层叠样式表(即 CSS )文件,本工具亦提供了一组现成的层叠样式表文件。凡这些样式表,均可用于美化采用超文本标记语言(即 HTML )格式存储的文章。且不必同时取用多个样式表文件,仅取其一足矣。",
7
7
  "directories": {
8
8
  "source": "源代码/原始的源代码",
@@ -34,6 +34,36 @@
34
34
  "每当制作集得之版本之前": "npm i && npm test",
35
35
  "prepublishOnly": "npm i && npm test"
36
36
  },
37
+ "dependencies": {
38
+ "globby": "^11.1.0"
39
+ },
40
+ "devDependencies": {
41
+ "@wulechuan/cli-scripts--git-push": "^2.0.2",
42
+ "@wulechuan/generate-html-via-markdown": "^3.2.1",
43
+ "@wulechuan/gulp-classical-task-cycle": "^0.3.0",
44
+ "chalk": "^4.1.2",
45
+ "cssnano": "^5.1.7",
46
+ "del": "^6.0.0",
47
+ "eslint": "^8.14.0",
48
+ "esm": "^3.2.25",
49
+ "fs-extra": "^10.1.0",
50
+ "gulp": "^4.0.2",
51
+ "gulp-concat": "^2.6.1",
52
+ "gulp-pipe": "^1.0.4",
53
+ "gulp-postcss": "^9.0.1",
54
+ "gulp-rename": "^2.0.0",
55
+ "gulp-stylus": "^2.7.1",
56
+ "gulp-terser": "^2.1.0",
57
+ "postcss": "^8.4.13"
58
+ },
59
+ "homepage": "https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns#readme",
60
+ "repository": {
61
+ "type": "git",
62
+ "url": "git+https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git"
63
+ },
64
+ "bugs": {
65
+ "url": "https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/issues"
66
+ },
37
67
  "keywords": [
38
68
  "markdown",
39
69
  "html",
@@ -64,35 +94,5 @@
64
94
  "stylus",
65
95
  "cascading-style-sheet",
66
96
  "cascading-style-sheets"
67
- ],
68
- "homepage": "https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns#readme",
69
- "repository": {
70
- "type": "git",
71
- "url": "git+https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git"
72
- },
73
- "bugs": {
74
- "url": "https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns/issues"
75
- },
76
- "dependencies": {
77
- "globby": "^11.1.0"
78
- },
79
- "devDependencies": {
80
- "@wulechuan/cli-scripts--git-push": "^2.0.1",
81
- "@wulechuan/generate-html-via-markdown": "^3.1.1",
82
- "@wulechuan/gulp-classical-task-cycle": "^0.3.0",
83
- "chalk": "^4.1.2",
84
- "cssnano": "^5.1.7",
85
- "del": "^6.0.0",
86
- "eslint": "^8.14.0",
87
- "esm": "^3.2.25",
88
- "fs-extra": "^10.1.0",
89
- "gulp": "^4.0.2",
90
- "gulp-concat": "^2.6.1",
91
- "gulp-pipe": "^1.0.4",
92
- "gulp-postcss": "^9.0.1",
93
- "gulp-rename": "^2.0.0",
94
- "gulp-stylus": "^2.7.1",
95
- "gulp-terser": "^2.1.0",
96
- "postcss": "^8.4.12"
97
- }
97
+ ]
98
98
  }
@@ -1,4 +1,4 @@
1
- # 吴乐川的文章默认样式的示例
1
+ # 吴乐川的文章默认样式的示例<br><small>——样式均采用 stylus 语言编写</small>
2
2
 
3
3
  <p class="document-author">作者:吴乐川</p>
4
4
 
@@ -64,12 +64,49 @@
64
64
 
65
65
  再来看看行文中的【代码词汇】、【专有名词】和【术语】:例如`grep`、`孙行者`和`中央处理单元`。又如`querySelector`和`querySelectorAll`早已取代了老式的`getElementsById`等函数。术语框中的多个连续空格也应得到保留,例如`这后面有四个空格 这前面有四个空格`。
66
66
 
67
- 术语与超链接还可组合为一体。新中国的建立和成长离不开一群功勋卓著的科学家们。例如伟大的、富有爱国主义精神和民族自信的[`钱学森`](https://baike.baidu.com/item/%E9%92%B1%E5%AD%A6%E6%A3%AE/26105),他是**中国科学院资深院士**、**中国工程院资深院士**。
67
+ 术语与超链接还可组合为一体。甚至与着重、斜体等效果进行组合。新中国的建立和成长离不开一群功勋卓著的科学家们。例如伟大的、富有爱国主义精神和民族自信的[`钱学森`](https://baike.baidu.com/item/%E9%92%B1%E5%AD%A6%E6%A3%AE/26105),**他是 `中国科学院资深院士`、 `中国工程院资深院士`。** *他提出的`钱学森弹道`至今(2022年4月)仍是 __无法拦截的__* !如今,我们在科技领域面临的两大钳制是 _**粮食`育种`技术**_ 和 **_高性能`光刻机`制造技术_** 。
68
+
68
69
 
69
70
  计算机键盘快捷键,其视觉样式如是:<kbd>Ctrl</kbd>+<kbd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</kbd>;又例:如今,<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>s</kbd>这一组合键早已广泛用于各种现代计算机软件中,代表(将工作内容或文件)`另存为`(壹文件)之功能。
70
71
 
71
- 还有些内容会故意“杠掉”,即被中划线划去,表示此内容不正确,不应采纳,应作废。例如:~~地球是平的~~。
72
+ 还有些内容会故意“杠掉”,即被中划线划去,表示此内容不正确,不应采纳,应作废。例如:~~地球是平的~~。术语或专有名词也可以标记为废弃,例:非必要不用舶来词。不应称 ~~`车厘子`~~ ,而应称 `进口樱桃` 。不应称 ~~`芝士`~~ 、 ~~`起司`~~ ,而应称 `奶酪` 。还有两个作废的超链接: ~~[`SOFTIMAGE.com`](http://softimage.com/)~~ 和 ~~[`假设已经删除的章节的文内链接`](#)~~ 。
73
+
74
+ #### 复杂的样式组合
75
+
76
+
77
+ 再看几个“近乎终极”的组合效果——具有着重斜体强调的带有超链接的术语。为什么不止一个?因为 HTML 标签的嵌套组合是很灵活的,偏偏 MarkDown 的语法又允许制造出这几种组合。如下。
78
+
79
+ - 着重符号(即星号与下划线)包裹在方括号外的效果:我们中国有 **_了不起的民营企业[`华为`](https://consumer.huawei.com/cn/)公司_** 或我们中国有 _**了不起的民营企业[`福耀玻璃`](https://www.fuyaogroup.com/)公司**_。
80
+
81
+ 上例的 MarkDown 源码:
82
+
83
+ ```md
84
+ **_了不起的民营企业[`华为`](https://consumer.huawei.com/cn/)公司_**
85
+ ```
86
+
87
+ ```md
88
+ _**了不起的民营企业[`福耀玻璃`](https://www.fuyaogroup.com/)公司**_
89
+ ```
90
+
91
+ - 着重符号(即星号与下划线)在方括号内:我们中国有 [**_了不起的民营企业`华为`公司_**](https://consumer.huawei.com/cn/) 或我们中国有 [_**了不起的民营企业`福耀玻璃`公司**_](https://www.fuyaogroup.com/)。
92
+
93
+ 上例的 MarkDown 源码:
94
+
95
+ ```md
96
+ [**_了不起的民营企业_`华为`公司_**](https://consumer.huawei.com/cn/)
97
+ ```
98
+
99
+ ```md
100
+ [_**_了不起的民营企业`福耀玻璃`公司**_](https://www.fuyaogroup.com/)
101
+ ```
102
+
103
+ 不难看出,我的策略是任凭它如何组合,我总是令它们的视觉效果一致。因为我认为尽管文章作者处于任何原因采用了不一致的书写方式,但他意图达到的目的是相同的。
104
+
105
+ 你以为这就完了?非也!倘若再加上删除线呢?那就更复杂了!例如:每每危难时刻,不论哪一个国家或地区,总有昧着良心的人在 ~~[**_`发国难财`_**](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820)~~ 、 [~~**_`发国难财`_**~~](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820) 、 [**~~_`发国难财`_~~**](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820) 或 [**_~~`发国难财`~~_**](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820) ,以及 ~~**_[`发国难财`](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820)_**~~ 、 **~~_[`发国难财`](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820)_~~** 或 **_~~[`发国难财`](https://baike.baidu.com/item/%E5%8F%91%E5%9B%BD%E9%9A%BE%E8%B4%A2/15514820)~~_** 。这些人终将受到历史的审判!
106
+
107
+ 去掉超链接再试试:中国南宋时期有一个十恶不赦的奸佞宰相,名唤 ~~__*`秦桧`*__~~ 、 __~~*`秦桧`*~~__ 、 __*~~`秦桧`~~*__ 或 *__~~`秦桧`~~__* ,他陷害了*爱国将领 [`岳飞`](https://baike.baidu.com/item/%E5%B2%B3%E9%A3%9E/127844)* 。
72
108
 
109
+ > 注:排列组合的可能性太多,示例不一而足。
73
110
 
74
111
  #### 多级列表
75
112
 
@@ -112,7 +149,7 @@
112
149
  - 壬:巡海夜叉
113
150
  - 癸:长生云
114
151
 
115
- 6. 第 1 级第 6
152
+ 6. 第 1 级第 6 项。“`81192`,收到请返航。”
116
153
 
117
154
 
118
155
  ### 多级标题(这是 h3)
@@ -302,7 +339,7 @@ CSS Object Model 是一组允许用 JavaScript 操纵 CSS 的 API。 它是继 D
302
339
  > `circumference` [sər&apos;kʌmf(ə)rəns] <i>n.</i> 圆周长
303
340
 
304
341
  - <details open>
305
- <summary>折叠内容中的代码块1</summary>
342
+ <summary>在折叠内容块中的代码块1</summary>
306
343
 
307
344
  ```js
308
345
  var age = +prompt('你多大了?');
@@ -313,12 +350,12 @@ CSS Object Model 是一组允许用 JavaScript 操纵 CSS 的 API。 它是继 D
313
350
 
314
351
 
315
352
 
316
- #### 叠内容中的代码块
353
+ #### 在折叠内容块中的代码块
317
354
 
318
- 下面是在叠内容中的代码块。
355
+ 下面是在折叠内容块中的代码块。
319
356
 
320
357
  <details open>
321
- <summary>折叠内容中的代码块2</summary>
358
+ <summary>在折叠内容块中的代码块2</summary>
322
359
 
323
360
  ```js
324
361
  console.log(NaN === NaN); // false
@@ -887,7 +924,7 @@ nav li {
887
924
  <table>
888
925
  <thead>
889
926
  <tr>
890
- <th style="width: 5em;">甲</th>
927
+ <th style="width: 7em;">甲</th>
891
928
  <th>乙</th>
892
929
  </tr>
893
930
  </thead>
@@ -17,9 +17,9 @@ window.atBeginingShouldExpandTOCWhenWindowIsWideEnough = false
17
17
  const printDoubleLine = '='.repeat(fullWidth)
18
18
 
19
19
  const emailAddress = 'wulechuan@live.com'
20
- const timeStamp = '北京时间 2021-03-21'
20
+ const timeStamp = '北京时间 2022-05-01'
21
21
 
22
- const welcomeZhHansCN = '欢迎使用吴乐川设计的用于控制文章目录之交互的控制器。'
22
+ const welcomeZhHansCN = '欢迎使用吴乐川设计的用于“控制文章目录之交互”的控制器。'
23
23
  const welcomeEn = 'Welcome to wulechuan\'s article TOC controller.'
24
24
 
25
25
  const words = '中国人——特别是汉族人,理应坚持广泛、规范地使用汉语。凡非必要之情形不说外国话、不用外国字。此乃天经地义!\n然则每当必要,亦不排斥采用外国之语言。不妨博世界之学问,养中国之精神。\n本人亦支持少数民族坚持采用自己民族的传统语言。仍须强调,凡中国人,皆应会用汉语、积极使用汉语,此乃中华各民族之大一统之必由。'
@@ -52,9 +52,9 @@ window.atBeginingShouldExpandTOCWhenWindowIsWideEnough = false
52
52
  console.log(
53
53
  `\n${
54
54
  printDoubleLine
55
- }\n\n${
55
+ }\n\n%c${
56
56
  welcomeZhHansCN
57
- }\n( ${
57
+ }%c\n( ${
58
58
  welcomeEn
59
59
  } )\n\n${
60
60
  ' '.repeat(fullWidth - emailAddress.length)
@@ -74,7 +74,22 @@ window.atBeginingShouldExpandTOCWhenWindowIsWideEnough = false
74
74
  wordLines.join('\n')
75
75
  }\n\n${
76
76
  printDoubleLine
77
- }\n\n\n`
77
+ }\n\n\n`,
78
+
79
+ [
80
+ 'font-family: sans-serif;',
81
+ 'font-size: 1.25em;',
82
+ 'display: inline-block;',
83
+ 'vertical-align: baseline;',
84
+ 'color: #000;',
85
+ 'text-shadow: 0.5px 0.5px 2px rgba(0, 0, 0, 0.51);',
86
+ 'background-color: #ffe0be;',
87
+ 'border-radius: 3px;',
88
+ 'margin: 0.5em 0;',
89
+ 'padding: 0.5em 1em 0.5em 1.5em;',
90
+ ].join(''),
91
+
92
+ null
78
93
  )
79
94
 
80
95
  const cssClassNameTOCExists = 'markdown-article-toc-exists'
@@ -1 +1 @@
1
- window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost=!1,window.atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan=1,window.atBeginingShouldExpandTOCWhenWindowIsWideEnough=!1,function(){const e=["https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git","https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git"],t=e.reduce(((e,t)=>Math.max(e,t.length)),0)+0,n=Math.floor(t/2)+6,o="-".repeat(t),l="=".repeat(t),s="wulechuan@live.com",c="北京时间 2021-03-21",i=[];"中国人——特别是汉族人,理应坚持广泛、规范地使用汉语。凡非必要之情形不说外国话、不用外国字。此乃天经地义!\n然则每当必要,亦不排斥采用外国之语言。不妨博世界之学问,养中国之精神。\n本人亦支持少数民族坚持采用自己民族的传统语言。仍须强调,凡中国人,皆应会用汉语、积极使用汉语,此乃中华各民族之大一统之必由。".split("\n").forEach((e=>{i.push(""),i.push(" "+e.slice(0,n-4));let t=e.slice(n-4);for(;t.length>0;){const e=t.match(/^(,|。|!|,”|。”|!”| 》,|》。| 》!| 》,”| 》。”| 》!”)/);if(e){const n=e[1],o=i[i.length-1];i[i.length-1]=o+n,t=t.slice(n.length)}const o=t.slice(0,n);o&&i.push(o),t=t.slice(o.length)}})),console.log(`\n${l}\n\n欢迎使用吴乐川设计的用于控制文章目录之交互的控制器。\n( Welcome to wulechuan's article TOC controller. )\n\n${" ".repeat(t-s.length)}${s}\n${" ".repeat(t-c.length-3)}${c}\n\n${o}\n\n${e.join("\n")}\n\n${o}\n${i.join("\n")}\n\n${l}\n\n\n`);const a="has-nested-toc-list",r="is-collapsed",u="is-expanded",d="markdown-article-toc-toggling-button",h=1e3,w=document.querySelector(".markdown-article");if(!w)return;const p=document.querySelector("nav.markdown-article-toc");if(!p)return;p.classList.toggle("should-show-2-levels-at-most",window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost);const f=document.querySelector(".markdown-article-back-to-top");f&&(f.onclick=function(){if(!C())return;O(!1)}),w.onclick=function(){if(!(window.innerWidth<=h))return;O(!1)};const m=document.body,g=m,y=m;let v;y.classList.add("markdown-article-toc-exists"),function e(t,n){const o=t.querySelector("ol, ul");if(!o)return;n||(n=1);o.classList.add(`toc-list-level-${n}`);Array.prototype.slice.apply(o.children).filter((e=>"li"===e.tagName.toLowerCase())).forEach((t=>{t.tocLevelId=n,t.classList.add(`toc-list-level-${n}-item`),e(t,n+1)}))}(p),function(){let e;if(Array.prototype.slice.apply(p.querySelectorAll("li")).forEach((e=>{if(e.querySelectorAll("li").length>0){const t=e.querySelector("a");e.classList.add(a),e.hasNestedList=!0,e.isCollapsible=!1,e.selfAnchor=t,e.onclick=k}})),window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost){const t=p.querySelector("ol, ul").children;e=t}else e=p.querySelectorAll("li.has-nested-toc-list");Array.prototype.slice.apply(e).forEach((e=>{e.isCollapsible=!0;$(e,e.tocLevelId<=window.atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan)}))}(),function(){let e=document.querySelector(`.${d}`);e||(e=document.createElement("button"),e.className=d,g===m?g.insertBefore(e,document.scripts[0]):g.appendChild(e));null===e.onclick&&(e.onclick=S)}();let L="";function S(){O(!v)}function O(e){y.classList.toggle("markdown-article-toc-is-visible",e),v=e}function C(){return window.innerWidth<=600}function k(e){e.stopPropagation();const{srcElement:t}=e,n=this,{selfAnchor:o}=n;if(t!==n&&t!==o)return;const l=o.href;let s="";l.match(/#/)&&(s=`#${l.split("#").pop()}`);const c=!!s&&L!==s;L=s;let i=n.isCollapsible;if(C()&&(i=!1),i){const{classList:e}=n;$(n,e.contains(r)||c)}}function $(e,t){const{classList:n}=e;t?(n.contains(u)||n.add(u),n.contains(r)&&n.remove(r)):(n.contains(r)||n.add(r),n.contains(u)&&n.remove(u))}O(window.atBeginingShouldExpandTOCWhenWindowIsWideEnough&&window.innerWidth>=h)}();
1
+ window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost=!1,window.atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan=1,window.atBeginingShouldExpandTOCWhenWindowIsWideEnough=!1,function(){const e=["https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git","https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns.git"],n=e.reduce(((e,n)=>Math.max(e,n.length)),0)+0,t=Math.floor(n/2)+6,o="-".repeat(n),l="=".repeat(n),s="wulechuan@live.com",i="北京时间 2022-05-01",c=[];"中国人——特别是汉族人,理应坚持广泛、规范地使用汉语。凡非必要之情形不说外国话、不用外国字。此乃天经地义!\n然则每当必要,亦不排斥采用外国之语言。不妨博世界之学问,养中国之精神。\n本人亦支持少数民族坚持采用自己民族的传统语言。仍须强调,凡中国人,皆应会用汉语、积极使用汉语,此乃中华各民族之大一统之必由。".split("\n").forEach((e=>{c.push(""),c.push(" "+e.slice(0,t-4));let n=e.slice(t-4);for(;n.length>0;){const e=n.match(/^(,|。|!|,”|。”|!”| 》,|》。| 》!| 》,”| 》。”| 》!”)/);if(e){const t=e[1],o=c[c.length-1];c[c.length-1]=o+t,n=n.slice(t.length)}const o=n.slice(0,t);o&&c.push(o),n=n.slice(o.length)}})),console.log(`\n${l}\n\n%c欢迎使用吴乐川设计的用于“控制文章目录之交互”的控制器。%c\n( Welcome to wulechuan's article TOC controller. )\n\n${" ".repeat(n-s.length)}${s}\n${" ".repeat(n-i.length-3)}${i}\n\n${o}\n\n${e.join("\n")}\n\n${o}\n${c.join("\n")}\n\n${l}\n\n\n`,["font-family: sans-serif;","font-size: 1.25em;","display: inline-block;","vertical-align: baseline;","color: #000;","text-shadow: 0.5px 0.5px 2px rgba(0, 0, 0, 0.51);","background-color: #ffe0be;","border-radius: 3px;","margin: 0.5em 0;","padding: 0.5em 1em 0.5em 1.5em;"].join(""),null);const a="has-nested-toc-list",r="is-collapsed",d="is-expanded",u="markdown-article-toc-toggling-button",h=1e3,m=document.querySelector(".markdown-article");if(!m)return;const p=document.querySelector("nav.markdown-article-toc");if(!p)return;p.classList.toggle("should-show-2-levels-at-most",window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost);const f=document.querySelector(".markdown-article-back-to-top");f&&(f.onclick=function(){if(!O())return;k(!1)}),m.onclick=function(){if(!(window.innerWidth<=h))return;k(!1)};const w=document.body,g=w,y=w;let v;y.classList.add("markdown-article-toc-exists"),function e(n,t){const o=n.querySelector("ol, ul");if(!o)return;t||(t=1);o.classList.add(`toc-list-level-${t}`);Array.prototype.slice.apply(o.children).filter((e=>"li"===e.tagName.toLowerCase())).forEach((n=>{n.tocLevelId=t,n.classList.add(`toc-list-level-${t}-item`),e(n,t+1)}))}(p),function(){let e;if(Array.prototype.slice.apply(p.querySelectorAll("li")).forEach((e=>{if(e.querySelectorAll("li").length>0){const n=e.querySelector("a");e.classList.add(a),e.hasNestedList=!0,e.isCollapsible=!1,e.selfAnchor=n,e.onclick=b}})),window.shouldShowOnlyTwoLevelsOfTOCItemsAtMost){const n=p.querySelector("ol, ul").children;e=n}else e=p.querySelectorAll("li.has-nested-toc-list");Array.prototype.slice.apply(e).forEach((e=>{e.isCollapsible=!0;C(e,e.tocLevelId<=window.atBeginingShouldCollapseAllTOCItemsOfLevelsGreaterThan)}))}(),function(){let e=document.querySelector(`.${u}`);e||(e=document.createElement("button"),e.className=u,g===w?g.insertBefore(e,document.scripts[0]):g.appendChild(e));null===e.onclick&&(e.onclick=S)}();let L="";function S(){k(!v)}function k(e){y.classList.toggle("markdown-article-toc-is-visible",e),v=e}function O(){return window.innerWidth<=600}function b(e){e.stopPropagation();const{srcElement:n}=e,t=this,{selfAnchor:o}=t;if(n!==t&&n!==o)return;const l=o.href;let s="";l.match(/#/)&&(s=`#${l.split("#").pop()}`);const i=!!s&&L!==s;L=s;let c=t.isCollapsible;if(O()&&(c=!1),c){const{classList:e}=t;C(t,e.contains(r)||i)}}function C(e,n){const{classList:t}=e;n?(t.contains(d)||t.add(d),t.contains(r)&&t.remove(r)):(t.contains(r)||t.add(r),t.contains(d)&&t.remove(d))}k(window.atBeginingShouldExpandTOCWhenWindowIsWideEnough&&window.innerWidth>=h)}();