docs: 字型交消費端(同步 main 之 _lang.css 移除)
changelog 增「變更:字型移出聚珍管理」(不內建 font-family、半形顯式保留 locl、 render 不改 lang;halt/margin 兩模式驗證正常)。使用文檔 CSS 基礎設定「字型」項 改寫為「字型由消費端負責」+推薦逐 lang 範式。HTML 與 Markdown 孿生同步、manifest 重建。
This commit is contained in:
+3
-3
@@ -137,10 +137,10 @@ createJuzhen({ lang: { default: "zh-Hant" } }).render(document.querySelector("ma
|
||||
<ol>
|
||||
<li><strong>引入樣式(必須)</strong>:<code><link rel="stylesheet" href="dist/juzhen.css"></code>(或 ESM <code>import "cjk-autospace/css"</code>)。</li>
|
||||
<li><strong>設定 <code>lang</code>(強烈建議)</strong>:內容容器標 <code>lang="zh-Hans"</code>/<code>"zh-Hant"</code>/<code>"ja"</code>,驅動全角/開明政策與字形 <code>locl</code>。</li>
|
||||
<li><strong>作用域類</strong>:若設 <code>scope.include: ".juzhen"</code>,須給內容容器加對應 class;<code>juzhen.css</code> 之 normalize/字型堆疊亦收斂於此域。</li>
|
||||
<li><strong>作用域類</strong>:若設 <code>scope.include: ".juzhen"</code>,須給內容容器加對應 class;<code>juzhen.css</code> 之 normalize 亦收斂於此域。</li>
|
||||
<li><strong>長英文詞斷字</strong>:須由消費端 CSS 提供 <code>hyphens: auto</code>(含 <code>-webkit-hyphens</code>)。</li>
|
||||
<li><strong><code>justify</code>(選用)</strong>:欲兩端對齊則自設 <code>text-align: justify</code>;句末標點單份間距與行末去隙由聚珍處理。</li>
|
||||
<li><strong>字型(影響擠壓)</strong>:半形預設依字型 <code>halt</code>;含 <code>halt</code> 字型(Noto CJK/思源)即可,缺則用 <code>margin</code> 後備。<code>juzhen.css</code> 內建依 <code>:lang</code> 之 Noto CJK 字型堆疊,但<strong>僅作後備</strong>(全包 <code>:where()</code> 零特異度、只命中帶 <code>lang</code> 屬性之元素、不直接覆寫標點字面容器)——<strong>消費端 <code>font-family</code> 恆優先</strong>,標點亦隨之以消費端字型渲染。</li>
|
||||
<li><strong>字型由消費端負責</strong>:聚珍<strong>不</strong>內建任何 <code>font-family</code>/字型堆疊——逐語言字型完全由消費端 CSS 決定(推薦範式:逐 <code>lang</code> 設於 <code>.juzhen</code> 或帶 <code>lang</code> 之容器,<strong>勿</strong>直接設 <code>jz-inner</code>)。聚珍僅以 <code>jz-* { font: inherit }</code> 使原子繼承消費端字型、不強加,並顯式保留 <code>locl</code>(不改寫 <code>lang</code>、不關閉 locl,故正確標 <code>lang</code> + 用支援 locl 之字型即正常)。半形擠壓依字型 OpenType <code>halt</code>;缺 <code>halt</code> 之字型須用 <code>jiya.halfWidth:"margin"</code> +按字型以 <code>jiya.bias</code> 微調。</li>
|
||||
<li><strong>自動處理</strong>:<code>juzhen.css</code> 已於 <code>.juzhen</code> 範圍內以 <code>@supports</code> 關閉 Blink 原生 <code>text-spacing-trim</code>/<code>text-autospace</code>,並令注入間隙 <code>user-select: none</code>(複製乾淨)。</li>
|
||||
<li><strong>段落屬性照常設、原子透明</strong>:聚珍把標點拆成 <code>inline-block</code> 原子,但已確保原子對消費端段落樣式透明——段落可正常設 <code>text-indent</code>(首行縮排)、<code>hanging-punctuation</code>、<code>text-decoration</code>(下劃線)等。庫內已歸零會被原子重複套用之繼承屬性、並令原子承接段落裝飾,故首行縮排正常、下劃線連續不斷,<strong>無需任何額外配置</strong>。</li>
|
||||
</ol>
|
||||
@@ -205,7 +205,7 @@ JS 只注入 `jz-*` 結構,所有視覺尺寸在 juzhen.css,缺一不可。
|
||||
|
||||
## CSS 基礎設定
|
||||
|
||||
引入 juzhen.css(必須);設 lang;scope class;hyphens:auto;text-align:justify(選用);含 halt 字型或 margin 後備。juzhen.css 之 Noto 字型堆疊僅作後備,消費端 font-family 恆優先。段落屬性照常設、原子透明:text-indent/hanging-punctuation/text-decoration 等已由庫內統一處理(歸零過套用、令原子承接段落裝飾),首行縮排正常、下劃線連續,無需額外配置。
|
||||
引入 juzhen.css(必須);設 lang;scope class;hyphens:auto;text-align:justify(選用)。字型由消費端負責:聚珍不內建 font-family,逐語言字型自設於 .juzhen 或帶 lang 之容器(含 halt 字型,缺則 margin 後備+bias);聚珍以 font:inherit 繼承消費端字型、顯式保留 locl(正確標 lang + 支援 locl 之字型即正常)。段落屬性照常設、原子透明:text-indent/hanging-punctuation/text-decoration 等已由庫內統一處理(歸零過套用、令原子承接段落裝飾),首行縮排正常、下劃線連續,無需額外配置。
|
||||
|
||||
## 分頁器相容
|
||||
|
||||
|
||||
Reference in New Issue
Block a user