MrMYHuang/cbetar2

A frontend + backend ePub viewer supporting fetching and displaying HTML as ePub. This (unofficial) app is also a Buddhist text viewer using CBETA backend API or offline DB.

CBETA 電子佛典閱讀器 2 (非官方)

特色

搜尋目錄、全文檢索、書籤功能、網址分享、離線瀏覽、語音播放、佛學詞典、佈景主題切換、經文分頁、字型調整、楷書字型、直排文字、列印經文/抄經本、連線/離線 DB 支援、跨平台、無廣告、開放原始碼。

說明

CBETA 電子佛典閱讀器 2 (非官方) (Chinese Buddhist Electronic Text Association Reader 2)，簡寫 cbetar2，使用連線 CBETA API 或離線 CBETA 經文檔存取電子佛經，支援以下功能

• 搜尋、瀏覽(線上查詢)

  1. 搜索目錄：在目錄頁，按下右上角放大鏡圖示。在對話框輸入經文部分(或全部)標題，按下"搜索目錄"後會列出相關經文。
  

  2. 全文檢索：類似"搜索目錄"。但在對話框可輸入某卷經文內的一段文字，如"大水忽起卒至無期"。

  3. 經文內搜索。

  4. 上下卷切換：在經文頁中，右下方半透明鈕按下會跳按鈕，可切換上下卷。

  

• 書籤

  1. 開啟某經文後，(手機、平板)長按後選擇想標記為書籤的字串位置，按右上角書籤圖示，即新增一書籤，可至書籤頁查詢。加入書籤的經文可作離線瀏覽。
  
  2. 刪除：至書籤頁，左滑項目即出現刪除鈕，再點擊。

• 離線瀏覽

  1. 書籤頁包含的"經"或"卷"書籤都具有離線瀏覽的功能，並用圖示標示。
  2. 設定頁的"更新離線經文檔"按鈕用途為：當 CBETA 每季更新經文後，離線經文檔不會自動更新，必須手動執行此功能更新所有離線檔。

• 網址分享

  1. 用瀏覽器開啟此 app 並開啟某卷經文後，可複製其網址分享給別人開啟。
  2. 也可以使用瀏覽器內建書籤功能儲存經文網址。與 app 書籤功能相比，可以依個人使習慣作選擇。
  3. App 內建"分享此頁"功能，可複製以下連結至作業系統剪貼簿或產生 QR code，可分享給其他人：目錄、經、卷、目錄搜尋、全文檢索搜尋、詞典搜尋、app 主頁
  4. 分享網址可帶上部分 app 設定參數。
  
  5. 經文文字連結功能：選取經文一段文字後、執行"分享此頁"功能，所產生的 app 連結開啟後會自動跳至選取文字頁面並標示選取文字。
  6. 文章引用：選取經文一段文字後、執行"文章引用"功能，引用文字即複製至作業系統剪貼簿。引用格式基於CBETA Online，例如："《長阿含經》卷1：「長阿含經」(CBETA, T01, no. 1, p. 1a02)"

• 經文分頁

  1. 經文可調整成單頁或分頁模式。單頁模式，使用滑動方式閱讀經文。分頁模式，可使用鍵盤方向鍵或螢幕方向鍵切換經文頁。

• 字型調整

  1. 考量視力不佳的同修，提供最大 128 px 的經文字型設定。若有需要更大字型，請 E-mail 或 GitHub 聯絡開發者新增。
  2. 支援全字庫楷書字型。

• 直排文字

  1. 傳統中文書的直排文字、由右至左排版。

• 佈景主題切換

  1. 支援多種佈景主題。
  

• 經文頁鍵盤/手勢支援

  • 左、右鍵，右、左滑：分頁直排模式下一頁、上一頁
  • 下、上鍵，上、下滑：分頁模排模式下一頁、上一頁
  • Alt + Enter、滑鼠雙擊、手勢雙擊: 全螢幕進入/離開切換
  • Esc: 離開全螢幕
  • F3 或 Ctrl + f: 搜尋文字

• 語音播放

  1. 使用電腦語音合成技術 - text to speech，作唸經文功能，即所謂的"有聲書"。(注意，當代電腦語音合成技術與"真人發音"仍有落差。因此聽到的經文發音偶爾不正確是正常現象。)
  2. 播放步驟：開啟經文，按下右上方音符鈕，即可播放（如擷圖所示）
  
  3. 單頁模式下指定位置播放：選取部分經文，按下播放鍵，即會從選取處開始播放至經文結尾。
  4. 分頁模式下指定頁數播放：切換至特定頁數，按下播放鍵，即會從該頁開始播放。一頁播完會自動跳下一頁，至經文結尾。
  5. 循環播放：可選擇循環播放的啟始與結束文字，即會自動重複播放，直到按下暫停播放鈕。用途：作唸佛機用。
  
  6. 合成語音切換：可切換中國大陸腔、台灣腔、廣東腔，尚不支援 Linux。Windows 10 使用者，請先至 OS 設定安裝各種語音檔，如圖所示：
  

• 佛學詞典(線上查詢)

  1. 整合"DILA 佛學術語字辭典"，可在"佛學詞典"分頁查詢佛學字詞。
  
  2. 也可以從查詢的結果選取文字，再執行查詢詞典功能。
  3. 也可以在經文頁選取文字後，執行查詢詞典功能。

• 萌典字典(線上查詢)

  1. 整合"萌典"字典，可在"佛學詞典"分頁切換至"萌典字典"，可查詢單字，包括注音、解釋。
  2. 也可以從查詢的結果選取文字，再執行查詢字典功能。
  3. 也可以在經文頁選取文字後，執行查詢字典功能。

• App 捷徑

  1. Windows Chrome, Android Chrome, iOS App Store 使用者，滑鼠右鍵或長按 app 圖示，可存取 app 功能捷徑，目前有：(開啟)第1書籤、佛學詞典、萌典字典。
  2. 若由舊版 app 升級至 >= 4.3.0版，要作一次移除 app (可不刪 app 資料)，再重新安裝，此 app 捷徑選單才會出現。
  

• 列印經文

  1. 經文頁右上三點按鈕點開，按下列印按鈕，即會跳出列印對話框。
  2. 應用：可選擇印紙本或 PDF 檔。
  3. 調整：可至設定頁調整字型大小、橫/直排文字、黑體/楷書體，再作列印。
  4. 設定頁可設定"經文列印樣式"，目前支援"白底黑字"、"抄經本"。
  5. 已在 Chrome 87, Edge Chrome 87 測過可用。iOS Safari 僅支援橫排文字列印。
  

• App 設定匯出/匯入

  1. 此功能位於設定頁。
  2. 匯出 app 設定，同時也會匯出書籤資訊，可作備分。
  3. 匯入設定後，會重新下載離線經文檔。

• App 異常回報

  App 設定頁的異常回報鈕使用方法為：執行會造成 app 異常的步驟後，再至設定頁按下異常回報鈕，輸入您的 E-mail 及造成異常的步驟，送出即可。

• 模組化程式

  cbetar2 為一支模組化程式，由 frontend app (PWA) + backend app (CBETA API or cbetar2 backend) 組成。有3種使用方式：

  1. 連線 DB：PWA + CBETA API
  • 此模式不須先下載 CBETA 離線經文資料檔，但要作離線瀏覽要把經文加至書籤。
  2. 離線 DB + PWA：PWA + CBETA 離線經文檔
  • 此模式與連線模式相似，多了離線DB的支援。要設定此模式，要先下載 DB：詳情。可離線瀏覽目錄、經文，但部分功能仍須連線，如全文檢索。
  3. 離線 DB + Electron app：PWA + cbetar2 backend
  • 此模式與 PWA 離線版功能相同。要設定此模式，要先下載、解壓CBETA 離線經文資料檔。啟動 app 後，執行選單/檔案/設定 Bookcase目錄。
  • 使用瀏覽器安裝的 PWA 不支援此模式。

程式碼為開放(MIT License)，可自由下載修改、重新發佈。

支援平台

已在這些環境作過安裝、測試:

• Windows 10 amd64 + Chrome
• Windows 11 on ARM + Chrome
• Android 9 + Chrome
• Firefly RK-3399 + Android 7.1 + Firefox 91
• macOS 11 amd64 + Chrome
• macOS 11 arm64 + Mac App Store
• iPad 7 iPadOS 14-15 + Safari
• iPad Pro + App Store
• iPhone 8 (模擬器) + Safari
• Debian Linux arm64 10 + Chrome
• Ubuntu 21 amd64 + Snap Store
• Ubuntu 21 amd64 + Flathub
• Ubuntu 20.04 arm64 + Snap Store
• Fedora 35 aarch64 + Flathub
• Fedora 36 aarch64 + COPR
• openSUSE Leap 15.3 aarch64 + AppImage
• Arch Linux aarch64 + AppImage
• Kali Linux arm64 + DEB
• Raspberry Pi 4 + Ubuntu 20 arm64 + Snap Store
• CentOS Stream 9 aarch64 + COPR
• AlmaLinux 9 aarch64 + COPR

非上述環境仍可嘗試使用此 app。若有已知問題未描述的問題，可用異常回報功能。

建議 OS 與 Chrome、Safari 保持在最新版，以取得最佳 app 體驗。

安裝

此 app 有3種取得、安裝方式：

1. Chrome, Safari 網頁瀏覽器。
2. App 商店。
3. 下載安裝檔。

3種安裝方法如下。

從瀏覽器開啟/安裝

從 App 商店安裝

iOS 14.0+ (iPhone), iPadOS 14.0+ (iPad) - 使用 Apple App Store

Android 4.4+ - 使用 Google Play Store

Android 4.4+ - 使用 Amazon Appstore

Android 4.4+ - 使用 Samsung Galaxy Store

Android 4.4+ - 使用 Huawei AppGallery (未過審中國大陸)

macOS 10.11+ (x86_64 & arm64) - 使用 Apple App Store

Windows 10+ (x64 & arm64) - 使用 Microsoft Store

Linux (amd64 & arm64) - 使用 Snap Store

Linux (x86_64 & aarch64) - 使用 Flathub

RHEL 8 & 9 / CentOS 8 & 9 / Fedora Linux 34-36 (x86_64 & aarch64) - 使用 Copr

Shell script:

sudo dnf copr enable mrmyh/cbetar2
sudo dnf install cbetar2

下載安裝檔

支援的作業系統如下：

1. Android (中國大陸使用者也能安裝)
2. Linux amd64 & arm64 AppImage (Ubuntu, Fedora, Debian, Arch, openSUSE)
3. Linux amd64 & arm64 DEB (Debian, Ubuntu, Kali, ...)
4. Linux RPM x86_64 & aarch64 (Fedora, CentOS Stream, AlmaLinux, ...)
5. Windows 7+ x64 & arm64
6. macOS 10.11+ x86_64 & arm64

請開啟任一頁面，下載最新版安裝檔：

• https://www.electronjs.org/apps/cbetar2
• https://github.com/MrMYHuang/cbetar2/releases/latest

也可以至此安裝 Electron App Store，搜尋 "cbeta" 找到此 app 安裝檔:

• https://electron-store.org/

TODO

1. 離線版 app 未完成或不支援功能：
   1. 搜尋目錄
   2. 全文搜索
   3. 查字典
   4. 查詞典
   5. 經文顯示缺字
   6. 初次啟動 app 仍須網路連線(自動下載前端 app)。

已知問題

1. iOS
   1. iOS Safari 在單頁模式下，捲軸無法顯示。
   2. iOS Safari 13.4 以上才支援"分享此頁"功能。
   3. iOS Safari 不支援 app 捷徑 (iOS App Store app 支援)。
   4. Safari, iOS Safari 不支援列印直排經文。( https://bugs.webkit.org/show_bug.cgi?id=220043 )
   5. iOS App Store app 不支援列印。
   6. iOS Safari 選擇文字後，仍會閃爍彈出式選單才消失。
   7. 不支援"避免螢幕自動鎖定"。
2. 其它
   1. 目前多數 Chrome 無法暫停合成語音播放，因此此 app 目前經文語音播放功能不支援暫停，只支援停止。
   2. 語音播放速度受限不同引擎、語音限制，可能無法達到指定速度。
   3. 合成語音選項濾掉非離線語音，以避開非離線語音單次播放最長字串過小的問題。
   4. 合成語音功能在 Linux 無作用。

版本歷史

程式開發

第三方軟體版權聲明

1. CBETA API 參考文件
2. DILA 佛學術語字辭典
3. 全字庫字型
4. 萌典字典

App相關貢獻者 (依姓名英、中排序)

• CBETA (https://cbeta.org)
• DILA (https://www.dila.edu.tw/)
• Godfery Wang
• Meng-Yuan Huang (myh@live.com)
• 曹博堯
• 謝仁方