whatisgithub

What is jasminum?

l0o0/jasminum — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

A Zotero plugin that fixes missing metadata for Chinese academic papers by looking them up in CNKI, and also helps attach PDF or CAJ files you downloaded manually to their Zotero entries.

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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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

What is it built with?

TypeScriptZotero

How does it compare?

l0o0/jasminumnutlope/llamacoderlatentcat/qrbtf
Stars6,9316,9326,927
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audienceresearcherdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is jasminum?

A Zotero plugin that fixes missing metadata for Chinese academic papers by looking them up in CNKI, and also helps attach PDF or CAJ files you downloaded manually to their Zotero entries.

What language is jasminum written in?

Mainly TypeScript. The stack also includes TypeScript, Zotero.

How hard is jasminum to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is jasminum for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.