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

=簡介及目的=

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

= 處理範圍 =

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

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

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

== 作業環境 ==

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

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

* 標逗：主要在 oXygen（XML編輯器）中的 Author mode 中作業。
* 標注、特殊名詞解釋：主要在 oXygen（XML編輯器）中的 text 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>

【註】例句中的①、②，表示在對應此科判的論文中，該二處有其對應之註釋論文，因此標記以 &lt;anchor corresp="#n1.1"/> 及 &lt;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>

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

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

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

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

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

<syntaxhighlight lang="XML">
<div type="CL">
  <p type="CL">稽首<anchor corresp="#n1.1"/>唯識性、滿、分清淨者<anchor corresp="n1.2"/></p>
  <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></ab>
    <div type="YM"><p>演密：……（《演秘》的內文）</p></ab>
  </div>
</div>
</syntaxhighlight>

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

=== 註解的標記 ===

●應在text中作業。

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

●舉例：

例1：（原文）

<syntaxhighlight lang="XML">
今造此論，為於二（我、法或云生、法）空有迷謬者，生正解故。
</syntaxhighlight>

（標記方法）

<syntaxhighlight lang="XML">
今造此論，為於二<note resp="bolang">（我、法或云生、法）</note>空有迷謬者，生正解故。
</syntaxhighlight>

例2：（原文）

<syntaxhighlight lang="XML">
又為開示謬執我、法，迷唯識者，令達〔我、法〕二空，於唯識理如實知故。
</syntaxhighlight>

（標記方法）：

<syntaxhighlight lang="XML">
又為開示謬執我、法，迷唯識者，令達<note resp="bolang">〔我、法〕</note>二空，於唯識理如實知故。
</syntaxhighlight>

●說明：

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

=== 特殊名詞解釋的標記 ===

●標記規則：

1. 將 X mark起來→ crl+e → 在視窗中選term → <term> X</term>（X為需解釋的特殊名詞）

2. 於text 中作業。

例1：（原文） 

<syntaxhighlight lang="XML">
稽首唯識性、滿分清淨者    （「稽首」為須解釋的的名詞）
</syntaxhighlight>

（標記方法）將「稽首」mark 起來→ crl+e →在視窗中選term → <term>稽首</term>

● 說明：

# 可在text中→crl+e→選term，將須特別解釋的名詞標註起來。
# 初期可以先進行規則1的作業，可待文獻處理資訊工程師將所有特殊名詞列出後，屆時再個別將解釋的內容鍵入。

●特殊情況的標記方法：

1.當需解釋的特殊名詞重複出現，且對應的釋文詞條不同時：

例：（原文）

<syntaxhighlight lang="XML">
「我今釋彼說」中的「我」與「我謂主宰」中的「我」，兩處對於「我」的釋文不同。
</syntaxhighlight>

（標記規則）可將兩處的「我」分別予以「我1」、「我2」紀錄，之後亦於釋文詞條時給予相對應的「我1」、「我2」，俾便兩造對應時相符。

（標記方法）於「我1」標記為：<term key="我1">我</term>，於「我2」標記為：<term key="我2">我</term>


2.當需解釋的特殊名詞與所對應的釋文詞條不符合時：

例1：（原文）

<syntaxhighlight lang="XML">
「謂有異生伏遍淨貪，……」，此中「遍淨」其對應的釋文詞條為「遍淨天」。
</syntaxhighlight>

（標記方法）<term key="遍淨天">遍淨</term>

例2：（原文）

<syntaxhighlight lang="XML">
「聞熏習中，有漏性者是修所斷，……」，此中「修所斷」其對應的釋文詞條為「三斷」。
</syntaxhighlight>

（標記方法）<term key="三斷">修所斷</term>

=== 行中夾註及雙行夾註的標記 ===

=== 圖表的標記 ===
●再確認處理方式。

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

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

= 校對、修訂 =

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

= 其他注意事項 =