CBReader v0.9 版書籤功能說明(2023-12-19 發布)

 

CBReader Windows 版從 v0.9 開始提供書籤的功能,但因為設計還不夠完善,所以在此提供基本的使用說明。Mac 版則尚未提供此功能,有待未來努力。

使用條件

要執行書籤功能,必須將程式中的 IE 瀏覽器核心換成 Mircrsoft Edge WebView2 元件,安裝 WebView2 的方法請看底下連結。

https://www.cbeta.org/CBReader2X_FAQ.php#Q12

基本介紹

CBReader 主畫面中和書籤有關的地方有二處。

  1. 工具列的「新增書籤」功能。

  2. 主功能區的「書籤」頁面。

在書籤頁面中則有數個工具按鈕及樹狀書籤結構,此樹狀書籤有支援拖曳功能。

image

新增書籤(工具列)

當閱讀經文時,想將某個位置記錄在書籤中時,操作方法如下。

  1. 選取要記錄在書籤中的文字

  2. 按下工具列上面的書籤按鈕

image

按下書籤按鈕後,會自動出現書籤的輸入視窗。

「名稱」可以自行修改,但「位置」請不要隨意更動,那就是經文所在的位置,除非你知道自己在改什麼。

image

我將上圖的名稱改為「正觀世間集」,按下儲存後,則會在主功能區的書籤頁面看到新增的書籤。

image

注意:在上方功能表新增的書籤,一律會新增至書籤第一層的最下方。

新增書籤(主功能區)

在「主功能區」的「書籤頁面」也有「新增書籤」的按鈕,見下圖紅框處。

image

此處的新增書籤與上方工具列新增書籤功能大同小異。差別處在於若有選取目錄或書籤,則新增書籤是在「已選取目錄之內」或「已選取書籤的下方」。

舉例說明:

  1. 目前已選取的是「覺林菩薩偈」這筆書籤。

  2. 選取一段經文。

  3. 按下「新增書籤」的按鈕。

  4. 將名稱修改成適當的文字。

  5. 按下儲存。

image

此時就會看到新增的書籤出現在「覺林菩薩偈」的下方。

image

若一開始選取的是目錄,例如「偈頌」這個目錄,則新增的書籤就會在該目錄內的最後位置,例如下圖紅框處的「若以色見我,以音聲求我」。

image

書籤的種類

CBReader 目前支援的書籤有下列數種,程式會根據「書籤位置」的內容來判斷。

  1. CBETA電子佛典的標準行首格式,例如前面提過的例子「T02n0099_p0067a02」

  2. 一般網頁的網址,例如書籤位置為「https://www.cbeta.org」,這會開啟 CBETA 官網。

  3. 電腦中的檔案,例如書籤位置為

「file:///C:\path\file.ext」,表示開啟電腦中指定位置的檔案。

目前測試過檔案可以是純文字檔、PDF檔、圖檔、html檔等。理論上只要 WebView2 元件可以支援的檔案格式,就可以在此開啟。

  1. 電腦中的目錄,例如書籤位置為

「file:///C:\path\」,則開啟此書籤時,會將指定目錄的檔案列出,供進一步點選使用。

新增目錄

新增目錄操作方式如下:

  1. 按下「新增目錄」的按鈕。

  2. 在彈出視窗中輸入要新增目錄的名稱。

  3. 按下儲存。

image

儲存後就可以看到新增的目錄了。

目錄的位置會在最後選取的目錄之內,或最後選取的書籤下方。

image

編輯書籤及目錄

要編輯書籤或目錄,只要選取書籤或目錄,再按下「編輯」的按鈕即可。如下圖所示:

image

書籤編輯的界面和新增書籤的界面相同,更改請小心即可。

刪除書籤及目錄

要刪除書籤或目錄,只要選取書籤或目錄,再按下「刪除」的按鈕即可。如下圖所示:

image

在此樹狀目錄下,一次只能刪除一個書籤或目錄,如果需要大量刪除,請至「書籤管理員」中操作。

注意:目前刪除書籤是無法還原,請小心使用。未來會試著建立「回收筒」機制。

匯出書籤

按下「匯出」的按鈕,就可以將書籤匯出成為 json 格式的檔案,可做為個人備份或與他人交換書籤資訊。

「匯出」按鈕為箭頭所指紅框處。

image

匯入書籤

按下「匯入」的按鈕,就可以將 json 格式書籤匯入,此格式必須符合 CBReader 的書籤格式,並非所有書籤都可匯入。只要是 CBReader 匯出的書籤,理論上就可以匯入。

匯入並非取代原有的書籤,而是自動建立新的目錄,將書籤匯入其中。

底下是將剛剛匯出的書籤再匯入的動作:

  1. 按下「匯入」按鈕。

image

  1. 選擇先前匯出的書籤,按下開啟。

image

底下是紅框處是匯入的書籤。

image

匯入舊版書籤

在 2016 年之前的 CBReader,也有提供書籤功能,但該書籤的格式和目前的版本不同,使用匯入的功能時,依然可以選擇舊版的書籤,將它匯入新版的 CBReader。

舊版的書籤檔名是 bookmark.bmk,請不要改名,程式會依檔名來判斷是不是舊版書籤。

  1. 按下「匯入」按鈕。

image

  1. 選取舊版書籤,舊版書籤的目錄通常是在底下位置,其中 <ooo> 是使用者的帳號。

c:\Users\<ooo>\AppData\Roaming\CBETA\CBReader\bookmark\

image

底下是匯入舊版書籤的結果。

image

如果您的舊書籤無法順利匯入,可將書籤檔寄到 CBETA 來,告訴我們要轉成新版書籤格式,我們會試著幫您處理。

書籤管理員

「書籤管理員」按鈕就是在底下箭頭紅框處。

image

底下是「書籤管理員」的畫面,左邊是目錄,右邊是左邊選取目錄的內容。

在操作上,上方四個按鈕的功能和主功能區的書籤功能類似。

最大的差別在於右邊的列表可以多重選取,因此可以一次刪除多筆內容。也可以將多筆書籤及目錄拖曳至左邊其它目錄中,或拖曳至右邊某個目錄中,或是上下移動位置,方便整理書籤。

image

下圖是拖曳過的畫面,可以看到紅框處是把單層變成四層目錄。

綠框則是調整了上下的位置。

這些拖曳功能在主選單也可以操作,只是在書籤管理員中可以有多重選取的操作。

image

書籤檔位置及備份

CBReader 的書籤檔位置在

c:\Users\<ooo>\AppData\Roaming\CBETA\CBReader2X\Bookmark\

其中 <ooo> 是使用者帳號。

書籤檔名則是 bookmark.json,目前只支援單一書籤檔案。

另外有一個書籤備份目錄,每次書籤更新時,都會在此複製一份。

c:\Users\<ooo>\AppData\Roaming\CBETA\CBReader2X\Bookmark_Backup\

備份書籤內容與書籤一致,檔名則有所不同,它會記錄日期及當地時間,如下例:

bookmark_backup_20231217T223808.json

bookmark_backup_20231217T225840.json

bookmark_backup_20231218T002623.json

bookmark_backup_20231221T000733.json

目前只是單純備份,尚未進一步處理,未來會進一步考量如何規劃安排。如果不慎誤刪書籤,可在此尋找備份資料。

未來期待

目前書籤只有基本功能,還有諸多不足。未來規劃的功能還有:

  1. 更方便、直覺的操作流程。

  2. 新增書籤時,可以指定書籤位置。

  3. 支援書籤回收筒功能,以免誤刪。

  4. 支援雲端書籤備份,與 cbetaonline 共用雲端書籤。