karthik / karthik/markdown_science

Implementation example: Zotero ODF Scan

Open
#4 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TeX
Stars
308
Forks
77
PR merge metrics
No merged PRs in 30d

Description

The group is probably fully aware of this one, but I'll point it out just in case:

```
http://zotero-odf-scan.github.io/zotero-odf-scan/
```

What the tool does is to implement drag-and-drop markers that provide (a) minimal human-readable cite details; (b) slots for adding prefix, suffix and pinpoint details; and (c) a machine-readable identifier for the full underlying metadata of the cited item.

The markers can be added to any text document, including Markdown documents. If the text is later converted to ODF format, the markers can be converted into fully linked, dynamic Zotero citations for final formatting.

There are compromises, of course: the tool is specific to Zotero; the markers link to a specific (set of) Zotero database(s); and conversion to ODF is a necessary precondition to producing final, formatted citations. In addition, the syntax used (with fields separated by pipe characters, for ease of parsing) may be awkward for some text processors to handle (specifically reStructuredText, where pipe characters are used in unrelated markup).

On the other hand, in terms of workflow it is hard to beat drag-and-drop for ease of use, and the tool is agnostic to the authoring environment -- if you can paste text into it, you can use it with Zotero.

Happy to answer questions or collab if there is interest.

Contributor guide

No contributing guide indexed for this repository

Research direction

No project files, tests, or entry points are named. Start by reviewing the repository's scope and the linked Zotero ODF Scan tool to determine whether an integration or implementation is wanted. Done would require a clearly agreed project change and corresponding validation criteria.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.