diff --git a/docs/sma/content/images/plugin-pdf/pdf-mathpix-usage.png b/docs/sma/content/images/plugin-pdf/pdf-mathpix-usage.png new file mode 100644 index 0000000..7c3241c Binary files /dev/null and b/docs/sma/content/images/plugin-pdf/pdf-mathpix-usage.png differ diff --git a/docs/sma/plugin-pdf-common.md b/docs/sma/plugin-pdf-common.md index 46cc987..4f88beb 100644 --- a/docs/sma/plugin-pdf-common.md +++ b/docs/sma/plugin-pdf-common.md @@ -1,3 +1,17 @@ +### PDF Summary + +> **Import:** Ctrl + Alt + I to import PDF. +> +> **Open PDF:** Select the **PDF element** SMA created for you. Unselect to close. +> +> **Extract:** Alt + X to extract. +> +> **Images:** Hold Right click and drag mouse to **area snapshot** images. +> +> **Multi-content:** Hold CTRL to choose multiple elements (e.g. text + images). +> +> See also: [Sub-PDFs](#pdf-sub-pdf), [LateX](plugin-latex.md), [Dictionary](plugin-Dictionary.md), [PDF deletion](#pdf-Deletion) + ### PDF: Video tutorial
@@ -44,7 +58,7 @@ There are **two modes** for extracting images: 1. **Image selection (A)**: Left click on the image. An overlay will be displayed to indicate your selection. Alt + X to extract. -2. **Area snapshot (B)**: Hold Left click or Right click, then drag your mouse **(B)**. Alt + X to extract. +2. **Area snapshot (B)**: Hold Right click, then drag your mouse **(B)**. Alt + X to extract. ![Image selection](content/images/plugin-pdf/pdf-image-selections.png '@z2v="content/videos/plugin-pdf/pdf-extract-image-click-and-drag"') @@ -56,6 +70,6 @@ SMA allows you to **select as many objects** to extract as you desire. To start > [!NOTE] -> SMA will automatically try to fit your content to make the best use of the space in SuperMemo. You can create new [layouts](#) to change the default arrangement. +> SMA will automatically try to fit your content to make the best use of the space in SuperMemo. *You can create new **layouts** to change the default arrangement. (work in progress)* ![](content/images/plugin-pdf/pdf-extract-multiple-AB.png '@z2v="content/videos/plugin-pdf/pdf-extract-multiple"') \ No newline at end of file diff --git a/docs/sma/plugin-pdf-glossary.md b/docs/sma/plugin-pdf-glossary.md index a03659c..ad9632e 100644 --- a/docs/sma/plugin-pdf-glossary.md +++ b/docs/sma/plugin-pdf-glossary.md @@ -1,5 +1,6 @@ - **PDF element**: [Element in SuperMemo](content/images/plugin-pdf/pdf-element.png ':ignore'), which contains the data relating to an imported PDF. - **PDF window**: [The window](content/images/plugin-pdf/pdf-window.png ':ignore') that displays the actual PDF, and where extracts can be created. - **Sub-PDFs**: PDF elements which contain only a [part of your original PDF](content/images/plugin-pdf/pdf-subpdf-out-of-extract.png ':ignore'). -- **Area snapshot**: Image selection mode which [captures a region](content/videos/plugin-pdf/pdf-image-drag-result) of your PDF into an image. Hold left or right click, then drag an area with your mouse. -- **Multi-selection**: Selection that contains more than one object (text, image, area snapshot, OCR). Types of objects can be mixed and matched. To start a multi-selection, **hold** the Ctrl key, and select your content. \ No newline at end of file +- **Area snapshot**: Image selection mode which [captures a region](content/videos/plugin-pdf/pdf-image-drag-result) of your PDF into an image. Hold right click, then drag an area with your mouse. +- **Multi-selection**: Selection that contains more than one object (text, image, area snapshot, OCR). Types of objects can be mixed and matched. To start a multi-selection, **hold** the Ctrl key, and select your content. + diff --git a/docs/sma/plugin-pdf.md b/docs/sma/plugin-pdf.md index 14deb16..387bfbf 100644 --- a/docs/sma/plugin-pdf.md +++ b/docs/sma/plugin-pdf.md @@ -4,7 +4,7 @@ ### PDF: Force selection -When you have PDF made of images only, or when you find it hard to select the image (interference with text) you can use force selection by holding Right click. This will ignore text selection. +When you have PDF made of images only, or when you find it hard to select the image (because text is in the way) you can use force selection by holding Right click. This will ignore text selection. You can use force selection with OCR as shown in the video clip below. (See [built-in OCR](#pdf-built-in-ocr)) @@ -16,27 +16,42 @@ You can use
- + +
+
+
+
+ +*You can find amount of requests you made each month in https://dashboard.mathpix.com* + + + + + +Once you are registered, copy your **MathPix App Name** and **Key** and paste them in the [PDF plugin settings](#). +
+ -#### Using the OCR -1. In the **PDF window**, press the Alt key, then capture an [area snapshot](#extract-images). -2. If your image was success recognized, a window titled *TeX editor* will display your result. +#### How to use OCR + +1. In the **PDF window**, press the Alt key, then capture an [area snapshot](#extract-images). +2. If your image was successfully recognized, a *TeX editor* window pops up, in which you can preview your result and make changes before you extract it into SM. ![TeX editor](content/images/plugin-pdf/pdf-ocr-TeX-editor.png '@z2v="content/videos/plugin-pdf/pdf-ocr-wholeline"') @@ -105,7 +120,7 @@ There are two layers of settings available: - **Global PDF settings**: To access these settings, either - Right click the ![](content/images/icons/robot-16.png) icon in your Window tray bar, and click on the PDF menu item - Press Ctrl + Alt + Shift + O and click on the cog ![](content/images/icons/cog.png) icon next to the PDF plugin - + - **Per-PDF settings**: In the PDF window, press Ctrl + O to bring up [settings dialog ![](content/images/plugin-pdf/pdf-per-pdf-settings.png)](content/images/plugin-pdf/pdf-per-pdf-settings.png ':ignore @tooltip-preview'). > [!NOTE] @@ -128,15 +143,12 @@ HotKeys - SM extract (Alt+X) - Mark text as ignored (Ctrl+Shift+I) - Show selected text in Dictionary (Ctrl+D) - - Go To Page (Ctrl+G) - SM Learn (Ctrl+L) - Learn And Reschedule (Ctrl+Shift+L) - SM Reschedule (Ctrl+J) - SM LaterToday (Ctrl+Shift+J) - SM Done (Ctrl+Shift+Enter) - SM Delete (Ctrl+Shift+Del) - - SM Previous (Alt+Left) - - SM Next (Alt+Right) - SM Parent (Ctrl+Alt+Up) - SM Child (Ctrl+Alt+Down) - SM Prev Sibling (Ctrl+Alt+Left) @@ -152,20 +164,28 @@ HotKeys ``` Non-hotkeys - OCR (Alt+Click) - - Image area selection (Hold left click) - - Force image area selection (Hold right click) + - Image area selection (Hold right click) - Zoom (Ctrl+Wheel) - Extend text selection (Shift+Click, Shift+Left/Right) - - Deselect (Escape) - PDF navigation (Up/Down/Left/Right/Pg. Down/Pg. Up/Home/End) - Select word (Double click) - - Select paragraph (Triple click) - - Select page text (Quadra click) - Select page (double click on empty space in page) - Extend page selection (Shift+Click page) - Add to selection (Hold ctrl) - Select image (Click image) ``` +``` +Hotkeys not working currently: +- Go To Page (Ctrl+G) +- SM Previous (Alt+Left) +- SM Next (Alt+Right) +- Deselect (Escape) +- Select paragraph (Triple click) +- Select page text (Quadra click) +``` + + + > [!NOTE] > When you extract text from the PDF file, the windows error sound may play. You can [disable it by switching off system sounds](#faq). @@ -175,10 +195,6 @@ Non-hotkeys ## FAQ -**Q: Concept verification error: hook is not a child of root!** - -A: Change currently activated concept as the one with hook in it for the PDFs. - **Q: PDFs stop working after repair of SM collection** A: This is because when you do repair, SM restarts itself, while SMA doesn't. So the solution is to restart SMA manually. @@ -197,4 +213,4 @@ A: Use Ctrl + G. **Q:How do I disable the Windows Sound from playing when I extract from a PDF?** -A: In order to stop the sound from playing, you can right click the volume icon on the taskbar, then open the volume mixer and set system sounds to zero. +A: In order to stop the sound from playing, you can right click the volume icon on the taskbar, then open the volume mixer and set system sounds to zero.