guoc / excerptor

Take and locate excerpts in PDF files quickly.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Excerptor

Quickly take and locate excerpts in PDF files.

Support Preview / Skim (>= 1.4.11) in OS X / macOS (>= 10.10)

Dependencies: SIMBL / mySIMBL

When you read a PDF file, you may want to take some excerpts, like excerpting on physical books (including article name, page number etc.). Via Excerptor, you can take excerpts easily: select text in Preview/Skim and type a shortcut. An excerpt will be stored in pasteboard or a file. The excerpt includes a special link. By clicking the link, Excerptor will open the corresponding file by Preview/Skim, go to the page you want and highlight the excerpt you made, automatically.

Excerpt To Pasteboard

(In the screenshot, the link is pasted as rich text in Notes.app. It will be plain text if it is pasted in an application which only supports plain text.)

Features

No lock-in format.

  • Excerpt file format is plain text.

  • Excerptor links contain all information to locate excerpts. It is possible to find your excerpts by following the information in an excerpt link itself. Even if the PDF files are missing, the excerpt text could be extracted from the excerpt link per se.

    A typical excerpt link is as follows (The part in square brackets may be repeated and delimited by "-").

    excerptor://{FilePathOrDEVONthinkUUID}:{ExcerptText}:[p{PageNumber}_{ExcerptTextLocation}_{ExcerptTextLength}]
    

    See Wiki page Excerpt Link Format for details.

Fully customizable

Excerpts are generated by templates which can be set in Excerptor's preferences.

Excerptor Preferences (Excerpt To Pasteboard) Excerptor Preferences (Excerpt To File)

DEVONthink Pro support

UUID in DEVONthink Pro can be used to locate PDF files if it is installed, otherwise file paths are used to locate files.

DEVONthink's built-in PDF viewer is not supported to take excerpts.

QuickLook excerpt files

By default, excerpt files generated by Excerptor are Markdown plain text format.

With Brett Terpstra's MMD-QuickLook(https://github.com/ttscoff/MMD-QuickLook/), you can QuickLook excerpt files by typing space bar when a excerpt file is selected.

MMD-QuickLook

You can click an excerpt link in QuickLook views to open the corresponding PDF file and locate to your excerpt.

Installation

See Wiki page Excerptor Installation for OS X 10.10 and 10.11 or Excerptor Installation for macOS 10.12

Bug report and feature request

are very welcome. Create an issue or email me guochen42+excerptor@gmail.com

About

Take and locate excerpts in PDF files quickly.

License:MIT License


Languages

Language:Objective-C 56.8%Language:Swift 43.1%Language:Makefile 0.1%