zotero-pdf2zh is an application consisting of a Zotero plugin (TypeScript) and a companion Python Flask server that together enable in-place PDF translation within Zotero. The plugin adds a right-click menu to Zotero items — Translate, Crop, Compare, Crop-Compare — and communicates with the local server via HTTP. The server manages a dedicated Python virtual environment (using uv or conda) that runs either the legacy `pdf2zh` or the recommended `pdf2zh_next` CLI translation engine. The server exposes REST endpoints for translation, cropping, comparison, file download, and SSE-based progress tracking, and supports over 20 LLM translation services (OpenAI, DeepSeek, Gemini, etc.) via user-configured API keys. The system includes Docker deployment, Windows/macOS automation (monitors, right-click scripts), auto-updates, and a bilingual VitePress documentation site. Despite being primarily a software application, it has a strong data-processing character in its PDF manipulation and LLM orchestration layers, but the overall architecture is clearly a client-server addon, not a data analytics project.
ZotLit is a dual-plugin system (Obsidian plugin + Zotero addon) that bridges Zotero's reference management with Obsidian's note-taking environment. It enables users to create literature notes from Zotero items, insert formatted citations, import annotations, and export documents via Pandoc — all within Obsidian. The system is a monorepo with three main applications: an Obsidian plugin (apps/obsidian) that provides views (annotation sidebar, references panel, citation popover, template data explorer), services (citation indexing, live updates from Zotero, Pandoc integration, note creation/update), and a settings tab; a Zotero addon (apps/zotero) that extends Zotero's menus, database status, and freshness signaling; and a documentation site (apps/docs) built with TanStack Router and Fumadocs on Cloudflare Workers. The architecture is service-oriented on the Obsidian side, with approximately 20 services wired in a service container (build.ts) using AsyncDisposableStack for lifecycle management. Shared packages (@zotlit/db, @zotlit/templates, @zotlit/protocol, @zotlit/obsidian-i18n, @zotlit/item-lookup) provide database queries over Zotero's SQLite via Drizzle ORM, template rendering with Eta/Liquid engines, a versioned HTTP wire protocol between Zotero and Obsidian, i18n Language Pack compilation, and a search index for item lookup. The codebase is well-tested with Vitest, employs modern TypeScript patterns, and maintains a comprehensive typed contract system for template data. Key workflows include: bidirectional citation linking (pandoc-style and wikilink), live preview of citations in reading view, annotation import from PDF/EPUB/snapshots with turndown HTML-to-Markdown conversion, Pandoc export with a bundled Lua filter and pinned WASM engine, batch note creation from collection selections, and a template workbench CLI for debugging and authoring templates. The system relies on Zotero's local SQLite database as the authoritative source, with a freshness detection mechanism (WAL checkpoint polling) to trigger updates in Obsidian.
This repository contains a Zotero plugin for formatting item metadata, specifically designed to ensure the existence, correctness, and accuracy of all items and fields in a Zotero library. The plugin includes a rule system with core abstractions expressed as rules, and uses large reference datasets bundled as assets. It is built on the zotero-plugin-template and zotero-plugin-scaffold toolchain and is designed to work with Zotero 8 & 9.