Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/windingwind/zotero-pdf-preview
Preview Zotero attachments in the library view.
https://github.com/windingwind/zotero-pdf-preview
pdf preview zotero zotero-plugin zotero7
Last synced: about 2 months ago
JSON representation
Preview Zotero attachments in the library view.
- Host: GitHub
- URL: https://github.com/windingwind/zotero-pdf-preview
- Owner: windingwind
- License: gpl-3.0
- Archived: true
- Created: 2022-07-13T15:12:28.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-25T06:38:25.000Z (10 months ago)
- Last Synced: 2024-09-21T16:28:28.345Z (about 2 months ago)
- Topics: pdf, preview, zotero, zotero-plugin, zotero7
- Language: TypeScript
- Homepage:
- Size: 797 KB
- Stars: 1,156
- Watchers: 7
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> This repository/plugin is archived and no longer maintained, since from Zotero 7.0.0-beta.55, attachment preview is supported natively.
# Preview for Zotero
[![Using Zotero Plugin Template](https://img.shields.io/badge/Using-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github)](https://github.com/windingwind/zotero-plugin-template)
![teaser](./image/README/teaser.gif)
Preview attachments in the library view.
Fast & easy. Do not require any third-party softwares.
## 🧩 Outline
[👋 Install](#-install)
[😎 Quick start](#-quick-start)
[🔧 Development](#-development)
[🔎 My Zotero Plugins](#-my-zotero-plugins)
## 👋 Install
> For Zotero 6, install the [latest stable version](https://github.com/windingwind/zotero-pdf-preview/releases/latest); For Zotero 7, install the [latest prerelease version](https://github.com/windingwind/zotero-pdf-preview/releases/)
- Download the latest release (.xpi file) from the [Releases Page](https://github.com/windingwind/zotero-pdf-preview/releases)
_Note_ If you're using Firefox as your browser, right-click the `.xpi` and select "Save As.."
- In Zotero click `Tools` in the top menu bar and then click `Addons`
- Go to the Extensions page and then click the gear icon in the top right.
- Select `Install Add-on from file`.
- Browse to where you downloaded the `.xpi` file and select it.
- Finish!## 😎 Quick start
Preview can be found in the right side panel of Zotero's main window. You can preview items in either the top/bottom of the info pane or the preview pane. See [Settings](#settings) to customize your preview position.
### Shortcuts
To show/hide the preview in info pane, use shortcut `P` or drag/click the toggel bar.
To zoom in or zoom out, hold `ctrl/cmd` and scroll, or `ctrl/cmd and +/-`;
To reset zoom, use `ctrl/cmd + 0`.
### Settings
Find settings here: Menubar -> Edit -> Preferences -> Preview
| Setting | Details | Default Value |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | ------------- |
| Enable Preview | Enable to allow the preview behavior. | `true` |
| Preview in Info Tab | Enable to show the preview in a split view under 'info' tab. | `true` |
| Preview Position | Preview position in the Info Tab | `bottom` |
| Preview in 'Preview' Tab | Enable show the preview in a new tab of right sidebar. | `true` |
| Show Toolbar in Info Tab/Preview Tab | Enable show the toolbar there. | `true` |
| Show Annotations | Enable to show annotations of the PDF files. May slow down the preview speed. | `false` |
| Show Hovered Page Style | Enable extra style of the hovered page: box shadow and hand cursor. | `true` |
| Double-click Preview Page to Open/Jump PDF | Enable double-click to open/jump to the selected page of PDF. | `true` |
| Dark Mode | Enable to preview PDF files in dark mode. This is a naive dark mode and images color may not be displayed correctly. | `false` |
| Preview First _N_ Pages | See [below](#advanced-usage-of-preview-page-index) | `10` |
| Preview Tab Name | Set the tab label. | `preview` |### Advanced Usage of Preview Page Index
A python-style slice command is supported.
Syntax: Click to expand
`command1,command2,...`
Supported Commands:- Number
Number from 1 to last page> Example:
> `1`
> preview page 1***
> Example:
> `10`
> preview page 10- Slice
`startIndex:stopIndex`.
The `startIndex` page is included while the `stopIndex` page is excluded.`startIndex` or `stopIndex` may be a negative number, which means it counts from the end of the file instead of the beginning.
The `startIndex` or `stopIndex` may be missing to indicate that starts from the first page or ends at the last page.
> Example:
> `1:11`
> preview page 1-10***
> Example:
> `:11`
> preview page first page(1)-10***
> Example:
> `10:`
> preview page 10-last page***
> Example:
> `-3:`
> preview last 3 pages***
> Example:
> `:-3`
> preview page first page(1)-last 3rd page(excluded)***
> Example:
> `:`
> preview every page
## 🔧 Development
This plugin is built based on the [Zotero Plugin Template](https://github.com/windingwind/zotero-plugin-template). See the setup and debug details there.
To startup, run
```bash
git clone https://github.com/windingwind/zotero-better-notes.git
cd zotero-better-notes
npm install
npm run build
```The plugin is built to `./builds/*.xpi`.
## 🔔 Disclaimer
Use this code under AGPL. No warranties are provided. Keep the laws of your locality in mind!
## 🔎 My Zotero Plugins
- [zotero-pdf-translate](https://github.com/windingwind/zotero-pdf-translate): PDF translation for Zotero
- [zotero-pdf-preview](https://github.com/windingwind/zotero-tag): PDF preview for Zotero
- [zotero-tag](https://github.com/windingwind/zotero-tag): Automatically tag items/Batch tagging