{"id":16392753,"url":"https://github.com/a-ws-m/zotenote","last_synced_at":"2025-10-26T14:30:17.888Z","repository":{"id":39585580,"uuid":"415719238","full_name":"a-ws-m/zotenote","owner":"a-ws-m","description":"A VSCode extension that allows you to easily create literature notes with bibliographic information from Zotero.","archived":false,"fork":false,"pushed_at":"2023-08-08T17:20:44.000Z","size":616,"stargazers_count":10,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-16T20:23:24.047Z","etag":null,"topics":["note-taking","second-brain","vscode","zettelkasten","zotero"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a-ws-m.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-10-10T23:00:09.000Z","updated_at":"2024-09-11T12:16:58.000Z","dependencies_parsed_at":"2022-09-20T05:52:50.083Z","dependency_job_id":"ec576da9-25f8-454d-bf9d-7f2968db2ae8","html_url":"https://github.com/a-ws-m/zotenote","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-ws-m%2Fzotenote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-ws-m%2Fzotenote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-ws-m%2Fzotenote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-ws-m%2Fzotenote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a-ws-m","download_url":"https://codeload.github.com/a-ws-m/zotenote/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238337682,"owners_count":19455357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["note-taking","second-brain","vscode","zettelkasten","zotero"],"created_at":"2024-10-11T04:51:18.654Z","updated_at":"2025-10-26T14:30:17.533Z","avatar_url":"https://github.com/a-ws-m.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zotenote\n\nZotenote is an extension for VSCode that enables easy creation of literature notes from Zotero library entries.\n\n## Features\n\nZotenote allows you to configure a literature note *template*, or just use the default one.\nThen, run `Make literature notes from Zotero` from the Command Palette to view a Zotero\ncitations picker dialogue. Type the name of the literature you'd like to create a note for,\nthen press Enter to select. You can select multiple entries. Once you're done, press Enter\nagain to create the notes and have them displayed in the editor:\n\n\u003chttps://user-images.githubusercontent.com/25207558/138964836-50b65865-b44b-4b95-8ca1-55178404114e.mp4\u003e\n\n## Requirements\n\nZotenote requires the [Better BibTex](https://retorque.re/zotero-better-bibtex/installation/)\nextension for Zotero. Zotero must also be opened on your local machine running VSCode in order\nto create new literature notes.\n\n## Extension Settings\n\nThis extension contributes the following settings:\n\n* `zotenote.templateFile`: The literature note template file, relative to the workspace.\n* `zotenote.destination`: The directory in which to save literature notes, relative to the workspace.\n\n## Template file format\n\nThere are two ways of including bibliographic information in the template file,\nwhich I will refer to as *replacement fields* (because they're replaced in the\nformatted literature note file):\n\n* `${attribute:}` will be replaced with `attribute: \u003cthe bibliographic attribute\u003e`.\n* `${attribute}` will be replaced with `\u003cthe bibliographic attribute\u003e`.\n\nIf the `attribute` is missing from the imported data, the replacement field is\nremoved. If its on its own line, the line will be deleted.\n\nValid `attribute`s are any Better BibTex CSLJSON field, plus some special convenience\n`attributes`:\n\n* `${author}` or `${authors}` produces a space-separated list of the authors.\n* `${date}` produces the date in `YYYY-MM-DD` format.\n\nYou can see an example of the `attribute`s available by selecting an item in\nZotero, Right Click \u003e Export, then choose `Format: Better CSL JSON`. The\nresulting file will look something like this:\n\n```json\n[{\n  \"id\": \"schwenkerConstructingSelfLabeledMaterials2020\",\n  \"abstract\": \"//static.cambridge.org/content/id/urn%3Acambridge.org%3Aid%3Aarticle%3AS1431927620023806/resource/name/firstPage-S1431927620023806a.jpg\",\n  \"accessed\": {\n    \"date-parts\": [\n      [2020, 12, 4]\n    ]\n  },\n  \"author\": [{\n    \"family\": \"Schwenker\",\n    \"given\": \"Eric\"\n  }, {\n    \"family\": \"Jiang\",\n    \"given\": \"Weixin\"\n  }, {\n    \"family\": \"Spreadbury\",\n    \"given\": \"Trevor\"\n  }, {\n    \"family\": \"O'Brien\",\n    \"given\": \"Sarah\"\n  }, {\n    \"family\": \"Ferrier\",\n    \"given\": \"Nicola\"\n  }, {\n    \"family\": \"Cossairt\",\n    \"given\": \"Oliver\"\n  }, {\n    \"family\": \"Chan\",\n    \"given\": \"Maria\"\n  }],\n  \"container-title\": \"Microscopy and Microanalysis\",\n  \"DOI\": \"10.1017/S1431927620023806\",\n  \"ISSN\": \"1431-9276, 1435-8115\",\n  \"issue\": \"S2\",\n  \"issued\": {\n    \"date-parts\": [\n      [2020, 8]\n    ]\n  },\n  \"language\": \"en\",\n  \"page\": \"3096-3097\",\n  \"publisher\": \"Cambridge University Press\",\n  \"source\": \"Cambridge University Press\",\n  \"title\": \"Constructing Self-Labeled Materials Imaging Datasets from Open Access Scientific Journals with EXSCLAIM!\",\n  \"type\": \"article-journal\",\n  \"URL\": \"https://www.cambridge.org/core/journals/microscopy-and-microanalysis/article/constructing-selflabeled-materials-imaging-datasets-from-open-access-scientific-journals-with-exsclaim/7549DC118103BEA2591447961289D23E#article\",\n  \"volume\": \"26\"\n}]\n```\n\nThe format of each entry in this format is `\"attribute\": value`, and the\n`attribute` (sans quotes) is what should be used in the replacement field.\nNote that the `attribute` is case sensitive: `${DOI}` will work, but `${doi}`\nwill not.\n\n## Release Notes\n\n### 1.0.0\n\nInitial release of Zotenote, with customisable templates.\n\n### 1.0.1\n\nAdded templating guide to `README`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-ws-m%2Fzotenote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa-ws-m%2Fzotenote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-ws-m%2Fzotenote/lists"}