@wulechuan/css-stylus-markdown-themes 7.6.0 → 7.6.1
Sign up to get free protection for your applications and to get access to all the features.
- package/ReadMe.md +77 -43
- package/package.json +5 -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/217/221/345/270/203/346/226/260/345/233/276/347/211/207/345/211/215/347/232/204/345/277/205/350/246/201/346/255/245/351/252/244.md +13 -0
package/ReadMe.md
CHANGED
@@ -1,6 +1,7 @@
|
|
1
|
+
# 吴乐川的 HTML 文章排版与配色之方案集
|
2
|
+
|
1
3
|
<link rel="stylesheet" href="./源代码/发布的源代码/文章排版与配色方案集/层叠样式表/wulechuan-styles-for-html-via-markdown--vscode.default.min.css">
|
2
4
|
|
3
|
-
# 吴乐川的 HTML 文章排版与配色之方案集
|
4
5
|
|
5
6
|
> 中国人——特别是汉族人,理应坚持广泛、规范地使用汉语。凡非必要之情形不说外国话、不用外国字。此乃天经地义!然则每当必要,亦不排斥采用外国之语言。不妨 **博世界之学问,养中国之精神** 。
|
6
7
|
>
|
@@ -29,13 +30,35 @@
|
|
29
30
|
</dl>
|
30
31
|
|
31
32
|
|
33
|
+
|
34
|
+
|
35
|
+
|
36
|
+
## 源代码仓库
|
37
|
+
|
38
|
+
| <span style="display:inline-block;width:180px;">提供仓库服务之组织</span> | <span style="display:inline-block;width:150px;">仓库组织之国别</span> | 仓库地址 |
|
39
|
+
| ------------- | :----------: | ------- |
|
40
|
+
| 码云 | 中华人民共和国 | [https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns) |
|
41
|
+
| 阿里云之代码仓库 | 中华人民共和国 | [https://code.aliyun.com/wulechuan/wulechuan-themes-for-htmls-via-markdowns](https://code.aliyun.com/wulechuan/wulechuan-themes-for-htmls-via-markdowns) |
|
42
|
+
| GitHub | 美 | [https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns](https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns) |
|
43
|
+
|
44
|
+
|
45
|
+
|
32
46
|
## 此物何用
|
33
47
|
|
34
|
-
|
48
|
+
本工具提供两类基本功能。且二者紧密相关。
|
49
|
+
|
50
|
+
1. 本工具用于构建一组层叠样式表(即外国话所谓 CSS)文件。
|
51
|
+
|
52
|
+
|
53
|
+
2. 本工具亦提供了一组现成的层叠样式表文件。
|
54
|
+
|
55
|
+
凡这些样式表,不论是本工具现成提供的还是开发者采用本工具自己创建的,均可用于美化采用超文本标记语言(即 HTML)格式的文章。于任一文章,不必同时取用多个样式表文件,仅取其一足矣。
|
35
56
|
|
36
|
-
|
57
|
+
本品还提供了一个 JavaScript 编程接口,使得其它 JavaScript 工具包亦可以程序化之方式使用这些层叠样式表文件之内容。详见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》一节。
|
58
|
+
|
59
|
+
|
60
|
+
> 不妨强调,于开发者而言,本品可以是一个样式表**构建工具**,用以相对方便地构建出新的符合特定喜好或需求的样式表文件。
|
37
61
|
|
38
|
-
> 不妨强调,于开发者而言,本品可以是一个样式表构建工具,用以相对方便地构建出新的符合特定喜欢或需求的 CSS 文件。
|
39
62
|
|
40
63
|
|
41
64
|
|
@@ -56,19 +79,28 @@
|
|
56
79
|
|
57
80
|
本工具配备了两篇范文,汉语一篇,英语一篇,均套用了本工具之默认样式,以示效果。
|
58
81
|
|
59
|
-
|
82
|
+
### 已转换为 HTML 格式的范文副本
|
60
83
|
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
84
|
+
范文之截图可以较好地展示文章之(视觉层面的)样貌。但截图文件往往较大,有些竟在**百万字节**级别。因此,不妨在此先给出 HTML 文件。截图在后文也会一并给出。
|
85
|
+
|
86
|
+
|
87
|
+
HTML 范文如下:
|
88
|
+
|
89
|
+
- 《[HTML 范文(汉语版,浅色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.zh-hans-cn.default-light-colored-theme.html)》
|
90
|
+
- 《[HTML 范文(汉语版,深色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.zh-hans-cn.default-dark-colored-theme.html)》
|
91
|
+
- 《[HTML 范文(英语版,浅色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.en-us.default-light-colored-theme.html)》
|
92
|
+
- 《[HTML 范文(英语版,深色)](./文档集/文章排版与配色效果示例集/以-html-格式渲染好的文章成品/html/example.en-us.default-dark-colored-theme.html)》
|
69
93
|
|
70
94
|
|
71
|
-
|
95
|
+
|
96
|
+
### HTML 范文的截图
|
97
|
+
|
98
|
+
一图胜千言。以下将给出范文之截图。
|
99
|
+
|
100
|
+
> 以下各图较大,文件大小在**百万字节**级别。若网络不佳不便阅图,亦可改为下载 HTML 文件观察其面貌。见上文《[已转换为 HTML 格式的范文副本](#已转换为%20HTML%20格式的范文副本)》。
|
101
|
+
|
102
|
+
|
103
|
+
#### 范文富有特色的大幅截图
|
72
104
|
|
73
105
|
|
74
106
|
1. 应用了**默认浅色主题**的范文之截图
|
@@ -103,61 +135,54 @@
|
|
103
135
|
- [存放在 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)
|
104
136
|
|
105
137
|
|
106
|
-
|
138
|
+
#### 范文的所有截图
|
107
139
|
|
108
140
|
两篇范文之截图不止于上文中提及的四幅。更多图例,见:
|
109
141
|
|
110
142
|
- 《[应用效果示例(汉语版)](./文档集/说明书/汉语/关于文章排版与配色效果示例集的说明.md)》
|
111
143
|
- 《[应用效果示例(英语版)](./文档集/说明书/en-US/application-examples.md)》
|
112
144
|
|
145
|
+
#### 范文截图制作指南
|
146
|
+
|
113
147
|
另,日常制作网页截图是很简单的事情,但本工具之范文篇幅巨大,为其截图确须一定经验和技巧。见《[示范文章之截图之制作指南](./文档集/说明书/汉语/示范文章之截图之制作指南.md)》。
|
114
148
|
|
115
149
|
|
116
150
|
|
117
151
|
|
118
|
-
## 源代码仓库
|
119
|
-
|
120
|
-
| <span style="display:inline-block;width:180px;">提供仓库服务之组织</span> | <span style="display:inline-block;width:150px;">仓库组织之国别</span> | 仓库地址 |
|
121
|
-
| ------------- | :----------: | ------- |
|
122
|
-
| 码云 | 中华人民共和国 | [https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns](https://gitee.com/nanchang-wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns) |
|
123
|
-
| 阿里云之代码仓库 | 中华人民共和国 | [https://code.aliyun.com/wulechuan/wulechuan-themes-for-htmls-via-markdowns](https://code.aliyun.com/wulechuan/wulechuan-themes-for-htmls-via-markdowns) |
|
124
|
-
| GitHub | 美 | [https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns](https://github.com/wulechuan/wulechuan-css-stylus-themes-for-htmls-via-markdowns) |
|
125
|
-
|
126
|
-
|
127
152
|
|
128
153
|
## 使用说明
|
129
154
|
|
130
155
|
### 使用须知
|
131
156
|
|
132
|
-
|
157
|
+
本工具提供一组层叠样式表(CSS)文件,及配套的 JavaScript 文件(目前仅一个这样的 JavaScript 文件)。它们可用于装点 HTML 文章之样貌,也为文章提供额外的交互行为。应该指出,被装点的文章可以是任何人以任何方式创建的 HTML 文件,但常见的情形往往是这些 HTML 文件系从 MarkDown 文件转换而得。**但重点在于本工具提供的主体内容仅限层叠样式表文件。**
|
133
158
|
|
134
|
-
|
159
|
+
换言之,本工具**并不能**将 Markdown 文件转换为对应的 HTML 文件。本工具假定诸君各自另有办法将 Markdown 内容转换成 HTML 内容,诸君采用本工具仅仅是希望取其中的 CSS 对诸君的 HTML 做进一步的排版美化。于此种情形,用法再简单不过——**自行取用那些 CSS 文件**即可。
|
135
160
|
|
136
161
|
|
137
|
-
|
162
|
+
所谓自行取用,即是说诸君在本项目之发布文件夹中自行找到中意之 CSS 文件(及配套 JavaScript 文件),采用之。且于单一 HTML 文件,在本工具提供之所有 CSS 文件取用其任一足矣,不必取用多者。
|
138
163
|
|
139
|
-
|
164
|
+
又,取用本工具提供之 CSS 、 JavaScript 文件之内容时,若每每人为复制、粘贴,未免麻烦。尤其是在面对批量运用或自动化运用之要求时,开发人员当然希望能编写程序调集所需资源加以运用。刚巧本工具确实提供了专门的 JavaScript 编程接口,以 **JavaScript 文本(string)** 之形式提供各 CSS 、 JavaScript 文件之内容。见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》。
|
140
165
|
|
141
166
|
|
142
|
-
|
143
|
-
|
144
|
-
|
145
|
-
|
146
|
-
|
167
|
+
> 不过,不论是手工直接取用本工具中之 CSS 文件,还是调用本工具之 JavaScript 接口取用这些 CSS 文件,都没有解决一部分读者的困难:你们的初衷是要将手头的一些 Markdown 文件转换成 HTML 文件,而采用我提供的这些 CSS 只是锦上添花式的要求。临用之际,单单一个 CSS 文件显然不解燃眉之急。
|
168
|
+
>
|
169
|
+
> 此种情形下,诸君首先需要的是一款可以进行文件格式转换之工具,而后才考虑如何将本工具提供之 CSS 嵌入 HTML 之中。
|
170
|
+
>
|
171
|
+
> 那么新的问题来了,我能不能**顺便**推荐几款能将 MarkDown 文件转换至 HTML 文件的工具呢?当然!鄙人毛遂自荐,愿助诸君一臂之力!鄙人另行自创有三个工具,专用于轻松、快速地从 Markdown 内容构建对应之 HTML 内容。且三者均默认采用本工具发布之 CSS 之内容(及配套 JavaScript 内容)。我在[本说明书之尾部](#相关工具之推广)亦对此三款软件包做了推广。诸君无需另起炉灶了!唯愿三者之任一能对君有所裨益!
|
147
172
|
|
148
173
|
|
149
|
-
|
174
|
+
又,如果阁下取用本工具中之 CSS 主题文件另有意图,即与将 Markdown 转换至 HTML 之事毫无干系,那么或许更应该了解如何编写程序调集所需的由本工具提供之 CSS 资源加以运用。见下文《[以程序化之方式取用本工具提供之内容](#以程序化之方式取用本工具提供之内容)》。
|
150
175
|
|
151
176
|
|
152
177
|
### 手工取用本工具的文件
|
153
178
|
|
154
179
|
#### 取用 CSS 文件
|
155
180
|
|
156
|
-
请在 `./源代码/发布的源代码/文章排版与配色方案集/层叠样式表`
|
181
|
+
请在 `./源代码/发布的源代码/文章排版与配色方案集/层叠样式表` 文件夹下自行获取所需的样式表文件。
|
157
182
|
|
158
183
|
#### 取用 Javascript 文件
|
159
184
|
|
160
|
-
请在 `./源代码/发布的源代码/文章排版与配色方案集/javascript`
|
185
|
+
请在 `./源代码/发布的源代码/文章排版与配色方案集/javascript` 文件夹下自行获取所需的 JavaScript 文件。
|
161
186
|
|
162
187
|
|
163
188
|
### 以程序化之方式取用本工具提供之内容
|
@@ -166,13 +191,13 @@
|
|
166
191
|
|
167
192
|
在面对批量运用或自动化运用之要求时,开发人员当然希望能编写程序调集所需资源加以运用。本工具确实提供了专门的 JavaScript 编程接口,以 JavaScript 字符串数据的形式提供各 CSS 、 JavaScript 文件之内容。
|
168
193
|
|
169
|
-
> 本工具还额外提供了编程接口配套的 TypeScript
|
170
|
-
>
|
194
|
+
> 本工具还额外提供了编程接口配套的 TypeScript 类型定义:\
|
171
195
|
> `源代码/发布的源代码/本工具作为其他-javascript-工具之依赖模块时的代码/index.d.ts`
|
172
196
|
|
173
197
|
#### 以程序化之方式取用本工具提供之内容之示范代码
|
174
198
|
|
175
|
-
>
|
199
|
+
> 下例中代码之主体节选自本项目的\
|
200
|
+
> 《`测试集/用于测试本项目之-javascript-接口的测试代码集.js`》。
|
176
201
|
|
177
202
|
```js
|
178
203
|
const {
|
@@ -265,7 +290,7 @@ const 这还是目前唯一的Javascript文件之内容全文 = 获取某一已
|
|
265
290
|
```
|
266
291
|
|
267
292
|
|
268
|
-
####
|
293
|
+
#### 本工具特有的所谓“文件简易描述项”
|
269
294
|
|
270
295
|
其 TypeScript 类型定义如下:
|
271
296
|
|
@@ -300,8 +325,11 @@ declare type 范_吴乐川用于美化文章的层叠样式表集_文件简易
|
|
300
325
|
又,借助“**接口 js**”获取“**文章 js**”之内容时,“接口 js”还**允许对“文章 js”之内容进行些许临时定制**。故而,最终获得的内容字符串有异于本工具存储的原始版本。换言之,你调用本工具的“**接口 js**”中的某接口函数时,可在接口函数的某一项参数传入【配置项集】,以对 “**文章 js**”之内容做些许改变。
|
301
326
|
|
302
327
|
> 有两个不同的接口函数各自可以接受该配置项集,但形参位置不同。
|
303
|
-
> 1.
|
304
|
-
>
|
328
|
+
> 1. 第一个函数是\
|
329
|
+
> `总接口.获取某一已发布之文件之完整内容字符串` ,它在**第 3 形参**接受上述【配置项集】。
|
330
|
+
>
|
331
|
+
> 1. 第二个函数是\
|
332
|
+
> `总接口.获取本项目官方选定之所谓默认Javascript之完整内容字符串` ,它在**第 2 形参**接受上述【配置项集】。
|
305
333
|
|
306
334
|
上述【配置项集】之 TypeScript 类型定义如下:
|
307
335
|
|
@@ -332,7 +360,7 @@ declare type 范_吴乐川用于美化文章的层叠样式表集_拾取默认Ja
|
|
332
360
|
-----
|
333
361
|
|
334
362
|
|
335
|
-
##
|
363
|
+
## 相关工具之推广
|
336
364
|
|
337
365
|
鄙人另有一款 NPM 包,名为“[@wulechuan/generate-html-via-markdown](https://www.npmjs.com/package/@wulechuan/generate-html-via-markdown)”。为便于指称,不妨暂称“**甲**”。调用甲之接口,可将传入该接口的 Markdown 字符串转换成 HTML 字符串。此时,甲默认会采用本工具提供的 CSS 文件来装饰甲自身产生的 HTML 之内容。
|
338
366
|
|
@@ -355,6 +383,12 @@ declare type 范_吴乐川用于美化文章的层叠样式表集_拾取默认Ja
|
|
355
383
|
|
356
384
|
1. 旧版代码不复存在。
|
357
385
|
2. 当前的范文截图常常与代码所能产出之真正面貌有所差异,因为范文更新进度多半时候落后于代码,也落后于 NPM 版本发布。
|
386
|
+
|
387
|
+
> 最末发布的截图系针对本工具之 `v7.6.0` 版,各图均制作于 2022 年 5 月 1 日。
|
388
|
+
>
|
389
|
+
> 但若再有新图发布替换旧图,亦可因为本人遗漏对此文之修订而令上述版本、发布日期均不实。
|
390
|
+
|
391
|
+
|
358
392
|
3. 未来是否因为代码仓库累计尺寸巨大而再次清空代码仓库从头提交代码,亦未可知。
|
359
393
|
|
360
394
|
|
package/package.json
CHANGED
@@ -2,8 +2,8 @@
|
|
2
2
|
"name": "@wulechuan/css-stylus-markdown-themes",
|
3
3
|
"author": "吴乐川 <wulechuan@live.com>",
|
4
4
|
"license": "WTFPL",
|
5
|
-
"version": "7.6.
|
6
|
-
"description": "此为吴乐川的《HTML 文章排版与配色之方案集与相关制作工具》。本工具可用于构建一组层叠样式表(即 CSS
|
5
|
+
"version": "7.6.1",
|
6
|
+
"description": "此为吴乐川的《HTML 文章排版与配色之方案集与相关制作工具》。本工具可用于构建一组层叠样式表(即 CSS )文件。本工具亦提供了一组现成的层叠样式表文件。凡这些样式表,均可用于美化超文本标记语言(即 HTML)格式的文章。于单一文章,不必同时取用多个样式表文件,仅取其一足矣。",
|
7
7
|
"directories": {
|
8
8
|
"source": "源代码/原始的源代码",
|
9
9
|
"dist": "源代码/发布的源代码",
|
@@ -12,6 +12,7 @@
|
|
12
12
|
},
|
13
13
|
"main": "源代码/发布的源代码/本工具作为其他-javascript-工具之依赖模块时的代码/index.js",
|
14
14
|
"types": "源代码/发布的源代码/本工具作为其他-javascript-工具之依赖模块时的代码/index.d.ts",
|
15
|
+
"type": "commonjs",
|
15
16
|
"scripts": {
|
16
17
|
"eslint": "eslint ./.eslintrc.js ./gulpfile.esm.js/**/*.js ./文档集/文章排版与配色效果示例集/*.js ./测试集/*.js ./源代码/发布的源代码/本工具作为其他-javascript-工具之依赖模块时的代码/*.js ./源代码/原始的源代码/用于设计文章排版与配色方案的代码/js/**/*.js ./本项目之全局配置项集.js",
|
17
18
|
"open-firefox-for-snapshots": "start firefox ./测试集/产生的临时文件/示例性-html-文件集(均嵌有半自动化截图辅助逻辑)/example.en-us.default-light-colored-theme.html ./测试集/产生的临时文件/示例性-html-文件集(均嵌有半自动化截图辅助逻辑)/example.en-us.default-dark-colored-theme.html ./测试集/产生的临时文件/示例性-html-文件集(均嵌有半自动化截图辅助逻辑)/example.zh-hans-cn.default-light-colored-theme.html ./测试集/产生的临时文件/示例性-html-文件集(均嵌有半自动化截图辅助逻辑)/example.zh-hans-cn.default-dark-colored-theme.html",
|
@@ -31,7 +32,8 @@
|
|
31
32
|
"test": "npm run eslint && npm run _test-all-without-linting-without-browser && npm run open-firefox-for-snapshots && npm run open-dev-htmls",
|
32
33
|
"build": "npm run eslint && npm run _build && npm run update-example-htmls",
|
33
34
|
"build-2": "npm run eslint && npm run _build-2 && npm run update-example-htmls-2",
|
34
|
-
"
|
35
|
+
"发布新图片之前对开发者做出提醒": "node ./文档集/文章排版与配色效果示例集/供-nodejs-调用--发布新图片前的必要步骤.js & code ./文档集/文章排版与配色效果示例集/发布新图片前的必要步骤.md",
|
36
|
+
"每当制作集得之版本之前": "npm i && npm test && npm run 发布新图片之前对开发者做出提醒",
|
35
37
|
"prepublishOnly": "npm i && npm test"
|
36
38
|
},
|
37
39
|
"dependencies": {
|
@@ -0,0 +1,13 @@
|
|
1
|
+
# 吴乐川的 HTML 文章排版与配色之方案集发布范文的新截图之前的必要步骤
|
2
|
+
|
3
|
+
|
4
|
+
<link rel="stylesheet" href="../../源代码/发布的源代码/文章排版与配色方案集/层叠样式表/wulechuan-styles-for-html-via-markdown--vscode.default.min.css">
|
5
|
+
|
6
|
+
|
7
|
+
1. 确保图片数目齐全。目前应为 25 张。
|
8
|
+
|
9
|
+
2. 采用任何图像处理工具,将图片文件字节数尽量减小。
|
10
|
+
|
11
|
+
3. 修订《说明书》中的该小节《[**版本 6 及更旧版本之源代码业已删除**](../../ReadMe.md#版本%206%20及更旧版本之源代码业已删除)》以如实记载新图片的制作和发布日期、对应该工具的版本等信息。
|
12
|
+
|
13
|
+
4. 修订《[关于文章排版与配色效果示例集的说明](../%E8%AF%B4%E6%98%8E%E4%B9%A6/%E6%B1%89%E8%AF%AD/%E5%85%B3%E4%BA%8E%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%E7%9A%84%E8%AF%B4%E6%98%8E.md)》以及《[application-examples](../%E8%AF%B4%E6%98%8E%E4%B9%A6/en-US/application-examples.md)》,以如实记载所采用的浏览器品牌。
|