repdf 0.1.2__tar.gz → 0.1.4__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 (52) hide show
  1. {repdf-0.1.2 → repdf-0.1.4}/PKG-INFO +53 -13
  2. {repdf-0.1.2 → repdf-0.1.4}/README.md +52 -12
  3. {repdf-0.1.2 → repdf-0.1.4}/pyproject.toml +1 -1
  4. {repdf-0.1.2 → repdf-0.1.4}/pyproject.toml.orig +1 -1
  5. repdf-0.1.4/src/repdf/annotation_data.py +687 -0
  6. repdf-0.1.4/src/repdf/annotation_editor.py +1705 -0
  7. repdf-0.1.4/src/repdf/annotation_geometry.py +82 -0
  8. repdf-0.1.4/src/repdf/annotation_graphics.py +279 -0
  9. repdf-0.1.4/src/repdf/annotation_reader_cache.py +43 -0
  10. repdf-0.1.4/src/repdf/annotation_spin.py +100 -0
  11. repdf-0.1.4/src/repdf/annotation_store.py +90 -0
  12. repdf-0.1.4/src/repdf/annotation_tree.py +149 -0
  13. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/app.py +246 -65
  14. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/core.py +81 -0
  15. repdf-0.1.4/src/repdf/floating_tools.py +210 -0
  16. repdf-0.1.4/src/repdf/icon_layout.py +24 -0
  17. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/icons.py +97 -10
  18. repdf-0.1.4/src/repdf/message_dialogs.py +86 -0
  19. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/navigation.py +110 -12
  20. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/packaging_smoke.py +27 -0
  21. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/page_view.py +1 -0
  22. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/preview.py +52 -11
  23. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/print_preview.py +5 -2
  24. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/printing.py +7 -3
  25. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/render_worker.py +68 -8
  26. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/renderer.py +2 -1
  27. repdf-0.1.4/src/repdf/saving.py +133 -0
  28. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/search_panel.py +73 -33
  29. repdf-0.1.4/src/repdf/shortcut_hints.py +61 -0
  30. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/strings.py +119 -0
  31. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/theme.py +12 -0
  32. repdf-0.1.4/src/repdf/toolbar.py +271 -0
  33. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/widgets.py +2 -0
  34. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/workers.py +22 -2
  35. repdf-0.1.2/src/repdf/toolbar.py +0 -162
  36. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/__init__.py +0 -0
  37. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/__main__.py +0 -0
  38. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/check-dark.svg +0 -0
  39. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/check.svg +0 -0
  40. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/partial-dark.svg +0 -0
  41. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/partial.svg +0 -0
  42. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/repdf.ico +0 -0
  43. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/assets/repdf.png +0 -0
  44. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/entrypoint.py +0 -0
  45. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/images.py +0 -0
  46. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/ocr.py +0 -0
  47. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/ocr_languages.py +0 -0
  48. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/ocr_models.py +0 -0
  49. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/pdf_annotations.py +0 -0
  50. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/pdf_navigation.py +0 -0
  51. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/preferences.py +0 -0
  52. {repdf-0.1.2 → repdf-0.1.4}/src/repdf/search.py +0 -0
{repdf-0.1.2 → repdf-0.1.4}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: repdf
3
- Version: 0.1.2
3
+ Version: 0.1.4
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,27 +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> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
71
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> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
72
- | <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> |
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，指定基本檔名與儲存位置。 | — |
73
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> |
74
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 | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
75
- | <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> 返回 |
76
- | <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> 返回 |
77
- | <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> 返回 |
78
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」，選擇會記住。 | — |
79
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> | 介面配色 | 點擊依序切換「跟隨系統 → 淺色 → 深色」，選擇會記住。 | — |
80
92
 
@@ -110,6 +122,7 @@ repdf
110
122
  - Fit 與全螢幕優先使用最近點擊且仍可見的頁面；未指定時使用預覽區中央附近的頁面。
111
123
  - Fit 的適應比例可超出滑桿的手動範圍，實際比例仍顯示於工具列。
112
124
  - 滑桿的手動範圍為 25%–200%；完整縮放說明可查看比例按鈕的 tooltip。
125
+ - 全螢幕工具以主按鈕及右側下拉箭頭選擇單頁、對頁或封面＋對頁；<kbd>F11</kbd> 沿用本次執行中最近選擇的模式。單頁每次一頁，對頁由第一頁開始兩頁一組；封面＋對頁先單獨顯示第一頁，再將其餘頁面兩頁分組。
113
126
  - 全螢幕對頁以同一比例完整顯示兩頁，最後剩一頁時單獨顯示。
114
127
  - 返回主視窗後，保留原有縮放比例。
115
128
 
@@ -132,6 +145,15 @@ repdf
132
145
  - 頁碼與頁面卡片上的原始頁碼一致；重新排序後，輸入同一頁碼仍會找到原本的頁面。
133
146
  - 跳頁保留目前縮放／Fit 模式；輸入超出範圍或無效內容時會顯示提示，不會改變目前頁面。
134
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
+
135
157
  ### 列印
136
158
 
137
159
  - 點列印圖示，或按 <kbd>Ctrl</kbd>+<kbd>P</kbd>（macOS：<kbd>⌘</kbd>+<kbd>P</kbd>），直接開啟整合列印視窗；全螢幕中使用快捷鍵會先返回主視窗。
@@ -171,14 +193,32 @@ repdf
171
193
  - 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
172
194
  - 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
173
195
  - 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
174
- - 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；此功能提供檢視與跳頁，不編輯註解或執行附件內容。
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 閱讀器顯示；其他程式是否提供相同編輯操作，依其功能而定。
175
215
 
176
216
  ### 搜尋文字
177
217
 
178
218
  1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
179
219
  2. 輸入搜尋內容，選擇「目前標籤頁」、「勾選的標籤頁」或「所有標籤頁」；同一列的 `.*`、`Aa` 與底線 `ab` 狀態按鈕分別切換「規則表達式」、「區分大小寫」與「僅限單字」，亮起表示啟用。
180
220
  3. 按 <kbd>Enter</kbd> 或「搜尋」執行；修改條件後再次執行才會更新結果。
181
- 4. 上方選取有命中的檔案，下方以交錯底色單行列出命中段落、原始頁碼與命中次數；內容過長時以 `...` 結尾，滑鼠停留可查看完整段落。
221
+ 4. 上方「檔案」表格列出檔名與命中段落筆數；選取檔案後，下方「命中項目」表格以「頁碼／段落」分欄顯示，段落採交錯底色單行呈現，命中次數保留在提示文字中；內容過長時以 `...` 結尾，滑鼠停留可查看完整段落。
182
222
  5. 單擊段落，切換到對應標籤與頁面，捲至命中位置；尚未載入的頁面會自動載入。命中預設以黃色螢光筆標示，選取段落以較深的同色系突出。
183
223
 
184
224
  - 預設搜尋目前標籤頁、不區分大小寫、不使用規則表達式；三種範圍互斥。
{repdf-0.1.2 → repdf-0.1.4}/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,27 +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> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
54
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> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
55
- | <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> |
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，指定基本檔名與儲存位置。 | — |
56
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> |
57
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 | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
58
- | <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> 返回 |
59
- | <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> 返回 |
60
- | <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> 返回 |
61
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」，選擇會記住。 | — |
62
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> | 介面配色 | 點擊依序切換「跟隨系統 → 淺色 → 深色」，選擇會記住。 | — |
63
75
 
@@ -93,6 +105,7 @@ repdf
93
105
  - Fit 與全螢幕優先使用最近點擊且仍可見的頁面；未指定時使用預覽區中央附近的頁面。
94
106
  - Fit 的適應比例可超出滑桿的手動範圍，實際比例仍顯示於工具列。
95
107
  - 滑桿的手動範圍為 25%–200%；完整縮放說明可查看比例按鈕的 tooltip。
108
+ - 全螢幕工具以主按鈕及右側下拉箭頭選擇單頁、對頁或封面＋對頁；<kbd>F11</kbd> 沿用本次執行中最近選擇的模式。單頁每次一頁，對頁由第一頁開始兩頁一組；封面＋對頁先單獨顯示第一頁，再將其餘頁面兩頁分組。
96
109
  - 全螢幕對頁以同一比例完整顯示兩頁，最後剩一頁時單獨顯示。
97
110
  - 返回主視窗後，保留原有縮放比例。
98
111
 
@@ -115,6 +128,15 @@ repdf
115
128
  - 頁碼與頁面卡片上的原始頁碼一致；重新排序後，輸入同一頁碼仍會找到原本的頁面。
116
129
  - 跳頁保留目前縮放／Fit 模式；輸入超出範圍或無效內容時會顯示提示，不會改變目前頁面。
117
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
+
118
140
  ### 列印
119
141
 
120
142
  - 點列印圖示，或按 <kbd>Ctrl</kbd>+<kbd>P</kbd>（macOS：<kbd>⌘</kbd>+<kbd>P</kbd>），直接開啟整合列印視窗；全螢幕中使用快捷鍵會先返回主視窗。
@@ -154,14 +176,32 @@ repdf
154
176
  - 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
155
177
  - 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
156
178
  - 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
157
- - 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；此功能提供檢視與跳頁，不編輯註解或執行附件內容。
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 閱讀器顯示；其他程式是否提供相同編輯操作，依其功能而定。
158
198
 
159
199
  ### 搜尋文字
160
200
 
161
201
  1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
162
202
  2. 輸入搜尋內容，選擇「目前標籤頁」、「勾選的標籤頁」或「所有標籤頁」；同一列的 `.*`、`Aa` 與底線 `ab` 狀態按鈕分別切換「規則表達式」、「區分大小寫」與「僅限單字」，亮起表示啟用。
163
203
  3. 按 <kbd>Enter</kbd> 或「搜尋」執行；修改條件後再次執行才會更新結果。
164
- 4. 上方選取有命中的檔案，下方以交錯底色單行列出命中段落、原始頁碼與命中次數；內容過長時以 `...` 結尾，滑鼠停留可查看完整段落。
204
+ 4. 上方「檔案」表格列出檔名與命中段落筆數；選取檔案後，下方「命中項目」表格以「頁碼／段落」分欄顯示，段落採交錯底色單行呈現，命中次數保留在提示文字中；內容過長時以 `...` 結尾，滑鼠停留可查看完整段落。
165
205
  5. 單擊段落，切換到對應標籤與頁面，捲至命中位置；尚未載入的頁面會自動載入。命中預設以黃色螢光筆標示，選取段落以較深的同色系突出。
166
206
 
167
207
  - 預設搜尋目前標籤頁、不區分大小寫、不使用規則表達式；三種範圍互斥。
{repdf-0.1.2 → repdf-0.1.4}/pyproject.toml RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "repdf"
3
- version = "0.1.2"
3
+ version = "0.1.4"
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.2 → repdf-0.1.4}/pyproject.toml.orig RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "repdf"
3
- version = "0.1.2"
3
+ version = "0.1.4"
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"