Class: CBETA

Inherits:
Object
  • Object
show all
Defined in:
lib/cbeta.rb

Defined Under Namespace

Classes: BMToText, CharCount, CharFrequency, Gaiji, HTMLToPDF, HTMLToText, P5aToHTML, P5aToHTMLForEveryEdition, P5aToHTMLForPDF, P5aToSimpleHTML, P5aToText, P5aValidator

Constant Summary collapse

CANON = 
'DA|GA|GB|ZS|ZW|[A-Z]'
SORT_ORDER = 
%w(T X A K S F C D U P J L G M N ZS I ZW B GA GB)
DATA = 
File.join(File.dirname(__FILE__), 'data')
PUNCS = 
'.[]。，、；？：「」『』《》＜＞〈〉〔〕［］【】〖〗'

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ CBETA

載入藏經資料



142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
 
# File 'lib/cbeta.rb', line 142

def initialize()
  fn = File.join(File.dirname(__FILE__), 'data/canons.csv')
  text = File.read(fn)
  @canon_abbr = {}
  @canon_nickname = {}
  CSV.parse(text, :headers => true) do |row|
    id = row['id']
    unless row['nickname'].nil?
      @canon_nickname[id] = row['nickname']
    end
    next if row['abbreviation'].nil?
    next if row['abbreviation'].empty?
    @canon_abbr[id] = row['abbreviation']
  end
  
  fn = File.join(File.dirname(__FILE__), 'data/categories.json')
  s = File.read(fn)
  @categories = JSON.parse(s)
end

Class Method Details

.get_canon_from_vol(vol) ⇒ String

由 冊號 取得 藏經 ID

Parameters:

  • vol (String) —

    冊號, 例如 “T01” 或 “GA009”

Returns:

  • (String) —

    藏經 ID，例如 “T” 或 “GA”



31
32
33
 
# File 'lib/cbeta.rb', line 31

def self.get_canon_from_vol(vol)
  vol.sub(/^(#{CANON}).*$/, '\1')
end

.get_canon_id_from_linehead(linehead) ⇒ String

由 行首資訊 取得 藏經 ID

Parameters:

  • linehead (String) —

    行首資訊, 例如 “T01n0001_p0001a01” 或 “GA009n0008_p0003a01”

Returns:

  • (String) —

    藏經 ID，例如 “T” 或 “GA”



17
18
19
 
# File 'lib/cbeta.rb', line 17

def self.get_canon_id_from_linehead(linehead)
  linehead.sub(/^(#{CANON}).*$/, '\1')
end

.get_canon_id_from_work_id(work) ⇒ String

由 典籍編號 取得 藏經 ID

Parameters:

  • work (String) —

    典籍編號, 例如 “T0001” 或 “ZW0001”

Returns:

  • (String) —

    藏經 ID，例如 “T” 或 “ZW”



24
25
26
 
# File 'lib/cbeta.rb', line 24

def self.get_canon_id_from_work_id(work)
  work.sub(/^(#{CANON}).*$/, '\1')
end

.get_linehead(file_basename, lb) ⇒ String

Returns CBETA 行首資訊，例如 “T01n0001_p0001a01” 或 “T25n1510ap0757b29”.

Parameters:

  • file_basename (String) —

    XML檔主檔名, 例如 “T01n0001” 或 “T25n1510a”

  • lb (String) —

    例如 “0001a01” 或 “0757b29”

Returns:

  • (String) —

    CBETA 行首資訊，例如 “T01n0001_p0001a01” 或 “T25n1510ap0757b29”



38
39
40
41
42
43
44
 
# File 'lib/cbeta.rb', line 38

def self.get_linehead(file_basename, lb)
  r = file_basename
  r = 'T0220' if r.start_with? 'T0220'
  r += '_' if file_basename.match(/\d$/)
  r += 'p' + lb
  r
end

.get_sort_order_from_canon_id(canon) ⇒ String

由「藏經 ID」取得「排序用編號」，例如：傳入 “T” 回傳 “A”；傳入 “X” 回傳 “B”

Parameters:

  • canon (String) —

    藏經 ID

Returns:

  • (String) —

    排序用編號



77
78
79
80
81
82
83
 
# File 'lib/cbeta.rb', line 77

def self.get_sort_order_from_canon_id(canon)
  # CBETA 提供，惠敏法師最後決定的全文檢索順序表, 2016-06-03
  i = SORT_ORDER.index(canon)
  abort "unknown canon id: #{canon}" if i.nil?
  
  (i + 'A'.ord).chr
end

.get_work_id_from_file_basename(fn) ⇒ String

由 XML檔主檔名 取得 典籍編號

Parameters:

  • fn (String) —

    檔名, 例如 “T01n0001” 或 “GA009n0008”

Returns:

  • (String) —

    典籍編號，例如 “T0001” 或 “GA0008”



68
69
70
71
72
 
# File 'lib/cbeta.rb', line 68

def self.get_work_id_from_file_basename(fn)
  r = fn.sub(/^(#{CANON})\d{2,3}n(.*)$/, '\1\2')
  r = 'T0220' if r.start_with? 'T0220'
  r
end

.get_xml_file_from_vol_and_work(vol, work) ⇒ String

由 冊號 及 典籍編號 取得 XML 主檔名

Parameters:

  • vol (String) —

    冊號, 例如 “T01” 或 “GA009”

  • work (String) —

    典籍編號, 例如 “T0001” 或 “GA0008”

Returns:

  • (String) —

    XML主檔名，例如 “T01n0001” 或 “GA009n0008”



50
51
52
 
# File 'lib/cbeta.rb', line 50

def self.get_xml_file_from_vol_and_work(vol, work)
  vol + 'n' + work.sub(/^(#{CANON})(.*)$/, '\2')
end

.linehead_to_s(linehead) ⇒ String

將行首資訊轉為引用格式

Examples:

CBETA.linehead_to_s('T85n2838_p1291a03')
# return "T85, no. 2838, p. 1291, a03"

Parameters:

  • linehead (String) —

    行首資訊, 例如：T85n2838_p1291a03

Returns:

  • (String) —

    引用格式的出處資訊，例如：T85, no. 2838, p. 1291, a03



93
94
95
96
97
98
 
# File 'lib/cbeta.rb', line 93

def self.linehead_to_s(linehead)
  linehead.match(/^((?:#{CANON})\d+)n(.*)_p(\d+)([a-z]\d+)$/) {
    return "#{$1}, no. #{$2}, p. #{$3}, #{$4}"
  }
  nil
end

.linehead_to_xml_file_path(linehead) ⇒ String

由 行首資訊 取得 XML檔相對路徑

Parameters:

  • linehead (String) —

    行首資訊, 例如 “GA009n0008_p0003a01”

Returns:

  • (String) —

    XML檔相對路徑，例如 “GA/GA009/GA009n0008.xml”



57
58
59
60
61
62
63
 
# File 'lib/cbeta.rb', line 57

def self.linehead_to_xml_file_path(linehead)
  if m = linehead.match(/^(?<work>(?<vol>(?<canon>#{CANON})\d+)n\d+[a-zA-Z]?).*$/)
    File.join(m[:canon], m[:vol], m[:work]+'.xml')
  else
    nil
  end
end

.normalize_vol(vol) ⇒ Object 



100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
# File 'lib/cbeta.rb', line 100

def self.normalize_vol(vol)
  if vol.match(/^(#{CANON})(.*)$/)
    canon = $1
    vol = $2
  
    if %w[A C G GA GB L M P U].include? canon
      # 這些藏經的冊號是三碼
      vol_len = 3
    else
      vol_len = 2      
    end
    canon + vol.rjust(vol_len, '0')
  else
    abort "unknown vol format: #{vol}"
  end
end

.open_xml(fn) ⇒ Object 



117
118
119
120
121
122
 
# File 'lib/cbeta.rb', line 117

def self.open_xml(fn)
  s = File.read(fn)
  doc = Nokogiri::XML(s)
  doc.remove_namespaces!()
  doc
end

.pua(gid) ⇒ Object

傳入 缺字碼，傳回 Unicode PUA 字元



125
126
127
 
# File 'lib/cbeta.rb', line 125

def self.pua(gid)
  [0xf0000 + gid[2..-1].to_i].pack 'U'
end

.ranjana_pua(gid) ⇒ Object

傳入 蘭札體 缺字碼，傳回 Unicode PUA 字元



130
131
132
133
 
# File 'lib/cbeta.rb', line 130

def self.ranjana_pua(gid)
  i = 0x10000 + gid[-4..-1].hex
  [i].pack("U")
end

.siddham_pua(gid) ⇒ Object

傳入 悉曇字 缺字碼，傳回 Unicode PUA 字元



136
137
138
139
 
# File 'lib/cbeta.rb', line 136

def self.siddham_pua(gid)
  i = 0xFA000 + gid[-4..-1].hex
  [i].pack("U")
end

Instance Method Details

#get_canon_abbr(id) ⇒ String

取得藏經略名

Examples:

cbeta = CBETA.new
cbeta.get_canon_abbr('T') # return "大"

Parameters:

  • id (String) —

    藏經 ID, 例如大正藏的 ID 是 “T”

Returns:

  • (String) —

    藏經短名，例如 “大”



190
191
192
193
194
 
# File 'lib/cbeta.rb', line 190

def get_canon_abbr(id)
   r = get_canon_symbol(id)
   return nil if r.nil?
   r.sub(/^【(.*?)】$/, '\1')
end

#get_canon_nickname(id) ⇒ String

Returns 藏經短名，例如 “大正藏”.

Parameters:

  • id (String) —

    藏經 ID, 例如大正藏的 ID 是 “T”

Returns:

  • (String) —

    藏經短名，例如 “大正藏”



164
165
166
167
 
# File 'lib/cbeta.rb', line 164

def get_canon_nickname(id)
  return nil unless @canon_nickname.key? id
  @canon_nickname[id]
end

#get_canon_symbol(id) ⇒ String

取得藏經略符

Examples:

cbeta = CBETA.new
cbeta.get_canon_symbol('T') # return "【大】"

Parameters:

  • id (String) —

    藏經 ID, 例如大正藏的 ID 是 “T”

Returns:

  • (String) —

    藏經略符，例如 “【大】”



177
178
179
180
 
# File 'lib/cbeta.rb', line 177

def get_canon_symbol(id)
  return nil unless @canon_abbr.key? id
  @canon_abbr[id]
end

#get_category(book_id) ⇒ String

傳入經號，取得部類

Examples:

cbeta = CBETA.new
cbeta.get_category('T0220') # return '般若部類'

Parameters:

  • book_id (String) —

    Book ID (經號), ex. “T0220”

Returns:

  • (String) —

    部類名稱，例如 “阿含部類”



203
204
205
 
# File 'lib/cbeta.rb', line 203

def get_category(book_id)
  @categories[book_id]
end