格式手冊

本站文本以語義化HTML記錄,記錄時亦盡可能兼顧人機在各種情況下的檢索。

通用格式

元資料

<header>
<h1>本經疏證</h1>
<dl class="元資料">
<div><dt>名稱1</dt><dd><data value="機器值1">顯示值1</data>、<data value="機器值2">顯示值2</data></dd></div>
<div><dt>名稱2</dt><dd>機器及顯示值</dd></div>
<div hidden><dt>名稱3</dt><dd>隱藏的元資料</dd></div>
</dl>
</header>

<header>下的<h1>定義此頁面的主標題。

<dl class="元資料">...</dl>定義此頁面的元資料(後設資料),其中以<dt>定義元資料名稱,<dd>定義該名稱對應的元資料值。為排版考量,原則上會用<div>分組包覆<dt><dd>

<dt><dd>中可用<data value="...">...</data>定義一或多個值。如此例中「名稱1」的機器解析值為「機器值1」、「機器值2」。若無<data>則取<dt><dd>的文字內容為值,如此例中「名稱2」的機器解析值為「機器及顯示值」。

次要的元資料可用<div hidden>隱藏,如此例中的「名稱3」。

其他格式

<ol class="階層列表">:將以下的巢狀<ol><li>輸出如「1.」、「1.1.」、「1.1.1.」、「1.2.」、「2.」……的格式。

典籍專用格式

元資料

<header data-type="book">
<h1>本經疏證</h1>
<dl class="元資料">
<div><dt>作者</dt><dd><data value="朱震亨">朱震亨</data>、<data value="戴思恭">戴思恭</data></dd></div>
<div><dt>朝代</dt><dd><data value="元">元末</data><data value="明">明初</data></dd></div>
<div><dt>年份</dt><dd><data value="1347">公元1347年</data></dd></div>
<div><dt>底本</dt><dd>《古今醫統正脈全書·丹溪心法》,明萬曆29年(1601)吳勉學刊本(<a href="http://nrs.harvard.edu/urn-3:FHCL:27609414?n=2">哈佛燕京圖書館掃描本</a>)</dd></div>
<div><dt>品質</dt><dd>70%</dd></div>
<div><dt>字元替換</dt><dd>{"内": {"古": "内", "今": "內"}}</dd></div>
</dl>
</header>

<header data-type="book">標示此頁面規格為「book」(典籍),以支援各種典籍專用格式。

<header>下的<h1>定義書名(同時也是此頁面的主標題)。

「字元替換」使用JSON值。可用非物件值(如「null」)取消預設值,例如{",": null}表示取消「,」的預設字元替換;{",": {"今": null}}表示把「,」設為在今版不顯示(若用""仍會產生空HTML標籤)。

大綱、段落、縮排

<h1><h2><h3><h4><h5><h6>:標題,用於產生章節大綱,供瀏覽時產生目錄表及檢索時分割章節。預設今版會格式化,獨立成段且放大、加粗;古版為無格式效果的區塊。

<p><div data-sec="p">:段落,供檢索時分割段落。須巢狀嵌套(如古今版本不同分段方式)時可用<div data-sec="p">取代<p>,檢索時只分割到最外層段落。預設今版會格式化並與前後段產生適當間距;古版為無格式效果的區塊。

<br>:強制換行(例如詩歌)。

class="行首對齊"

class="置中對齊"

class="行尾對齊"

class="行首懸浮"

class="行尾懸浮":用於在靠上對齊正文的同一行後面有靠下對齊的文字,例如:

<div><!--
--><h2 data-rev="今版-元素">鄒潤安先生傳</h2><!--
--><div class="行尾懸浮 首行縮進4字 行尾縮進2字">同里周儀顥撰</div><!--
--><div class="中止懸浮"></div><!--
--></div>

class="中止懸浮"

class="行寬#字"

class="縮進#字"

class="行尾縮進#字"

class="首行縮進#字"

class="首行凸出#字"

字元及標點符號

圓圈狀的漢字「零」用「」(U+3007)。

古文漢字間的圓圈斷句,較小的圓圈(約半個字大)用「」(U+25CB),較大的圓圈(約一個字大)用「」(U+25EF)。

古文旁註式句讀直接用現代標點「」(U+3001)、「」(U+FF0C)、「」(U+FF0E)、「」(U+3002)。並修改元資料「字元替換」以免自動將這些標點標示為今版。

古文用於列舉項目的「一」字型符號,使用漢字的「一」記錄,一般可加上頓號並設定縮進1字及首行凸出1字,如下:

<p class="首行凸出1字 縮進1字">一、XXXXXXXXXXXXXXXXXXXX</p>
<p class="首行凸出1字 縮進1字">一、XXXXXXXXXXXXXXXXXXXXXXXXX</p>

現代用於區分外國人姓名的「間隔號」用「·」(U+00B7)。

現代中文破折號用連續兩個「」(U+2014)。表示數字區間用全形連字號「」(U+FF0D)。

現代書名號原則上用「」、「」表示書名,「」、「」表示章節名,例如「《素問》〈上古天真論〉」。可暫時接受用「」、「」及間隔號表示書名及章節名,例如「《素問·上古天真論》」。特別講究排版的場合,可用「<cite>」,例如「素問·上古天真論」。

現代專名號一般省略,如有特別需要使用時,用「<u>」,例如「張仲景」。

常見特殊格式

<small class="雙行夾註">:以一半大小分割為左右兩行書寫的文字,多用於附註或提供次要訊息,日文稱為「分註」或「割註」。可暫時用括號()記錄。

<small class="左右小字">:以一半大小分割為左右兩行並寫兩則訊息的文字。可暫時連用兩組括號()記錄。例如:

祝<small class="左右小字"><span class="右文">王小明</span><span class="左文">李如花</span> 百年好合</small>

<small class="靠右小字">:以一半大小寫於右半行的文字。

<small class="靠左小字">:以一半大小寫於左半行的文字。

<small class="略小字">

<small class="夾註">

<small class="腳註">

<b class="陰文">:黑底白字。可暫時用黑方頭括號【】記錄。

<b class="圓角陰文">黑底白字,邊緣為圖弧形。可暫時用黑方頭括號【】記錄。

<b class="方外框">。可暫時用白方頭括號〖〗記錄。

<b class="圓外框">。可暫時用白方頭括號〖〗記錄。

<b class="圓括號">。可暫時用白方頭括號〖〗記錄。

古版與今版處理

<* data-rev="今版"><ins>:今版元素,於呈現古版時隱藏。

<* data-rev="古版"><del>:古版元素,於呈現今版時隱藏。

<* data-rev="今版-元素">:今版才有作用的元素,呈現古版時忽略此元素(但內容仍會顯示)。

<* data-rev="古版-元素">:古版才有作用的元素,呈現今版時忽略此元素(但內容仍會顯示)。

例如:以下範例表示古版時標題「XXX」縮排兩個字,今版時不縮排:

<div class="縮進2字" data-rev="古版-元素">
<h2>XXX</h2>
</div>

例如:以下範例表示在古版時「XXX……」、「YYY……」、「ZZZ……」排在同一段落中,在今版時則分成標題及二個段落:

<div data-sec="p" data-rev="古版-元素"><!--
--><h2 data-rev="今版-元素">XXXXXX</h2><!--
--><p data-rev="今版-元素">YYYYYYYYYYYYYYY</p><!--
--><p data-rev="今版-元素">ZZZZZZZZZZZZZZZ</p><!--
--></div>

盡可能使用符合底本原貌的異體字記錄。本站會透過轉換表將形似且無字義爭議的字在今版轉為現代常用字。例如「虚」轉「虛」、「脚」轉「腳」、「衆」轉「眾」等。若個別書籍有特殊需要在今版保留原用字,可在元資料設定「字元替換」調整轉換方式。

註文、疏文、校文

<span class="註">:註文是註家對原文的註解,例如王冰註《素問》的文字。

<span class="疏">:疏文是第二註家對原文或註文的註解,例如林億、高保衡校註《素問王冰註》的文字。

<span class="校">:校文是原典所無,而由現代整理者加入的額外內容或註釋。

項目列表

<ul class="隱式列表">:以每層縮排一字的方式顯示多層 ul, li。例如:

<ul class="隱式列表">
<li>項目一
  <ul>
  <li>項目一之一</li>
  <li>項目一之二</li>
  </ul>
</li>
<li>項目二
  <ul>
  <li>項目二之一</li>
  <li>項目二之二</li>
  </ul>
</li>
</ul>

<ul class="行內列表">:以每項固定字數的方式排列,寬度不足時整項移至下一行。例如:

<ul class="行內列表 項寬8字"><li>項目一內容 <li>項目二內容文 <li>...</ul>

表格

<table class="標準框線">:輸出有標準框線的表格。