「《法鼓全集 2020 紀念版》標記手冊」：修訂間差異

出自DILA Wiki
imported>Chengen.xie
imported>Chengen.xie
行 248： 行 248：
</syntaxhighlight>
</syntaxhighlight>


[[圖片:01-02-18.png]]
[[圖片:01-02-19.png]]


==head 標題==
==head 標題==

於 2020年3月24日 (二) 13:03 的修訂

標記規範參考來源

XML說明

teiHeader 檔首

<teiHeader>
	<fileDesc>
		<titleStmt>
			<title>法鼓全集2020紀念版第一輯第一冊 明末佛教研究</title>
			<respStmt>
				<resp>Electronic Version by</resp>
				<name>法鼓文理學院 Dharma Drum Institute of Liberal Arts</name>
			</respStmt>
		</titleStmt>
	        <editionStmt>
		        <edition>Version 1.0 (UTF-8)<date>2020/03/30</date></edition>
	        </editionStmt>
	        <sourceDesc>
		        <biblStruct>
			        <monogr>
			        	<title>明末佛教研究</title>
				        <imprint>
					        <pubPlace>台灣‧台北</pubPlace>
					        <publisher>法鼓文化</publisher>
        					<date>2020-12</date>
	        			</imprint>
		        	</monogr>
			        <series>
				        <title>法鼓全集</title>
				        <biblScope type="vol">第一輯‧第一册</biblScope>
			        </series>
		        </biblStruct>
        	</sourceDesc>
        </fileDesc>
</teiHeader>

內文

front 正文前資訊

  • 包含位於文件最前端、正文之前的項目 (標頭、題名頁、前言、獻詞等)
  • 例如 07-14 華嚴心詮 p.55 於正文前的扉頁：
<front>
  <seg rend="appendix">本編</seg>
  <head>《原人論》考釋</head>
</front>

signed 署名

  • 包含結尾致意詞等，可附加在序言、獻詞、或其他文本區段中。
  • 例如：05-04 學佛知津 p.53
<div>
    ......
    <p>最後謝謝貴會主持人李譽先生的邀請，並謝謝趙茂林居士的介紹。謝謝各位。</p>
    <signed>（一九六七年四月十七日講於臺北市甲辰學佛粥會）</signed>
</div>

div 區塊

  • 除特別層次的div (如："part", "section"...) 外，其他的 div 可不用給予 type 屬性。
  • 例如：07-09 天台心鑰 p.67 此處標 div 是為了區別小標題「原文」所在的範圍：
<div>
    <head>原文</head>
    <p>論曰：智者、章安，明文若此，今人絕不寓目，尚自訛傳「阿含十二方 等八」之妄說，為害甚大，故先申通論，次申別論。</p>
</div>

@type

type="part" 章、篇

  • 定義：目錄中第一層次的文義單位。
  • 主要為文章(篇) 或書籍的章。
  • n 的值為章節編號，例如：第一章 標示為 1
<div n="1" type="part">
    <head>第一章 西藏的歷史與環境</head>
    <div n="1.1" type="section">
       <head>第一節 西藏的歷史</head>
       <head>西藏的名稱</head>
       <p>西藏民族的古代史，不甚了然，唯由中國內地古史記載中可獲一些消息。據舜竄三苗於三危的傳說......</p>
   </div>
......
</div>

type="section" 節

  • 定義：目錄中第二層次的文義單位。
  • n 的值為章節編號，例如：第一章第一節 標示為 1.1
<div n="1.1" type="section">
    <head>一、提要</head>
    <p>《法華經》自稱是「諸經中王」，不論從理論方面或實踐方面來看，的...</p>
</div>


p 段落

  • 沒有 rend 屬性時：預設樣式為無縮排、滿版對齊
  <p>《法華經》自稱是「諸經中王」，不論從理論方面或實踐方面來看，的...</p>

@rend

rend = "indent" 第一行縮排

  • 指定樣式為段落第一行縮排2字
  • 法鼓全集中大部份的段落均屬此類
  <p rend="indent">《法華經》自稱是「諸經中王」，不論從理論方面或實踐方面來看，的...</p>
  • 有些段落僅縮排一個字，則使用 "indent-1"，例如：07-14 華嚴心詮 p.77
<p rend="indent-1">儒道二教說，人畜等類，皆是虛無大道生成養育。謂道法自然，生於元氣，元氣生天地，天地生萬物。故愚智、貴賤、貧富、苦樂，皆稟於天，由於時命。故死後卻歸天地，復其虛無。</p>


rend = "outdent" 第一行凸排

  • 指定樣式為段落第一行凸排2字
  <p rend="outdent">《法華經》自稱是「諸經中王」，不論從理論方面或實踐方面來看，的...</p>

rend = "justified-indent" 每行均縮排對齊

  • 指定樣式段落的每行均縮排2字且齊行
  <p rend="justified-indent">《法華經》自稱是「諸經中王」，不論從理論方面或實踐方面來看，的...</p>

lg 詩組、偈頌

  • lg 標誌形成一個正式單位的一群韻句，如：詩節、疊句、行韻的段落等。
  • l 標誌韻文的一行。
  • 例如：06-04 金山有鑛 p.47
<p>......現在我把寫於今（一九九○）年五月十五日的這二十句「共勉語」抄錄 如下：</p>
<lg>
	<l>信佛學法敬僧，三寶萬世明燈；</l>
	<l>提昇人的品質，建設人間淨土；</l>
	<l>知恩報恩為先，利人便是利己；</l>
	<l> 盡心盡力第一，不爭你我多少；</l>
	<l>慈悲沒有敵人，智慧不起煩惱；</l>
	<l>忙人時間最多，勤勞健康最好；</l>
	<l>為了廣種福田，那怕任怨任勞；</l>
	<l>布施的人有福，行善的人快樂；</l>
	<l>時時心有法喜，念念不離禪悅；</l>
	<l>處處觀音菩薩，聲聲阿彌陀佛。</l>
</lg>
  • 偈頌最後一行含有出處，以 bibl 標記，例如：07-07《智慧一〇〇》p.15
<lg>
  <l>多聞令志明，</l>
  <l>己明智慧增；</l>
  <l>智則博解義，</l>
  <l>見義行法安。</l>
  <bibl><title type="jing">──法句經</title><biblScope>卷上．多聞品</biblScope></bibl>
</lg>

list 清單

  • 項目清單的排版格式若同一般段落，則視同段落直接標 p (不標list）。
  • list 用來表示以列表方式呈現的任何連續項目。
  • 樣式設定在 <list> 身上，<item> 不需設屬性。

情況一、無清單項目符號

  • <list> 跟 <item> 均不設屬性
  • 例如 07-14 華嚴心詮 p.41
<p>......因此，中國華嚴宗諸祖的傳承，應該是：
<list>
	<item>初祖杜順（西元五五七―六四○年）</item>
	<item>二祖智儼（西元六○二―六六八年）</item>
	<item>三祖法藏（西元六四三―七一二年）</item>
	<item>四祖慧苑（西元六七三？―七四二？年）</item>
	<item>五祖法詵（西元七一八―七七八年）</item>
	<item>六祖澄觀（西元七三八―八三九年）</item>
	<item>七祖宗密（西元七八○―八四一年）</item>
</list>
</p>

情況二、清單項目符號為小圓點

  • <list> 屬性 rend = "bulleted"
<list rend = "bulleted">
    <item>...</item>
    <item>...</item>
</list>


情況三、清單項目符號為純數字

  • <list> 屬性 rend = "decimal"
<list rend = "decimal">
    <item>...</item>
    <item>...</item>
</list>


情況四、清單項目符號為英文字

  • 小寫字母 rend = "lower-alpha"，例如：01-02 大乘止觀法門 p.113~115
  • 大寫字母 rend = "upper-alpha"
<list rend = "lower-alpha">
    <item>...</item>
    <item>...</item>
</list>

情況五、清單裡含有自訂任意文字

  • <list> 屬性 type="gloss" (*注意此處不是用rend)
  • 序號的文字以 <label> 標記
<list type="gloss">
 <label>（一） </label>
 <item>獎金新台幣二十萬元。</item>
 <label>（二）</label>
 <item>價值新台幣二十萬元的藝術銅雕獎座乙座。</item>
 <label>（三）</label>
 <item>由行政院長蕭萬長先生頒獎。</item>
 <label>（四）</label>
 <item>總統李登輝先生接見並個別合照留念。</item>
 </list>

複雜的例子

  • 要使用段落或項目清單進行標記，需視排版格式及文義而定，由標記人員評估何者較適宜。
  • 如 01-02 大乘止觀法門 p.19 中「(1)《起信論》言:⋯⋯」如一般段落僅有第一行縮排2字，故用 p 標記。自「 (B)《大乘起信論》⋯⋯」第二行的換行看出是清單，故以 list 標記。
  • 段落與項目清單的混用例子如下：
<p>
  (1)《起信論》言:「一切諸法，從本已來，離言說相，離名字相，離心緣相， 畢竟平等，無有變異，不可破壞。唯是一心，故名真如。」
   <list type="gloss">
    <label> (A)</label> <item>《大正》四十六.六四二頁中。 </item>
    <label> (B)</label> <item>《大乘起信論》(陳真諦三藏譯本)，《大正》三十二.五七六頁上，少 一「諸」字。</item>
   </list>
</p>

01-02-19.png

head 標題

  • 包含任何種類的標題，如章節、列表、圖說.....等。
  • 在一個 div 層次中的第一個 head 會被當成該 div 的標題。
  • 在文中標明 head 時，需指定該 head 的div 範圍，例如：07-09 天台心鑰 p.66-67 列出的3個div 標題分別為：原文、語譯、註釋
<div type="section">
<head>一、認識五時的通別</head>
......
<div>
    <pb n="66"/>
	<head>原文</head>
	<p>論曰：智者、章安，明文若此，今人絕不寓目，尚自訛傳「阿含十二方<pb n="67"/>等八」之妄說，為害甚大，故先申通論，次申別論。</p>
</div>
<div>
	<head>語譯</head>
	<p>智者大師及章安尊者，已有如此的明文，迄於今日的天台學派中人，竟爾絕然 不去閱讀，尚且以訛傳訛地跟著亂說什麼「阿含十二方等八」的偈語，對於聖教，為害極大。因此論列，先辨通五時，次辨別五時如下。</p>
</div>
<div>
	<head>註釋</head>
	<p>「阿含十二方等八」：此一偈語，已在本書緒論第一節中論列過了，傳說是出 於唐代的荊溪大師，而唯見載於元代的《四教儀備釋》及《四教儀集註》。</p>
</div>
......
</div>

cb 分欄

  • 標明文字欄之間的分界
  • 屬性n的值為 頁碼-欄。兩欄的狀況：上欄為 1，下欄為 2。三欄的狀況：上欄為 1，中欄為 2，下欄為 3。以此類推。
  • cb 也有可能出現在p段落中。
  • 使用 cb 的情況下，原則將 pb (分頁) 的標記放在上欄。
  • 例如：07-14 華嚴心詮 p.59~ 60
<cb n="59-1"/>
<p> 萬靈蠢蠢，皆有其本，萬物芸芸，各歸其根，未有無根本而有枝末者也......古今之人之事乎？<pb n="60"/><cb n="60-1"/>故數十年中，學無常師...</p>
<cb n="59-2"/>
<p> 宇宙間的一切生命，皆有其各自的根本源頭，一切萬物，必可各各找回其根本。好像樹木一樣，...<cb n="60-2"/>今來的種種人和種種事呢！...</p>

07-14-cb.png

pb 分頁

@n

  • 屬性 n 的值為頁碼，只填數字，前方不需補0
  • <pb> 要放在 div 之前，目次才能捉到正確的頁碼。例如：06-04 金山有鑛 p.23
<pb n="23"/>
<div type="part">
  <head>四、法鼓山的護法會</head>
  <p>
  ......</p>
</div>
  • 內文第一頁之前可能有其他頁面，則頁碼前加 f 字元，例如：09-06.xml
<pb n="f1"/>

lb 分行

段落中的分行

  • 標記文本裡在印刷上的新起行。
  • lb 為空元素 不標行號、不標屬性
  <p>
    <lb/>儒道二教說，人畜等類，皆是虛無大道生成養育。謂道法自然，生於元
    <lb/>氣，元氣生天地，天地生萬物。故愚智、貴賤、貧富、苦樂，皆稟於天，由
    <lb/>於時命。故死後卻歸天地，復其虛無。
  </p>

表格中的分行

  • 表格內文的換行，需加上屬性 break = "yes"，註明它是強迫換行。
  • 例如：06-07 春夏秋冬 p.18
<row>
  <cell>Prof. Roongraung Boonyoros<lb break = "yes"/>龍格讓教授</cell>
  <cell>泰國</cell>
  <cell>清邁大學</cell>
  <cell>Householders and the Five Precepts<lb break = "yes"/>在家人與五戒</cell>
</row>

emph 強調字體

@rend

rend ="bold" 粗體

 <p><lb/><emph rend="bold">成住壞空，空而復成</emph>　佛教對於......緣起緣滅的無常法。</p>

rend ="italic" 斜體

 <p><lb/>這裡是正常的字<emph rend="italic">這裡斜體</emph>這裡還是正常的。</p>

rend ="small" 小字

  • 07-14 華嚴心詮 p.63
 <p>本文計有四篇，名為「原人」。＜原人論序＞<emph rend="small">終</emph>。</p>

註解、註腳參照

note 內文中的註解

行內註解

  • rend = "inline" 表示為行內註解。
  • 行內註解的文字樣式如果與一般段落相同，則不需特別標記為note
  • 行內註解指的為於文章內文顯示的註解內容 (即：不是作者註、校註那種於章節後呈現的註腳形式)
  • 例如：07-09 天台心鑰 p.303
<p>次明別五時者，乃約一類最鈍聲聞，具經五番陶鑄，方得入實。所謂初 於華嚴，不見不聞，全生如乳。
  <note rend="inline">華嚴前八會中，永無聲聞，故云不見不聞。至第九會入法界品，在祇園中，方有聲聞，爾時已證聖果，尚於菩薩境界，如啞如聾。驗 知爾前縱聞華嚴，
  亦決無益。然舍利弗等，由聞藏教，方證聖果，方預入法界會，則知入法界品，斷不說在阿含前矣。人胡略不思察，妄謂華嚴局在三七日內耶？</note>
</p>
<p>次於阿含，聞因緣生滅法，轉凡成聖，如轉乳成酪。<note>酪即熟乳漿也。</note></p>

07-09-303.png

雙行夾註

  • rend = "warichu" 表示為夾註。
  • 夾註中的換行以 lb 標示，並以屬性 break="maybe" 標示。
  • 例如：07-14 華嚴心詮 p.111
......
<lb/>是大乘法相教，四是大乘破相教<note place="warichu">前四在<lb break="maybe"/>此篇中</note>，五是
<lb/>一乘顯性教<note place="warichu">後一在第<lb break="maybe" />三篇中</note>。
......

07-14-111.png

note 作者註、校註

@n

  • n 的值為註解編號，例如註解3為 n="3"
  • note裡可以包含多個p, list，例如：
<note resp="author" n="3">
  <p><lb/><emph rend="bold">成住壞空，空而復成</emph>　佛教對於......緣起緣滅的無常法。</p>
  <p><lb/>《雜阿含經》......</p>
</note>

@resp

  • resp: 標明來源來自作者或編輯

resp="author" 原註 (聖嚴法師)

  • n 的值為 章節編號.第幾個註
  • 例如：第一章第一節的作者註1
<note resp="author" n="1.1.1"><p>印順長老於二○○五年圓寂。</p></note>

resp="editor" 校註 (法鼓文化)

  • 校註因為沒有分章節，故 n 的值為 本書第幾個校註
  • 例如：校註5
<note resp="editor" n="5"><p>參見《法華傳記》卷二（T51, no. 2068, p. 53c16-p. 56a7）。</p></note>

ref 註腳參照

  • 表示文中所參照的作者註或註腳編號（紙本通常以圓圈內數字顯示）
  • 屬性 target 記錄參照的註腳編號。
  • 屬性 resp 記錄註腳屬性 (author 為作者註；editor 為校註)。
  • 需和 note 搭配使用，例如：參照第一章第一節的作者註1
  <ref resp="author" target="1.1.1"/>
  ......
  <note resp="author" n="1.1.1"><p>印順長老於二○○五年圓寂。</p></note>

引文、書目、出處

quote 引文

  • 引文為敘述者或作者引用自文本以外來源的字 (句) 詞或段落。
  • 沒有出處的時候可以單獨使用；有出處時則搭配cit使用。
  • quote 可以包含多個段落p，例如: 10-11.xml
<quote>
  <p>佛告阿難及韋提希：見此事已，次當想佛。....是故應當一心繫念，諦觀彼佛多陀阿伽度阿羅訶三藐三佛陀。</p>
  <p>想彼佛者，先當想像....見如此事，極令明了，如觀掌中。</p>
  <p>見此事已，復當更作一大蓮花在佛左邊....諸蓮花上各有一佛二菩薩像，遍滿彼國。</p>
  <p>此想成時....於現身中，得念佛三昧。</p>
</quote>

bibl 書目

  • 書目不夠清楚時不需標記

@source

CBETA

  • 有明確的經號頁碼及欄位
例如《觀無量壽經》的「下品往生」條下有云：1.「<cit><quote>稱佛名故，除五十億劫生死之罪。 </quote>」
（<bibl source="T12n0365_p0345c15">《大正藏》一二．三四五頁下</bibl></cit>）
  • 僅有經名(經號)
<bibl source="X73n1452">《紫柏尊者全集》</bibl>

法鼓全集

  • 格式為：全集代碼.書號.頁碼
  • 頁碼僅記錄起始頁碼(如下例為 FGQJ.03-08.P22)
  • 篇名、書名：使用 title 標籤，篇名屬性為level="a"，書名為 level="m"。
  • 出版者：使用 publisher 標籤。
<bibl source="FGQJ.03-08.P22">
    <title level="a">〈童年和少年〉</title>，<title level="m">《聖嚴法師學思歷程》</title>，法鼓全集3輯8冊，<publisher>法鼓文化</publisher>，頁22-23
</bibl>

cit 引用出處

  • 同時包含引文及書目：引文 quote、書目 bibl
例如《觀無量壽經》的「下品往生」條下有云：1.「<cit><quote>稱佛名故，除五十億劫生死之罪。 </quote>」
（<bibl source="T12n0365_p0345c15">《大正藏》一二．三四五頁下</bibl></cit>）

圖、表

table 表格

  • [重要] 由於紙本為直式排版（表格為直式），於網頁呈現時為橫式排版（表格為橫式），因此標記時需將表格視為橫式表格進行標記，請特別注意!!

table 表格結構 @cols @row

  • 說明表格有幾欄(cols) 幾列(row)，如下例為2列4欄 rows="2" cols="4"
<table rows="2" cols="4">
　<row role="label">
　　<cell>學者姓名</cell><cell>國籍</cell><cell>所屬學術單位</cell><cell>發表論文主題</cell>
　</row>
　<row>
　　<cell>聖嚴法師</cell><cell>中華民國</cell><cell>中華佛學研究所</cell><cell>從「三聚淨戒」論菩薩戒的時空適應</cell>
　</row>
</table>


cell 合併欄位 @cols @row

  • 合併欄或合併列的情況，在 cell (格)使用
  • <cell rows="數字">：跨列列數
  • <cell cols="數字">：跨欄欄數
  • 下列為跨欄的例子：
<head>（十二）圓教凡聖八位六即圖</head>
<table>
	<row>
		<cell cols="6">聖 位</cell>
		<cell cols="4">凡 位</cell>
	</row>
	<row>
		<cell>妙 覺</cell>
		<cell>等 覺</cell>
		<cell>十 地</cell>
		<cell>十迴向</cell>
		<cell>十 行</cell>
		<cell>十 住</cell>
		<cell>十 信</cell>
		<cell>五 品</cell>
		<cell cols="2"> </cell>
	</row>
	<row>
		<cell>究竟即</cell>
		<cell cols="5">分證即</cell>
		<cell>相似即</cell>
		<cell>觀行即</cell>
		<cell>名字即</cell>
		<cell>理 即</cell>
	</row>
</table>


@role 標題列（欄）

  • 用來指定為表格標題，可用在 row 或 cell 欄位。
  • 用在 row 時用以指定該列為標題列，例如：
<table rows="2" cols="4">
　<row role="label">
　　<cell>學者姓名</cell><cell>國籍</cell><cell>所屬學術單位</cell><cell>發表論文主題</cell>
　</row>
　<row>
　　<cell>聖嚴法師</cell><cell>中華民國</cell><cell>中華佛學研究所</cell><cell>從「三聚淨戒」論菩薩戒的時空適應</cell>
　</row>
</table>


  • 用在 cell 時用以指定該格為標題欄，例如：
<table rows="2" cols="3">
　<row>
　　<cell role="label">學者姓名</cell><cell>聖嚴法師</cell>
　</row>
　<row>
　　<cell role="label">國籍</cell><cell>中華民國</cell>
　</row>
　<row>
　　<cell role="label">所屬學術單位</cell><cell>中華佛學研究所</cell>
　</row>
</table>

figure 圖片

圖片

  • 圖片以 graphic 標記，url為圖檔檔名，圖檔命名原則為「書號p頁碼」，例如：06-07 第14頁的圖片為：06-07p14.jpg
  • 如一頁中有2個以上的圖片，則在圖檔檔名後加 - 流水號，例如：06-07p14-1.jpg, 06-07p14-2.jpg 以此類推
  • 標記時必須包括圖檔的副檔名，例如：.jpg .gif .png .svg
<figure>
 <graphic url="06-07p14.jpg"/>
</figure>

圖片（含圖說）

  • 圖片標題以 head 標記，如果無標題可以省略該標籤。
  • 圖說文字以 figDesc 標記。
<figure>
    <graphic url="06-07p14.jpg"/>
    <head>圖說標題</head>
    <figDesc>戚肩時將軍。</figDesc>
</figure>

表解圖片

  • 表解性質的圖片（如： 01-02 大乘止觀法門 p.40），需使用 indesign 軟體另存成向量檔(.svg) 後視為圖片進行標記。
  • XML檔中可能會出現部分表解文字的碎片，需由標記人員人工刪除。
  • 表解圖片為向量檔，與一般圖片不同，標記時需加上 n 屬性指定寬度以利顯示。
  • n 的值為佔畫面文字的行寬，例如佔畫面約 6行字寬時 n="6"。
<figure>
    <graphic url="07-09p340.svg" n="6"/>
</figure>

07-09-340.png

行中插圖

  • 行中插圖為文字行中與字寬相等的圖片，圖檔命名原則與圖片相同。
  • 設定 rend="inline"，例如：01-04.xml, p.179
一即是《易經》八卦中的「<figure rend="inline"><graphic url="01-04p179-1.gif"/></figure>」，二是八卦中的「<figure rend="inline"><graphic url="01-04p179-2.gif"/></figure>」，......

不標記

  • 原《法鼓全集》有標記，新《法鼓全集2020紀念版》不標記的項目有：人名 persName、地名 placeName、時間 date、手稿 ref。
取自「https://jiva.dila.edu.tw/index.php?title=《法鼓全集_2020_紀念版》標記手冊&oldid=3439」