l0o0/jasminum

★ 6,931TypeScriptAudience · researcherComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((jasminum))
    What it does
      CNKI metadata lookup
      PDF attachment matching
      Chinese citation styles
    Features
      Right-click metadata fill
      Bookmark outline panel
      Chinese translators
    Tech Stack
      TypeScript
      Zotero plugin
    Audience
      Chinese researchers
      Academic users

mindmap root((jasminum)) What it does CNKI metadata lookup PDF attachment matching Chinese citation styles Features Right-click metadata fill Bookmark outline panel Chinese translators Tech Stack TypeScript Zotero plugin Audience Chinese researchers Academic users

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Add a Chinese academic paper PDF to Zotero and automatically fill in its title, author, and journal info by looking it up in CNKI

USE CASE 2

Match CAJ or PDF files you saved manually from CNKI to their corresponding Zotero library entries based on filename similarity

USE CASE 3

Export Zotero references in Chinese academic citation formats required by Chinese journals and institutions

Tech stack

TypeScriptZotero

Getting it running

Difficulty · easy Time to first run · 5min

Install the plugin file in Zotero, requires Zotero 8 or 9 and access to CNKI for metadata lookups.

In plain English

Jasminum is a plugin for Zotero, the free academic reference manager. Its main purpose is to pull metadata for Chinese academic papers from CNKI (China National Knowledge Infrastructure), which is the dominant database for Chinese-language research. If you add a Chinese PDF to Zotero and the automatic metadata detection fails, Jasminum gives you a right-click option to search CNKI and fill in the title, author, journal, and other details. The plugin also handles a common frustration with Chinese journal sources: when you save an item using the Zotero browser extension, the metadata often comes through correctly but the actual PDF or CAJ file fails to download automatically. Jasminum can scan your downloads folder and match files you have saved manually to their corresponding Zotero entries, based on how closely the filename matches the paper title. Two other features round out the plugin. First, Jasminum installs additional translators for Chinese sources, which are the scripts Zotero uses to recognize and import items from different websites. These come from the community-maintained translators_CN project. Second, it adds Chinese citation styles, so you can export references in formats required by Chinese academic journals and institutions. A bonus feature inside the Zotero PDF reader adds a bookmark outline panel. A toolbar button in the left sidebar opens a table of contents built from the PDF's existing bookmarks, with keyboard shortcuts for navigating and editing the bookmark tree. The README is written primarily in Chinese and the plugin is designed for researchers who work with Chinese academic literature. It supports Zotero versions 8 and 9.

Copy-paste prompts

Prompt 1

I installed the Jasminum plugin in Zotero 9. I added a Chinese paper PDF but the metadata fields are blank. How do I use Jasminum to search CNKI and fill in the title, author, and journal?

Prompt 2

I downloaded several CAJ files from CNKI manually and they are not attached to my Zotero entries. How does Jasminum match them using the filename and what folder should I point it at?

Prompt 3

I want to export my Zotero library in a Chinese academic citation style. How do I install and apply the Chinese citation styles that Jasminum provides?

Prompt 4

How do I use the bookmark outline panel that Jasminum adds to the Zotero PDF reader? What keyboard shortcuts are available for navigating and editing bookmarks?

Open on GitHub → Explain another repo

← l0o0 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.