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

出自DILA Wiki
imported>Chengen.xie
→‎cell
imported>Chengen.xie
 
(未顯示由 3 位使用者於中間所作的 353 次修訂)
行 5: 行 5:
=XML說明=
=XML說明=
==teiHeader 檔首==
==teiHeader 檔首==
* 檔首會於原始檔轉XML檔時建立,請標記人員完成標記後,於 revisionDesc 標籤內更新完成日期並填上自己的姓名。
* titleStmt 中的 title 記錄:書名(不含副標題)。如該書為合集,此處僅記錄本身的書名,合集的書名則記載於 monogr 標籤內。
* 如該書有副標題,則記載於 monogr 標籤內 title (type ="sub") 標示。無副標題時,該標籤留空白。
* 例如05-08 為「漢傳佛教的智慧生活(修訂版)」與「佛法的知見與修行」兩冊的合集,其中「佛法的知見與修行」的teiHeader 如下:
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<teiHeader>
   <teiHeader>
<fileDesc>
     <fileDesc>
<titleStmt>
       <titleStmt>
<title>法 鼓全集2020紀念版第一輯第一冊 明末佛教研究</title>
         <title> 的知見與修行</title>
<respStmt>
         <respStmt>
<resp>Electronic Version by</resp>
           <resp> 電子版本製作</resp>
<name>法鼓文理學院 Dharma Drum Institute of Liberal Arts</name>
           <name>法鼓文理學院 Dharma Drum Institute of Liberal Arts</name>
</respStmt>
         </respStmt>
</titleStmt>
       </titleStmt>
     <editionStmt>
       <publicationStmt>
     <edition>Version 1.0 (UTF-8)<date>2020/03/30</date></edition>
         <publisher> 法鼓文化</publisher>
     </editionStmt>
         <pubPlace> 台灣:台北</pubPlace>
     <sourceDesc>
         <date when="2020">2020</date>
     <biblStruct>
       </publicationStmt>
     <monogr>
       <sourceDesc>
     <title> 明末 佛教 研究</title>
         <biblStruct>
     <imprint>
           <monogr>
     <pubPlace>台灣 台北</pubPlace>
             <title type="main"> 漢傳 佛教 的智慧生活(修訂版)‧佛法的知見與修行</title>
     <publisher>法鼓文化</publisher>
             <title type="sub"></title>
     <date>2020-12</date>
             <imprint>
     </imprint>
               <pubPlace>台灣 台北</pubPlace>
     </monogr>
               <publisher>法鼓文化</publisher>
     <series>
               <date>2020-12</date>
     <title>法鼓全集</title>
             </imprint>
     <biblScope type="vol">第 一册</biblScope>
           </monogr>
     </series>
           <series>
     </biblStruct>
             <title>法鼓全集</title>
     </sourceDesc>
             <biblScope unit="輯" n="5">第 </biblScope>
             <biblScope unit="冊" n="8"> 八冊</biblScope>
           </series>
         </biblStruct>
       </sourceDesc>
      </fileDesc>
      </fileDesc>
</teiHeader>
     <revisionDesc>      
       <change when="2020-03-30"><name>標記人員</name>完成標記</change>
     </revisionDesc>
   </teiHeader>
</syntaxhighlight>
</syntaxhighlight>


=內文標記 明=
=內文=
==front ==
* 包含位於文件最前端、正文之前的項目 (標頭、題名頁、前言、獻詞等)
* front 的位置位於 body 的前面
* 例如扉頁:
<syntaxhighlight lang="XML">
    <front>
     <div><quote>「九二一大地震的所有罹難者都是大菩薩、是老師,用生命做為教材,現身說法,代替二千二百萬臺灣人受災受難,救了我們下一代;我們應該從過去的錯誤中學習重生、感恩,讓社會充滿祥和與善良。」</quote>
     <byline>聖嚴法師於一九九九年十月六日接受《中時晚報》專訪之談話</byline>
     <byline>李總統登輝先生亦於十月十一日於九二一大地震全國追悼大會致詞中引用此段談話</byline></div>
    </front>
    <body>
    ......
</syntaxhighlight>
 
[[圖片:08-05-00.png |500px]]
 
==byline 作品陳述==
* 包含作品的主要責任陳述,出現在題名頁或作品開頭或結尾處。
* 例如:05-04 學佛知津 p.53 結尾
<syntaxhighlight lang="XML">
<div>
   ......
   <p>最後謝謝貴會主持人李譽先生的邀請,並謝謝趙茂林居士的介紹。謝謝各位。</p>
   <byline>(一九六七年四月十七日講於臺北市甲辰學佛粥會)</byline>
</div>
</syntaxhighlight>
 
* '''請注意''' byline 後方出現註解 div 時,會因 byline 本身的限制,不能通過 validate。
* 例如::05-04 學佛知津 p.151~ p.161 以下列 標記 方式無法通過 validate:
<syntaxhighlight lang="XML">
<div type="article" n="8">
  <head>神鬼的種類</head>
    …內文…
  <byline>(臺中農民電台《慈明之聲》播講)</byline>
  <div>
    <head>註解</head>
     … 註解 …
  </div>
</div> 
</syntaxhighlight>
 
* 為了不破壞 div type="article" 的區間範圍,並維持 head 正確所在層次,解決方式為:將內文與byline以div包起來,成為與註解同層的div。
* 修正後可通過 validate 的標記如下(請注意新標的div範圍不含head):
<syntaxhighlight lang="XML">
<div type="article" n="8">
  <head>神鬼的種類</head>
 
  <div>
    …內文…
  <byline>(臺中農民電台《慈明之聲》播講)</byline>
   </div>
 
  <div>
    <head>註解</head>
     … 註解 …
  </div>
</div> 
</syntaxhighlight>
 
==採用新細 體的byline 作品陳述==
(依2020.06.24email討論)
標記以rend給予ming屬性,以09-03 p.213為例:
<syntaxhighlight lang="XML">
<byline rend="ming">聖嚴師父一九九四年二月十日</byline>
</syntaxhighlight>
 
 
 
==div 區塊==
==div 區塊==
===@type===
===@type===
====type="part"  章、 篇 ====
====type="part" 篇 ====
*定 義: 目錄 第一 層次 文義單位
* part 是分區的最大單位,不是每本書都有part,視結構而 (請由書籍的 目錄 判定)。
*主要為 文章(篇) 或 書籍的章。
* part 不需要給屬性 n 。
* 例如 07-14 華嚴心詮 分為「前篇」及「本篇」
 
<syntaxhighlight lang="XML">
<div type="part">
<head><seg rend="appendix">前篇</seg>緒論</head>
<div n="1" type="chapter">
   <head>第一章 西藏的歷史與環境</head>
   <div n="1.1" type="section">
    <head> 第一 節 西藏的歷史</head>
    <head>西藏的名稱</head>
    <p>西藏民族 古代史,不甚了然,唯由中國內地古史記載中可獲一些消息 據舜竄三苗於三危的傳說......</p>
  </div>
......
</div>
<div type="part">
<head><seg rend="appendix">本篇</seg>《原人論》考釋</head>
<div n="1" type="chapter">
   <head>釋題</head>
......
</div>
</syntaxhighlight>
[[圖片:07-14-m1.png |500px]]
 
* 例如 08-05 台灣加油
 
<syntaxhighlight lang="XML">
<div type="part">
<head>第一篇 人心重建.世界平安</head>
<div type="article" n="1">
   <head>地震為什麼發生在臺灣?</head>
......
</div>
</syntaxhighlight>
 
 
==== type="chapter" 章 ====
主要為書籍的章。
* n 的值為章節編號,例如:第一章 標示為 1
* n 的值為章節編號,例如:第一章 標示為 1
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<div n="1" type="part">
<div n="1" type="chapter">
    <head>第一章 西藏的歷史與環境</head>
    <head>第一章 西藏的歷史與環境</head>
    <div n="1.1" type="session">
    <div n="1.1" type="section">
     <head>第一節 西藏的歷史</head>
     <head>第一節 西藏的歷史</head>
     <head>西藏的名稱</head>
     <head>西藏的名稱</head>
行 58: 行 175:


====type="section" 節 ====
====type="section" 節 ====
* 定義: 目錄 中第二層次的文義單位
* 章的下一層 div 標示為 section (請由書籍的 目錄 判定)
* n 的值為章節編號,例如:第一章第一節 標示為 1.1
* n 的值為章節編號,例如:第一章第一節 標示為 1.1
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<div n="1.1" type="section">
<div n="1.1" type="section">
行 67: 行 185:
</syntaxhighlight>
</syntaxhighlight>


=== 特殊狀況===
====type="article" 文章 ====
*ex. 07-14華嚴 有分緒篇 本篇 此「 的編號 前要加上???
* 如果該書沒有分章節,而是文章的集合體 (請由書籍的目錄判定)。
* n 的值為文章編號,例如:第一篇文章 標示為 1
* 例如 08-05 台灣加油
 
<syntaxhighlight lang="XML">
<div type="part">
<head>第一篇 人心重建.世界平安</head>
<div type="article" n="1">
   <head>地震為什麼發生在臺灣?</head>
......</div>
<div type="article" n="1">
   <head>是天災?是人禍?</head>
......</div>
</div>
</syntaxhighlight>
 
* 除特別層次的div (如:"part", "chapter", "section", "article"...) 外,其他的 div 可不用給予 type 屬性。
* 例如:07-09 天台 鑰 p.67 此處標 div 是為了區別小標題「原文」所在的範圍:
<syntaxhighlight lang="XML">
<div>
   <head>原文</head>
   <p>論曰 智者 章安 明文若 ,今人絕不寓目,尚自訛傳 阿含十二方 等八 」之 妄說,為害甚大,故先申通論,次申別論。</p>
</div>
</syntaxhighlight>


==p 段落==
==p 段落==
*沒有 rend 屬性時:預設樣式為無縮排、滿版對齊
<syntaxhighlight lang="XML">
  <p>《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
</syntaxhighlight>
===@rend===
===@rend===
==== 指定====
====rend = "indent" 第一行縮排 ====
*未 指定rend 屬性時: 預設 段落樣式為第一行縮排2字
* 指定 樣式為段落第一行縮排2字
*法鼓全集中大部份的段落均屬此類
<syntaxhighlight lang="XML">
  <p rend="indent">《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
</syntaxhighlight>
 
<s>*有些段落僅縮排一個字,則使用 "indent-1",例如:07-14 華嚴心詮 p.77</s>
<s><syntaxhighlight lang="XML">
<p rend="indent-1">儒道二教說,人畜等類,皆是虛無大道生成養育。謂道法自然,生於元氣,元氣生天地,天地生萬物。故愚智、貴賤、貧富、苦樂,皆稟於天,由於時命。故死後卻歸天地,復其虛無。</p>
</syntaxhighlight></s>
<span style="color: red">2020/7/8更新: 此範例應使用quote標示,故刪除 indent-1 屬性。</span>
 
====rend = "outdent" 第一行凸排 ====
*指定樣式為段落第一行凸排2字
<syntaxhighlight lang="XML">
  <p rend="outdent">《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
</syntaxhighlight>
 
* 指定樣式為段落第一行凸排n字,以英文字母o加凸排字數,例如凸排3字為 o3,例: 09-12《法鼓道風》目錄後、正文前
<syntaxhighlight lang="XML">
<front>
<div>
<p rend="o3"><lb/>編案:本書部分選文曾收錄於《法鼓山僧伽大學年報》、《僧林悟語》,
其他選文<lb/>則曾發表於《人生》雜誌與《法鼓》雜誌,但皆 集結出版,今依相關主題<lb/>彙編成書出版。 </p>
</div>
</front>
<body>
......
</body>
</syntaxhighlight>
[[圖片:09-12.png| 600px]]
 
====其它首行、左邊界變化(需注意,限用於未被其它標記改排版的段落)====
 
改左邊界:m+數字,代表左邊界縮幾字。
 
改首行:i+數字,代表首行縮排幾字;o+數字,代表首行凸排幾字。
 
若要同時更改左邊界與首行(以縮排為例):rend="m3 i2",m3與i2間為半形空格。<--罕用。
 
 
常用者如下:
 
1.首行凸排三字:
<syntaxhighlight lang="XML">
<p rend="o3">…內文…</p>
</syntaxhighlight>
2.首行縮排三字:
<syntaxhighlight lang="XML">
<p rend="i3">…內文…</p>
</syntaxhighlight>
 
 
 
====rend = "big" 強調大字 ====
*屬於段落文字(非標題)的強調大字,例如:08-05 台灣加油 p.78
<syntaxhighlight lang="XML">
  <p rend="big">眼看傷者與死神搏鬥 心中有更多的不忍......</p>
</syntaxhighlight>
[[圖片:08-05-78.png]]
 
 
====rend = "postscript" 後記 ====
*以不同文字呈現的後記段落,例如:08-05 台灣加油 p.88 ~ 89
<syntaxhighlight lang="XML">
  <p rend="postscript">
  後記:因為地震停電的緣故,使得這場對談必須在屋外進行。一干人與法師坐 在涼亭中,清風徐徐地吹著,雖然,和著蟲鳴鳥叫幾乎淹沒了師父的聲音,但是,
  我們清楚地聽見聖嚴法師莊嚴地說著:災難的發生和整個社會的人心有著很大的關 係。在秋日的午後,坐在涼亭裡聽師父的開示,對大家是一種可貴的人生領悟。
</p> 
<byline>(一九九九年十月一日《勁報》刊出,王艾琪整理)</byline>
 
</syntaxhighlight>
[[圖片:08-05-88.png|900px]]
 
====<p rend="indent bold">使用於PDF特定排版小標題====
例如:05-01 p.222
<syntaxhighlight lang="XML">
<p rend="indent bold">1調身法</p>
</syntaxhighlight>
[[圖片:Pic.jpg]]
 
====rend = "note" 自成一個段落的批註 ====
例如:04-01 p.170
<syntaxhighlight lang="XML">
<p rend="note">雲棲評曰:......悟則無二。</p>
</syntaxhighlight>
 
== milestone 分界點 ==
* [重要] 每冊的第一個 milestone 應緊連在第一個頁碼前,例:09-09
<syntaxhighlight lang="XML">
<text>
   <milestone unit="doc"/>
   <pb n="1"/>
   <front> ...</front>
   <body> ...</body>
</text>
</syntaxhighlight>
 
* 用來標示轉換成網頁時 '''一個文件''' 的範圍。判斷範圍的基本原則是依目錄區分。
屬性 unit = "doc"
* milestone '''必須放在區分的div之外以及頁碼前''',才能抓取完整的 div 內容。
* 如果該書為文集,則一篇文章會分成一個文件。例如:08-01 法鼓鐘聲 (請注意milestone的位置在 article的div之外)
* 如為'''篇名頁之後的第一章或第一篇文''',則milestone改標在篇名頁頁碼前。
 
<syntaxhighlight lang="XML">
<milestone unit="doc"/>
<pb n="11">
     <div type="article" n="1">
       <head>謹慎處理家庭暴力事件</head>
       ......
     </div>
<milestone unit="doc"/>
<pb n="13">
     <div type="article" n="2">
       <head>天災是老天對人類的懲罰嗎?</head>
       ......
     </div>
     <milestone unit="doc"/>
<pb n="15">
     <div type="article" n="3">
       <head>舍我其誰</head>
       ......
     </div>
</syntaxhighlight>
 
[[圖片:08-01-00.png |500px]]
 
* 如果該書為章節,原則是以一章分成一個文件。例如:07-14 華嚴心詮
<syntaxhighlight lang="XML">
<milestone unit="doc"/>
<pb n="55">               
<div type="part">
<head><seg rend="appendix">前篇</seg>緒論</head>
 
<pb n="66">                '''(請注意,雖這裡是一章,但由於前有篇名頁,因此milestone改標在篇名頁的頁碼前)'''
  <div type="chapter" n="1">        
    <head>第一章 華嚴學 </head>
    <div type="section" n="1.1">
     <head>一、《華嚴經》的傳譯</head>
    </div>
    <div type="section" n="1.2">
     <head>二、《華嚴經》的內容</head>
    </div>
    <div type="section" n="1.3">
     <head>三、《十地經》與《十地論》</head>
    </div>
    <div type="section" n="1.4">
     <head>四、華嚴宗的先驅</head>
    </div>
  </div>
  <milestone unit="doc"/>         '''(篇名頁後第二個章起,恢復至平常milestone的標記方式)'''
  <pb n="77">
  <div type="chapter" n="2">
    <head>第二章 華嚴宗</head>
    <div type="section" n="2.1">
     <head>一、初祖杜順—神異禪者</head>
    </div>
    <div type="section" n="2.2">
     <head>二、二祖智儼—精通梵漢</head>
    </div>
    <div type="section" n="2.3">
     <head>三、三祖法藏—集大成者</head>
    </div>
    <div type="section" n="2.4">
     <head>四、四祖澄觀—疑點特點</head>
    </div>
    <div type="section" n="2.5">
     <head>五、五祖宗密—禪教一致</head>
    </div>
  </div>
</div>
</syntaxhighlight>
 
==lg ==
===詩組、偈頌===
* lg 標誌形成一個正式單位的一群韻句,如:詩節、疊句、行韻的段落等。
* l 標誌韻文的一行。
* 例如:06-04 金山有鑛 p.47
<syntaxhighlight lang="XML">
<p>......現在我把寫於今(一九九○)年五月十五日的這二十句「共勉語」抄錄 如下:</p>
<lg>
<l>信佛學法敬僧,三寶萬世明燈;</l>
<l>提昇人的品質,建設人間淨土;</l>
<l>知恩報恩為先,利人便是利己;</l>
<l>盡心盡力第一,不爭你我多少;</l>
<l>慈悲沒有敵人,智慧不起煩惱;</l>
<l>忙人時間最多,勤勞健康最好;</l>
<l>為了廣種福田,那怕任怨任勞;</l>
<l>布施的人有福,行善的人快樂;</l>
<l>時 心有法喜,念念不離禪悅;</l>
<l>處處觀音菩薩,聲聲阿彌陀佛。</l>
</lg>
</syntaxhighlight>
 
* 引用詩偈之出處:
使用byline並標於lg之內,見07-05 p.15
<syntaxhighlight lang="XML">
<quote><lg>
 <l>多聞令志明,己明智慧增;</l>
 <l>智則博解義,見義行法安。</l>
 <byline>──法句經卷上.多聞品</byline>
</lg></quote>
</syntaxhighlight>
 
===開場引言===
 
* 文章前面的開場白也以lg 標記,例如:08-05 台灣加油 p.127
 
<syntaxhighlight lang="XML">
<div>
   ......
     <lg>
       <l>法鼓山委託教育部</l>
       <l>將人心重建安心手冊送到災區的學校,</l>
       <l>希望將愛與關懷送到他們的手中,</l>
       <l>進行生命教育的人心重建。</l>
     </lg>
   <p>法鼓山文教基金......
</div>
</syntaxhighlight>
 
[[圖片:08-05-127.png|500px]]
 
===文末法語===
 
* 文末以小語格式呈現的師父法語也使用lg 標示,並於外層加上div 屬性 rend="motto" 標示所含範圍。
* 由於小語為額外附加的,不屬於文章內容,故不包含在屬性 article 的 div 中。
* 例如:08-05 台灣加油 p.27
 
<syntaxhighlight lang="XML">
<div type="article" n="5">
...
</div>
<div rend="motto">
   <head>聖嚴法師人心重建法語之二</head>
     <lg>
       <l>救苦救難的是菩薩, </l>
       <l>受苦受難的是大菩薩。</l>
     </lg>
</div>
</syntaxhighlight>
 
[[圖片:08-05-27.png|500px]]
 
===問與答===
以rend="qa"給div屬性,當中"問與答"三字須使用<head>處理。
e.g.07-15 p.46
<syntaxhighlight lang="XML">
<div rend="qa">
<head>問與答</head>
<p rend="o3"><lb/>信眾:如果做懶人也不要緊,但是這跟自己的業有沒有關係?</p>
...
</div>
</syntaxhighlight>
 
==list 清單==
* '''項目清單的排版格式若同一般段落,則視同 段落 直接標 p (不標list)'''。
* list 用來表示以列表方式呈現的任何連續項目。
樣式 設定在 <list> 身上,<item> 不需設屬性。
* 於2020.06.09主旨「05-01 p.222~223」 email,承恩補充項目定義:
  項目後方必須有半形句點「.」:
  a. 項目  (符合定義)
  a 項目 (不符合定義)
 
=== 情況一、無清單項目符號 ===
* <list> 跟 <item> 均不設屬性
* 例如 07-14 華嚴心詮 p.41
<syntaxhighlight lang="XML">
<p>......因此,中國華嚴宗諸祖的傳承,應該是:
<list>
<item>初祖杜順(西元五五七―六四○年)</item>
<item>二祖智儼(西元六○二―六六八年)</item>
<item>三祖法藏(西元六四三―七一二年)</item>
<item>四祖慧苑(西元六七三?―七四二?年)</item>
<item>五祖法詵(西元七一八―七七八年)</item>
<item>六祖澄觀(西元七三八―八三九年)</item>
<item>七祖宗密(西元七八○―八四一年)</item>
</list>
</p>
</syntaxhighlight>
 
=== 情況二、清單項目符號為小圓點===
* <list> 屬性 rend = "bulleted"
 
<syntaxhighlight lang="XML">
<list rend = "bulleted">
   <item>...</item>
   <item>...</item>
</list>
</syntaxhighlight>
 
 
=== 情況三、清單項目符號為純數字===
* <list> 屬性 rend = "decimal"
 
<syntaxhighlight lang="XML">
<list rend = "decimal">
   <item>...</item>
   <item>...</item>
</list>
</syntaxhighlight>
 
* 如為純數字,但清單並非由1開始編號者,則在 list 加入屬性 n 記錄開始數字
* 例如 04-15 p.139 清單編號由 7 開始:
<syntaxhighlight lang="XML">
<list rend = "decimal" n="7">
  <item><lb/>頭部緩慢地往左後轉,...</item>
  <item><lb/>頭部緩慢地往左後轉,...</item>
  ......
</list>
</syntaxhighlight>
 
=== 情況四、清單項目符號為英文字===
* 小寫字母 rend = "lower-alpha",例如:01-02 大乘止觀法門 p.113~115
* 大寫字母 rend = "upper-alpha"
 
<syntaxhighlight lang="XML">
<list rend = "lower-alpha">
   <item>...</item>
   <item>...</item>
</list>
</syntaxhighlight>
 
=== 情況五、清單裡含有自訂任意文字 ===
* <list> 屬性 type="gloss" (*注意此處不是用rend)
* 序號的文字以 <label> 標記
 
<syntaxhighlight lang="XML">
<list type="gloss">
<label>(一) </label>
<item>獎金新台幣二十萬元。</item>
<label>(二)</label>
<item>價值新台幣二十萬元的藝術銅雕獎座乙座。</item>
<label>(三)</label>
<item>由行政院長蕭萬長先生頒獎。</item>
<label>(四)</label>
<item>總統李登輝先生接見並個別合照留念。</item>
</list>
</syntaxhighlight>
 
* 例如:08-05 台灣加油 p.153
<syntaxhighlight lang="XML">
<head>三、安撫幼小心靈</head>
<p>我們能 孩子做什麼?</p>
<list type="gloss">
<label>分享</label>
<item>開誠布公地與孩子談論對災變的感受,也傾聽孩子內心的感覺。</item>
<label>解釋</label>
<item>用孩子聽得懂的話,告訴他們發生了什麼事,提供他們應該了解的資訊。 安撫 告訴孩子一切已經安全了,我們不會再分開,會在身邊陪伴孩子、保護孩子。</item>
<label>擁抱</label>
<item>時常擁抱孩子,給他們溫暖的關愛。尤其在入睡前,多花點時間彼此共處。</item>
<label>宣洩</label>
<item>讓孩子想哭就哭。對失去的玩具、心愛的物品、逝去的親友等哀傷情緒,藉畫畫、聊天得以宣洩。如果在學校出現情緒問題,不妨與老師溝通,請老師幫忙,協助孩子度過難關。</item>
</list>
</syntaxhighlight>
 
[[圖片:08-05-153.png|500px]]
 
===複雜的例子===
* 要使用段落或項目清單進行標記,需視排版格式及文義而定,由標記人員評估何者較適宜。
* 如 01-02 大乘止觀法門 p.19 中 第 9 行「(1)《起信論》言:⋯⋯」如一般段落僅有 第一行縮排2字 ,故用 p 標記。自「 (B)《大乘起信論》⋯⋯」
* 此例自清單的縮排看出是清單list 包含在 p 之中,故用 p 包 list,否則沒有強制限制 list 需包含在 p 之中。
* 段落與項目清單的混用例子如下:
<syntaxhighlight lang="XML">
<p>
  (1)《起信論》言:「一切諸法,從本已來,離言說相,離名字相,離心緣相, 畢竟平等,無有變異,不可破壞。唯是一心,故名真如。」
  <list type="gloss">
   <label> (A)</label> <item>《大正》四十六.六四二頁中。 </item>
   <label> (B)</label> <item>《大乘起信論》(陳真諦三藏譯本),《大正》三十二.五七六頁上,少 一「諸」字。</item>
  </list>
</p>
</syntaxhighlight>
 
[[圖片:01-02-19.png|600px]]
 
==head 標題==
 
* 包含任何種類的標題,如章節、列表、圖說.....等。
* 在一個 div 層次中的第一個 head 會被當成該 div 的標題。
* 在文中標明 head 時,需指定該 head 的div 範圍,例如:07-09 天台心鑰 p.66-67 列出的3個div 標題分別為:原文、語譯、註釋
 
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p> 《法華經》 稱是 諸經 」, 論從理 論方面或 面來看 ,的...</p>
<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>
</syntaxhighlight>
 
* 標題內含其他字型及作者時,以seg 搭配屬性rend 標示。
* 在標題旁表示該篇文章性質的小字:rend="head-label"
<syntaxhighlight lang="XML">
<head>
  <seg rend="head-label">附錄七</seg> 
    夢中的拓荒者
  <seg rend="author">李果然</seg>  
</head>
</syntaxhighlight>
 
* 在標題旁表示該篇文章性質的小字:rend="head-label"
 
* 標題中的註 :採用無屬性note。實例如下(from 03-09 p.67)
<syntaxhighlight lang="XML">
<head>白聖長老—戮力於護國衛教<note>(八十大壽誌慶)</note></head>
</syntaxhighlight>
 
* 標題帶副標題:rend="subheading"。範例(from 05-08-2 p.81):
<syntaxhighlight lang="XML">
<head>佛法的三個層次:信仰、理解、實踐<seg rend="subheading">— 信仰入手、明因果到超越</seg></head>
</syntaxhighlight>
 
* 作者註的標題(e.g. 03-01 p.47):因其出現的層級不固定,若僅以包覆div層數決定呈現樣式可能會忽大忽小,故以rend="author-note"給予屬性來處理。
<syntaxhighlight lang="XML">
<head rend="author-note">
註解
</head>
</syntaxhighlight>
 
* 細明體標題<head rend="o3 ming">
特徵:
一般出現在「節」的下一個層級。
多半有全形括號+中文數字編號。
 
e.g. 01-01 p.30
<syntaxhighlight lang="XML">
<head rend="o3 ming">(一)明末禪者的地 分布表</head>
</syntaxhighlight>
 
=== 標題僅出現於目錄 ===
* 當標題僅出現在目錄、而未出現在內文時,使用head標籤、rend 屬性值為 hidden。
* 例如: 00-00 p.6 於目錄中為「作者七十自題」,而內文實際標題為「七十自題」,出現於目錄者為 head,未出現於目錄者以 p 標記。
* 範例如下:
<syntaxhighlight lang="XML">
  <div type="article" n="3">
   <head rend="hidden">作者七十自題</head>
   <p rend="head">七十自題</p>
   ...
  </div>
</syntaxhighlight>
 
=== 標題中部份內容未出現於目錄 ===
* 當標題包含的部份內容僅出現在內文、而未出現在目錄時,在 rend 屬性加上 not-toc。
* 例如: 04-06 p.379 於目錄中為「附錄 〈默照銘〉全文」,而內文 際標題為「附錄 〈默照銘〉全文 宏智正覺」,其中「宏智正覺」加上 not-toc 屬性。
* 範例如下:
<syntaxhighlight lang="XML">
  <pb n="379"/>
  <div type="article" n="29">
  <head><seg rend="head-label">附錄</seg>〈默照銘〉全文<seg rend="author not-toc">宏智正覺</seg></head>
   ...
  </div>
</syntaxhighlight>
 
== pb 分頁 ==
===@n===
* 屬性 n 的值為頁碼,只填數字,前 不需補0
* <pb> 如果位在 div 的開頭 請放在 div 之外。例如:06-04 金山有鑛 p.23
<syntaxhighlight lang="XML">
<pb n="23"/>
<div type="part">
  <head>四、法鼓山 護法會</head>
  <p>
  ......</p>
</div>
</syntaxhighlight>
</syntaxhighlight>


====rend =??? 第一 行凸排 ====
* 內文 第一 頁之前可能有其他頁面,則頁碼前加 f  元,例如:09-06.xml
*指定段落樣式為第一行凸排2
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p rend="???">《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
<pb n="f1"/>
</syntaxhighlight>
</syntaxhighlight>


====rend =??? 齊行 ====
 
* 指定段落樣 為齊行滿版(無凸排、無縮排)
* 電腦自動轉出的初步XML,pb 可能會被包在 p 段落'''結尾處''',如下 :
......<pb n="1"/></p>
 
  這種情況請標記人員將它移至段落之外,如下:
  ......</p><pb n="1"/>
 
* 空白頁不標pb,因此需手動刪除程式轉出的空白頁pb。例如程 轉出如下:
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p rend="???"> 《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
<pb n="1"/>
<pb n="2"/>
<pb n="3"/>
<div type="chapter">
...
</div>
</syntaxhighlight>
</syntaxhighlight>


*指定段落樣式為齊行縮排(每行均縮排2字)
這種情況請標記人員將空白pb刪除,刪除後如下:
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p rend="???"> 《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
<pb n="3"/>
<div type="chapter">
...
</div>
</syntaxhighlight>
</syntaxhighlight>


=== table中的pb ===
* table 用在標記表格時,table 中的 pb 仍需標記,但僅為記錄,介面並不會顯示頁碼。
* table 用在文字排版的,table 中的 pb 必須顯示,故需要加上 rend="show" 屬性,以示區別。
例如:04-03 第 114 頁,table用於文字排版
<syntaxhighlight lang="XML">
<cell>
...
<lb/>動心,食知其味卻不動心,庵<pb n="114" rend="show"/><lb/>前庵後的花紅水綠,也只是自<lb/>然景物的自然存在,既不拒之<lb/>
...
</cell>
</syntaxhighlight>


==pb 頁碼==
==lb 分行==
===段落中的分行===
* 標記文本裡在印刷上的新起行。
* lb 為空元素 '''不標行號'''、'''不標屬性'''
* 初步轉出給標記人員使用的XML內已有 lb 標記,請標記人員檢查 lb 標記位置是否正確。
* 未出現 lb 時,請標記人員手動加上(註:通常容易出問題的行是在段落最後且小於三個字的行,以及有補漏字的行(因漏字無法自動比對位置))。
<syntaxhighlight lang="XML">
  <p>
   <lb/>儒道二教說,人畜等類,皆是虛無大道生成養育。謂道法自然,生於元
   <lb/>氣,元氣生天地,天地生萬物。故愚智、貴賤、貧富、苦樂,皆稟於天,由
   <lb/>於時命。故死後卻歸天地,復其虛無。
  </p>
</syntaxhighlight>


==lb 斷行==
===表格中的分行===
* 表格內文的換行,需手動加上 lb
* 例如:06-07 春夏秋冬 p.18
<syntaxhighlight lang="XML">
<row>
  <cell>Prof. Roongraung Boonyoros<lb/>龍格讓教授</cell>
  <cell>泰國</cell>
  <cell>清邁大學</cell>
  <cell>Householders and the Five Precepts<lb/>在家人與五戒</cell>
</row>
</syntaxhighlight>
===強制 斷行===
* <lb break="yes"/>


e.g.07-14 p.295
<syntaxhighlight lang="XML">
<head><seg rend="subheading">附錄二</seg>《原人論》語體譯<seg rend="author">終南山草堂寺沙門宗密述<lb break="yes"/>法鼓山沙門聖嚴語體譯註</seg></head>
</syntaxhighlight>


==emph 強調 ==
==seg ==
===@rend===
* seg 為任意分割的字詞單元,在全集標記中可利用屬性 rend 來標示特殊字體。
=== @rend===
====rend ="bold" 粗體====
====rend ="bold" 粗體====
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p><lb/><emph rend="bold">成住壞空,空而復成</emph> 佛教對於......緣起緣滅的無常法。</p>
  <p><lb/><seg rend="bold">成住壞空,空而復成</seg> 佛教對於......緣起緣滅的無常法。</p>
</syntaxhighlight>
</syntaxhighlight>


====rend ="italic" 斜體====
====rend ="italic" 斜體====
可用在內文,也可以使用於標題出現斜體字的情況。
<syntaxhighlight lang="XML">
<p><lb/>這裡是正常的字<seg rend="italic">這裡斜體</seg>這裡還是正常的。</p>
</syntaxhighlight>
====rend ="small" 小字====
* 07-14 華嚴心詮 p.63
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <p><lb/>這裡是正常的字<emph rend="italic"> 這裡斜體</emph> 這裡還是正常的 。</p>
  <p> 本文計有四篇,名為「原人」。<原人論序><seg rend="small"> </seg>。</p>
</syntaxhighlight>
</syntaxhighlight>


==note 註解==
====rend ="ming" 明體字====
===@n===
* 07-02 福慧自在 p.54
* n 為註解編 ,例如註 解3 n="3"
<syntaxhighlight lang="XML">
* note裡可以包含多個p, list,例如:
「所謂佛法者,即非佛法。」<seg rend="ming">=證大小乘聖果,即非證果。</seg>
...... <seg rend="ming">因</seg>
</syntaxhighlight>
 
====rend ="kai" 楷體字====
* 11-02 聖嚴法師年譜 p.26
<syntaxhighlight lang="XML">
<p rend="kai">蓮塘上人</p>
</syntaxhighlight>
 
=註解、註腳參照=
 
==note  文內 註解==
=== 編案===
* rend = "ednote" 表示為編案(editor note 簡寫)。
* '''編案的文字樣式如果與一般段落相同,則不需特別標記為note'''
* 編案 編輯者呈現於文章內文顯示的 註解 內容 (即:不是作者註、校註的註腳形式),'''附記''' 也是編案的一種。
* 編案不需註明來源,故不需要標註 resp 屬性。例如: 09-10 法鼓晨音 p. 10
<syntaxhighlight lang="XML">
<note rend="ednote"> 案:各篇文末加註聖嚴法師開示的日期。</note>
</syntaxhighlight>
 
 
 
===單行夾註===
* 文字間穿插單行註解時使用。
* 可使用在<nowiki><p rend="big"></nowiki>段落之中。
* 可使用在作者於文字間註明其出處時 實例如04-02 p.19「(以上錄自《高僧傳》卷七......五十.三六六頁中─三六七頁上)」等字樣。
 
例如 :07-09 天台心鑰 p.303
<syntaxhighlight lang="XML">
<p>次明別五時者,乃約一類最鈍聲聞,具經五番陶鑄,方得入實。所謂初 於華嚴,不見不聞,全生如乳。
  <note rend="inline">華嚴前八會中,永無聲聞,故云不見不聞。至第九會入法界品,在祇園中,方有聲聞,爾時已證聖果,尚於菩薩境界,如啞如聾。驗 知爾前縱聞華嚴,
  亦決無益。然舍利弗等,由聞藏教,方證聖果,方預入法界會,則知入法界品,斷不說在阿含前矣。人胡略不思察,妄謂華嚴局在三七日內耶?</note>
</p>
<p>次於阿含,聞因緣生滅法,轉凡成聖,如轉乳成酪。<note>酪即熟乳漿也。</note></p>
</syntaxhighlight>
 
[[圖片:07-09-303.png|500px]]
 
===雙行夾 ===
* rend = "warichu" 表示 夾註。
* 換行 lb 標示於夾註內。
* 例如:07-14 華嚴心詮 p.164
<syntaxhighlight lang="XML">
......
<lb/>造種種業,以致淪於無窮的生死苦海<note rend="warichu">已如前面的小乘
<lb/>教中所說</note>,悟解如此的道理,始知我們的身命,是
<lb/>唯識所變,識為身命的根本源頭<note rend="warichu">至於為何法相教是不了義的淺教,待
<lb/>到下一節的破相教中破斥</note>。
</syntaxhighlight>
[[圖片:07-14-163.png|500px]]
 
== note 作者註、校註 ==
 
===@xml:id===
* xml:id 的值為 n 加上註解編號,編號方式請見下節'''@resp '''原註 (聖嚴法師)、 校註 (法鼓文化) 兩段詳述。
* note裡可以包含多個p, list,例如 ,章節1.1的第3個作者註
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<note resp="author" n="3">
<note resp="author" xml:id="n1.1.3">
   <p><lb/><emph rend="bold">成住壞空,空而復成</emph> 佛教對於......緣起緣滅的無常法。</p>
   <p><lb/><seg rend="bold">成住壞空,空而復成</seg> 佛教對於......緣起緣滅的無常法。</p>
   <p><lb/>《雜阿含經》......</p>
   <p><lb/>《雜阿含經》......</p>
</note>
</note>
行 125: 行 863:


===@resp===
===@resp===
* resp: 標明來源來自作者或編輯
* resp: 標明來源來自作者(原註 author) 或編輯(校註 editor)。
==== resp="author" 原註(聖嚴法師)====
==== resp="author" 原註 (聖嚴法師)====
* 有分章節的書:n 的值為 章節編號.第幾個註
* 例如:第一章第一節的'''作者註1'''
<syntaxhighlight lang="XML">
<note resp="author" xml:id="n1.1.1">
  <p>印順長老於二○○五年圓寂。</p>
</note>
</syntaxhighlight>
 
* 不分章節的書:n 的值為 第n篇文章.第幾個註
* 例如:05-02 第16篇文章 p.44 '''作者註1'''
<syntaxhighlight lang="XML">
<note resp="author" xml:id="n16.1">
  <p>《增一阿含經》卷六〈利養品〉:有一婆羅門勸佛至孫陀羅江側沐浴除罪,佛以不與取、不殺生、不妄語、無增減心等告之洗罪。</p>
</note>
</syntaxhighlight>
 
* 在不分章節書籍,但文章各大段重新起算註數的情形 (見03-01各篇)
以「分章節書籍的作者註」方式做處理。
 
a.書末標記
 
<syntaxhighlight lang="XML">
   <note resp="author" xml:id="nx.y.z "><p><lb/>註解</p></note>
</syntaxhighlight>
 
x=第幾章、y=第幾段、z=本註為該段第幾個作者註。
 
b.內文標記
<syntaxhighlight lang="XML">
<p rend="indent">文章……<ref target="#nx.y.z"/>。</p>
</syntaxhighlight>
 
* 作者註中出現凸排三字的條列式(見01-01 p.20第六條作者註):
以rend="o3"給予p屬性,e.g.
<syntaxhighlight lang="XML">
<p rend="o3"><lb/>(一)明初……<lb/>《卍續藏》……</p>
<p rend="o3"><lb/>(二)明初……</p>
</syntaxhighlight>
 
*針對07-14作者註註文特殊排版
在note中,以rend="note-like-p"給予屬性。
註文部分加上p rend="indent"。
 
e.g.07-14 p.68:註文排版同一般正文。
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<note resp="author" n="1"><p> 印順長老於二○○五年圓寂。</p></note>
<note rend ="note-like-p" resp="author" xml:id="n3.9">
<p rend="indent"><lb/><seg rend="bold">混沌一氣</seg>  混沌又名渾沌……</p>
</note>
</syntaxhighlight>
</syntaxhighlight>


==== resp="editor" 校註(法鼓文化)====
 
==== resp="editor" 校註 (法鼓文化)====
* 校註因為沒有分章節,故 xml:id 的值為 本書第幾個校註
* 例如:'''校註5'''
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<note resp="editor" n="5"><p>參見《法華傳記》卷二(T51, no. 2068, p. 53c16-p. 56a7)。</p></note>
<note resp="editor" xml:id="n5"><p>參見《法華傳記》卷二(T51, no. 2068, p. 53c16-p. 56a7)。</p></note>
</syntaxhighlight>
</syntaxhighlight>


===@place===
===@place===
====place = "warichu雙行夾 ====
* place: 標明註解位置
*place:標明來源 中註 釋出現的位置,"warichu" 表示 註, 換行以lb <br/>
如果出現作者註的note與ref不在同一個milestone的情況,note處需加上place屬性,並標示值為end,表示註解位於該篇章的最後。
*例如 :07-14 華嚴心詮 p.111
 
例如:04-17 p.279
<syntaxhighlight lang="XML">
<note resp="author" place="end" xml:id="n3.1">
<p><lb/>「宗乘」意為各宗所弘揚的宗義和教典,此處指禪宗。</p>
</note>
</syntaxhighlight>
 
==ref 腳參照==
* 表示 文中 所參照的作者註或 腳編號(紙本通常以圓圈內數字顯示)。
* 編號方式:ref #n 加上 解編號 note 為 n 加上 解編號。
* 屬性 target 記錄參照 註腳編號。
* 不需要 記 resp
* 需和 note 搭配使用, 例如 :參照第一章第一節的'''作者註1'''
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
......
  <ref target="#n1.1.1"/>
<lb/>是大乘法相教,四是大乘破相教<note place="warichu"> 前四在<lb/> 此篇中</note>, 五是
  ......
<lb/> 一乘顯性教<note place="warichu"> 在第<lb/>三 中</note>。
  <note resp="author" xml:id="n1.1.1"><p>印順長老於二○○五年圓寂。</p></note>
......
</syntaxhighlight>
 
 
* 不分章節的書 例如:05-02 第16篇文章 p.44 '''作者註1'''
<syntaxhighlight lang="XML">
  <ref target="#n16.1"/>
  ......
<note resp="author" xml:id="n16.1">
  <p>《增 阿含經》卷六〈利養品〉:有一婆羅門勸佛至孫陀羅江側沐浴除罪,佛以不與取、不殺生、不妄語、無增減心等告之洗罪。</p>
</note>
</syntaxhighlight>
 
=== 綜合範例 ===
* 例如 05-04 學佛知津 p.140 ,章節編號為 6.4,其中編號 9~12 為作者註,21為校註。標記如下:
<syntaxhighlight lang="XML">
(一)六年苦行。
(二)孫陀利女殺身謗佛。
(三)乞食羅閱城時,木槍刺足。
(四)毘蘭邑安居 ,食馬麥。
(五)琉璃王滅釋迦族,頭背疼痛。<ref target="#n6.4.9"/>
(六)婆羅門聚落乞食,空缽而回 <ref target="#n6.4.10"/>
(七)旃荼女偽裝懷孕,謗佛通姦。
(八)提婆達多推下山石,傷破足指出血。 <ref target="#n6.4.11"/>
(九)在阿羅婆伽林,入夜寒風破竹。<ref target="#n6.4.12"/>
(十)骨節煩疼。<ref target="#n21"/>
</syntaxhighlight>
</syntaxhighlight>


==ref  參照==
 
* target 編號規則???
[[圖片:05-04-140.png|420px]]
 
==ref  註腳位置在向量圖時==
見6.2.4
http://wiki.dila.edu.tw/pages/%E3%80%8A%E6%B3%95%E9%BC%93%E5%85%A8%E9%9B%862020%E7%B4%80%E5%BF%B5%E7%89%88%E3%80%8B%E6%A8%99%E8%A8%98%E6%89%8B%E5%86%8A#.E8.A1.A8.E8.A7.A3.E5.9C.96.E7.89.87.EF.BC.88.E5.90.AB.E8.A8.BB.E8.A7.A3.EF.BC.89
 
==ref 註解中的註腳==
於註解 內文中出現註腳,例如:09-08 人間淨土 P.169 註28
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  當然,作者無意來談......作一番綜合的介紹而已<ref target=""/>。
<note resp="editor" xml:id="n28">
  <p> 參看註<ref target="#n24"/> 《楞伽師資記》所言的淨土觀 </p>
</note>
</syntaxhighlight>
</syntaxhighlight>
[[圖片:09-08p169.png | 800px]]


===ref 與 note 搭配用例 ===
= 引文、書目、出處=


==quote 引文==
==quote 引文==
行 165: 行 999:
   <p>見此事已,復當更作一大蓮花在佛左邊....諸蓮花上各有一佛二菩薩像,遍滿彼國。</p>
   <p>見此事已,復當更作一大蓮花在佛左邊....諸蓮花上各有一佛二菩薩像,遍滿彼國。</p>
   <p>此想成時....於現身中,得念佛三昧。</p>
   <p>此想成時....於現身中,得念佛三昧。</p>
</quote>
</syntaxhighlight>
* quote 也用在經文原文的引用使用,例如:07-09 天台心鑰 p. 41 「原文」開始:
<syntaxhighlight lang="XML">
<div>
<head>原文</head>
  <quote>
   <p>佛祖之要,教觀而已矣。觀非教不正,教非觀不傳;有教無觀則罔,有 觀無教則殆。然統論時教,大綱有八,依教設觀,數亦略同。</p>
  </quote>
</div>
</syntaxhighlight>
* 引文中的署名:
<syntaxhighlight lang="XML">
<p rend="byline">印順合十</p>
</syntaxhighlight>
===quote中的排版(依2020.06.11 email討論)===
預設無屬性quote使左邊界縮二字,p以及lg使首行或各行再縮一字。因此
<syntaxhighlight lang="XML">
<quote>
<p>成段引文</p>      請注意,這裡的p不加東西
<lg><l>一行詩</l></lg>
</quote>
</syntaxhighlight>
表示這段引文中,成段文字部分左邊界縮二字、首行縮一字,而引用詩偈每行縮排三字。此為最常見情形。
若遇其他排版,在quote、p或lg之後以rend加上mx或iy屬性的方式處理,mx代表左邊界縮排x字、iy代表首行(於左邊界縮排後,再)縮排y字。常見特殊情形如下:
* 成段引文排版同一般正文:
<syntaxhighlight lang="XML">
 <quote rend=”m0”>
 <p rend=”i2”>引文</p>
 </quote>
</syntaxhighlight>
* 引文成段部分排版同一般正文,詩偈部分卻每行縮排三字:
<syntaxhighlight lang="XML">
 <quote rend=”m0”>
 <p rend=”i2”>引文</p>
 <lg rend=”m3”><l>一行詩</l></lg>
 </quote>
</syntaxhighlight>
* 引用詩偈每行縮排二字:
<syntaxhighlight lang="XML">
<quote>
 <lg rend=”m0”><l>一行詩</l></lg>
</quote>
</syntaxhighlight>
* 散文首行縮二字、詩偈前方帶有數字符號
n後數字代表第幾首詩偈
實例見07-06 p.119
<syntaxhighlight lang="XML">
<quote rend="m0">
<p rend=”i2”>內文</p>
<lg n="1" type="gatha">
<l>由假說我法 有種種相轉</l> 請注意此處為全形空格
</lg>
</quote>
</quote>
</syntaxhighlight>
</syntaxhighlight>


==bibl 書目==
==bibl 書目==
* 書目不夠清楚時不需標記,例如:只有經名,於前後文無法判斷收錄於哪一部藏經者。
===@source===
===@source===
====CBETA====
==== 出自CBETA的書目〈〉《》====
這裡不是指「校註給出行號資訊」的Cbeta出處。
 
(一)使用的標記:
<syntaxhighlight lang="XML">
<bibl source="T14n0475_p0538c04">  </bibl>
</syntaxhighlight>
 
但為底下兩種情況時,不標記至行號:
 
'''1.只到經號'''
e.g.《景德傳燈錄》 T51n2076
'''2.到卷號'''
e.g.《景德傳燈錄》 第10卷  T51n2076_010
 
 
(二)標記方式
 
'''1.標記/不標記'''
 
 a.至少有明確的經名資訊才標:僅有大於等於「部」的資訊時不標記。
 
 b.一個段落裡引文被逐句解釋、逐句給出處,若前有共同的大範圍出處,只標大範圍出處。
 
 c.同一經目在一個段落內若多次出現,只標最早出現的一次即可。
 
 d.標記人員可考量讀者需求斟酌決定是否標記。判斷困難時提出討論:出現經名都可以考慮標記。
 
'''2.標記位置'''
 
 a.同一引文或同一筆參考資料有多個出處時,標記其中範圍較小者。e.g. 01-01 p.19註4:
 
 '''《景德傳燈錄》三十卷''',宋之道原,纂成於西元一○○四年,現存於'''《大正藏》五十一冊'''。
 
 前者範圍較小,所以標記「《景德傳燈錄》三十卷」。
 
 b.標記人員以輔助讀者角度,自行斟酌標記位置。e.g. 01-01 p.21的兩種標記方式:
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  <bibl source="T12n0365p0345c15">《 大正藏 一二.三四 頁下</bibl>
參看《靈峰宗論》卷五的<bibl source="J36nB348_p0346a23">〈法派稱呼辯〉</bibl>及卷五的<bibl source="J36nB348_p0346c17">〈儒釋宗傳竊議〉</bibl>二文。
 
參看<bibl source="J36nB348_p0346a23">《 靈峰宗論 卷五的〈法派稱呼辯〉</bibl>及卷 的<bibl source="J36nB348_p0346c17">〈儒釋宗傳竊議〉</bibl> 二文。
</syntaxhighlight>
</syntaxhighlight>
'''3.不考證'''
只標記到書本給出的層次:例如若書本出處若只寫到卷,則標記人員只需要標到卷,不查位於第幾頁。


====法鼓全集====
====法鼓全集====
* 格式為: 全集代碼. 書號.頁碼
* 格式為:書號.頁碼
* 頁碼僅記錄起始頁碼(如下例為 FGQJ.03-08.P22)
* 頁碼僅記錄起始頁碼(如下例為 03-08.P22)
* 篇名、書名:使用 title 標籤 ,篇名屬性為level="a",書名為 level="m"。
* 屬性為type = "FGQJ" 英文全大寫
出版者:使用 publisher 標籤。
* 篇名、書名:使用 bibl 標籤
 
例如:01-01 頁21,參照文章位於同書頁260
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<bibl source="FGQJ.03-08.P22">
明末的十一位居士資料,參閱本書第四章<bibl type="FGQJ" source="01-01.P260">〈 明末的居士佛教 〉</bibl>
   <title level="a">〈 童年和少年 〉</title>,<title level="m"> 《聖嚴法師學思歷程》</title>,法鼓全集3輯8冊,<publisher>法鼓 化</publisher>,頁22-23
</bibl>
</syntaxhighlight>
</syntaxhighlight>


====不夠清楚 時====
* 例如:06-07 頁50,參照文章位於03-04 頁328
* 書目不夠清楚時不需標記
<syntaxhighlight lang="XML">
我曾在日本求學 所寫的<bibl type="FGQJ" source="03-04.P328">〈東京的佛教大學〉</bibl>一文中
</syntaxhighlight>


==cit 引用出處==
篇名和書名 同時 出現時,標記於篇名, 名不標,例如:07-09 頁152 裡參照 章位於 04-09 頁15。
* 同時 包含引文及 目:引 quote、書目 bibl
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<cit>
「五 停心 :我有一篇<bibl type="FGQJ" source="04-09.P15"> 〈「 停心觀」修行法〉</bibl> ,介紹得比較詳細,請參閱。(收錄於《禪鑰》一書中
  <quote> 稱佛名故,除 十億劫生死之罪。 </quote>(
  <bibl source="T12n0365p0345c15"> 《大正藏》一二.三四 頁下</bibl>)
</cit>
</syntaxhighlight>
</syntaxhighlight>


==list 清單==
== ref 參考出處 ==
=== @cRef ===
* 連結以屬性 cRef 標記。
 
=== @type ===
==== CBETA出處 ====
* 使用屬性 type 標記值為 "cbeta",表示出處來自 CBETA。
 
=== 標記原則 ===
# 有引文及出處,標記需要標至該引用句的正確起始行號。例如:「三界虛妄,但是心作。」(大正九,五五八下)
# 沒有引文,但有明確出處,則標記至明確出處位置。例如:以上資料見於《卍續藏》一二五‧五五一頁
# 引文如無特殊字型則不需標記quote
# 標記位置在出處的文字處、不含引文 (請見範例) 07-14 p.23
<syntaxhighlight lang="XML">
經文是:<lb/>「三界虛妄,但是心作。」(<ref type="cbeta" cRef="T09n0278_p0558c10">大正九,五五八下</ref>)
</syntaxhighlight>
 
==參考書目==
  部分書籍有特別段落列出參考書目(如:學術引用的reference),以 清單 標記處理,書目需標註出處。例如:03-01 p.391
 
* 無項目符號
<syntaxhighlight lang="XML">
<list type="reference">
<item>⋯⋯</item>
</list>
</syntaxhighlight>
* 有項目符號
<syntaxhighlight lang="XML">
<list rend="decimal" type="reference">
<item>⋯⋯</item>
</list>
</syntaxhighlight>
 
= 圖、表=


==table 表格==
==table 表格==
===@cols @row===
* '''[重要] 由於紙本為直式排版(表格為直式),於網頁呈現時為橫式排版(表格為橫式),因此標記時需將表格視為橫式表格進行標記,請特別注意!!'''
說明表格有幾 欄(cols) (row),如下例為4欄2列 rows="2" cols="4"
 
* 有框線表格
<syntaxhighlight lang="XML">
<table>...(表格)...</table>
</syntaxhighlight>
* 無框線表格
<syntaxhighlight lang="XML">
<table rend="none-border">...(表格)...</table>
</syntaxhighlight>
 
===cell內容跨頁時的頁碼標記===
cell若內容跨頁,仍要忠實表現內容所在的頁數,故有時會產生同一個頁碼需要標記數次的情形。
同一個頁碼第一次標記時請仍以<pb n=”xx”/>標記,第二次標記<pb n=”xx” type=”notfirst-1”/ >、第三次標記<pb n=”xx” type=”notfirst-2”/ >,之後類推。
 
<pb n=”xx” type=”notfirst-n”/ >使用方式同<pb n=”xx”/>。
一個cell若跨頁部分為空白,不須特別為空白部分標記頁碼。
 
===合併欄位 @cols @rows===
合併 或合併列的情況,在 '''cell ( 格)使用'''
* <cell rows="數字">:跨列列數
* <cell cols="數字">:跨欄欄數
* 為跨欄的例子:
<syntaxhighlight lang="XML">
<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>
</syntaxhighlight>
[[圖片:fgqj2020table.png | 640px]]


== row 列==
=== @role 標題列(欄)===
===@role===
用來 指定為表格標題 可用在 row 或 cell 欄位
====role = "label"====
* 用在 row 時用以指定該列為''' 標題列''',例如:
* 指定為表格標題
可用在 row 或 cell 欄位
例如 用在 row ( 標題列)
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<table rows="2" cols="4">
<table rows="2" cols="4">
行 221: 行 1,236:
</syntaxhighlight>
</syntaxhighlight>


例如 用在 cell ( 標題欄)
 
* 用在 cell 時用以指定該格為''' 標題欄''',例如:
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<table rows="2" cols="3">
<table rows="2" cols="3">
行 236: 行 1,252:
</syntaxhighlight>
</syntaxhighlight>


== cell ==
==figure 圖片==
===@cols @row===
* 網頁圖檔僅接受 jpg, gif, png, svg 等格式。
合併欄或合併列 情況 使用
叢書部提供 原始檔案為印刷用檔,需要轉換為小檔才利網頁 使用
* <cell rows="數字">:縱向跨列
* 原始檔案如為eps檔,需透過 illustrator 轉換成150dpi JPEG,設定如下圖
* <cell cols="數字"> 橫向跨欄
[[ 片:Eps轉存檔案設定.png‎]]
 
<syntaxhighlight lang="XML">
<head>(十二)圓教凡聖八位六即 </head>
<table>
<row>
<cell cols="6">
<p>聖 位</p>
</cell>
<cell colspan="4">
<p>凡 位</p>
</cell>
</row>
<row>
<cell>
<p>妙 覺</p>
</cell>
<cell>
<p>等 覺</p>
</cell>
<cell>
<p>十 地</p>
</cell>
<cell>
<p>十迴向</p>
</cell>
<cell>
<p>十 行</p>
</cell>
<cell>
<p>十 住</p>
</cell>
<cell>
<p>十 信</p>
</cell>
<cell>
<p>五 品</p>
</cell>
<cell cols="2"> </cell>
</row>
<row>
<cell>
<p>究竟即</p>
</cell>
<cell colspan="5">
<p>分證即</p>
</cell>
<cell>
<p>相似即</p>
</cell>
<cell>
<p>觀行即</p>
</cell>
<cell>
<p>名字即</p>
</cell>
<cell>
<p>理 即</p>
</cell>
</row>
</table>


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


<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
行 317: 行 1,270:


=== 圖片(含圖說)===
=== 圖片(含圖說)===
* 圖片標題以 head 標記 (目前全集 未發 有圖片有標題 因此可省略該 標記
* 圖片標題(圖說)  以 head 標記
* 圖 文字以 figDesc  標記。
* 請注意 '''圖說文字在電腦初步轉出的XML檔 會出 在最後方 標記 人員手動移動至正確的位置'''
* 圖 檔若造成段落 文字 切斷,請標記於「內容相關」且「位置最接近」段落的之前或之後。
* 若某頁內容僅有圖檔,因上面規則改變標記位置 致該頁空白時,仍保留其頁碼 標記。


<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<figure>
<figure>
    <graphic url="06-07p14.jpg"/>
    <graphic url="06-04p14.jpg"/>
    <head> 圖說標題</head>
    <head> 聖嚴法師於農禪寺護法會年會中,欣喜地展示已找到法鼓山原始地貌照片。</head>
   <figDesc>戚肩時將軍。</figDesc>
</figure>
</figure>
</syntaxhighlight>
</syntaxhighlight>
[[圖片:06-04-14.png]]


=== 表解圖片 ===
=== 表解圖片 ===
* 表解圖片為向量檔,與一般圖片不同,標記時需指定寬度以利顯示。
* 表解性質的圖片(如: 01-02 大乘止觀法門 p.40),需使用 indesign 軟體另存成向量檔(.svg) 後視為圖片進行標記。
* n 的值為佔畫面文字的行寬,例如佔畫面約  6行字寬時 n="6"。
* 電腦初步轉出的 XML 檔中可能會出現部分表解文字的碎片,需由標記人員人工刪除。
* 表解圖片為向量檔,與一般圖片不同,標記時需 加上 n 屬性 指定寬度以利顯示。
* width 的值為佔畫面文字的行寬 ,並加上單位為em ,例如佔畫面約  6行字寬時 width="6em"。
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
<figure>
<figure>
    <graphic url="07-09p340.svg" n="6"/>
    <graphic url="07-09p340.svg" width="6em"/>
</figure>
</syntaxhighlight>
 
[[圖片:07-09-340.png|400px]]
 
=== 表解圖片(含註解)===
* 穿插註解的表解圖片(如02-02 p.123)。
* xmL中的處理:
 (1)穿插於圖解的註給予rend="hidden"屬性,標記在圖解之前。
 
 (2)graphic給予rend="svg-link"屬性。
* xmL外的處理:
 標記人員至進度表備註欄登記,以知會程式人員做後續處理。
 
<syntaxhighlight lang="XML">
<figure>
<span>
<ref target="#n5.1.1" rend="hidden"/>
<ref target="#n5.1.2" rend="hidden"/>
<ref target="#n5.1.3" rend="hidden"/>
<ref target="#n5.1.4" rend="hidden"/>
</span>
<graphic url="02-02p123.svg" rend="svg-link"/>
</figure>
</figure>
</syntaxhighlight>
</syntaxhighlight>
行 339: 行 1,320:
=== 行中插圖 ===
=== 行中插圖 ===
* 行中插圖為文字行中與字寬相等的圖片,圖檔命名原則與圖片相同。
* 行中插圖為文字行中與字寬相等的圖片,圖檔命名原則與圖片相同。
* 設定 rend="inline",例如:01-04.xml, p.179
* 不需要包在 figure 裡,直接用 graphic 即可。
* 設定 rend="inline",例如:01-04.xml, p.196


<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
  一即是《易經》八卦中的「<figure rend="inline"><graphic url="01-04p179-1.gif"/></figure>」, 二是八卦中 的「<figure rend="inline"><graphic url="01-04p179-2.gif"/></figure> ......
  例如觀 <graphic rend="inline" url="01-04p196-1.png"/><graphic rend="inline" url="01-04p196-2.png"/> (唵
</syntaxhighlight>
 
=錯字或內文更正=
==情況一、有錯字需修改==
錯字修改時使用 choice 標記,
錯字標示為 sic,正確字標示為 corr,
choice 的屬性 change 記錄問題回報表的填報日期。
 
例如:
01-03 第39頁,填表日期為2021年12月10日,修改內容為「吠舍離」改為「毘舍離
 
<syntaxhighlight lang="XML">
<choice change="2021-12-10">
  <sic>吠</sic>
  <corr>毘</corr>
</choice>
</syntaxhighlight>
 
==情況二、無錯字 僅加字==
無錯字情況下,僅需使用 corr 標記,
corr 的屬性 change 記錄問題回報表 填報日期。
 
例如:
01-03 第46頁,填表日期為2021年12月10日,內容 以為四分律義」修改為「以為《四分律》義」
 
<syntaxhighlight lang="XML">
以為<corr change="2021-12-10"> 《</corr>四分律<corr change="2021-12-10">》</corr>義
 
</syntaxhighlight>
 
==情況三、無更正字,刪除該字==
刪除錯字情況下,僅需使用 sic 標記,
sic 的屬性 change 記錄問題回報表的填報日期。
 
例如:
01-03 第425頁,填表日期為2021年12月10日,內容「《梵網經》受戒法,已失其傳」修改為「《梵網》受法,已失其傳」
 
<syntaxhighlight lang="XML">
《梵網<sic change="2021-12-10">經</sic>》受<sic change="2021-12-10"> </sic> 已失其傳
 
</syntaxhighlight>
</syntaxhighlight>


=不標記=
=不標記=
* 原《法鼓全集》有標記,新《法鼓全集2020紀念版》不標記的項目有:人名 persName、地名 placeName、時間 date、手稿 ref。
* 原《法鼓全集》有標記,新《法鼓全集2020紀念版》不標記的項目有:人名 persName、地名 placeName、時間 date、手稿 ref。
=缺字處理原則=
* 叢書部提供的indesign檔中,以造字方式製作的文字,在轉成XML檔時會造成缺字,依情況有不同的處理方式。
== 情況一、為美觀而造字 ==
* 缺字原因通常是書籍排版使用的字型無此字,美編為了美觀而造字。該字通常於新細明體(中文)、unicode字型(外文)可以正常顯示。
* 處理方式:直接使用標準字取代缺字。
* 例如:
**05-04 尼師壇那(Nişīdana)的ş、袈裟(kaṣāya)的ṣ,請參考[https://zh.wikipedia.org/wiki/%E6%8B%89%E4%B8%81%E5%AD%97%E6%AF%8D%E5%88%97%E8%A1%A8 拉丁字母列表])
**05-02 「佛子羅睺羅」的「睺」
== 情況二、因輸入法沒有該字而造字 ==
* 如果該缺字來自藏經,則處理方式如下:
=== 方案 1. 查詢 CBETA Online 和法鼓全集 ===
====CBETA Online====
* 至 [http://cbetaonline.dila.edu.tw/ http://cbetaonline.dila.edu.tw/] 找到 '''符合師父引用出處''' 的同一部經,如果該字於CBETA online 正常顯示,則直接COPY使用。
* 例如: [http://cbetaonline.dila.edu.tw/zh/GA0028_006 http://cbetaonline.dila.edu.tw/zh/GA0028_006] 大藏經音疏五百卷 「宋高僧傳唐行瑫撰」 的 「瑫」,<br/>為求嚴謹,可以查教育部異體字字典,看 [焰-火+王] 與 瑫 是不是異體字關係,再決定是否使用。
====法鼓全集====
* 至 [http://ddc.shengyen.org/ 法鼓全集] 找同一本書的處理方式是否可沿用。
* 例如:06-05 p179 「是一條寬闊的上坡𨃇蹉」的 「𨃇」字可直接COPY使用。
* 若 方案 1 未解決問題,則進行 方案 2。
===方案 2. 查詢 DILA難檢字庫===
* 至[http://dev.ddbc.edu.tw/schar/ DILA難檢字庫]搜尋該字,字形以 Unicode 的字形圖片為準,而非「Your Browser」那欄。
* 如果該字於新細明體可正常顯示,或是顯示後字形為異體字者,可直接COPY使用。
* 例如:05-10 「阿㝹樓馱」的「㝹」在新細明體時,底下為「免」而非「兔」,但在教育部異體字字典中兩字相通,所以可直接使用。
* 若 方案 2 中看到的文字於新細明體無法顯示,則進行 方案 3。
===方案 3. 使用缺字標記 ===
* 至[http://dev.ddbc.edu.tw/schar/ DILA難檢字庫]搜尋該字,如該字無法顯示(下圖 B處),記下'''字碼'''(下圖 A處)及其'''組字式''':
[[圖片:gword20200512.png|600px]]
* 標記格式為:
<g ref = "#CB字碼">[完整組字式含左右括號]</g>
* 例如 05-09 p.127 此處標為:
 為求金、銀、琉璃、車<g ref="#CB00006">[(王*巨)/木]</g>、馬瑙、珊瑚、虎珀、真珠等寶

於 2022年9月15日 (四) 09:14 的最新修訂

標記規範參考來源

XML說明

teiHeader 檔首

  • 檔首會於原始檔轉XML檔時建立,請標記人員完成標記後,於 revisionDesc 標籤內更新完成日期並填上自己的姓名。
  • titleStmt 中的 title 記錄:書名(不含副標題)。如該書為合集,此處僅記錄本身的書名,合集的書名則記載於 monogr 標籤內。
  • 如該書有副標題,則記載於 monogr 標籤內 title (type ="sub") 標示。無副標題時,該標籤留空白。
  • 例如05-08 為「漢傳佛教的智慧生活(修訂版)」與「佛法的知見與修行」兩冊的合集,其中「佛法的知見與修行」的teiHeader 如下:
    <teiHeader>
        <fileDesc>
            <titleStmt>
                <title>佛法的知見與修行</title>
                <respStmt>
                    <resp>電子版本製作</resp>
                    <name>法鼓文理學院 Dharma Drum Institute of Liberal Arts</name>
                </respStmt>
            </titleStmt>
            <publicationStmt>
                <publisher>法鼓文化</publisher>
                <pubPlace>台灣:台北</pubPlace>
                <date when="2020">2020</date>
            </publicationStmt>
            <sourceDesc>
                <biblStruct>
                    <monogr>
                        <title type="main">漢傳佛教的智慧生活(修訂版)‧佛法的知見與修行</title>
                        <title type="sub"></title>
                        <imprint>
                            <pubPlace>台灣:台北</pubPlace>
                            <publisher>法鼓文化</publisher>
                            <date>2020-12</date>
                        </imprint>
                    </monogr>
                    <series>
                        <title>法鼓全集</title>
                        <biblScope unit="輯" n="5">第五輯</biblScope>
                        <biblScope unit="冊" n="8">第八冊</biblScope>
                    </series>
                </biblStruct>
            </sourceDesc>
        </fileDesc>
        <revisionDesc>            
            <change when="2020-03-30"><name>標記人員</name>完成標記</change>
        </revisionDesc>
    </teiHeader>

內文

front

  • 包含位於文件最前端、正文之前的項目 (標頭、題名頁、前言、獻詞等)
  • front 的位置位於 body 的前面
  • 例如扉頁:
      <front>
         <div><quote>「九二一大地震的所有罹難者都是大菩薩、是老師,用生命做為教材,現身說法,代替二千二百萬臺灣人受災受難,救了我們下一代;我們應該從過去的錯誤中學習重生、感恩,讓社會充滿祥和與善良。」</quote>
         <byline>聖嚴法師於一九九九年十月六日接受《中時晚報》專訪之談話</byline>
         <byline>李總統登輝先生亦於十月十一日於九二一大地震全國追悼大會致詞中引用此段談話</byline></div>
      </front>
      <body>
      ......

08-05-00.png

byline 作品陳述

  • 包含作品的主要責任陳述,出現在題名頁或作品開頭或結尾處。
  • 例如:05-04 學佛知津 p.53 結尾
<div>
    ......
    <p>最後謝謝貴會主持人李譽先生的邀請,並謝謝趙茂林居士的介紹。謝謝各位。</p>
    <byline>(一九六七年四月十七日講於臺北市甲辰學佛粥會)</byline>
</div>
  • 請注意 byline 後方出現註解 div 時,會因 byline 本身的限制,不能通過 validate。
  • 例如::05-04 學佛知津 p.151~ p.161 以下列標記方式無法通過 validate:
<div type="article" n="8">
  <head>神鬼的種類</head>
    …內文…
  <byline>(臺中農民電台《慈明之聲》播講)</byline>
  <div>
    <head>註解</head>
     … 註解 …
  </div>
</div>
  • 為了不破壞 div type="article" 的區間範圍,並維持 head 正確所在層次,解決方式為:將內文與byline以div包起來,成為與註解同層的div。
  • 修正後可通過 validate 的標記如下(請注意新標的div範圍不含head):
<div type="article" n="8">
  <head>神鬼的種類</head>

  <div>
    …內文…
  <byline>(臺中農民電台《慈明之聲》播講)</byline>
    </div>

  <div>
    <head>註解</head>
     … 註解 …
  </div>
</div>

採用新細明體的byline 作品陳述

(依2020.06.24email討論) 標記以rend給予ming屬性,以09-03 p.213為例:

<byline rend="ming">聖嚴師父一九九四年二月十日</byline>


div 區塊

@type

type="part" 篇

  • part 是分區的最大單位,不是每本書都有part,視結構而定 (請由書籍的目錄判定)。
  • part 不需要給屬性 n 。
  • 例如 07-14 華嚴心詮 分為「前篇」及「本篇」
<div type="part">
<head><seg rend="appendix">前篇</seg>緒論</head>
<div n="1" type="chapter">
    <head>第一章 西藏的歷史與環境</head>
    <div n="1.1" type="section">
       <head>第一節 西藏的歷史</head>
       <head>西藏的名稱</head>
       <p>西藏民族的古代史,不甚了然,唯由中國內地古史記載中可獲一些消息。據舜竄三苗於三危的傳說......</p>
   </div>
......
</div>
<div type="part">
<head><seg rend="appendix">本篇</seg>《原人論》考釋</head>
<div n="1" type="chapter">
    <head>釋題</head>
......
</div>

07-14-m1.png

  • 例如 08-05 台灣加油
<div type="part">
<head>第一篇 人心重建.世界平安</head>
<div type="article" n="1">
    <head>地震為什麼發生在臺灣?</head>
......
</div>


type="chapter" 章

  • 主要為書籍的章。
  • n 的值為章節編號,例如:第一章 標示為 1
<div n="1" type="chapter">
    <head>第一章 西藏的歷史與環境</head>
    <div n="1.1" type="section">
       <head>第一節 西藏的歷史</head>
       <head>西藏的名稱</head>
       <p>西藏民族的古代史,不甚了然,唯由中國內地古史記載中可獲一些消息。據舜竄三苗於三危的傳說......</p>
   </div>
......
</div>

type="section" 節

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

type="article" 文章

  • 如果該書沒有分章節,而是文章的集合體 (請由書籍的目錄判定)。
  • n 的值為文章編號,例如:第一篇文章 標示為 1
  • 例如 08-05 台灣加油
<div type="part">
<head>第一篇 人心重建.世界平安</head>
<div type="article" n="1">
    <head>地震為什麼發生在臺灣?</head>
......</div>
<div type="article" n="1">
    <head>是天災?是人禍?</head>
......</div>
</div>
  • 除特別層次的div (如:"part", "chapter", "section", "article"...) 外,其他的 div 可不用給予 type 屬性。
  • 例如:07-09 天台心鑰 p.67 此處標 div 是為了區別小標題「原文」所在的範圍:
<div>
    <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>

2020/7/8更新: 此範例應使用quote標示,故刪除 indent-1 屬性。

rend = "outdent" 第一行凸排

  • 指定樣式為段落第一行凸排2字
  <p rend="outdent">《法華經》自稱是「諸經中王」,不論從理論方面或實踐方面來看,的...</p>
  • 指定樣式為段落第一行凸排n字,以英文字母o加凸排字數,例如凸排3字為 o3,例: 09-12《法鼓道風》目錄後、正文前
<front>
<div>
<p rend="o3"><lb/>編案:本書部分選文曾收錄於《法鼓山僧伽大學年報》、《僧林悟語》,
其他選文<lb/>則曾發表於《人生》雜誌與《法鼓》雜誌,但皆未集結出版,今依相關主題<lb/>彙編成書出版。 </p>
</div>
</front>
<body>
......
</body>

09-12.png

其它首行、左邊界變化(需注意,限用於未被其它標記改排版的段落)

改左邊界:m+數字,代表左邊界縮幾字。

改首行:i+數字,代表首行縮排幾字;o+數字,代表首行凸排幾字。

若要同時更改左邊界與首行(以縮排為例):rend="m3 i2",m3與i2間為半形空格。<--罕用。


常用者如下:

1.首行凸排三字:

<p rend="o3">…內文…</p>

2.首行縮排三字:

<p rend="i3">…內文…</p>


rend = "big" 強調大字

  • 屬於段落文字(非標題)的強調大字,例如:08-05 台灣加油 p.78
  <p rend="big">眼看傷者與死神搏鬥 心中有更多的不忍......</p>

08-05-78.png


rend = "postscript" 後記

  • 以不同文字呈現的後記段落,例如:08-05 台灣加油 p.88 ~ 89
  <p rend="postscript">
  後記:因為地震停電的緣故,使得這場對談必須在屋外進行。一干人與法師坐 在涼亭中,清風徐徐地吹著,雖然,和著蟲鳴鳥叫幾乎淹沒了師父的聲音,但是,
  我們清楚地聽見聖嚴法師莊嚴地說著:災難的發生和整個社會的人心有著很大的關 係。在秋日的午後,坐在涼亭裡聽師父的開示,對大家是一種可貴的人生領悟。
</p>  
<byline>(一九九九年十月一日《勁報》刊出,王艾琪整理)</byline>

08-05-88.png

使用於PDF特定排版小標題

例如:05-01 p.222

<p rend="indent bold">1調身法</p>

Pic.jpg

rend = "note" 自成一個段落的批註

例如:04-01 p.170

<p rend="note">雲棲評曰:......悟則無二。</p>

milestone 分界點

  • [重要] 每冊的第一個 milestone 應緊連在第一個頁碼前,例:09-09
<text>
    <milestone unit="doc"/>
    <pb n="1"/>
    <front>	...</front>
    <body> ...</body>
</text>
  • 用來標示轉換成網頁時 一個文件 的範圍。判斷範圍的基本原則是依目錄區分。
  • 屬性 unit = "doc"
  • milestone 必須放在區分的div之外以及頁碼前,才能抓取完整的 div 內容。
  • 如果該書為文集,則一篇文章會分成一個文件。例如:08-01 法鼓鐘聲 (請注意milestone的位置在 article的div之外)
  • 如為篇名頁之後的第一章或第一篇文,則milestone改標在篇名頁頁碼前。
<milestone unit="doc"/>
<pb n="11">
         <div type="article" n="1">
            <head>謹慎處理家庭暴力事件</head>
             ......
         </div>
<milestone unit="doc"/>
<pb n="13">
         <div type="article" n="2">
            <head>天災是老天對人類的懲罰嗎?</head>
             ......
         </div>
         <milestone unit="doc"/>
<pb n="15">
         <div type="article" n="3">
            <head>舍我其誰</head>
             ......
         </div>

08-01-00.png

  • 如果該書為章節,原則是以一章分成一個文件。例如:07-14 華嚴心詮
<milestone unit="doc"/>
<pb n="55">                               
<div type="part">
<head><seg rend="appendix">前篇</seg>緒論</head>
   
<pb n="66">                              '''(請注意,雖這裡是一章,但由於前有篇名頁,因此milestone改標在篇名頁的頁碼前)'''
   <div type="chapter" n="1">        
      <head>第一章 華嚴學 </head>
      <div type="section" n="1.1">
         <head>一、《華嚴經》的傳譯</head>
      </div>
      <div type="section" n="1.2">
         <head>二、《華嚴經》的內容</head>
      </div>
      <div type="section" n="1.3">
         <head>三、《十地經》與《十地論》</head>
      </div>
      <div type="section" n="1.4">
         <head>四、華嚴宗的先驅</head>
      </div>
   </div>
   <milestone unit="doc"/>         '''(篇名頁後第二個章起,恢復至平常milestone的標記方式)'''
   <pb n="77">
  <div type="chapter" n="2">
      <head>第二章 華嚴宗</head>
      <div type="section" n="2.1">
         <head>一、初祖杜順—神異禪者</head>
      </div>
      <div type="section" n="2.2">
         <head>二、二祖智儼—精通梵漢</head>
      </div>
      <div type="section" n="2.3">
         <head>三、三祖法藏—集大成者</head>
      </div>
      <div type="section" n="2.4">
         <head>四、四祖澄觀—疑點特點</head>
      </div>
      <div type="section" n="2.5">
         <head>五、五祖宗密—禪教一致</head>
      </div>
   </div>
</div>

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>
  • 引用詩偈之出處:

使用byline並標於lg之內,見07-05 p.15:

<quote><lg>
 <l>多聞令志明,己明智慧增;</l>
 <l>智則博解義,見義行法安。</l>
 <byline>──法句經卷上.多聞品</byline>
</lg></quote>

開場引言

  • 文章前面的開場白也以lg 標記,例如:08-05 台灣加油 p.127
<div>
    ......
         <lg>
            <l>法鼓山委託教育部</l>
            <l>將人心重建安心手冊送到災區的學校,</l>
            <l>希望將愛與關懷送到他們的手中,</l>
            <l>進行生命教育的人心重建。</l>
         </lg>
    <p>法鼓山文教基金......
</div>

08-05-127.png

文末法語

  • 文末以小語格式呈現的師父法語也使用lg 標示,並於外層加上div 屬性 rend="motto" 標示所含範圍。
  • 由於小語為額外附加的,不屬於文章內容,故不包含在屬性 article 的 div 中。
  • 例如:08-05 台灣加油 p.27
<div type="article" n="5">
...
</div>
<div rend="motto">
    <head>聖嚴法師人心重建法語之二</head>
         <lg>
            <l>救苦救難的是菩薩, </l>
            <l>受苦受難的是大菩薩。</l>
         </lg>
</div>

08-05-27.png

問與答

以rend="qa"給div屬性,當中"問與答"三字須使用<head>處理。 e.g.07-15 p.46

<div rend="qa">
<head>問與答</head>
<p rend="o3"><lb/>信眾:如果做懶人也不要緊,但是這跟自己的業有沒有關係?</p>
...
</div>

list 清單

  • 項目清單的排版格式若同一般段落,則視同段落直接標 p (不標list)
  • list 用來表示以列表方式呈現的任何連續項目。
  • 樣式設定在 <list> 身上,<item> 不需設屬性。
  • 於2020.06.09主旨「05-01 p.222~223」 email,承恩補充項目定義:
 項目後方必須有半形句點「.」: 
 a. 項目  (符合定義)
 a 項目 (不符合定義)

情況一、無清單項目符號

  • <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>
  • 如為純數字,但清單並非由1開始編號者,則在 list 加入屬性 n 記錄開始數字
  • 例如 04-15 p.139 清單編號由 7 開始:
<list rend = "decimal" n="7">
  <item><lb/>頭部緩慢地往左後轉,...</item>
  <item><lb/>頭部緩慢地往左後轉,...</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>
  • 例如:08-05 台灣加油 p.153
<head>三、安撫幼小心靈</head>
<p>我們能為孩子做什麼?</p>
<list type="gloss">
 <label>分享</label> 
 <item>開誠布公地與孩子談論對災變的感受,也傾聽孩子內心的感覺。</item>
 <label>解釋</label> 
 <item>用孩子聽得懂的話,告訴他們發生了什麼事,提供他們應該了解的資訊。 安撫 告訴孩子一切已經安全了,我們不會再分開,會在身邊陪伴孩子、保護孩子。</item>
 <label>擁抱</label> 
 <item>時常擁抱孩子,給他們溫暖的關愛。尤其在入睡前,多花點時間彼此共處。</item>
 <label>宣洩</label> 
 <item>讓孩子想哭就哭。對失去的玩具、心愛的物品、逝去的親友等哀傷情緒,藉畫畫、聊天得以宣洩。如果在學校出現情緒問題,不妨與老師溝通,請老師幫忙,協助孩子度過難關。</item>
</list>

08-05-153.png

複雜的例子

  • 要使用段落或項目清單進行標記,需視排版格式及文義而定,由標記人員評估何者較適宜。
  • 如 01-02 大乘止觀法門 p.19 中 第 9 行「(1)《起信論》言:⋯⋯」如一般段落僅有第一行縮排2字,故用 p 標記。自「 (B)《大乘起信論》⋯⋯」
  • 此例自清單的縮排看出是清單list 包含在 p 之中,故用 p 包 list,否則沒有強制限制 list 需包含在 p 之中。
  • 段落與項目清單的混用例子如下:
<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>
  • 標題內含其他字型及作者時,以seg 搭配屬性rend 標示。
  • 在標題旁表示該篇文章性質的小字:rend="head-label"
<head>
  <seg rend="head-label">附錄七</seg>  
    夢中的拓荒者
  <seg rend="author">李果然</seg>    
</head>
  • 在標題旁表示該篇文章性質的小字:rend="head-label"
  • 標題中的註 :採用無屬性note。實例如下(from 03-09 p.67)
<head>白聖長老—戮力於護國衛教<note>(八十大壽誌慶)</note></head>
  • 標題帶副標題:rend="subheading"。範例(from 05-08-2 p.81):
<head>佛法的三個層次:信仰、理解、實踐<seg rend="subheading">—從信仰入手、明因果到超越</seg></head>
  • 作者註的標題(e.g. 03-01 p.47):因其出現的層級不固定,若僅以包覆div層數決定呈現樣式可能會忽大忽小,故以rend="author-note"給予屬性來處理。
<head rend="author-note">
註解
</head>
  • 細明體標題<head rend="o3 ming">

特徵: 一般出現在「節」的下一個層級。 多半有全形括號+中文數字編號。

e.g. 01-01 p.30

<head rend="o3 ming">(一)明末禪者的地理分布表</head>

標題僅出現於目錄

  • 當標題僅出現在目錄、而未出現在內文時,使用head標籤、rend 屬性值為 hidden。
  • 例如: 00-00 p.6 於目錄中為「作者七十自題」,而內文實際標題為「七十自題」,出現於目錄者為 head,未出現於目錄者以 p 標記。
  • 範例如下:
  <div type="article" n="3">
    <head rend="hidden">作者七十自題</head>
    <p rend="head">七十自題</p>
    ...
  </div>

標題中部份內容未出現於目錄

  • 當標題包含的部份內容僅出現在內文、而未出現在目錄時,在 rend 屬性加上 not-toc。
  • 例如: 04-06 p.379 於目錄中為「附錄 〈默照銘〉全文」,而內文實際標題為「附錄 〈默照銘〉全文 宏智正覺」,其中「宏智正覺」加上 not-toc 屬性。
  • 範例如下:
  <pb n="379"/>
  <div type="article" n="29">
  <head><seg rend="head-label">附錄</seg>〈默照銘〉全文<seg rend="author not-toc">宏智正覺</seg></head>
    ...
  </div>

pb 分頁

@n

  • 屬性 n 的值為頁碼,只填數字,前方不需補0
  • <pb> 如果位在 div 的開頭,請放在 div 之外。例如:06-04 金山有鑛 p.23
<pb n="23"/>
<div type="part">
  <head>四、法鼓山的護法會</head>
  <p>
  ......</p>
</div>
  • 內文第一頁之前可能有其他頁面,則頁碼前加 f 字元,例如:09-06.xml
<pb n="f1"/>


  • 電腦自動轉出的初步XML,pb 可能會被包在 p 段落結尾處,如下 :

......<pb n="1"/>

這種情況請標記人員將它移至段落之外,如下:

......

<pb n="1"/>

  • 空白頁不標pb,因此需手動刪除程式轉出的空白頁pb。例如程式轉出如下:
<pb n="1"/>
<pb n="2"/>
<pb n="3"/>
<div type="chapter">
 ...
</div>

這種情況請標記人員將空白pb刪除,刪除後如下:

<pb n="3"/>
<div type="chapter">
 ...
</div>

table中的pb

  • table 用在標記表格時,table 中的 pb 仍需標記,但僅為記錄,介面並不會顯示頁碼。
  • table 用在文字排版的,table 中的 pb 必須顯示,故需要加上 rend="show" 屬性,以示區別。

例如:04-03 第 114 頁,table用於文字排版

<cell>
...
<lb/>動心,食知其味卻不動心,庵<pb n="114" rend="show"/><lb/>前庵後的花紅水綠,也只是自<lb/>然景物的自然存在,既不拒之<lb/>
...
</cell>

lb 分行

段落中的分行

  • 標記文本裡在印刷上的新起行。
  • lb 為空元素 不標行號不標屬性
  • 初步轉出給標記人員使用的XML內已有 lb 標記,請標記人員檢查 lb 標記位置是否正確。
  • 未出現 lb 時,請標記人員手動加上(註:通常容易出問題的行是在段落最後且小於三個字的行,以及有補漏字的行(因漏字無法自動比對位置))。
  <p>
    <lb/>儒道二教說,人畜等類,皆是虛無大道生成養育。謂道法自然,生於元
    <lb/>氣,元氣生天地,天地生萬物。故愚智、貴賤、貧富、苦樂,皆稟於天,由
    <lb/>於時命。故死後卻歸天地,復其虛無。
  </p>

表格中的分行

  • 表格內文的換行,需手動加上 lb。
  • 例如:06-07 春夏秋冬 p.18
<row>
  <cell>Prof. Roongraung Boonyoros<lb/>龍格讓教授</cell>
  <cell>泰國</cell>
  <cell>清邁大學</cell>
  <cell>Householders and the Five Precepts<lb/>在家人與五戒</cell>
</row>

強制斷行

  • <lb break="yes"/>

e.g.07-14 p.295

<head><seg rend="subheading">附錄二</seg>《原人論》語體譯<seg rend="author">終南山草堂寺沙門宗密述<lb break="yes"/>法鼓山沙門聖嚴語體譯註</seg></head>

seg 字詞

  • seg 為任意分割的字詞單元,在全集標記中可利用屬性 rend 來標示特殊字體。

@rend

rend ="bold" 粗體

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

rend ="italic" 斜體

可用在內文,也可以使用於標題出現斜體字的情況。

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

rend ="small" 小字

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

rend ="ming" 明體字

  • 07-02 福慧自在 p.54
「所謂佛法者,即非佛法。」<seg rend="ming">=證大小乘聖果,即非證果。</seg>
...... <seg rend="ming"></seg>

rend ="kai" 楷體字

  • 11-02 聖嚴法師年譜 p.26
<p rend="kai">蓮塘上人</p>

註解、註腳參照

note 文內註解

編案

  • rend = "ednote" 表示為編案(editor note 的簡寫)。
  • 編案的文字樣式如果與一般段落相同,則不需特別標記為note
  • 編案為編輯者呈現於文章內文顯示的註解內容 (即:不是作者註、校註的註腳形式),附記 也是編案的一種。
  • 編案不需註明來源,故不需要標註 resp 屬性。例如: 09-10 法鼓晨音 p. 10
<note rend="ednote">編案:各篇文末加註聖嚴法師開示的日期。</note>


單行夾註

  • 文字間穿插單行註解時使用。
  • 可使用在<p rend="big">段落之中。
  • 可使用在作者於文字間註明其出處時,實例如04-02 p.19「(以上錄自《高僧傳》卷七......五十.三六六頁中─三六七頁上)」等字樣。
  • 例如:07-09 天台心鑰 p.303
<p>次明別五時者,乃約一類最鈍聲聞,具經五番陶鑄,方得入實。所謂初 於華嚴,不見不聞,全生如乳。
  <note rend="inline">華嚴前八會中,永無聲聞,故云不見不聞。至第九會入法界品,在祇園中,方有聲聞,爾時已證聖果,尚於菩薩境界,如啞如聾。驗 知爾前縱聞華嚴,
  亦決無益。然舍利弗等,由聞藏教,方證聖果,方預入法界會,則知入法界品,斷不說在阿含前矣。人胡略不思察,妄謂華嚴局在三七日內耶?</note>
</p>
<p>次於阿含,聞因緣生滅法,轉凡成聖,如轉乳成酪。<note>酪即熟乳漿也。</note></p>

07-09-303.png

雙行夾註

  • rend = "warichu" 表示為夾註。
  • 換行 lb 標示於夾註內。
  • 例如:07-14 華嚴心詮 p.164
......
<lb/>造種種業,以致淪於無窮的生死苦海<note rend="warichu">已如前面的小乘
<lb/>教中所說</note>,悟解如此的道理,始知我們的身命,是
<lb/>唯識所變,識為身命的根本源頭<note rend="warichu">至於為何法相教是不了義的淺教,待
<lb/>到下一節的破相教中破斥</note>

07-14-163.png

note 作者註、校註

@xml:id

  • xml:id 的值為 n 加上註解編號,編號方式請見下節@resp 原註 (聖嚴法師)、 校註 (法鼓文化) 兩段詳述。
  • note裡可以包含多個p, list,例如,章節1.1的第3個作者註:
<note resp="author" xml:id="n1.1.3">
  <p><lb/><seg rend="bold">成住壞空,空而復成</seg> 佛教對於......緣起緣滅的無常法。</p>
  <p><lb/>《雜阿含經》......</p>
</note>

@resp

  • resp: 標明來源來自作者(原註 author)或編輯(校註 editor)。

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

  • 有分章節的書:n 的值為 章節編號.第幾個註
  • 例如:第一章第一節的作者註1
<note resp="author" xml:id="n1.1.1">
  <p>印順長老於二○○五年圓寂。</p>
</note>
  • 不分章節的書:n 的值為 第n篇文章.第幾個註
  • 例如:05-02 第16篇文章 p.44 作者註1
<note resp="author" xml:id="n16.1">
  <p>《增一阿含經》卷六〈利養品〉:有一婆羅門勸佛至孫陀羅江側沐浴除罪,佛以不與取、不殺生、不妄語、無增減心等告之洗罪。</p>
</note>
  • 在不分章節書籍,但文章各大段重新起算註數的情形 (見03-01各篇)

以「分章節書籍的作者註」方式做處理。

a.書末標記

    <note resp="author" xml:id="nx.y.z "><p><lb/>註解</p></note>

x=第幾章、y=第幾段、z=本註為該段第幾個作者註。

b.內文標記

<p rend="indent">文章……<ref target="#nx.y.z"/></p>
  • 作者註中出現凸排三字的條列式(見01-01 p.20第六條作者註):

以rend="o3"給予p屬性,e.g.

<p rend="o3"><lb/>(一)明初……<lb/>《卍續藏》……</p>
<p rend="o3"><lb/>(二)明初……</p>
  • 針對07-14作者註註文特殊排版

在note中,以rend="note-like-p"給予屬性。 註文部分加上p rend="indent"。

e.g.07-14 p.68:註文排版同一般正文。

<note rend ="note-like-p" resp="author" xml:id="n3.9">
<p rend="indent"><lb/><seg rend="bold">混沌一氣</seg> 混沌又名渾沌……</p>
</note>


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

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

@place

  • place: 標明註解位置

如果出現作者註的note與ref不在同一個milestone的情況,note處需加上place屬性,並標示值為end,表示註解位於該篇章的最後。

例如:04-17 p.279

<note resp="author" place="end" xml:id="n3.1">
<p><lb/>「宗乘」意為各宗所弘揚的宗義和教典,此處指禪宗。</p>
</note>

ref 註腳參照

  • 表示文中所參照的作者註或註腳編號(紙本通常以圓圈內數字顯示)。
  • 編號方式:ref 為 #n 加上註解編號, note 為 n 加上註解編號。
  • 屬性 target 記錄參照的註腳編號。
  • 不需要標記 resp。
  • 需和 note 搭配使用,例如:參照第一章第一節的作者註1
  <ref target="#n1.1.1"/>
  ......
  <note resp="author" xml:id="n1.1.1"><p>印順長老於二○○五年圓寂。</p></note>


  • 不分章節的書,例如:05-02 第16篇文章 p.44 作者註1
  <ref target="#n16.1"/>
  ......
<note resp="author" xml:id="n16.1">
  <p>《增一阿含經》卷六〈利養品〉:有一婆羅門勸佛至孫陀羅江側沐浴除罪,佛以不與取、不殺生、不妄語、無增減心等告之洗罪。</p>
</note>

綜合範例

  • 例如 05-04 學佛知津 p.140 ,章節編號為 6.4,其中編號 9~12 為作者註,21為校註。標記如下:
(一)六年苦行。
(二)孫陀利女殺身謗佛。
(三)乞食羅閱城時,木槍刺足。
(四)毘蘭邑安居三月中,食馬麥。
(五)琉璃王滅釋迦族,頭背疼痛。<ref target="#n6.4.9"/>
(六)婆羅門聚落乞食,空缽而回。<ref target="#n6.4.10"/>
(七)旃荼女偽裝懷孕,謗佛通姦。
(八)提婆達多推下山石,傷破足指出血。 <ref target="#n6.4.11"/>
(九)在阿羅婆伽林,入夜寒風破竹。<ref target="#n6.4.12"/>
(十)骨節煩疼。<ref target="#n21"/>


05-04-140.png

ref 註腳位置在向量圖時

見6.2.4 http://wiki.dila.edu.tw/pages/%E3%80%8A%E6%B3%95%E9%BC%93%E5%85%A8%E9%9B%862020%E7%B4%80%E5%BF%B5%E7%89%88%E3%80%8B%E6%A8%99%E8%A8%98%E6%89%8B%E5%86%8A#.E8.A1.A8.E8.A7.A3.E5.9C.96.E7.89.87.EF.BC.88.E5.90.AB.E8.A8.BB.E8.A7.A3.EF.BC.89

ref 註解中的註腳

  • 於註解的內文中出現註腳,例如:09-08 人間淨土 P.169 註28
<note resp="editor" xml:id="n28">
  <p> 參看註<ref target="#n24"/>《楞伽師資記》所言的淨土觀。</p>
</note>

09-08p169.png

引文、書目、出處

quote 引文

  • 引文為敘述者或作者引用自文本以外來源的字 (句) 詞或段落。
  • 沒有出處的時候可以單獨使用;有出處時則搭配cit使用。
  • quote 可以包含多個段落p,例如: 10-11.xml
<quote>
  <p>佛告阿難及韋提希:見此事已,次當想佛。....是故應當一心繫念,諦觀彼佛多陀阿伽度阿羅訶三藐三佛陀。</p>
  <p>想彼佛者,先當想像....見如此事,極令明了,如觀掌中。</p>
  <p>見此事已,復當更作一大蓮花在佛左邊....諸蓮花上各有一佛二菩薩像,遍滿彼國。</p>
  <p>此想成時....於現身中,得念佛三昧。</p>
</quote>
  • quote 也用在經文原文的引用使用,例如:07-09 天台心鑰 p. 41 「原文」開始:
<div>
<head>原文</head>
  <quote>
    <p>佛祖之要,教觀而已矣。觀非教不正,教非觀不傳;有教無觀則罔,有 觀無教則殆。然統論時教,大綱有八,依教設觀,數亦略同。</p>
  </quote>
</div>
  • 引文中的署名:
<p rend="byline">印順合十</p>

quote中的排版(依2020.06.11 email討論)

預設無屬性quote使左邊界縮二字,p以及lg使首行或各行再縮一字。因此

<quote>
<p>成段引文</p>          請注意,這裡的p不加東西
<lg><l>一行詩</l></lg>
</quote>

表示這段引文中,成段文字部分左邊界縮二字、首行縮一字,而引用詩偈每行縮排三字。此為最常見情形。

若遇其他排版,在quote、p或lg之後以rend加上mx或iy屬性的方式處理,mx代表左邊界縮排x字、iy代表首行(於左邊界縮排後,再)縮排y字。常見特殊情形如下:

  • 成段引文排版同一般正文:
 <quote rend=”m0”>
 <p rend=”i2”>引文</p>
 </quote>
  • 引文成段部分排版同一般正文,詩偈部分卻每行縮排三字:
 <quote rend=”m0”>
 <p rend=”i2”>引文</p>
 <lg rend=”m3”><l>一行詩</l></lg>
 </quote>
  • 引用詩偈每行縮排二字:
<quote>
 <lg rend=”m0”><l>一行詩</l></lg>
</quote>
  • 散文首行縮二字、詩偈前方帶有數字符號

n後數字代表第幾首詩偈 實例見07-06 p.119

<quote rend="m0">
<p rend=”i2”>內文</p>
<lg n="1" type="gatha">
<l>由假說我法 有種種相轉</l> 請注意此處為全形空格
</lg>
</quote>

bibl 書目

  • 書目不夠清楚時不需標記,例如:只有經名,於前後文無法判斷收錄於哪一部藏經者。

@source

出自CBETA的書目〈〉《》

這裡不是指「校註給出行號資訊」的Cbeta出處。

(一)使用的標記:

<bibl source="T14n0475_p0538c04">  </bibl>

但為底下兩種情況時,不標記至行號:

1.只到經號

e.g.《景德傳燈錄》 T51n2076

2.到卷號

e.g.《景德傳燈錄》 第10卷  T51n2076_010


(二)標記方式

1.標記/不標記

 a.至少有明確的經名資訊才標:僅有大於等於「部」的資訊時不標記。

 b.一個段落裡引文被逐句解釋、逐句給出處,若前有共同的大範圍出處,只標大範圍出處。

 c.同一經目在一個段落內若多次出現,只標最早出現的一次即可。

 d.標記人員可考量讀者需求斟酌決定是否標記。判斷困難時提出討論:出現經名都可以考慮標記。

2.標記位置

 a.同一引文或同一筆參考資料有多個出處時,標記其中範圍較小者。e.g. 01-01 p.19註4:

 《景德傳燈錄》三十卷,宋之道原,纂成於西元一○○四年,現存於《大正藏》五十一冊

 前者範圍較小,所以標記「《景德傳燈錄》三十卷」。

 b.標記人員以輔助讀者角度,自行斟酌標記位置。e.g. 01-01 p.21的兩種標記方式:

參看《靈峰宗論》卷五的<bibl source="J36nB348_p0346a23">〈法派稱呼辯〉</bibl>及卷五的<bibl source="J36nB348_p0346c17">〈儒釋宗傳竊議〉</bibl>二文。

參看<bibl source="J36nB348_p0346a23">《靈峰宗論》卷五的〈法派稱呼辯〉</bibl>及卷五的<bibl source="J36nB348_p0346c17">〈儒釋宗傳竊議〉</bibl>二文。

3.不考證 只標記到書本給出的層次:例如若書本出處若只寫到卷,則標記人員只需要標到卷,不查位於第幾頁。

法鼓全集

  • 格式為:書號.頁碼
  • 頁碼僅記錄起始頁碼(如下例為 03-08.P22)
  • 屬性為type = "FGQJ" 英文全大寫
  • 篇名、書名:使用 bibl 標籤
  • 例如:01-01 頁21,參照文章位於同書頁260
明末的十一位居士資料,參閱本書第四章<bibl type="FGQJ" source="01-01.P260">〈明末的居士佛教〉</bibl>一文。
  • 例如:06-07 頁50,參照文章位於03-04 頁328
我曾在日本求學時所寫的<bibl type="FGQJ" source="03-04.P328">〈東京的佛教大學〉</bibl>一文中
  • 篇名和書名同時出現時,標記於篇名,書名不標,例如:07-09 頁152 裡參照文章位於 04-09 頁15。
「五停心」:我有一篇<bibl type="FGQJ" source="04-09.P15">〈「五停心觀」修行法〉</bibl>,介紹得比較詳細,請參閱。(收錄於《禪鑰》一書中)

ref 參考出處

@cRef

  • 連結以屬性 cRef 標記。

@type

CBETA出處

  • 使用屬性 type 標記值為 "cbeta",表示出處來自 CBETA。

標記原則

  1. 有引文及出處,標記需要標至該引用句的正確起始行號。例如:「三界虛妄,但是心作。」(大正九,五五八下)
  2. 沒有引文,但有明確出處,則標記至明確出處位置。例如:以上資料見於《卍續藏》一二五‧五五一頁
  3. 引文如無特殊字型則不需標記quote
  4. 標記位置在出處的文字處、不含引文 (請見範例) 07-14 p.23
經文是:<lb/>「三界虛妄,但是心作。」(<ref type="cbeta" cRef="T09n0278_p0558c10">大正九,五五八下</ref>

參考書目

部分書籍有特別段落列出參考書目(如:學術引用的reference),以清單標記處理,書目需標註出處。例如:03-01 p.391

  • 無項目符號
<list type="reference">
 <item>⋯⋯</item>
</list>
  • 有項目符號
<list rend="decimal" type="reference">
 <item>⋯⋯</item>
</list>

圖、表

table 表格

  • [重要] 由於紙本為直式排版(表格為直式),於網頁呈現時為橫式排版(表格為橫式),因此標記時需將表格視為橫式表格進行標記,請特別注意!!
  • 有框線表格
<table>...(表格)...</table>
  • 無框線表格
<table rend="none-border">...(表格)...</table>

cell內容跨頁時的頁碼標記

cell若內容跨頁,仍要忠實表現內容所在的頁數,故有時會產生同一個頁碼需要標記數次的情形。 同一個頁碼第一次標記時請仍以<pb n=”xx”/>標記,第二次標記<pb n=”xx” type=”notfirst-1”/ >、第三次標記<pb n=”xx” type=”notfirst-2”/ >,之後類推。

<pb n=”xx” type=”notfirst-n”/ >使用方式同<pb n=”xx”/>。 一個cell若跨頁部分為空白,不須特別為空白部分標記頁碼。

合併欄位 @cols @rows

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

Fgqj2020table.png

@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 圖片

  • 網頁圖檔僅接受 jpg, gif, png, svg 等格式。
  • 叢書部提供的原始檔案為印刷用檔,需要轉換為小檔才利網頁使用。
  • 原始檔案如為eps檔,需透過 illustrator 轉換成150dpi JPEG,設定如下圖:

Eps轉存檔案設定.png

圖片

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

圖片(含圖說)

  • 圖片標題(圖說) 以 head 標記。
  • 請注意 圖說文字在電腦初步轉出的XML檔中會出現在最後方,請標記人員手動移動至正確的位置
  • 圖檔若造成段落文字切斷,請標記於「內容相關」且「位置最接近」段落的之前或之後。
  • 若某頁內容僅有圖檔,因上面規則改變標記位置以致該頁空白時,仍保留其頁碼標記。
<figure>
    <graphic url="06-04p14.jpg"/>
    <head>聖嚴法師於農禪寺護法會年會中,欣喜地展示已找到法鼓山原始地貌照片。</head>
</figure>

06-04-14.png

表解圖片

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

07-09-340.png

表解圖片(含註解)

  • 穿插註解的表解圖片(如02-02 p.123)。
  • xmL中的處理:

 (1)穿插於圖解的註給予rend="hidden"屬性,標記在圖解之前。

 (2)graphic給予rend="svg-link"屬性。

  • xmL外的處理:

 標記人員至進度表備註欄登記,以知會程式人員做後續處理。

<figure>
<span>
<ref target="#n5.1.1" rend="hidden"/>
<ref target="#n5.1.2" rend="hidden"/>
<ref target="#n5.1.3" rend="hidden"/>
<ref target="#n5.1.4" rend="hidden"/>
</span>
 <graphic url="02-02p123.svg" rend="svg-link"/>
</figure>

行中插圖

  • 行中插圖為文字行中與字寬相等的圖片,圖檔命名原則與圖片相同。
  • 不需要包在 figure 裡,直接用 graphic 即可。
  • 設定 rend="inline",例如:01-04.xml, p.196
例如觀 <graphic rend="inline" url="01-04p196-1.png"/><graphic rend="inline" url="01-04p196-2.png"/>(唵

錯字或內文更正

情況一、有錯字需修改

錯字修改時使用 choice 標記, 錯字標示為 sic,正確字標示為 corr, choice 的屬性 change 記錄問題回報表的填報日期。

例如: 01-03 第39頁,填表日期為2021年12月10日,修改內容為「吠舍離」改為「毘舍離」

<choice change="2021-12-10">
  <sic></sic>
  <corr></corr>
</choice>

情況二、無錯字,僅加字

無錯字情況下,僅需使用 corr 標記, corr 的屬性 change 記錄問題回報表的填報日期。

例如: 01-03 第46頁,填表日期為2021年12月10日,內容「以為四分律義」修改為「以為《四分律》義」

以為<corr change="2021-12-10"></corr>四分律<corr change="2021-12-10"></corr>

情況三、無更正字,刪除該字

刪除錯字情況下,僅需使用 sic 標記, sic 的屬性 change 記錄問題回報表的填報日期。

例如: 01-03 第425頁,填表日期為2021年12月10日,內容「《梵網經》受戒法,已失其傳」修改為「《梵網》受法,已失其傳」

《梵網<sic change="2021-12-10"></sic>》受<sic change="2021-12-10"></sic>法,已失其傳

不標記

  • 原《法鼓全集》有標記,新《法鼓全集2020紀念版》不標記的項目有:人名 persName、地名 placeName、時間 date、手稿 ref。

缺字處理原則

  • 叢書部提供的indesign檔中,以造字方式製作的文字,在轉成XML檔時會造成缺字,依情況有不同的處理方式。


情況一、為美觀而造字

  • 缺字原因通常是書籍排版使用的字型無此字,美編為了美觀而造字。該字通常於新細明體(中文)、unicode字型(外文)可以正常顯示。
  • 處理方式:直接使用標準字取代缺字。
  • 例如:
    • 05-04 尼師壇那(Nişīdana)的ş、袈裟(kaṣāya)的ṣ,請參考拉丁字母列表
    • 05-02 「佛子羅睺羅」的「睺」


情況二、因輸入法沒有該字而造字

  • 如果該缺字來自藏經,則處理方式如下:

方案 1. 查詢 CBETA Online 和法鼓全集

CBETA Online

  • http://cbetaonline.dila.edu.tw/ 找到 符合師父引用出處 的同一部經,如果該字於CBETA online 正常顯示,則直接COPY使用。
  • 例如: http://cbetaonline.dila.edu.tw/zh/GA0028_006 大藏經音疏五百卷 「宋高僧傳唐行瑫撰」 的 「瑫」,
    為求嚴謹,可以查教育部異體字字典,看 [焰-火+王] 與 瑫 是不是異體字關係,再決定是否使用。

法鼓全集

  • 法鼓全集 找同一本書的處理方式是否可沿用。
  • 例如:06-05 p179 「是一條寬闊的上坡𨃇蹉」的 「𨃇」字可直接COPY使用。
  • 若 方案 1 未解決問題,則進行 方案 2。

方案 2. 查詢 DILA難檢字庫

  • DILA難檢字庫搜尋該字,字形以 Unicode 的字形圖片為準,而非「Your Browser」那欄。
  • 如果該字於新細明體可正常顯示,或是顯示後字形為異體字者,可直接COPY使用。
  • 例如:05-10 「阿㝹樓馱」的「㝹」在新細明體時,底下為「免」而非「兔」,但在教育部異體字字典中兩字相通,所以可直接使用。
  • 若 方案 2 中看到的文字於新細明體無法顯示,則進行 方案 3。


方案 3. 使用缺字標記

  • DILA難檢字庫搜尋該字,如該字無法顯示(下圖 B處),記下字碼(下圖 A處)及其組字式

Gword20200512.png

  • 標記格式為:
<g ref = "#CB字碼">[完整組字式含左右括號]</g>
  • 例如 05-09 p.127 此處標為:
為求金、銀、琉璃、車<g ref="#CB00006">[(王*巨)/木]</g>、馬瑙、珊瑚、虎珀、真珠等寶