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

出自DILA Wiki
imported>Chengen.xie
imported>Chengen.xie
行 317: 行 317:
==note 內文中的註解==
==note 內文中的註解==
===原文註===
===原文註===
* 原文註的文字如果與一般段落相同,則直接用 p 標記(不需標記為note)
* 原文就有的註解,可包含多個 p
* 原文就有的註解,可包含多個 p
* '''原文註的文字樣式如果與一般段落相同,則直接用 p 標記(不需標記為note)'''
* 例如:07-09 天台心鑰 p.83
* 例如:07-09 天台心鑰 p.83
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">

於 2020年3月17日 (二) 15:47 的修訂

標記規範參考來源

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="session">
       <head>第一節 西藏的歷史</head>
       <head>西藏的名稱</head>
       <p>西藏民族的古代史,不甚了然,唯由中國內地古史記載中可獲一些消息。據舜竄三苗於三危的傳說......</p>
   </div>
......
</div>

type="section" 節

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

head 標題

  • 包含任何種類的標題,如章節、列表、圖說.....等。
  • 在一個div層次中的第一個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>

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>......因此,中國華嚴宗諸祖的傳承,應該是:</p>
<list>
	<item>初祖杜順(西元五五七―六四○年)</item>
	<item>二祖智儼(西元六○二―六六八年)</item>
	<item>三祖法藏(西元六四三―七一二年)</item>
	<item>四祖慧苑(西元六七三?―七四二?年)</item>
	<item>五祖法詵(西元七一八―七七八年)</item>
	<item>六祖澄觀(西元七三八―八三九年)</item>
	<item>七祖宗密(西元七八○―八四一年)</item>
</list>

@rend

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

  • <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"
  • 大寫字母 rend = "upper-alpha"
<list rend = "lower-alpha">
    <item>...</item>
    <item>...</item>
</list>

@type

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

  • <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>

pb 頁碼

  • 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>
  • 表格內文的換行,例如:06-07 春夏秋冬 p.18
<row>
  <cell>Prof. Roongraung Boonyoros<lb/>龍格讓教授</cell>
  <cell>泰國</cell>
  <cell>清邁大學</cell>
  <cell>Householders and the Five Precepts<lb/>在家人與五戒</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 內文中的註解

原文註

  • 原文就有的註解,可包含多個 p
  • 原文註的文字樣式如果與一般段落相同,則直接用 p 標記(不需標記為note)
  • 例如:07-09 天台心鑰 p.83
<div>
...
 <p>所謂最初,於華嚴會中,不見亦不聞,好像《涅槃經》五味中的全生乳。</p>
 <note>
   <p>〔旭師自註云〕:《華嚴經》九會的前八會中,從未有聲聞會眾,故云不見不
   聞。到了第九會的〈入法界品〉,是在祇園精舍中,始見有聲聞眾參加的記載,當時
   他們已證小乘聖果,唯於菩薩境界,尚是如啞如聾。以此驗知,在這之前,縱然聽聞
   了華嚴,也決不會得益。不過,舍利弗等聲聞眾,先已聽聞小乘三藏教義,方證聖
   果,方來參與入法界會,由此可知,佛說〈入法界品〉,決定不是在說《阿含經》之
   前了。有人為什麼不審思細察,而妄謂《華嚴經》僅是在三七日內說出的呢?</p>
 </note>
</div>

雙行夾註

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

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 註腳參照

  • 使用 ref 表達文中所參照的作者註或註腳編號(紙本通常以圓圈內數字顯示)
  • target 記錄註腳編號
  • resp 記錄註腳屬性 (author 為作者註;editor 為校註)
  • 需和 note 搭配使用,屬性 target 記錄參照的註腳編號
  • 例如:參照第一章第一節的作者註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

  <bibl source="T12n0365p0345c15">《大正藏》一二.三四五頁下</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
<cit>
  <quote>「稱佛名故,除五十億劫生死之罪。」</quote><bibl source="T12n0365p0345c15">《大正藏》一二.三四五頁下</bibl></cit>

圖、表標記說明

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>

row 列

role = "label"

  • 指定為表格標題,可用在 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 格

role = "label"

  • 用在 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>

@cols @row

  • 合併欄或合併列的情況使用
  • <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>

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>

表解圖片

  • 表解圖片為向量檔,與一般圖片不同,標記時需指定寬度以利顯示。
  • n 的值為佔畫面文字的行寬,例如佔畫面約 6行字寬時 n="6"。
<figure>
    <graphic url="07-09p340.svg" n="6"/>
</figure>

行中插圖

  • 行中插圖為文字行中與字寬相等的圖片,圖檔命名原則與圖片相同。
  • 設定 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。