51 lines
2.0 KiB
Org Mode
51 lines
2.0 KiB
Org Mode
#+TITLE: PROJECT: Zotero Org Import Tool (Universal Literate Note)
|
|
#+ID: project-zotero-org-import-tool
|
|
#+STARTUP: content
|
|
#+FILETAGS: :research:zettelkasten:zotero:import:psf:
|
|
|
|
* Overview
|
|
The **Zotero Org Import Tool** is a "makeshift" utility designed to bridge the gap between academic research management (Zotero) and the personal knowledge base (Org-mode). It focuses on two critical priorities: accurate linking to academic PDFs and creating persistent web snapshots for bookmarks.
|
|
|
|
* Phase A: Demand (PRD)
|
|
:PROPERTIES:
|
|
:STATUS: FROZEN
|
|
:END:
|
|
|
|
** 1. Purpose
|
|
Define the requirements for a high-fidelity import of research artifacts from Zotero to Org-mode.
|
|
|
|
** 2. User Needs
|
|
- **BibTeX/JSON Parsing:** Ingest Zotero libraries via standard export formats.
|
|
- **Attachment Linking:** Maintain durable links to local PDF attachments.
|
|
- **Web Persistence:** Generate local or service-based snapshots of imported URLs.
|
|
- **Org-Native Schema:** Map Zotero metadata fields to appropriate Org properties.
|
|
|
|
** 3. Success Criteria
|
|
*** TODO Successful parsing of Zotero JSON export
|
|
*** TODO Verification of direct PDF file links in Org headlines
|
|
*** TODO Snapshot generation for at least one web bookmark
|
|
*** TODO Automated :CREATED: property injection based on Zotero "Date Added"
|
|
|
|
* Phase B: Blueprint (PROTOCOL)
|
|
:PROPERTIES:
|
|
:STATUS: SIGNED
|
|
:END:
|
|
|
|
** 1. Architectural Intent
|
|
Interfaces for data transformation and snapshot retrieval. Source of truth is the Zotero SQLite database/export and the local filesystem.
|
|
|
|
** 2. Semantic Interfaces
|
|
#+begin_src bash
|
|
(defun zotero-import-library (export-path)
|
|
"Parses the export and appends new entries to library.org.")
|
|
|
|
(defun zotero-resolve-attachment (zotero-key)
|
|
"Locates the physical PDF associated with a Zotero record.")
|
|
#+end_src
|
|
|
|
* Phase D: Build (Implementation)
|
|
Current implementation status is "Demand Phase." Placeholder for future Lisp/Python logic.
|
|
|
|
* Phase E: Chaos (Verification)
|
|
Verification involves importing a test collection and ensuring all PDFs are openable and all web links have valid snapshots.
|