repdf 0.1.1__tar.gz → 0.1.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. {repdf-0.1.1 → repdf-0.1.3}/PKG-INFO +66 -11
  2. {repdf-0.1.1 → repdf-0.1.3}/README.md +65 -10
  3. {repdf-0.1.1 → repdf-0.1.3}/pyproject.toml +1 -1
  4. {repdf-0.1.1 → repdf-0.1.3}/pyproject.toml.orig +1 -1
  5. repdf-0.1.3/src/repdf/annotation_data.py +687 -0
  6. repdf-0.1.3/src/repdf/annotation_editor.py +1705 -0
  7. repdf-0.1.3/src/repdf/annotation_geometry.py +82 -0
  8. repdf-0.1.3/src/repdf/annotation_graphics.py +279 -0
  9. repdf-0.1.3/src/repdf/annotation_reader_cache.py +43 -0
  10. repdf-0.1.3/src/repdf/annotation_spin.py +100 -0
  11. repdf-0.1.3/src/repdf/annotation_store.py +90 -0
  12. repdf-0.1.3/src/repdf/annotation_tree.py +149 -0
  13. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/app.py +257 -65
  14. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/core.py +81 -0
  15. repdf-0.1.3/src/repdf/floating_tools.py +210 -0
  16. repdf-0.1.3/src/repdf/icon_layout.py +24 -0
  17. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/icons.py +97 -2
  18. repdf-0.1.3/src/repdf/message_dialogs.py +86 -0
  19. repdf-0.1.3/src/repdf/navigation.py +495 -0
  20. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/packaging_smoke.py +47 -0
  21. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/page_view.py +15 -0
  22. repdf-0.1.3/src/repdf/pdf_annotations.py +92 -0
  23. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/pdf_navigation.py +8 -1
  24. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/preview.py +56 -11
  25. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/print_preview.py +5 -2
  26. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/printing.py +7 -3
  27. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/render_worker.py +88 -12
  28. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/renderer.py +3 -2
  29. repdf-0.1.3/src/repdf/saving.py +133 -0
  30. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/search_panel.py +1 -0
  31. repdf-0.1.3/src/repdf/shortcut_hints.py +61 -0
  32. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/strings.py +143 -0
  33. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/theme.py +12 -0
  34. repdf-0.1.3/src/repdf/toolbar.py +271 -0
  35. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/widgets.py +28 -2
  36. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/workers.py +22 -2
  37. repdf-0.1.1/src/repdf/navigation.py +0 -235
  38. repdf-0.1.1/src/repdf/toolbar.py +0 -162
  39. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/__init__.py +0 -0
  40. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/__main__.py +0 -0
  41. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/check-dark.svg +0 -0
  42. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/check.svg +0 -0
  43. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/partial-dark.svg +0 -0
  44. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/partial.svg +0 -0
  45. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/repdf.ico +0 -0
  46. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/assets/repdf.png +0 -0
  47. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/entrypoint.py +0 -0
  48. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/images.py +0 -0
  49. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/ocr.py +0 -0
  50. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/ocr_languages.py +0 -0
  51. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/ocr_models.py +0 -0
  52. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/preferences.py +0 -0
  53. {repdf-0.1.1 → repdf-0.1.3}/src/repdf/search.py +0 -0
{repdf-0.1.1 → repdf-0.1.3}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: repdf
3
- Version: 0.1.1
3
+ Version: 0.1.3
4
4
  Summary: RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement.
5
5
  Requires-Dist: onnxruntime>=1.31.0,<2
6
6
  Requires-Dist: pillow>=11.0,<13
@@ -19,7 +19,7 @@ Description-Content-Type: text/markdown
19
19
 
20
20
  [繁體中文](README.md) | [English](README.en.md)
21
21
 
22
- RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
22
+ RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、註解檢視與編輯、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
23
23
 
24
24
  ## 重點特色
25
25
 
@@ -54,26 +54,39 @@ repdf
54
54
 
55
55
  ## 操作方式
56
56
 
57
- 工具列按鈕的圖示與用途如下；將游標停在按鈕上也可查看 tooltip。
57
+ 主工具列保留開檔、儲存、列印、搜尋、書籤、註解清單與檢視控制。
58
+
59
+ - 複製文字、OCR 與擷取圖片直接位於主工具列。點「註解工具」顯示可拖移的水平懸浮工具列，提供文字畫線、文字註解及繪圖；顯示狀態會保留。
60
+ - 存檔與另存新檔為獨立按鈕；縮放、Fit、全螢幕模式下拉按鈕、語言與配色靠右排列。
61
+ - 單／雙頁勾選、重組與拆分直接顯示在主工具列的同一組，右側以分隔線區分檢視控制。視窗寬度不足時，完整群組收入三點選單，選單內也以分隔線區分。
62
+ - 全螢幕下方提供可展開／收合的水平懸浮註解工具列，可拖曳左側握柄移動；不占用 PDF 的顯示區，退出後保留一般視窗懸浮工具列的顯示狀態，並可從懸浮列右側模式下拉選單切換全螢幕模式。
63
+
64
+ 各工具的圖示與用途如下；將游標停在按鈕上也可查看 tooltip。
58
65
 
59
66
  | 工具列圖示／控制元件 | 功能 | 操作說明 | 快捷鍵 |
60
67
  | --- | --- | --- | --- |
61
68
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-open-dark.png"><img src="docs/images/toolbar-open.png" width="24" alt="開啟 PDF 圖示"></picture> | 開啟 PDF | 一次選取多個 PDF，也可從檔案總管拖入。 | <kbd>Ctrl</kbd>+<kbd>O</kbd> |
69
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-save-dark.png"><img src="docs/images/toolbar-save.png" width="24" alt="存檔"></picture> | 存檔 | 儲存目前檔案的完整頁面順序至原 PDF。 | <kbd>Ctrl</kbd>+<kbd>S</kbd> |
70
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-save-as-dark.png"><img src="docs/images/toolbar-save-as.png" width="24" alt="另存新檔"></picture> | 另存新檔 | 將目前檔案的完整頁面順序另存為新 PDF。 | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> |
62
71
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-print-dark.png"><img src="docs/images/toolbar-print.png" width="24" alt="列印圖示"></picture> | 列印 | 設定頁面範圍、縮放與印表機，預覽確認後列印。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>P</kbd>；macOS：<kbd>⌘</kbd>+<kbd>P</kbd> |
63
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-export-dark.png"><img src="docs/images/toolbar-export.png" width="24" alt="重組輸出圖示"></picture> | 重組輸出 | 將選取頁面依目前順序合併為一個新 PDF，指定檔名與儲存位置。 | <kbd>Ctrl</kbd>+<kbd>S</kbd>／<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> |
64
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-split-dark.png"><img src="docs/images/toolbar-split.png" width="24" alt="拆分輸出圖示"></picture> | 拆分輸出 | 將選取頁面依目前順序逐頁存成獨立 PDF，指定基本檔名與儲存位置。 | — |
65
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-odd-dark.png"><img src="docs/images/toolbar-odd.png" height="22" alt="單數頁核取方塊"></picture> | 單數頁 | 選取或取消目前標籤的原始單數頁；部分選取時顯示三態標記。 | — |
66
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-even-dark.png"><img src="docs/images/toolbar-even.png" height="22" alt="雙數頁核取方塊"></picture> | 雙數頁 | 選取或取消目前標籤的原始雙數頁；部分選取時顯示三態標記。 | — |
72
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotation-tools-dark.png"><img src="docs/images/toolbar-annotation-tools.png" width="24" alt="註解工具"></picture> | 註解工具 | 顯示或隱藏可拖移的水平懸浮註解工具列；隱藏時完成目前文字輸入。 | — |
73
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-more-dark.png"><img src="docs/images/toolbar-more.png" width="24" alt="更多"></picture> | 更多 | 視窗寬度不足時，開啟放不下的工具。 | — |
67
74
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-copy-text-dark.png"><img src="docs/images/toolbar-copy-text.png" width="24" alt="複製文字圖示"></picture> | 複製文字 | 啟用後拖曳選取文字，放開滑鼠即複製到剪貼簿；選取的文字會顯示高亮。 | — |
68
75
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-ocr-region-dark.png"><img src="docs/images/toolbar-ocr-region.png" width="24" alt="區域 OCR 圖示"></picture> | 區域 OCR | 拖曳矩形框選頁面或圖片，放開滑鼠後辨識並複製文字。 | — |
69
76
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-extract-image-dark.png"><img src="docs/images/toolbar-extract-image.png" width="24" alt="擷取圖片圖示"></picture> | 擷取圖片 | 啟用後點選內嵌點陣圖片，再選擇位置另存為 PNG。 | — |
70
77
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-bookmarks-dark.png"><img src="docs/images/toolbar-bookmarks.png" width="24" alt="書籤圖示"></picture> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
78
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotations-dark.png"><img src="docs/images/toolbar-annotations.png" width="24" alt="註解圖示"></picture> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
71
79
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-search-dark.png"><img src="docs/images/toolbar-search.png" width="24" alt="搜尋文字圖示"></picture> | 搜尋文字 | 在右側窗格搜尋文字，上方選檔案、下方選命中段落，單擊即可跳頁並高亮。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>F</kbd>；macOS：<kbd>⌘</kbd>+<kbd>F</kbd> |
80
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-text-markup-dark.png"><img src="docs/images/toolbar-text-markup.png" width="24" alt="文字畫線"></picture> | 文字畫線 | 拖曳選字畫線；下拉設定螢光筆、底線、刪除線、波浪線、顏色與粗細。 | — |
81
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-callout-dark.png"><img src="docs/images/toolbar-callout.png" width="24" alt="箭頭文字註解"></picture> | 文字註解 | 下拉選擇箭頭文字框或便利貼，點選頁面新增；雙擊可編輯文字。 | — |
82
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-drawing-dark.png"><img src="docs/images/toolbar-drawing.png" width="24" alt="繪圖註解"></picture> | 繪圖註解 | 下拉選擇直線、箭頭、矩形、橢圓或自由手繪；設定線條與填色後拖曳建立。 | — |
83
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-odd-dark.png"><img src="docs/images/toolbar-odd.png" height="22" alt="單數頁核取方塊"></picture> | 單數頁 | 選取或取消目前標籤的原始單數頁；部分選取時顯示三態標記。 | — |
84
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-even-dark.png"><img src="docs/images/toolbar-even.png" height="22" alt="雙數頁核取方塊"></picture> | 雙數頁 | 選取或取消目前標籤的原始雙數頁；部分選取時顯示三態標記。 | — |
85
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-export-dark.png"><img src="docs/images/toolbar-export.png" width="24" alt="重組輸出圖示"></picture> | 重組輸出 | 將選取頁面依目前順序合併為一個新 PDF，指定檔名與儲存位置。 | — |
86
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-split-dark.png"><img src="docs/images/toolbar-split.png" width="24" alt="拆分輸出圖示"></picture> | 拆分輸出 | 將選取頁面依目前順序逐頁存成獨立 PDF，指定基本檔名與儲存位置。 | — |
72
87
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-zoom-dark.png"><img src="docs/images/toolbar-zoom.png" width="160" alt="顯示比例與縮放滑桿"></picture> | 顯示比例 | 滑桿調整 25%–200%；點擊比例回到 100%。鍵盤縮放每次調整 25 個百分點。 | 放大：<kbd>Ctrl</kbd>+<kbd>+</kbd>／<kbd>Ctrl</kbd>+<kbd>=</kbd>；縮小：<kbd>Ctrl</kbd>+<kbd>-</kbd>；100%：<kbd>Ctrl</kbd>+<kbd>0</kbd> |
73
88
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fit-dark.png"><img src="docs/images/toolbar-fit.png" width="24" alt="Fit 圖示"></picture> | Fit | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
74
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-dark.png"><img src="docs/images/toolbar-fullscreen.png" width="24" alt="全螢幕單頁圖示"></picture> | 全螢幕單頁 | 每次顯示一頁，依螢幕寬度或高度等比例填滿；可用頁面上方的核取方塊選頁。 | <kbd>F11</kbd> 開啟／返回；<kbd>Esc</kbd> 返回 |
75
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-spread-dark.png"><img src="docs/images/toolbar-fullscreen-spread.png" width="24" alt="全螢幕對頁圖示"></picture> | 全螢幕對頁 | 依目前順序兩頁並排：第 1、2 頁一組，第 3、4 頁一組，以此類推；每頁可獨立勾選。 | <kbd>Esc</kbd>／<kbd>F11</kbd> 返回 |
76
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-cover-dark.png"><img src="docs/images/toolbar-fullscreen-cover.png" width="24" alt="全螢幕封面加對頁圖示"></picture> | 全螢幕封面＋對頁 | 目前順序的第一頁作為封面單獨顯示；第 2、3 頁一組，第 4、5 頁一組，以此類推；每頁可獨立勾選。 | <kbd>Esc</kbd>／<kbd>F11</kbd> 返回 |
89
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-dark.png"><img src="docs/images/toolbar-fullscreen.png" width="24" alt="全螢幕"></picture> | 全螢幕 | 主按鈕開啟上次選擇的模式，右側下拉箭頭選擇單頁、對頁或封面＋對頁。 | <kbd>F11</kbd> 開啟／返回；<kbd>Esc</kbd> 返回 |
77
90
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-system-dark.png"><img src="docs/images/toolbar-language-system.png" width="24" alt="跟隨系統語言"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-zh-dark.png"><img src="docs/images/toolbar-language-zh.png" width="24" alt="繁體中文"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-en-dark.png"><img src="docs/images/toolbar-language-en.png" width="24" alt="English"></picture> | 介面語言 | 點擊依序切換「跟隨系統 → 繁體中文 → English」，選擇會記住。 | — |
78
91
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-system-dark.png"><img src="docs/images/toolbar-theme-system.png" width="24" alt="跟隨系統配色：左白右黑圓形"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-light-dark.png"><img src="docs/images/toolbar-theme-light.png" width="24" alt="淺色：太陽"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-dark-dark.png"><img src="docs/images/toolbar-theme-dark.png" width="24" alt="深色：月亮"></picture> | 介面配色 | 點擊依序切換「跟隨系統 → 淺色 → 深色」，選擇會記住。 | — |
79
92
 
@@ -109,6 +122,7 @@ repdf
109
122
  - Fit 與全螢幕優先使用最近點擊且仍可見的頁面；未指定時使用預覽區中央附近的頁面。
110
123
  - Fit 的適應比例可超出滑桿的手動範圍，實際比例仍顯示於工具列。
111
124
  - 滑桿的手動範圍為 25%–200%；完整縮放說明可查看比例按鈕的 tooltip。
125
+ - 全螢幕工具以主按鈕及右側下拉箭頭選擇單頁、對頁或封面＋對頁；<kbd>F11</kbd> 沿用本次執行中最近選擇的模式。單頁每次一頁，對頁由第一頁開始兩頁一組；封面＋對頁先單獨顯示第一頁，再將其餘頁面兩頁分組。
112
126
  - 全螢幕對頁以同一比例完整顯示兩頁，最後剩一頁時單獨顯示。
113
127
  - 返回主視窗後，保留原有縮放比例。
114
128
 
@@ -131,6 +145,15 @@ repdf
131
145
  - 頁碼與頁面卡片上的原始頁碼一致；重新排序後，輸入同一頁碼仍會找到原本的頁面。
132
146
  - 跳頁保留目前縮放／Fit 模式；輸入超出範圍或無效內容時會顯示提示，不會改變目前頁面。
133
147
 
148
+ ### 存檔與另存新檔
149
+
150
+ - 新開啟的 PDF 預設使用 Fit 模式，自動適應閱讀區；調整比例可切換為手動縮放。
151
+ - 拖曳調整頁面順序後，標籤名稱會顯示 `*`；點「存檔」或按 <kbd>Ctrl</kbd>+<kbd>S</kbd> 儲存原 PDF。
152
+ - 點「另存新檔」或按 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>，選擇另一個檔名；儲存完成後，標籤改為新檔案。macOS 使用 <kbd>⌘</kbd> 取代 <kbd>Ctrl</kbd>。
153
+ - 存檔包含目前標籤的所有頁面，與頁面及標籤核取方塊無關；「重組輸出／拆分」仍依勾選內容輸出。
154
+ - 保留書籤、內部連結、註解、文件資料與頁碼標籤。密碼 PDF 以開啟時使用的密碼重新進行 AES-256 加密。
155
+ - 儲存失敗時保留原檔與目前頁序，可修正問題後重試；另存目的檔案若已在其他標籤開啟，請選擇其他檔名。
156
+
134
157
  ### 列印
135
158
 
136
159
  - 點列印圖示，或按 <kbd>Ctrl</kbd>+<kbd>P</kbd>（macOS：<kbd>⌘</kbd>+<kbd>P</kbd>），直接開啟整合列印視窗；全螢幕中使用快捷鍵會先返回主視窗。
@@ -153,11 +176,43 @@ repdf
153
176
  - 書籤跟隨目前標籤頁切換；沒有內建書籤的文件會顯示提示。
154
177
  - 一般預覽與全螢幕都可直接點選 PDF 頁內的目錄連結；滑鼠移到可跳頁區域時會顯示手指游標與目的頁碼。
155
178
  - 跳頁保留目前縮放／Fit 模式。頁面已重新排序時，仍會找到目的章節所屬的原始頁面。
156
- - 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。搜尋與書籤窗格可透過各自的工具按鈕切換。
179
+ - 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。書籤、註解與搜尋窗格可透過各自的工具按鈕切換。
157
180
  - 啟用複製文字、區域 OCR 或圖片擷取模式時，頁內連結暫停點選；停用後即可跳頁，拖曳頁面仍可排序。
158
181
  - 一般預覽與全螢幕可點選 PDF 內建的 HTTP／HTTPS 超連結，以系統預設瀏覽器開啟；滑鼠停留可查看網址。
159
182
  - 此功能使用 PDF 已有的書籤與連結；純文字或掃描圖片形式的目錄、網址不會自動變成連結。電子郵件、外部文件與其他動作不在支援範圍。
160
183
 
184
+ ### 註解清單
185
+
186
+ - 點工具列的「註解」對話框圖示，開啟目前標籤頁的左側註解清單。
187
+ - 清單依 PDF 原始頁序分組，每頁顯示註解數量，預設收合；展開後查看個別註解的類型與摘要。切換標籤、書籤或介面語言後會保留展開狀態。滑鼠停留可查看完整內容、作者、主旨及修改時間（若文件有提供）。
188
+ - 點選頁碼群組即可跳到該頁清單中的第一個註解，並標示其範圍；點選個別註解會跳到對應位置，並以半透明底色與外框標示註解範圍。保留目前縮放／Fit 模式，頁面重新排列後仍會找到原始目標頁。
189
+ - 選取含文字的註解時，會自動將註解文字複製到剪貼簿；頁碼群組會複製第一個註解的文字。無文字的註解不會覆蓋剪貼簿內容。
190
+ - 關閉註解窗格或切換至其他側欄時，會取消框選；重新開啟清單不會自動複製文字或恢復框選。
191
+ - 框選會跟隨縮放與全螢幕顯示；點選另一註解或頁碼群組會更新標示，點選書籤或搜尋結果則清除標示。文件未提供有效註解範圍時，仍可跳頁。
192
+ - 支援備註、文字方塊、螢光標示、底線、刪除線、手繪及形狀等註解。文字標示若沒有附註內容，會嘗試顯示標示的原文。
193
+ - 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
194
+ - 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
195
+ - 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
196
+ - 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；可編輯的註解由下方工具操作；其他類型維持檢視，不執行附件內容。
197
+
198
+ ### 新增與編輯註解
199
+
200
+ - 文字畫線面板可勾選「連帶加入文字註解」，選擇箭頭文字框或便利貼。選字完成後立即輸入說明；箭頭框指向選取範圍上緣中央，便利貼放在該處上方，位置會限制在頁面內。畫線與註解可一次復原；取消輸入則只保留畫線。
201
+ - **文字註解工具**：下拉面板選擇「箭頭文字框」或「便利貼」；選擇後啟用該工具，主按鈕圖示隨選擇切換。
202
+ - **便利貼**：點選頁面放置圖示，在交談窗輸入內容並儲存；雙擊圖示可編輯，拖曳圖示可移動，清單與快捷鍵也能複製其文字。
203
+ - **繪圖註解**：下拉選擇直線、箭頭、矩形、橢圓或自由手繪，於頁面拖曳建立；可調整顏色與 0.5–6 pt 粗細，矩形與橢圓另可設定填色或透明背景。
204
+ - 選取繪圖後可拖移、調整直線／箭頭端點，或以四角控點縮放矩形、橢圓與手繪；<kbd>Esc</kbd> 取消目前的繪製。
205
+
206
+ - **文字畫線**：啟用工具後拖曳選取文字，可跨行。下拉箭頭設定螢光筆、底線、刪除線或波浪線，以及顏色與 0.5–6 pt 粗細；選取範圍依文字順序呈現，拖曳時預覽選中的字元；預設紅色底線、1 pt。螢光筆預設半透明黃色，不使用線條粗細。沒有文字層的圖片區域不會自動 OCR。
207
+ - 註解清單以圖示標示類型，滑鼠停留可看完整類型與內容；每個有文字的項目右側提供複製按鈕，點一下即可複製完整內容，不會切換頁面；在清單或頁面上選取註解後，也可按 <kbd>Ctrl</kbd>+<kbd>C</kbd> 複製文字（macOS 使用 <kbd>⌘</kbd>+<kbd>C</kbd>）；選取有文字的項目後，下方內容區可拖曳選字、按全選按鈕或複製按鈕，也支援 <kbd>Ctrl</kbd>+<kbd>A</kbd>／<kbd>Ctrl</kbd>+<kbd>C</kbd>。
208
+ - **箭頭文字框**：啟用工具後點選指向位置，自動在旁邊建立文字框並輸入內容；文字框保留建立時的最小寬度，隨單行文字增寬，到頁面邊界才換行，並在頁面範圍內增高；在框外點一下完成輸入，再次點選才建立下一個註解。預設透明背景、藍字、紅框紅箭頭、12 pt；新建文字框預設 6 pt 圓角；下拉面板可分別調整文字色、線條色、線寬、字級、背景與圓角，圓角設為 0 即為直角。
209
+ - 直接雙擊文字框即可編輯，不必先開啟註解窗格；單擊會選取並開啟註解清單。<kbd>Enter</kbd> 換行，<kbd>Ctrl</kbd>+<kbd>Enter</kbd> 完成，<kbd>Esc</kbd> 取消本次編輯；空白內容不建立註解。
210
+ - 選取文字框後可拖動框本身、四角控制點或箭頭端點；游標分別顯示移動、對角縮放或手指提示；選取畫線可修改方式與樣式。<kbd>Delete</kbd> 刪除，<kbd>Ctrl</kbd>+<kbd>Z</kbd> 復原，<kbd>Ctrl</kbd>+<kbd>Y</kbd>／<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> 重做；macOS 使用系統對應快捷鍵。
211
+ - 支援本程式建立的註解，以及可可靠解析的標準螢光筆、底線、刪除線、波浪線與箭頭文字框。本程式新增的便利貼與繪圖存檔重開後可繼續編輯；其他程式的便利貼、繪圖，以及鎖定、特殊外觀、無法還原字型或混合格式的項目維持檢視，選取時會顯示原因。
212
+ - 註解工具與選字、OCR、圖片擷取互斥，並支援全螢幕。樣式會記住供下次使用；選取可編輯項目時，面板的顏色與樣式修改直接套用該項目；切換文字或繪圖工具種類則準備建立新項目。
213
+ - 變更會顯示未儲存星號。存檔後重新開啟仍可編輯；列印、重組及拆分也會包含未儲存的註解變更。關閉文件時可選擇儲存、不儲存或取消。
214
+ - 儲存為標準 PDF 註解及完整外觀，包含中文字型資源，可由其他 PDF 閱讀器顯示；其他程式是否提供相同編輯操作，依其功能而定。
215
+
161
216
  ### 搜尋文字
162
217
 
163
218
  1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
{repdf-0.1.1 → repdf-0.1.3}/README.md RENAMED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [繁體中文](README.md) | [English](README.en.md)
4
4
 
5
- RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
5
+ RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、註解檢視與編輯、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
6
6
 
7
7
  ## 重點特色
8
8
 
@@ -37,26 +37,39 @@ repdf
37
37
 
38
38
  ## 操作方式
39
39
 
40
- 工具列按鈕的圖示與用途如下；將游標停在按鈕上也可查看 tooltip。
40
+ 主工具列保留開檔、儲存、列印、搜尋、書籤、註解清單與檢視控制。
41
+
42
+ - 複製文字、OCR 與擷取圖片直接位於主工具列。點「註解工具」顯示可拖移的水平懸浮工具列，提供文字畫線、文字註解及繪圖；顯示狀態會保留。
43
+ - 存檔與另存新檔為獨立按鈕；縮放、Fit、全螢幕模式下拉按鈕、語言與配色靠右排列。
44
+ - 單／雙頁勾選、重組與拆分直接顯示在主工具列的同一組，右側以分隔線區分檢視控制。視窗寬度不足時，完整群組收入三點選單，選單內也以分隔線區分。
45
+ - 全螢幕下方提供可展開／收合的水平懸浮註解工具列，可拖曳左側握柄移動；不占用 PDF 的顯示區，退出後保留一般視窗懸浮工具列的顯示狀態，並可從懸浮列右側模式下拉選單切換全螢幕模式。
46
+
47
+ 各工具的圖示與用途如下；將游標停在按鈕上也可查看 tooltip。
41
48
 
42
49
  | 工具列圖示／控制元件 | 功能 | 操作說明 | 快捷鍵 |
43
50
  | --- | --- | --- | --- |
44
51
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-open-dark.png"><img src="docs/images/toolbar-open.png" width="24" alt="開啟 PDF 圖示"></picture> | 開啟 PDF | 一次選取多個 PDF，也可從檔案總管拖入。 | <kbd>Ctrl</kbd>+<kbd>O</kbd> |
52
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-save-dark.png"><img src="docs/images/toolbar-save.png" width="24" alt="存檔"></picture> | 存檔 | 儲存目前檔案的完整頁面順序至原 PDF。 | <kbd>Ctrl</kbd>+<kbd>S</kbd> |
53
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-save-as-dark.png"><img src="docs/images/toolbar-save-as.png" width="24" alt="另存新檔"></picture> | 另存新檔 | 將目前檔案的完整頁面順序另存為新 PDF。 | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> |
45
54
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-print-dark.png"><img src="docs/images/toolbar-print.png" width="24" alt="列印圖示"></picture> | 列印 | 設定頁面範圍、縮放與印表機，預覽確認後列印。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>P</kbd>；macOS：<kbd>⌘</kbd>+<kbd>P</kbd> |
46
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-export-dark.png"><img src="docs/images/toolbar-export.png" width="24" alt="重組輸出圖示"></picture> | 重組輸出 | 將選取頁面依目前順序合併為一個新 PDF，指定檔名與儲存位置。 | <kbd>Ctrl</kbd>+<kbd>S</kbd>／<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> |
47
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-split-dark.png"><img src="docs/images/toolbar-split.png" width="24" alt="拆分輸出圖示"></picture> | 拆分輸出 | 將選取頁面依目前順序逐頁存成獨立 PDF，指定基本檔名與儲存位置。 | — |
48
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-odd-dark.png"><img src="docs/images/toolbar-odd.png" height="22" alt="單數頁核取方塊"></picture> | 單數頁 | 選取或取消目前標籤的原始單數頁；部分選取時顯示三態標記。 | — |
49
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-even-dark.png"><img src="docs/images/toolbar-even.png" height="22" alt="雙數頁核取方塊"></picture> | 雙數頁 | 選取或取消目前標籤的原始雙數頁；部分選取時顯示三態標記。 | — |
55
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotation-tools-dark.png"><img src="docs/images/toolbar-annotation-tools.png" width="24" alt="註解工具"></picture> | 註解工具 | 顯示或隱藏可拖移的水平懸浮註解工具列；隱藏時完成目前文字輸入。 | — |
56
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-more-dark.png"><img src="docs/images/toolbar-more.png" width="24" alt="更多"></picture> | 更多 | 視窗寬度不足時，開啟放不下的工具。 | — |
50
57
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-copy-text-dark.png"><img src="docs/images/toolbar-copy-text.png" width="24" alt="複製文字圖示"></picture> | 複製文字 | 啟用後拖曳選取文字，放開滑鼠即複製到剪貼簿；選取的文字會顯示高亮。 | — |
51
58
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-ocr-region-dark.png"><img src="docs/images/toolbar-ocr-region.png" width="24" alt="區域 OCR 圖示"></picture> | 區域 OCR | 拖曳矩形框選頁面或圖片，放開滑鼠後辨識並複製文字。 | — |
52
59
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-extract-image-dark.png"><img src="docs/images/toolbar-extract-image.png" width="24" alt="擷取圖片圖示"></picture> | 擷取圖片 | 啟用後點選內嵌點陣圖片，再選擇位置另存為 PNG。 | — |
53
60
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-bookmarks-dark.png"><img src="docs/images/toolbar-bookmarks.png" width="24" alt="書籤圖示"></picture> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
61
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotations-dark.png"><img src="docs/images/toolbar-annotations.png" width="24" alt="註解圖示"></picture> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
54
62
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-search-dark.png"><img src="docs/images/toolbar-search.png" width="24" alt="搜尋文字圖示"></picture> | 搜尋文字 | 在右側窗格搜尋文字，上方選檔案、下方選命中段落，單擊即可跳頁並高亮。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>F</kbd>；macOS：<kbd>⌘</kbd>+<kbd>F</kbd> |
63
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-text-markup-dark.png"><img src="docs/images/toolbar-text-markup.png" width="24" alt="文字畫線"></picture> | 文字畫線 | 拖曳選字畫線；下拉設定螢光筆、底線、刪除線、波浪線、顏色與粗細。 | — |
64
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-callout-dark.png"><img src="docs/images/toolbar-callout.png" width="24" alt="箭頭文字註解"></picture> | 文字註解 | 下拉選擇箭頭文字框或便利貼，點選頁面新增；雙擊可編輯文字。 | — |
65
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-drawing-dark.png"><img src="docs/images/toolbar-drawing.png" width="24" alt="繪圖註解"></picture> | 繪圖註解 | 下拉選擇直線、箭頭、矩形、橢圓或自由手繪；設定線條與填色後拖曳建立。 | — |
66
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-odd-dark.png"><img src="docs/images/toolbar-odd.png" height="22" alt="單數頁核取方塊"></picture> | 單數頁 | 選取或取消目前標籤的原始單數頁；部分選取時顯示三態標記。 | — |
67
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-even-dark.png"><img src="docs/images/toolbar-even.png" height="22" alt="雙數頁核取方塊"></picture> | 雙數頁 | 選取或取消目前標籤的原始雙數頁；部分選取時顯示三態標記。 | — |
68
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-export-dark.png"><img src="docs/images/toolbar-export.png" width="24" alt="重組輸出圖示"></picture> | 重組輸出 | 將選取頁面依目前順序合併為一個新 PDF，指定檔名與儲存位置。 | — |
69
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-split-dark.png"><img src="docs/images/toolbar-split.png" width="24" alt="拆分輸出圖示"></picture> | 拆分輸出 | 將選取頁面依目前順序逐頁存成獨立 PDF，指定基本檔名與儲存位置。 | — |
55
70
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-zoom-dark.png"><img src="docs/images/toolbar-zoom.png" width="160" alt="顯示比例與縮放滑桿"></picture> | 顯示比例 | 滑桿調整 25%–200%；點擊比例回到 100%。鍵盤縮放每次調整 25 個百分點。 | 放大：<kbd>Ctrl</kbd>+<kbd>+</kbd>／<kbd>Ctrl</kbd>+<kbd>=</kbd>；縮小：<kbd>Ctrl</kbd>+<kbd>-</kbd>；100%：<kbd>Ctrl</kbd>+<kbd>0</kbd> |
56
71
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fit-dark.png"><img src="docs/images/toolbar-fit.png" width="24" alt="Fit 圖示"></picture> | Fit | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
57
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-dark.png"><img src="docs/images/toolbar-fullscreen.png" width="24" alt="全螢幕單頁圖示"></picture> | 全螢幕單頁 | 每次顯示一頁，依螢幕寬度或高度等比例填滿；可用頁面上方的核取方塊選頁。 | <kbd>F11</kbd> 開啟／返回；<kbd>Esc</kbd> 返回 |
58
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-spread-dark.png"><img src="docs/images/toolbar-fullscreen-spread.png" width="24" alt="全螢幕對頁圖示"></picture> | 全螢幕對頁 | 依目前順序兩頁並排：第 1、2 頁一組，第 3、4 頁一組，以此類推；每頁可獨立勾選。 | <kbd>Esc</kbd>／<kbd>F11</kbd> 返回 |
59
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-cover-dark.png"><img src="docs/images/toolbar-fullscreen-cover.png" width="24" alt="全螢幕封面加對頁圖示"></picture> | 全螢幕封面＋對頁 | 目前順序的第一頁作為封面單獨顯示；第 2、3 頁一組，第 4、5 頁一組，以此類推；每頁可獨立勾選。 | <kbd>Esc</kbd>／<kbd>F11</kbd> 返回 |
72
+ | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fullscreen-dark.png"><img src="docs/images/toolbar-fullscreen.png" width="24" alt="全螢幕"></picture> | 全螢幕 | 主按鈕開啟上次選擇的模式，右側下拉箭頭選擇單頁、對頁或封面＋對頁。 | <kbd>F11</kbd> 開啟／返回；<kbd>Esc</kbd> 返回 |
60
73
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-system-dark.png"><img src="docs/images/toolbar-language-system.png" width="24" alt="跟隨系統語言"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-zh-dark.png"><img src="docs/images/toolbar-language-zh.png" width="24" alt="繁體中文"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-language-en-dark.png"><img src="docs/images/toolbar-language-en.png" width="24" alt="English"></picture> | 介面語言 | 點擊依序切換「跟隨系統 → 繁體中文 → English」，選擇會記住。 | — |
61
74
  | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-system-dark.png"><img src="docs/images/toolbar-theme-system.png" width="24" alt="跟隨系統配色：左白右黑圓形"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-light-dark.png"><img src="docs/images/toolbar-theme-light.png" width="24" alt="淺色：太陽"></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-theme-dark-dark.png"><img src="docs/images/toolbar-theme-dark.png" width="24" alt="深色：月亮"></picture> | 介面配色 | 點擊依序切換「跟隨系統 → 淺色 → 深色」，選擇會記住。 | — |
62
75
 
@@ -92,6 +105,7 @@ repdf
92
105
  - Fit 與全螢幕優先使用最近點擊且仍可見的頁面；未指定時使用預覽區中央附近的頁面。
93
106
  - Fit 的適應比例可超出滑桿的手動範圍，實際比例仍顯示於工具列。
94
107
  - 滑桿的手動範圍為 25%–200%；完整縮放說明可查看比例按鈕的 tooltip。
108
+ - 全螢幕工具以主按鈕及右側下拉箭頭選擇單頁、對頁或封面＋對頁；<kbd>F11</kbd> 沿用本次執行中最近選擇的模式。單頁每次一頁，對頁由第一頁開始兩頁一組；封面＋對頁先單獨顯示第一頁，再將其餘頁面兩頁分組。
95
109
  - 全螢幕對頁以同一比例完整顯示兩頁，最後剩一頁時單獨顯示。
96
110
  - 返回主視窗後，保留原有縮放比例。
97
111
 
@@ -114,6 +128,15 @@ repdf
114
128
  - 頁碼與頁面卡片上的原始頁碼一致；重新排序後，輸入同一頁碼仍會找到原本的頁面。
115
129
  - 跳頁保留目前縮放／Fit 模式；輸入超出範圍或無效內容時會顯示提示，不會改變目前頁面。
116
130
 
131
+ ### 存檔與另存新檔
132
+
133
+ - 新開啟的 PDF 預設使用 Fit 模式，自動適應閱讀區；調整比例可切換為手動縮放。
134
+ - 拖曳調整頁面順序後，標籤名稱會顯示 `*`；點「存檔」或按 <kbd>Ctrl</kbd>+<kbd>S</kbd> 儲存原 PDF。
135
+ - 點「另存新檔」或按 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>，選擇另一個檔名；儲存完成後，標籤改為新檔案。macOS 使用 <kbd>⌘</kbd> 取代 <kbd>Ctrl</kbd>。
136
+ - 存檔包含目前標籤的所有頁面，與頁面及標籤核取方塊無關；「重組輸出／拆分」仍依勾選內容輸出。
137
+ - 保留書籤、內部連結、註解、文件資料與頁碼標籤。密碼 PDF 以開啟時使用的密碼重新進行 AES-256 加密。
138
+ - 儲存失敗時保留原檔與目前頁序，可修正問題後重試；另存目的檔案若已在其他標籤開啟，請選擇其他檔名。
139
+
117
140
  ### 列印
118
141
 
119
142
  - 點列印圖示，或按 <kbd>Ctrl</kbd>+<kbd>P</kbd>（macOS：<kbd>⌘</kbd>+<kbd>P</kbd>），直接開啟整合列印視窗；全螢幕中使用快捷鍵會先返回主視窗。
@@ -136,11 +159,43 @@ repdf
136
159
  - 書籤跟隨目前標籤頁切換；沒有內建書籤的文件會顯示提示。
137
160
  - 一般預覽與全螢幕都可直接點選 PDF 頁內的目錄連結；滑鼠移到可跳頁區域時會顯示手指游標與目的頁碼。
138
161
  - 跳頁保留目前縮放／Fit 模式。頁面已重新排序時，仍會找到目的章節所屬的原始頁面。
139
- - 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。搜尋與書籤窗格可透過各自的工具按鈕切換。
162
+ - 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。書籤、註解與搜尋窗格可透過各自的工具按鈕切換。
140
163
  - 啟用複製文字、區域 OCR 或圖片擷取模式時，頁內連結暫停點選；停用後即可跳頁，拖曳頁面仍可排序。
141
164
  - 一般預覽與全螢幕可點選 PDF 內建的 HTTP／HTTPS 超連結，以系統預設瀏覽器開啟；滑鼠停留可查看網址。
142
165
  - 此功能使用 PDF 已有的書籤與連結；純文字或掃描圖片形式的目錄、網址不會自動變成連結。電子郵件、外部文件與其他動作不在支援範圍。
143
166
 
167
+ ### 註解清單
168
+
169
+ - 點工具列的「註解」對話框圖示，開啟目前標籤頁的左側註解清單。
170
+ - 清單依 PDF 原始頁序分組，每頁顯示註解數量，預設收合；展開後查看個別註解的類型與摘要。切換標籤、書籤或介面語言後會保留展開狀態。滑鼠停留可查看完整內容、作者、主旨及修改時間（若文件有提供）。
171
+ - 點選頁碼群組即可跳到該頁清單中的第一個註解，並標示其範圍；點選個別註解會跳到對應位置，並以半透明底色與外框標示註解範圍。保留目前縮放／Fit 模式，頁面重新排列後仍會找到原始目標頁。
172
+ - 選取含文字的註解時，會自動將註解文字複製到剪貼簿；頁碼群組會複製第一個註解的文字。無文字的註解不會覆蓋剪貼簿內容。
173
+ - 關閉註解窗格或切換至其他側欄時，會取消框選；重新開啟清單不會自動複製文字或恢復框選。
174
+ - 框選會跟隨縮放與全螢幕顯示；點選另一註解或頁碼群組會更新標示，點選書籤或搜尋結果則清除標示。文件未提供有效註解範圍時，仍可跳頁。
175
+ - 支援備註、文字方塊、螢光標示、底線、刪除線、手繪及形狀等註解。文字標示若沒有附註內容，會嘗試顯示標示的原文。
176
+ - 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
177
+ - 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
178
+ - 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
179
+ - 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；可編輯的註解由下方工具操作；其他類型維持檢視，不執行附件內容。
180
+
181
+ ### 新增與編輯註解
182
+
183
+ - 文字畫線面板可勾選「連帶加入文字註解」，選擇箭頭文字框或便利貼。選字完成後立即輸入說明；箭頭框指向選取範圍上緣中央，便利貼放在該處上方，位置會限制在頁面內。畫線與註解可一次復原；取消輸入則只保留畫線。
184
+ - **文字註解工具**：下拉面板選擇「箭頭文字框」或「便利貼」；選擇後啟用該工具，主按鈕圖示隨選擇切換。
185
+ - **便利貼**：點選頁面放置圖示，在交談窗輸入內容並儲存；雙擊圖示可編輯，拖曳圖示可移動，清單與快捷鍵也能複製其文字。
186
+ - **繪圖註解**：下拉選擇直線、箭頭、矩形、橢圓或自由手繪，於頁面拖曳建立；可調整顏色與 0.5–6 pt 粗細，矩形與橢圓另可設定填色或透明背景。
187
+ - 選取繪圖後可拖移、調整直線／箭頭端點，或以四角控點縮放矩形、橢圓與手繪；<kbd>Esc</kbd> 取消目前的繪製。
188
+
189
+ - **文字畫線**：啟用工具後拖曳選取文字，可跨行。下拉箭頭設定螢光筆、底線、刪除線或波浪線，以及顏色與 0.5–6 pt 粗細；選取範圍依文字順序呈現，拖曳時預覽選中的字元；預設紅色底線、1 pt。螢光筆預設半透明黃色，不使用線條粗細。沒有文字層的圖片區域不會自動 OCR。
190
+ - 註解清單以圖示標示類型，滑鼠停留可看完整類型與內容；每個有文字的項目右側提供複製按鈕，點一下即可複製完整內容，不會切換頁面；在清單或頁面上選取註解後，也可按 <kbd>Ctrl</kbd>+<kbd>C</kbd> 複製文字（macOS 使用 <kbd>⌘</kbd>+<kbd>C</kbd>）；選取有文字的項目後，下方內容區可拖曳選字、按全選按鈕或複製按鈕，也支援 <kbd>Ctrl</kbd>+<kbd>A</kbd>／<kbd>Ctrl</kbd>+<kbd>C</kbd>。
191
+ - **箭頭文字框**：啟用工具後點選指向位置，自動在旁邊建立文字框並輸入內容；文字框保留建立時的最小寬度，隨單行文字增寬，到頁面邊界才換行，並在頁面範圍內增高；在框外點一下完成輸入，再次點選才建立下一個註解。預設透明背景、藍字、紅框紅箭頭、12 pt；新建文字框預設 6 pt 圓角；下拉面板可分別調整文字色、線條色、線寬、字級、背景與圓角，圓角設為 0 即為直角。
192
+ - 直接雙擊文字框即可編輯，不必先開啟註解窗格；單擊會選取並開啟註解清單。<kbd>Enter</kbd> 換行，<kbd>Ctrl</kbd>+<kbd>Enter</kbd> 完成，<kbd>Esc</kbd> 取消本次編輯；空白內容不建立註解。
193
+ - 選取文字框後可拖動框本身、四角控制點或箭頭端點；游標分別顯示移動、對角縮放或手指提示；選取畫線可修改方式與樣式。<kbd>Delete</kbd> 刪除，<kbd>Ctrl</kbd>+<kbd>Z</kbd> 復原，<kbd>Ctrl</kbd>+<kbd>Y</kbd>／<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> 重做；macOS 使用系統對應快捷鍵。
194
+ - 支援本程式建立的註解，以及可可靠解析的標準螢光筆、底線、刪除線、波浪線與箭頭文字框。本程式新增的便利貼與繪圖存檔重開後可繼續編輯；其他程式的便利貼、繪圖，以及鎖定、特殊外觀、無法還原字型或混合格式的項目維持檢視，選取時會顯示原因。
195
+ - 註解工具與選字、OCR、圖片擷取互斥，並支援全螢幕。樣式會記住供下次使用；選取可編輯項目時，面板的顏色與樣式修改直接套用該項目；切換文字或繪圖工具種類則準備建立新項目。
196
+ - 變更會顯示未儲存星號。存檔後重新開啟仍可編輯；列印、重組及拆分也會包含未儲存的註解變更。關閉文件時可選擇儲存、不儲存或取消。
197
+ - 儲存為標準 PDF 註解及完整外觀，包含中文字型資源，可由其他 PDF 閱讀器顯示；其他程式是否提供相同編輯操作，依其功能而定。
198
+
144
199
  ### 搜尋文字
145
200
 
146
201
  1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
{repdf-0.1.1 → repdf-0.1.3}/pyproject.toml RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "repdf"
3
- version = "0.1.1"
3
+ version = "0.1.3"
4
4
  description = "RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement."
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
{repdf-0.1.1 → repdf-0.1.3}/pyproject.toml.orig RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "repdf"
3
- version = "0.1.1"
3
+ version = "0.1.3"
4
4
  description = "RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement."
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"