https://github.com/pprevos/citar-denote
Emacs package to create and retrieve bibliography notes with the Citar and Denote packages.
https://github.com/pprevos/citar-denote
bibliography emacs notes
Last synced: over 1 year ago
JSON representation
Emacs package to create and retrieve bibliography notes with the Citar and Denote packages.
- Host: GitHub
- URL: https://github.com/pprevos/citar-denote
- Owner: pprevos
- License: gpl-3.0
- Created: 2022-07-23T06:48:01.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-25T09:28:41.000Z (over 1 year ago)
- Last Synced: 2025-04-07T05:43:34.676Z (over 1 year ago)
- Topics: bibliography, emacs, notes
- Language: Emacs Lisp
- Homepage:
- Size: 376 KB
- Stars: 74
- Watchers: 4
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: readme.org
- License: LICENSE
Awesome Lists containing this project
README
[[https://melpa.org/#/citar-denote][file:https://melpa.org/packages/citar-denote-badge.svg]] [[https://stable.melpa.org/#/citar-denote][file:https://stable.melpa.org/packages/citar-denote-badge.svg]]
Citar-Denote is a minor-mode integrating the Emacs [[https://github.com/emacs-citar/citar][Citar]] and [[https://protesilaos.com/emacs/denote][Denote]] packages to enable create managing bibliographic notes and citations.
This package is part of the [[https://github.com/pprevos/emacs-writing-studio/][Emacs Writing Studio]], a configuration, website and (e)book about researching, writing and publishing articles, books, dissertations and anything else an author needs.
For more information read the [[file:citar-denote.org][Citar-Denote Manual]] in this repository with =C-h R= (~info-display-manual~) and select =citar-denote=.
The =init.el= file in the =test= folder provides a minimum configuration for testing the package.
* Change Log
** Version 2.4.1
- Fixed bug in ~citar-denote-subdir~ concatenation
** Version 2.4
- New functionality to expand citation macros in templates.
- Fixed bugs in adding and removing references.
** Version 2.3
- New command to add bibliographic note in a silo: ~citar-denote-create-silo-note~.
- Renamed ~citar-denote-add-citekey~ to ~citar-denote-add-reference~ and implemented ability to select only from entries not yet used in any Denote file.
- Renamed ~citar-denote-remove-citekey~ to ~citar-denote-remove-reference~.
- Added ~citar-denote-check-keywords~ command to check.
- New command ~citar-denote-nobib~ lists citation keys referenced or cited in Denote, but not present in the in bibliography in the messages buffer.
- Improvements to detection of bibliographic items not used in Denote (nocite)
- Improvements to adding and removing bibliographic keyword
- Updated mechanism to add references
** Version 2.2.3
- Fixed ~citar-denote-add-citekey~ (compatibility with Denote 3.0)
- Grammar check of the manual
** Version 2.2.2
- Integration with ~citar-embark~.
- Added ~citar-denote-cite-includes-reference~ variable to include references when searching for citations.
- Updated manual and function docstrings.
- Bug fixes (compilation errors)
** Version 2.2.1
- ~citar-denote-template~ has additional options:
- =nil=: No template
- =t=: Ask or a template
- =string=: Name of the default template for literature notes
- Updated manual
** Version 2.2
- ~citar-denote-subdir~ has additional options:
- =nil=: No subdirectory
- =t=: Ask for subdirectory
- =string= : When using any string, save in a subdirectory with that name under ~denote-directory~
- Modified behaviour of ~citar-denote-signature~. Users can choose between manually adding a signature or using citation key without prompting.
** Version 2.1.2
- Removed lighter string to not clobber the mode line
- Bug fixed when using non-standard ~citar-denote-keyword~
** Version 2.1.1
- Updated the manual
- Minor code updates
** Version 2.1
- Included Texinfo manual.
- Bug fixes in regex to find citations.
- New function: ~citar-denote-no-bibliography~ lists all citations that do not appear in the global bibliography in the =*Messages*= buffer.
- Updated function documentation.
** Version 2.02
- Improved function docstrings
- Updated example config
** Version 2.0.1
- Updated minor mode definition
- Updated =readme.org= and =minimum-config.el= to define order or installation
** Version 2.0
- Commenced Change Log.
- Updated all functions for full compatibility with Denote 2.2
- Added =minimum-config.el= to provide minimal configuration example.
- Added ~citar-denote-signature~ variable to add signatures for new bibliographic notes. When entering an empty string as signature, the citation key is used as signature.
- The ~citar-denote-template~ variable defines whether a not template is used.
- Added ~citar-denote-nocite~ function to open Citar completion menu with all bibliographic entries neither cited nor referenced in any Denote file. This negates the need for ~citar-denote-reference-nocite~ because notes can be created from within the Citar menu.
- Existing reference removed from Citar completion menu when adding a new reference to a note.
- Fixed a bug in ~citar-denote-add-citekey~ and ~citar-denote-remove-citekey~ when using multiple file types.
- Removed false positives from ~citar-denote--extract-citations~.
- Behaviour of ~citar-denote-use-bib-keywords~ changed. When not-nil, don't prompt for keywords and only use those in the bibliography.
- The ~citar-denote-keyword~ ("bib") is removed from the keyword completion menu to avoid confusion.
- Resolved bug for when ~citar-denote-keyword~ is =nil=.
- ~citar-denote-link-reference~ check that file is a Denote file and fixed linking bug.
- Added ~citar-denote--select-file-using-title~ to select a Denote filename using their title in the completion menu.
- When only one candidate available in ~citar-denote-find-citation~, skip the section menu.
** Version 1.8
- Fixing bugs and improve package documentation.
- Marked private functions with double dash
- Updated ~citar-denote-citekey-regex~ to detect citations with multiple entries
- Updated Citar-Denote manual in [[https://lucidmanager.org/productivity/citar-denote-managing-bibliographic-notes-in-emacs/][Emacs Writing Studio]].
** Version 1.7
- Code refactoring and pretty-printing
- Updated function documentation
- Bug fix to ~citar-denote-remove-citekey~
- Package documentation update
- Code refactoring
- Added ~citar-denote-link-reference~ to insert a Denote link to an existing bibliographic note.
- Added ~citar-denote-find-citation~ to find a citation in your Denote files.