檢視「《成唯識論》及其註釋書之數位資料庫」作業手冊的原始碼

=簡介及目的=

*以法相宗所依據的重要論書之一的《成唯識論》（十卷）為主要架構，並依每一卷之論文，連結《成唯識論述記》、《成唯識論掌中樞要》、《成唯識論了義燈》、《成唯識論演秘》對其之註解及說明，進行研究唯識學重要參考資料之整合，完成專案內容之全文搜尋、引用複製、查找等各項功能。

= 處理範圍 =

# 《成唯識論》：共十卷，為護法等造，唐‧玄奘譯著。收於大正藏冊31。
# 《成唯識論述記》：共十卷，為唐‧窺基所撰。收於大正藏冊43。
# 《成唯識論掌中樞要》：總分為上、下二卷，為唐‧窺基所撰。收於大正藏冊43。
# 《成唯識論了義燈》：共七卷，為唐‧惠沼所著。收於大正藏冊43。
# 《成唯識論演秘》：共七卷，為唐‧智周所撰。收於大正藏冊43。

= 作業環境準備 =
== 安裝軟體 ==

* oXygen (XML 編輯器)
* Notepad++ (純文字編輯器)
* Free commander (檔案管理)
* Ruby (以後需要執行果睿寫的程式時會用到)

== 作業環境 ==

* 主要在 oXygen（XML編輯器） 裡面做，有些特殊字元在 oXygen 裡編輯可能有問題，需要時換至 Notepad++進行。
* oXygen（XML編輯器）並非絕對的作業環境，如果找到更好的編輯方式亦可。

= 執行作業 =
== 標逗 ==

* 主要在 oXygen（XML編輯器）中的 Author mode 中作業。

== 標記 ==
=== 經名、卷名、作者的標記 ===
● 經名、卷名、作者這些系統程式已設定，不須另外標記。
● 關於經名、卷名、作者等前面是否空格的問題：段落前內縮的空格一律不保留，由程式在輸出時控制。除非那個地方的空格不是標準的，才需要特別標示。例如：假設我們規定每個段落首行內縮兩格，這兩個空格，不必用空格直接打進去，程式會自動加，在 XML 裡會像這裡：<p>段落文字開頭不加空格??</p>；除非某個段落特別，不是空兩格，而是不要空格，這時才改標記為：<p style="text-indent:0">....</p>

=== 偈頌的標記 ===
不必處理空格之標記，程式會自動加， 除非偈頌中間是加標逗，就直接加。

=== 樹狀目錄（科判）的標記（以《成唯識論》為主） ===

* 樹狀目錄以《成唯識論》為主。
* 樹狀目錄的進行：切勿在word檔先作科判表，應在XML中進行。
* 範例：

<syntaxhighlight lang="XML">
壹﹑宗前敬序分
  (壹）以頌彰釋論之因
    一、歸敬福田
    二、敘釋論意
  (貳）以長行明本論主造論之意 
    一、安慧等悟斷得果解
    二、火辨等達空悟性義
    三、護法等破執顯理解
貳、依教廣成分
  (壹）明唯識相
    一、略釋難標
      (一）將發論端寄問徵起
      (二）舉頌依義正答
      (三）長行釋
    二、隨標廣釋
      ………
  （貳）明唯識性
    ………
參﹑釋結施願分
  （壹）………
  （貳）………
  （參）………
</syntaxhighlight>

● 標記方法：

<syntaxhighlight lang="XML">
<text>
  <body>
    <div>
      <head>宗前敬序分</head>
      <div>
        <head>以頌彰顯釋論之因</head>
        <div>
          <head>歸敬福田</head>
        </div>
        <div>
          <head>敘釋論意</head>
        </div>
      </div>
      <div>
        <head>以長行明本論主造論之意</head>
        <div>
          <head>安慧等悟斷得果解</head>
        </div>
        <div>
          <head>火辨等達空悟性義</head>
        </div>
        <div>
          <head>護法等破執顯理解</head>
        </div>
      </div>
    </div>
    <div>
      <head>依教廣成分</head>
      <div>
        <head>明唯識相</head>
        <div>
          <head>略釋難標宗</head>
          <div>
            <head>將發論端寄問徵起</head>
          </div>
          <div>
            <head>舉頌依義正答</head>
          </div>
          <div>
            <head>長行釋</head>
          </div>
        </div>
        <div>
          <head>隨標廣釋</head>
          …………
        </div>
      </div>
      <div>
        <head>明唯識性</head>
        …………
      </div>
    </div>
    <div>
      <head>釋結施願分</head>
      …………
    </div>
  </body>
</text>
</syntaxhighlight>

以上科判例舉至第四層，以此類推。

=== 對應科判內文之標記 ===

●對應科判之內文處理重點：

# 對應科判之內文的範圍。
# 該對應科判內文範圍中，有其對應之註釋內文的符號。如 4.2.4.1 及 4.2.4.2 範例中的 ①、② 、③……等。  


==== 對應內文為長行之標記 ====

●例舉：

<syntaxhighlight lang="XML">
稽首①唯識性、滿、分清淨者②，
</syntaxhighlight>

●標記方法：

<syntaxhighlight lang="XML">
<div type="CL">
  <p>稽首<anchor corresp="#n1.1"/>唯識性、滿、分清淨者<anchor corresp="#n1.2"/></p>
</div>
</syntaxhighlight>

【註】例句中的①、②，表示在對應此科判的論文中，該二處有其對應之註釋論文，因此標記以<anchor corresp="#n1.1"/> 及 <anchor corresp="#n1.2"/>記錄。

==== 對應內文為偈頌之標記 ====

●範例：

<syntaxhighlight lang="XML">
由假說我、法①，有種種相轉②。
彼依識所變③ ， 此能變唯三④：
謂異熟、思量  及了別境識⑤。
</syntaxhighlight>

●標記方法：

<syntaxhighlight lang="XML">
<div>
  <head>舉頌依義正答</head>
  <div type="CL">
    <lg type="CL">
      <l>由假說我、法<anchor corresp="#n2.1"/></l>
      <l>有種種相轉。<anchor corresp="#n2.2"/></l>
      <l>彼依識所變，<anchor corresp="#n2.3"/></l>
      <l>此能變唯三：<anchor corresp="#n2.4"/></l>
      <l>謂異熟、思量<anchor corresp="#n2.4"/></l>
      <l>及了別境識。<anchor corresp="#n2.5"/></l>
    </lg>
  </div>
</div>
</syntaxhighlight>

【註】例句中的 ①、②、③、④、⑤，表示在對應此科判的論文中，該五處有其對應之註釋論文，因此標記以<anchor corresp="#n2.1"/>……<anchor corresp="#n2.5"/>記錄。

=== 科判內文中之對應註釋論文的標記方法 ===

==== 對應之註釋論文為相同層次時的標記方法 ====

●範例： 稽首1唯識性、滿、分清淨者2，

●標記方法：（續前4.2.3.1長行標記方法）

<syntaxhighlight lang="XML">
<div>
   <div type="CL">
   <p>稽首<anchor corresp="#n1.1"/>唯識性、滿、分清淨者<anchor corresp="#n1.2"/></p>
   </div>  
   <div xml:id="n1.1">
      <div type="SJ"><p>述曰：.....（《述記》的內文）</p>
      </div>
      <div type="YM"><p>演秘：.....（《演秘》的內文）</p>
      </div> 
   </div>
   <div xml:id="n1.2">
     <div type="SJ"><p>述曰：....（《述記》的內文）</p>
     </div>
     <div type="SY"><p>樞要：....（《樞要》的內文）</p>
     </div>
   </div>
</div>
</syntaxhighlight>

==== 對應之註釋論文為不同層次時的標記方法 ====

●範例： 稽首1唯識性、滿、分清淨者2，

●標記方法：（續前4.2.3.1長行標記方法）

<syntaxhighlight lang="XML">
<div>
   <div type="CL">
   <p>稽首<anchor corresp="#n1.1"/>唯識性、滿、分清淨者<anchor corresp="#n1.2"/></p>
   </div>  
   <div xml:id="n1.1">
      <div type="SJ"><p>述曰：.....（《述記》的內文）</p>      
          <div type="YM"><p>演秘：.....（《演秘》的內文）</p>
          </div>
      </div> 
   </div>
   <div xml:id="n1.2">
     <div type="SY"><p>樞要：....（《樞要》的內文）</p>
        <div type="YM"><p>演秘：....（《演秘》的內文）</p>
        </div>
     </div>
   </div>
</div>
</syntaxhighlight>

=== 註解的標記 ===

註解分兩大類，一種是 <note resp="bolang">，一種是 <note type="gloss">。

<note resp="bolang"> 在呈現時會直接插入行中，幫助理解。

<note type="gloss"> 在呈現時會另開視窗，或以其他類似方式呈現，不干擾閱讀。

==== resp="bolang" ====

●應在text中作業。

●標記規則：<note resp="加注解者">X</note>  （X表示注解的內容）

●舉例：

例1：

（原文）今造此論，為於二（我、法或云生、法）空有迷謬者，生正解故。<br/>
（標記方法）今造此論，為於二<note resp="bolang">（我、法或云生、法）</note>空有迷謬者，生正解故。

例2：

（原文）又為開示謬執我、法，迷唯識者，令達〔我、法〕二空，於唯識理如實知故。<br/>
（標記方法）：又為開示謬執我、法，迷唯識者，令達<note resp="bolang">〔我、法〕</note>二空，於唯識理如實知故。

●說明：

# （）及〔〕括號亦為注解內容。
# 或可在text中→crl+e→選note可接在上面鍵入注解內容。

==== type="gloss" ====

原文

<syntaxhighlight lang="XML">
我今釋彼（世親）說
</syntaxhighlight>

標記方法

<syntaxhighlight lang="XML">
我<note type="gloss">《述記》謂「我」指安慧，然《測疏》「我謂護法」二者不同。</note>今釋彼（世親）說
</syntaxhighlight>

=== 特殊名詞解釋的標記 ===
●標記規則：

# 將 X mark起來→ crl+e → 在視窗中選term → <term> Y</term>（X為需解釋的特殊名詞，Y為釋文內容）
# 於text中作業，將內容填入。

例：<br/>
（原文） 稽首唯識性、滿分清淨者    （「稽首」為須解釋的的名詞）<br/>
（標記方法）將「稽首」mark 起來→ crl+e →在視窗中選term → <term>以頭觸地，表示禮敬之意。</term>

●說明：
# 可在text中→crl+e→選term可接在上面鍵入注解內容。<br>
# 初期可以先進行規則1的作業，可待文獻處理資訊工程師將所有特殊名詞列出後，屆時再個別將解釋的內容鍵入。

●特殊情況的標記方法：

1.當需解釋的名詞相同，但屬性及其內容不同時：

例：<br/>
（原文）「我今釋彼（世親）說」中的「我」（下面以「我1」表示）與「我謂主宰」中的「我」（下面以「我2」表示），兩處的屬性不同；其中「我1」是指安慧，應與第一句之指示代名詞「彼」（世親）相同，是指涉特定的人；而「我2」乃指佛學中的ātman，則是屬於特殊名詞解釋。<br/>
（標記方法）「我1」的標記方法為：「我<note type="gloss">X</note>今釋彼（世親）說」（其中X表示對於「我1」的說明內容）；而「我2」則同前面所述之正規的標記方法。　

2.當文本需解釋的特殊名詞（如：遍淨）與釋文詞條（如：遍淨天）不符合時：

例：<br/>
（原文）「謂有異生伏遍淨貪，……」，此中「遍淨」為需解釋的特殊名詞，其所對應的釋文詞條為「遍淨天」。<br/>
（標記方法）<term key="遍淨天">遍淨</term>

3.當需解釋的特殊名詞重複出現，且每一名詞所對應的釋文詞條不同時：<br />
（確認後補充說明）

=== 行中夾註及雙行夾註的標記 ===
（後續補充）

=== 圖表的標記 ===
===== 表格的標記方式 =====
● 在text中作業。

● 表格的呈現方式有二類：


1.一般常規性的表格，舉例如下：

<table border="1" cellspacing="0" cellpadding="5">
<tr>
  <td>（空白）</td>
  <td>a</td>
  <td>b</td>
</tr>
<tr>
  <td>c</td>
  <td>d</td>
  <td>e</td>
</tr>
</table>

此類的標記規則為：

<syntaxhighlight lang="XML">
<note resp="bolang"><table>
  <head>表格名稱</head>
    <row>
      <cell></cell>
      <cell>a</cell>
      <cell>b</cell>
    </row>
    <row>
      <cell>c</cell>
      <cell>d</cell>
      <cell>e</cell>  
    </row>
</table></note>
</syntaxhighlight>

2.內含合併儲存的表格，舉例如下：

<table border="1" cellspacing="0" cellpadding="5">
<tr>
  <td colspan="2">a</td>
  <td colspan="2">b</td>
</tr>
<tr>
  <td>c</td>
  <td>d</td>
  <td>e</td>
  <td>f</td>
</tr>
<tr>
  <td colspan="2">g</td>
  <td colspan="2">h</td>
</tr>
<tr>
  <td colspan="2" rowspan="2">i</td>
  <td colspan="2">j</td>
</tr>
<tr>
  <td colspan="2">k</td>
</tr>
<tr>
  <td rowspan="2">l</td>
  <td colspan="2">m</td>
  <td>n</td>
</tr>
<tr>
  <td colspan="2">o</td>
  <td>p</td>
</tr>
</table>

此類之標記規則為：
<syntaxhighlight lang="XML">
<note resp="bolang"><table>
  <head>表格名稱</head>
    <row>
      <cell cols="2">a</cell>
      <cell cols="2">b</cell>
    </row>
    <row>
      <cell>c</cell>
      <cell>d</cell>
      <cell>e</cell>
      <cell>f</cell>
    </row>
    <row>
      <cell cols="2">g</cell>
      <cell cols="2">h>/cell>
    </row>
    <row>
      <cell rows="2" cols="2">i</cell>
      <cell cols="2">j</cell>
    </row>
    <row>
      <cell cols="2">k</cell>
    </row>
    <row>
      <cell rows="2">l</cell>
      <cell cols="2">m</cell>
      <cell>n</cell>
    </row>
    <row>
      <cell rows="2">o</cell>
      <cell>p</cell>
    </row>
</table></note>
</syntaxhighlight>

● 表格內容的特殊需求(此項需求為編輯者自行加註)：

1.內容須條列且呈現「序號」時：

例如：

  俱有因乃俱有果之因，分為二種：
  1.互為果俱有因。
  2.同一果俱有因。

此類標記方法為：

<syntaxhighlight lang="XML">
<note resp="bolang"><table>
   <row>
     <cell>
        <p>俱有因乃俱有果之因，有分為二種：</p>
        <list rend="numbered">
           <item>互為果俱有因。</item>
           <item>同一果俱有因。</item>
        </list>
     </cell>
   </row> 
</table></note>
</syntaxhighlight>

2.文本為長行，但頁面須於特定處以分行呈現，此時則須"強制"換行：

例如：
<syntaxhighlight lang="XML">
（文本資料）顯阿賴耶識之流轉、還滅義。「由此有諸趣」：顯流轉義。「及涅槃證得」：顯還滅義。
（頁面呈現）顯阿賴耶識之流轉、還滅義。
　　　　　 「由此有諸趣」：顯流轉義。
          「及涅槃證得」：顯還滅義。
</syntaxhighlight>

此類標記方法為：

<syntaxhighlight lang="XML">
<table>
  <row>
    <cell>顯阿賴耶識之流轉、還滅義。</lb>「由此有諸趣」：顯流轉義。</lb>「及涅槃證得」：顯還滅義。</cell>
  </row>
</table>
</syntaxhighlight>

===== 圖的標記方式 =====

圖的標記方式分兩種：

1.屬於cbeta經論原文的圖

（圖檔的檔案名稱為：sy1.k1.svg）

其標記規則為：

<syntaxhighlight lang="XML">
   
<figure>
  <graphic url="sy1.k1.svg"/>
</figure>

</syntaxhighlight>

2.為編輯者自行繪製的圖

(例如：圖檔之檔名為：k3.svg，圖檔的名稱為：造論目的)

其標記規則為：

<syntaxhighlight lang="XML">

<note resp="bolang"><figure>
  <head>造論目的</head>
  <graphic url="k3.svg"/>
</figure></note>

</syntaxhighlight>

= 檔案名稱 =
●五部論各別一個檔名。

= 存檔方式 =
●直接存檔 →上傳到dropbox

= 校對、修訂 =
●完成標逗的檔案逐字逐句校對。
●完成標記的檔案的校對。
●有錯誤者直接在其原本的作業環境中修訂。

= 其他注意事項 =