heti/index.html

630 lines
41 KiB
HTML
Raw Normal View History

<!DOCTYPE html>
<html lang="zh-Hans" data-darkmode="auto">
<head>
<meta charset="UTF-8">
<title>赫蹏 - 一个简约又简单的网页中文排版增强</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="./heti.css">
<link rel="stylesheet" href="./index.css">
<link rel="icon" href="./favicon.svg">
</head>
<body>
<main class="container">
<article class="article heti heti--classic">
<h1 class="article__title">赫蹏</h1>
<blockquote>古代称用以书写的小幅绢帛。后亦以借指纸。《汉书·外戚传下·孝成赵皇后》:「武(籍武)发篋中,有裹药二枚,赫蹏书。」<u>颜师古</u>注:「<u>邓展</u>曰:『赫音兄弟鬩墙之鬩。』<u>应劭</u>曰:『赫蹏,薄小纸也。』」<u></u><u>赵彦卫</u> 《云麓漫钞》卷七:「《赵后传》所谓『赫蹏』者,注云『薄小纸』,然其寔亦縑帛。」</blockquote>
<nav class="article__nav heti-skip">
<details open>
<summary>目录</summary>
<ol>
<li><a href="#intro">介绍</a></li>
<li><a href="#usage">使用方法</a></li>
<li>
<a href="#examples">效果演示</a>
<ul>
<li><a href="#example-ancient">古文</a></li>
<li><a href="#example-verse">诗词</a></li>
<li><a href="#example-annotation">行间注</a></li>
<li><a href="#example-columns">多栏排版</a></li>
<li><a href="#example-vertical">竖排排版</a></li>
</ul>
</li>
<li><a href="#guidelines">设计原则</a></li>
<li>
<a href="#appendix">附录</a>
<ol class="heti-list-latin">
<li><a href="#compatibility">兼容性</a></li>
<li><a href="#tags">标签示例表</a></li>
<li><a href="#javascript">增强脚本</a></li>
<li><a href="#license">开源协议</a></li>
</ol>
</li>
</ol>
</details>
</nav>
<h2 id="intro">介绍<a class="anchor" href="#intro">#</a></h2>
<p><ruby class="heti-ruby--inline"><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby><ruby class="heti-ruby--inline"><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby>是专为中文网页内容设计的排版样式增强。它基于通行的中文排版规范,可为网站的读者带来更好的内容阅读体验。它的主要特性有:</p>
<ul>
<li>贴合网格的排版;</li>
<li>全标签样式美化;</li>
<li>预置古文、诗词样式;</li>
<li>预置多种排版样式(行间注、多栏、竖排等);</li>
<li>多种预设字体族(仅限桌面端);</li>
<li>简/繁体中文支持;</li>
<li>自适应黑暗模式;</li>
<li>中西文混排美化,不再手敲空格(基于JavaScript脚本);</li>
<li>标点挤压(基于JavaScript脚本);</li>
<li>兼容<i>normalize.css</i><i>CSS Reset<sup><a id="ref-01" href="#fn-01">[1]</a></sup></i>等常见样式重置;</li>
<li>移动端支持;</li>
<li>……</li>
</ul>
<p>总之,用上就会变好看。</p>
<hr>
<h2 id="usage">使用方法<a class="anchor" href="#usage">#</a></h2>
<p>项目地址:<a href="https://github.com/sivan/heti">https://github.com/sivan/heti</a>,使用方法如下:</p>
<ol>
<li>
在页面的<code>&lt;/head&gt;</code>标签前中引入<code>heti.css</code>样式文件:
<pre><code>&lt;link rel=&quot;stylesheet&quot; href=&quot;//unpkg.com/heti/umd/heti.min.css&quot;&gt;</code></pre>
</li>
<li>
在要作用的容器元素上增加<code>class="heti"</code>的类名即可:
<pre><code>&lt;article class=&quot;entry <ins>heti</ins>&quot;&gt;
&lt;h1&gt;我的世界观&lt;/h1&gt;
&lt;p&gt;有钱人的生活就是这么朴实无华,且枯燥。&lt;/p&gt;
……
&lt;/article&gt;</code></pre>
</li>
</ol>
<small>注:赫蹏是正文区域的样式增强,不是<i>normalize.css</i><i>CSS Reset</i>的替代。因此<b>不建议</b>将它作用在根标签(如<code>&lt;body&gt;</code><code>&lt;div class=&quot;container&quot;&gt;</code>)上。</small>
<hr>
<h2 id="examples">效果示例<a class="anchor" href="#examples">#</a></h2>
<p>本页面<em>全页</em>应用了赫蹏样式,所见即所得。下面是内置的多种排版效果演示。</p>
<h3 id="example-ancient">古文<a class="anchor" href="#example-ancient">#</a></h3>
<details>
<summary>如何使用?</summary>
<p>为容器元素<code>&lt;div class=&quot;heti&quot;&gt;</code>添加名为<code>heti--ancient</code>的class即可实现古文版式:</p>
<pre><code>&lt;div class=&quot;heti heti--ancient&quot;&gt;...&lt;/div&gt;</code></pre>
</details>
<details open>
<summary>示例</summary>
<section class="demo">
<div class="heti heti--ancient">
<h1>出师表</h1>
<p class="heti-meta heti-small">作者:<abbr title="字孔明">諸葛亮</abbr>(181年~234年10月8日)</p>
<p>先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。</p>
<p>宫中府中,俱为一体;陟罚臧否,不宜异同。若有作奸犯科及为忠善者,宜付有司论其刑赏,以昭陛下平明之理;不宜偏私,使内外异法也。</p>
<p>侍中、侍郎郭攸之、费祎、董允等,此皆良实,志虑忠纯,是以先帝简拔以遗陛下:愚以为宫中之事,事无大小,悉以咨之,然后施行,必能裨补阙漏,有所广益。</p>
<p>将军向宠,性行淑均,晓畅军事,试用于昔日,先帝称之曰能,是以众议举宠为督。愚以为营中之事,悉以咨之,必能使行阵和睦,优劣得所。</p>
<p>亲贤臣,远小人,此先汉所以兴隆也;亲小人,远贤臣,此后汉所以倾颓也。先帝在时,每与臣论此事,未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军,此悉贞良死节之臣,愿陛下亲之信之,则汉室之隆,可计日而待也。</p>
<p>臣本布衣,躬耕于南阳,苟全性命于乱世,不求闻达于诸侯。先帝不以臣卑鄙,猥自枉屈,三顾臣于草庐之中,咨臣以当世之事,由是感激,遂许先帝以驱驰。后值倾覆,受任于败军之际,奉命于危难之间,尔来二十有一年矣。</p>
<p>先帝知臣谨慎,故临崩寄臣以大事也。受命以来,夙夜忧叹,恐托付不效,以伤先帝之明;故五月渡泸,深入不毛。今南方已定,兵甲已足,当奖率三军,北定中原,庶竭驽钝,攘除奸凶,兴复汉室,还于旧都。此臣所以报先帝而忠陛下之职分也。至于斟酌损益,进尽忠言,则攸之、祎、允之任也。</p>
<p>愿陛下托臣以讨贼兴复之效,不效,则治臣之罪,以告先帝之灵。若无兴德之言,则责攸之、祎、允等之慢,以彰其咎;陛下亦宜自谋,以咨诹善道,察纳雅言,深追先帝遗诏。臣不胜受恩感激。</p>
<p>今当远离,临表涕零,不知所言。</p>
</div>
</section>
</details>
<h3 id="example-verse">诗词<a class="anchor" href="#example-verse">#</a></h3>
<details>
<summary>如何使用?</summary>
<ul>
<li>
诗词:为容器元素<code>&lt;div class=&quot;heti&quot;&gt;</code>添加名为<code>heti--poetry</code>的class实现诗词版式:
<pre><code>&lt;div class=&quot;heti heti--poetry&quot;&gt;
&lt;h2&gt;九月九日忆山东兄弟&lt;span class=&quot;heti-meta heti-small&quot;&gt;[唐]&lt;abbr title=&quot;号摩诘居士&quot;&gt;王维&lt;/abbr&gt;&lt;/span&gt;&lt;/h2&gt;
&lt;p class=&quot;heti-x-large&quot;&gt;
独在异乡为异客&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
每逢佳节倍思亲&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
遥知兄弟登高处&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
遍插茱萸少一人&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;
&lt;/p&gt;
&lt;/div&gt;</code></pre>
</li>
<li>
诗节:在古文版式<code>&lt;div class=&quot;heti heti--ancient&quot;&gt;</code>中,为诗句添加名为<code>heti-verse</code>的class可以将其居中显示:
<pre><code>&lt;div class=&quot;heti heti--ancient&quot;&gt;
&lt;h2&gt;一剪梅&middot;红藕香残玉簟秋&lt;span class=&quot;heti-meta heti-small&quot;&gt;[宋]&lt;abbr title=&quot;号易安居士&quot;&gt;李清照&lt;/abbr&gt;&lt;/span&gt;&lt;/h2&gt;
&lt;p class=&quot;heti-verse heti-x-large&quot;&gt;
红藕香残玉簟秋。轻解罗裳,独上兰舟&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
云中谁寄锦书来,雁字回时,月满西楼&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
花自飘零水自流。一种相思,两处闲愁&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;&lt;br&gt;
此情无计可消除,才下眉头,却上心头&lt;span class=&quot;heti-hang&quot;&gt;&lt;/span&gt;
&lt;/p&gt;
&lt;/div&gt;</code></pre>
</li>
<li>搭配使用标点悬挂<code>&lt;span class=&quot;heti-hang&quot;&gt;</code>、元信息<code>&lt;span class=&quot;heti-meta heti-small&quot;&gt;</code>来丰富展示效果。</li>
</ul>
</details>
<details open>
<summary>示例</summary>
<section class="demo">
<div class="heti heti--ancient">
<h2>一剪梅·红藕香残玉簟秋<span class="heti-meta heti-small">[宋]<abbr title="号易安居士">李清照</abbr></span></h2>
<p class="heti-verse heti-x-large">
红藕香残玉簟秋。轻解罗裳,独上兰舟<span class="heti-hang"></span><br>
云中谁寄锦书来,雁字回时,月满西楼<span class="heti-hang"></span><br>
花自飘零水自流。一种相思,两处闲愁<span class="heti-hang"></span><br>
此情无计可消除,才下眉头,却上心头<span class="heti-hang"></span>
</p>
</div>
<hr>
<div class="heti heti--poetry">
<h2>赠汪伦<span class="heti-meta heti-small">[唐]<abbr title="号青莲居士">李白</abbr></span></h2>
<p class="heti-x-large">
李白乘舟将欲行<span class="heti-hang"></span><br>
忽闻岸上踏歌声<span class="heti-hang"></span><br>
桃花潭水深千尺<span class="heti-hang"></span><br>
不及汪伦送我情<span class="heti-hang"></span>
</p>
</div>
</section>
</details>
<h3 id="example-annotation">行间注<a class="anchor" href="#example-annotation">#</a></h3>
<details>
<summary>如何使用?</summary>
<p>为容器元素<code>&lt;div class=&quot;heti&quot;&gt;</code>添加名为<code>heti--annotation</code>的class后,搭配<code>&lt;ruby&gt;</code>元素即可实现整齐的行间注效果:</p>
<pre><code>&lt;div class=&quot;heti heti--annotation&quot;&gt;...&lt;/div&gt;</code></pre>
</details>
<details open>
<summary>示例</summary>
<section class="demo">
<div class="heti heti--ancient heti--annotation">
<h2>庖丁解牛</h2>
<p class="heti-meta heti-small">作者:<abbr title="庄子">庄周</abbr>(公元前369~公元前286年)</p>
<p>吾生也有涯,而知也无涯。以有涯随无涯,殆已!已而为知者,殆而已矣!为善无近名,为恶无近刑。缘督以为经,可以保身,可以全生,可以养亲,可以尽年。</p>
<p><u title="名丁的厨工。先秦古书往往以职业放在人名前"><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">páo</rt><rp>)</rp></ruby></u>为文惠君解牛,手之所触,肩之所倚,足之所履,膝之所<u title="支撑,接触"><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby></u><u title="砉然:砉,又读xū,象声词。砉然,皮骨相离的声音"><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">huā</rt><rp>)</rp></ruby></u><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">xiǎng</rt><rp>)</rp></ruby>然,奏刀<u title="騞然:象声词,形容比砉然更大的进刀解牛声"><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">huō</rt><rp>)</rp></ruby></u>,莫不中音。合于《桑林》之舞,乃中《经首》之会。</p>
<p>文惠君曰:「嘻,善哉!技<u title="通「盍」,何,怎样"><ruby><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby></u>至此乎?」</p>
<p>庖丁释刀对曰:「臣之所好者,道也,进乎技矣。始臣之解牛之时,所见无非牛者。三年之后,未尝见全牛也。方今之时,臣以神遇而不以目视,官知止而<u title="指精神活动">神欲</u>行。依乎<u title="指牛的生理上的天然结构">天理</u><u title="击入大的缝隙">批大<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby></u><u title="顺着(骨节间的)空处进刀">导大<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">kuǎn</rt><rp>)</rp></ruby></u><u title="依"></u><u title="指牛体本来的结构">固然</u>,技经肯<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">qìng</rt><rp>)</rp></ruby>之未尝,而况大<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn"></rt><rp>)</rp></ruby>乎!良庖岁更刀,割也;族庖月更刀,折也。今臣之刀十九年矣,所解数千牛矣,而刀刃若新发于<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">xíng</rt><rp>)</rp></ruby>。彼节者有间,而刀刃者无厚;以无厚入有间,恢恢乎其于<em>游刃必有余地</em>矣,是以十九年而刀刃若新发于硎。虽然,每至于族,吾见其难为,<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">chù</rt><rp>)</rp></ruby>然为戒,视为止,行为迟。动刀甚微,<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">huò</rt><rp>)</rp></ruby>然已解,如土委地。提刀而立,为之四顾,为之<ruby><rb></rb><rp>(</rp><rt lang="zh-Latn">chóu</rt><rp>)</rp><rb></rb><rp>(</rp><rt lang="zh-Latn">chú</rt><rp>)</rp></ruby>满志,善刀而藏之。」</p>
<p>文惠君曰:「善哉!吾闻庖丁之言,得养生焉。」</p>
</div>
</section>
</details>
<h3 id="example-columns">多栏排版<a class="anchor" href="#example-columns">#</a></h3>
<p>赫蹏预置了多种多栏布局类,可以按栏数或每栏行宽进行设置。</p>
<details>
<summary>如何使用?</summary>
<p>为容器元素<code>&lt;div class=&quot;heti&quot;&gt;</code>添加名为<code>heti--columns-2</code>的class即可实现双栏排版:</p>
<pre><code>&lt;div class=&quot;heti heti--columns-2&quot;&gt;...&lt;/div&gt;</code></pre>
<table>
<thead>
<tr>
<th style="width: 80px;">方式</th>
<th style="width: 160px;">对应类名</th>
<th style="width: 300px;">可选数值</th>
</tr>
</thead>
<tbody>
<tr>
<td>按栏目数量</td>
<td><code>heti--columns-3</code></td>
<td>2, 3, 4</td>
</tr>
<tr>
<td>按每栏行宽</td>
<td><code>heti--columns-16em</code></td>
<td>16em, 20em, 24em, … +4em, … , 48em</td>
</tr>
</tbody>
</table>
</details>
<details open>
<summary>示例</summary>
<figure class="card card--multi-column">
<section class="heti--columns-2">
<p>先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。</p>
<p>宫中府中,俱为一体;陟罚臧否,不宜异同。若有作奸犯科及为忠善者,宜付有司论其刑赏,以昭陛下平明之理;不宜偏私,使内外异法也。</p>
<p>侍中、侍郎郭攸之、费祎、董允等,此皆良实,志虑忠纯,是以先帝简拔以遗陛下:愚以为宫中之事,事无大小,悉以咨之,然后施行,必能裨补阙漏,有所广益。</p>
<p>将军向宠,性行淑均,晓畅军事,试用于昔日,先帝称之曰能,是以众议举宠为督。愚以为营中之事,悉以咨之,必能使行阵和睦,优劣得所。</p>
<p>亲贤臣,远小人,此先汉所以兴隆也;亲小人,远贤臣,此后汉所以倾颓也。先帝在时,每与臣论此事,未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军,此悉贞良死节之臣,愿陛下亲之信之,则汉室之隆,可计日而待也。</p>
<p>臣本布衣,躬耕于南阳,苟全性命于乱世,不求闻达于诸侯。先帝不以臣卑鄙,猥自枉屈,三顾臣于草庐之中,咨臣以当世之事,由是感激,遂许先帝以驱驰。后值倾覆,受任于败军之际,奉命于危难之间,尔来二十有一年矣。</p>
<p>先帝知臣谨慎,故临崩寄臣以大事也。受命以来,夙夜忧叹,恐托付不效,以伤先帝之明;故五月渡泸,深入不毛。今南方已定,兵甲已足,当奖率三军,北定中原,庶竭驽钝,攘除奸凶,兴复汉室,还于旧都。此臣所以报先帝而忠陛下之职分也。至于斟酌损益,进尽忠言,则攸之、祎、允之任也。</p>
<p>愿陛下托臣以讨贼兴复之效,不效,则治臣之罪,以告先帝之灵。若无兴德之言,则责攸之、祎、允等之慢,以彰其咎;陛下亦宜自谋,以咨诹善道,察纳雅言,深追先帝遗诏。臣不胜受恩感激。</p>
<p>今当远离,临表涕零,不知所言。</p>
</section>
<figcaption>多栏排版演示</figcaption>
</figure>
</details>
<h3 id="example-vertical">竖排排版<a class="anchor" href="#example-vertical">#</a></h3>
<p>赫蹏预置了传统的竖排(直排)方向排版,同样贴合栅格。</p>
<details>
<summary>如何使用?</summary>
<p>为容器元素<code>&lt;div class=&quot;heti&quot;&gt;</code>添加名为<code>heti--vertical</code>的class即可实现竖排布局:</p>
<pre><code>&lt;div class=&quot;heti heti--vertical&quot;&gt;...&lt;/div&gt;</code></pre>
</details>
<details open>
<summary>示例</summary>
<figure class="card card--vertical">
<div class="card__vertical-container">
<section class="heti--vertical heti--ancient">
<h1>出師表</h1>
<p class="heti-small">作者:<abbr title="字孔明">諸葛亮</abbr>(181年-234年10月8日)</p>
<p>先帝創業未半,而中道崩殂;今天下三分,益州疲弊,此誠危急存亡之秋也﹗然侍衞之臣,不懈於內;忠志之士,忘身於外者,蓋追先帝之殊遇,欲報之於陛下也。</p>
<p>誠宜開張聖聽,以光先帝遺德,恢弘志士之氣﹔不宜妄自菲薄,引喻失義,以塞忠諫之路也。</p>
<p>宮中、府中,俱為一體;陟罰臧否,不宜異同。若有作姦、犯科,及為忠善者,宜付有司,論其刑賞,以昭陛下平明之治;不宜偏私,使內外異法也。</p>
<p>侍中、侍郎郭攸之、費禕、董允等,此皆良實,志慮忠純,是以先帝簡拔以遺陛下。愚以為宮中之事,事無大小,悉以咨之,然後施行,必能裨補闕漏,有所廣益。將軍向寵,性行淑均,曉暢軍事,試用於昔日,先帝稱之曰「能」,是以眾議舉寵為督。愚以為營中之事,悉以咨之,必能使行陣和睦,優劣得所。</p>
<p>親賢臣,遠小人,此先漢所以興隆也﹔親小人,遠賢臣,此後漢所以傾頹也。先帝在時,每與臣論此事,未嘗不歎息痛恨於桓、靈也!侍中、尚書、長史、參軍,此悉貞良死節之臣,願陛下親之、信之,則漢室之隆,可計日而待也。</p>
<p>臣本布衣,躬耕於南陽,苟全性命於亂世,不求聞達於諸侯。先帝不以臣卑鄙,猥自枉屈,三顧臣於草廬之中,諮臣以當世之事;由是感激,遂許先帝以驅馳。後值傾覆,受任於敗軍之際,奉命於危難之間,爾來二十有一年矣。先帝知臣謹慎,故臨崩寄臣以大事也。受命以來,夙夜憂歎,恐託付不效,以傷先帝之明。故五月渡瀘,深入不毛。今南方已定,兵甲已足,當獎率三軍,北定中原,庶竭駑鈍,攘除姦凶,興復漢室,還於舊都。此臣所以報先帝而忠陛下之職分也。至於斟酌損益,進盡忠言,則攸之、禕、允之任也。</p>
<p>願陛下託臣以討賊興復之效;不效,則治臣之罪,以告先帝之靈。若無興德之言,則責攸之、禕、允等之慢,以彰其咎。陛下亦宜自謀,以諮諏善道,察納雅言,深追先帝遺詔。臣不勝受恩感激。今當遠離,臨表涕零,不知所言!</p>
</section>
</div>
<figcaption>竖排排版演示</figcaption>
</figure>
</details>
<h3 id="example-latin">英文排版<a class="anchor" href="#example-latin">#</a></h3>
<details>
<summary>效果演示</summary>
<section class="demo">
<div lang="en-US">
<h1>Lorem Ipsum</h1>
<p><q>There is no one who loves pain itself, who seeks after it and wants to have it, simply because it is pain...</q></p>
<p><dfn>Lorem Ipsum</dfn> is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like <em>Aldus PageMaker</em> including versions of Lorem Ipsum.</p>
<p>The standard chunk of Lorem Ipsum used since the 1500s is reproduced below for those interested. Sections 1.10.32 and 1.10.33 from <cite>"de Finibus Bonorum et Malorum"</cite> by Cicero are also reproduced in their exact original form, accompanied by English versions from the 1914 translation by H. Rackham.</p>
</div>
</section>
</details>
<hr>
<h2 id="guidelines">设计原则<a class="anchor" href="#guidelines">#</a></h2>
<p>赫蹏项目的初衷很简单:它不作为一个CSS Reset出现,而是根据通行的中文排版规范,对网页正文区域进行排版样式增强。在部分CSS特性尚未有浏览器支持前,可通过JavaScript实现功能补充。</p>
<h3>文字</h3>
<p>参考《中文排版需求<sup><a id="ref-02" href="#fn-02">[2]</a></sup>》中描述的常用书籍排版字体,赫蹏提供了黑体、宋体和<u title="以正文宋体、标题楷体构成的搭配">传统</u>三种字体风格,前两者分别对应无衬线、衬线字体族。文字默认采用16px作为标准字号。在标题等文字较大的情况下,会适当地增加字间距以便获得更好地可读性。</p>
<details>
<summary>查看字体风格详细对照表</summary>
<section class="section">
<table>
<caption>各字体族下不同标签对应的字体</caption>
<thead>
<tr>
<td style="width: 60px;"></td>
<th style="width: 60px;">黑体</th>
<th style="width: 60px;">宋体</th>
<th style="width: 60px;">传统</th>
<th style="width: 380px;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<th>标题</th>
<td rowspan="7">黑体</td>
<td rowspan="7">宋体</td>
<td>楷体</td>
<td>
<section>
<h1>记忆中的站台</h1>
</section>
</td>
</tr>
<tr>
<th>正文</th>
<td>宋体</td>
<td>
<section>
<p>那是一个风雨交加的夜晚。</p>
</section>
</td>
</tr>
<tr>
<th>引用</th>
<td>楷体</td>
<td>
<section>
<blockquote>锣鼓喧天,鞭炮齐鸣,红旗招展,人山人海。</blockquote>
</section>
</td>
</tr>
<tr>
<th>强调</th>
<td>宋体</td>
<td>
<section>
<p>父亲<em>特意</em>嘱咐了我两句。</p>
</section>
</td>
</tr>
<tr>
<th>对话</th>
<td>楷体</td>
<td>
<section>
<p>他说:<q>我买几个橘子去。你就在此地,不要走动。</q></p>
</section>
</td>
</tr>
<tr>
<th>图例</th>
<td>黑体</td>
<td>
<section>
<figure>
<img src="./assets/orange.jpg" alt="" style="width: 200px;">
<figcaption>橘子</figcaption>
</figure>
</section>
</td>
</tr>
<tr>
<th>表头</th>
<td>黑体</td>
<td>
<section>
<table>
<caption>当时的情形</caption>
<tr>
<th>角色</th>
<th>物品</th>
</tr>
<tr>
<td>父亲</td>
<td>橘子</td>
</tr>
<tr>
<td></td>
<td>车票</td>
</tr>
</table>
</section>
</td>
</tr>
<tr>
<th>角标</th>
<td>黑体</td>
<td>黑体</td>
<td>黑体</td>
<td>鲁迅<sup>[1]</sup>曾经没有说过</td>
</tr>
</tbody>
</table>
</section>
</details>
<h3>标点</h3>
<p>参考《中文排版需求》制定符号样式。唯一的差异在于简体中文一律采用直角引号(「」)替代弯引号(“”),这样可以保持字符等宽。</p>
<details>
<summary>查看如何将引号设置为弯引号(“”)</summary>
<p>通过源码引用的方式覆盖`_variables.scss`文件中`$chinese-quote-set`变量的值为`cn`即可将引号设为GB/T 15834-2011的国家标准。</p>
</details>
<h3>间距</h3>
<p>为保持页面元素总是贴合垂直栅格,块级元素(段落、列表、表格等)采用一行行高作为底边距,半行行高作为顶边距。标题根据亲密性原则采用相反的边距设计。</p>
<hr>
<h2 id="appendix">附录<a class="anchor" href="#appendix">#</a></h2>
<h3 id="compatibility">兼容性<a class="anchor" href="#compatibility">#</a></h3>
<p>赫蹏在间距、边框、位置属性上采用了Logical properties,在所有现代浏览器上表现良好。</p>
<details>
<summary>查看兼容性列表</summary>
<section class="section">
<table>
<caption>兼容性列表(未经充分测试)</caption>
<tr>
<td></td>
<th>Chrome</th>
<th>Safari</th>
<th>Firefox</th>
<th>IE</th>
<th>Edge</th>
</tr>
<tr>
<th>兼容性</th>
<td>69</td>
<td>12.1</td>
<td>3</td>
<td>暂未支持</td>
<td>79</td>
</tr>
</table>
</section>
</details>
<h3 id="tags">标签示例表<a class="anchor" href="#tags">#</a></h3>
<details open>
<summary>查看标签示例表</summary>
<section class="section">
<table>
<caption>常用标签样式示例表</caption>
<tr>
<th style="width: 72px;">类型</th>
<th style="width: 320px;">标签</th>
<th style="width: 240px;">效果</th>
</tr>
<tr>
<td>链接</td>
<td><code>&lt;a href=&quot;https://github.com/sivan/heti&quot; title=&quot;赫蹏&quot;&gt;heti.css&lt;/a&gt;</code></td>
<td><a href="https://github.com/sivan/heti" title="赫蹏">heti.css</a></td>
</tr>
<tr>
<td>缩写</td>
<td><code>&lt;abbr title=&quot;Cascading Style Sheets&quot;&gt;CSS&lt;/abbr&gt;</code></td>
<td><abbr title="Cascading Style Sheets">CSS</abbr></td>
</tr>
<tr>
<td>代码</td>
<td><code>&lt;code&gt;.heti { star: 5; }&lt;/code&gt;</code></td>
<td><code>.heti { star: 5; }</code></td>
</tr>
<tr>
<td>专名号</td>
<td><code>此时来自&lt;u title=&quot;位于山东省聊城市阳谷县城东&quot;&gt;景阳冈&lt;/u&gt;&lt;u&gt;武松&lt;/u&gt;大喝一声:&lt;q&gt;纳命来!&lt;/q&gt;</code></td>
<td>此时来自<u title="位于山东省聊城市阳谷县城东">景阳冈</u><u>武松</u>大喝一声:<q>纳命来!</q></td>
</tr>
<tr>
<td>文本变动</td>
<td><code>这次考试,我考了&lt;del datetime=&quot;17:00:00&quot;&gt;58&lt;/del&gt;&lt;ins datetime=&quot;18:15:00&quot;&gt;98&lt;/ins&gt;分呢!</code></td>
<td>这次考试,我考了<del datetime="17:00:00">58</del><ins datetime="18:15:00">98</ins>分呢!</td>
</tr>
<tr>
<td>文本更新</td>
<td><code>因为谁也不认识,所以最后我们决定念&lt;s&gt;d&iacute;&lt;/s&gt;t&iacute;</code></td>
<td>因为谁也不认识,所以最后我们决定念<s></s>tí。</td>
</tr>
<tr>
<td>引号</td>
<td><code>&middot;格瓦拉曾经说过:&lt;q&gt;打工是不可能打工的。&lt;/q&gt;</code></td>
<td>窃·格瓦拉曾经说过:<q>打工是不可能打工的。</q></td>
</tr>
<tr>
<td>术语</td>
<td><code>&lt;dfn&gt;&middot;格瓦拉&lt;/dfn&gt;,中国大陆网络红人、罪犯。被奉为百度「戒赌吧」400万会员的「精神领袖」。</code></td>
<td><dfn>窃·格瓦拉</dfn>,中国大陆网络红人、罪犯。被奉为百度「戒赌吧」400万会员的「精神领袖」。</td>
</tr>
<tr>
<td>标记</td>
<td><code>这道题&lt;mark&gt;必考&lt;/mark&gt;,你们爱记不记。</code></td>
<td>这道题<mark>必考</mark>,你们爱记不记。</td>
</tr>
<tr>
<td>强调</td>
<td><code>稳住,&lt;em&gt;我们能赢&lt;/em&gt;</code></td>
<td>稳住,<em>我们能赢</em></td>
</tr>
<tr>
<td>着重号</td>
<td><code>我们&lt;span class=&quot;heti-em&quot;&gt;必将&lt;/span&gt;战胜这场疫情。</code></td>
<td>我们<span class="heti-em">必将</span>战胜这场疫情。</td>
</tr>
</table>
</section>
</details>
<h3 id="javascript">增强脚本<sup>beta</sup><a class="anchor" href="#javascript">#</a></h3>
<p>由于部分CSS特性尚未有浏览器支持等原因,可选择使用增强脚本进行排版效果优化。在页面的<code>&lt;/body&gt;</code>标签前引入JavaScript脚本后初始化即可:</p>
<pre><code>&lt;script src=&quot;//unpkg.com/heti/umd/heti-addon.min.js&quot;&gt;&lt;/script&gt;
&lt;script&gt;
const heti = new Heti('.heti');
heti.autoSpacing();
&lt;/script&gt;</code></pre>
<p>目前支持的功能有:</p>
<ul>
<li>中英文混排优化:无论你的输入习惯是否在中西文之间留有「空格」<sup><a id="ref-03" href="#fn-03">[3]</a></sup>,都会统一成标准间距(¼字宽的空白);</li>
<li>标点挤压:自动对中文标点进行½字宽的挤压(弯引号和间隔符挤压¼字宽)。</li>
</ul>
<p>效果演示:</p>
<table>
<caption>增强脚本示例表</caption>
<tr>
<th colspan="4">中西文混排美化</th>
</tr>
<tr>
<th style="width: 80px;">默认文本</th>
<td colspan="3">
<div class="heti-skip"><b>Hello, world!</b>是大家第一次学习Programming时最常写的demo,它看似简单,但对有些人来说寥寥数语有时也会产生bug。</div>
</td>
</tr>
<tr>
<th>脚本效果</th>
<td colspan="3">
<div><b>Hello, world!</b>是大家第一次学习Programming时最常写的demo,它看似简单,但对有些人来说寥寥数语有时也会产生bug。</div>
</td>
</tr>
<tr>
<th colspan="4">标点挤压</th>
</tr>
<tr>
<th>默认文本</th>
<td colspan="3">
<blockquote class="heti-skip" style="margin-inline-start: 0; margin-inline-end: 0;">古代称用以书写的小幅绢帛。后亦以借指纸<mark>。《</mark>汉书·外戚传下·孝成赵皇后<mark>》:「</mark>武(籍武 )发篋中,有裹药二枚,赫蹏书。」<u>颜师古</u>注:「<u>邓展</u>曰:『赫音兄弟鬩墙之鬩。』<u>应劭</u>曰:『赫蹏,薄小纸也。』」<u></u><u>赵彦卫</u>《云麓漫钞》卷七:「《赵后传》所谓『赫蹏』者,注云『薄小纸』,然其寔亦縑帛。」</blockquote>
</td>
</tr>
<tr>
<th>脚本效果</th>
<td colspan="3">
<blockquote style="margin-inline-start: 0; margin-inline-end: 0;">古代称用以书写的小幅绢帛。后亦以借指纸<mark>。《</mark>汉书·外戚传下·孝成赵皇后<mark>》:「</mark>武(籍武 )发篋中,有裹药二枚,赫蹏书。」<u>颜师古</u>注:「<u>邓展</u>曰:『赫音兄弟鬩墙之鬩。』<u>应劭</u>曰:『赫蹏,薄小纸也。』」<u></u><u>赵彦卫</u>《云麓漫钞》卷七:「《赵后传》所谓『赫蹏』者,注云『薄小纸』,然其寔亦縑帛。」</blockquote>
</td>
</tr>
<!-- <tr>-->
<!-- <th>默认文本(弯引号)</th>-->
<!-- <td colspan="3">-->
<!-- <blockquote class="heti-skip" style="margin-inline-start: 0; margin-inline-end: 0;">古代称用以书写的小幅绢帛。后亦以借指纸。《汉书·外戚传下·孝成赵皇后<mark>》:“</mark>武(籍武 )发篋中,有裹药二枚,赫蹏书。”<u>颜师古</u>注:“<u>邓展</u>曰:‘赫音兄弟鬩墙之鬩。’<u>应劭</u>曰:‘赫蹏,薄小纸也。’”<u>宋</u><u>赵彦卫</u>《云麓漫钞》卷七<mark>:“《</mark>赵后传》所谓‘赫蹏’者,注云‘薄小纸’,然其寔亦縑帛。”</blockquote>-->
<!-- </td>-->
<!-- </tr>-->
<!-- <tr>-->
<!-- <th>脚本效果(弯引号)</th>-->
<!-- <td colspan="3">-->
<!-- <blockquote style="margin-inline-start: 0; margin-inline-end: 0;">古代称用以书写的小幅绢帛。后亦以借指纸。《汉书·外戚传下·孝成赵皇后<mark>》:“</mark>武(籍武 )发篋中,有裹药二枚,赫蹏书。”<u>颜师古</u>注:“<u>邓展</u>曰:‘赫音兄弟鬩墙之鬩。’<u>应劭</u>曰:‘赫蹏,薄小纸也。’”<u>宋</u><u>赵彦卫</u>《云麓漫钞》卷七<mark>:“《</mark>赵后传》所谓‘赫蹏’者,注云‘薄小纸’,然其寔亦縑帛。”</blockquote>-->
<!-- </td>-->
<!-- </tr>-->
</table>
<h3 id="license">开源协议<a class="anchor" href="#tags">#</a></h3>
<p>「赫蹏」遵循MIT协议开源。</p>
<footer class="heti-fn">
<ol>
<li id="fn-01">
<a href="#ref-01" title="移至">^</a>
CSS Reset:指代类似Eric Meyer's Reset CSS的样式重置方案
</li>
<li id="fn-02">
<a href="#ref-02" title="移至">^</a>
《中文排版需求》:https://w3c.github.io/clreq/
</li>
<li id="fn-03">
<a href="#ref-03" title="移至">^</a>
在当下前端技术尚不能完美解决中西文混排间距的情况下,常见的输入习惯是手动在中西文间加入空格(https://github.com/vinta/pangu.js)。这样做的弊端一是间距不可控(有时显得过大),二是通过空格符来排版只能算无奈之举。好消息是在最新的macOS、iOS中,使用原生语言开发的文本区域会自动处理中西文混排的间距(无论是否加空格),期待不用手敲空格的日子早日到来。
</li>
</ol>
</footer>
</article>
</main>
<aside class="panel">
<ul class="panel-list panel-list--gray">
<li><input type="radio" class="J_fontStack" value="heti--classic" name="font" id="font-classic" checked><label for="font-classic">传统</label></li>
<li><input type="radio" class="J_fontStack" value="heti--sans" name="font" id="font-sans"><label for="font-sans">黑体</label></li>
<li><input type="radio" class="J_fontStack" value="heti--serif" name="font" id="font-serif"><label for="font-serif">宋体</label></li>
</ul>
<ul class="panel-list panel-list--gray">
<li><input type="radio" class="J_radioGrid" value="" name="grid" id="grid-disable" checked><label for="grid-disable">网格:关</label></li>
<li><input type="radio" class="J_radioGrid" value="grid-24" name="grid" id="grid-24"><label for="grid-24"></label></li>
<li><input type="radio" class="J_radioGrid" value="grid-12" name="grid" id="grid-12"><label for="grid-12"></label></li>
</ul>
<ul class="panel-list panel-list--gray panel-list--icon">
<li><input type="radio" class="J_darkMode" value="auto" name="darkmode" id="darkmode-auto" checked><label for="darkmode-auto">🌗</label></li>
<li><input type="radio" class="J_darkMode" value="light" name="darkmode" id="darkmode-light"><label for="darkmode-light">🌞</label></li>
<li><input type="radio" class="J_darkMode" value="dark" name="darkmode" id="darkmode-dark"><label for="darkmode-dark">🌙</label></li>
</ul>
</aside>
<script src="./heti-addon.js"></script>
<script>
const $$root = document.getElementsByTagName('html')[0]
const $$main = document.getElementsByTagName('main')[0]
const $$article = document.getElementsByTagName('article')[0]
function addEventListeners(nodeList, event, fn) {
[].forEach.call(nodeList, function(elm) {
elm.addEventListener(event, fn, false)
}, false)
}
addEventListeners(document.getElementsByClassName('J_darkMode'), 'change', function (e) {
$$root.setAttribute('data-darkmode', e.target.value)
})
addEventListeners(document.getElementsByClassName('J_radioGrid'), 'change', function (e) {
$$main.setAttribute('data-bg-grid', e.target.value)
})
addEventListeners(document.getElementsByClassName('J_fontStack'), 'change', function (e) {
$$article.className = ['article', 'heti', e.target.value].join(' ')
})
const heti = new Heti('.article')
heti.autoSpacing()
</script>
</body>
</html>