Bog NEWS – history of user-visible changes -*- mode: org; -*-
- New option
bog-citekey-format-allow-at, which can be disabled to make it easier to use Bog commands on citekeys that use Pandoc’s @citekey format. - New hook
bog-clean-bib-hookis run for each file processed withbog-clean-and-rename-staged-bibs.
- The default value for
bog-file-secondary-namehas been changed from “-supplement” to “.supplement”.
- New command
bog-list-orphan-files. - New command
bog-dired-jump-to-citekey-file.
- New command
bog-list-orphan-filesfinds citekey files that don’t have a corresponding citekey heading in the notes. - New command
bog-rename-citekey-fileupdates the name of an existing citekey file. - New option
bog-combined-bib-ignore-not-foundcontrols whetherbog-create-combined-bibprompts to continue when a citekey’s bib file is missing. With a prefix argument tobog-create-combined-bib, the meaning of this option is reversed.
bog-search-notesandbog-search-notes-for-citekeynow ignore any agenda restriction locks.- In Dired,
bog-create-combined-bibnow always acts on the marked files (or, if there are none, the one at point) regardless of the prefix argument, which is no longer interpreted bydired-get-marked-files.
- Any file type (not just PDFs) can now be associated with a citekey.
Variables
bog-pdf-directoryandbog-pdf-file-name-separatorshave been replaced by new variablesbog-file-directoryandbog-citekey-file-name-separators, respectively. Unlikebog-pdf-file-name-separators, the value ofbog-citekey-file-name-separatorsis a regular expression, not a list. - In addition to
bog-find-citekey-fileandbog-find-citekey-bib, most functions will now prompt with set of citekeys when prefix argument is given. What this list is depends on the function. - When locating a citekey from the notes fails, functions will now prompt with a list of citekeys instead of giving an error.
- All Bog commands now work outside of Org buffers. To access them,
bind
bog-commanda global key. - When Bog mode is turned on in non-Org buffers, text matching bog-citekey-format is now highlighted, without relying on Org-specific font-lock mechanisms.
- New command
bog-citekey-tree-to-indirect-bufferopens the subtree for a citekey in an indirect buffer. The citekey is either taken from at point or selected from all heading citekeys. - New command
bog-insert-heading-citekeyprompts with all heading citekeys and inserts the selected one at point. - New commands
bog-open-citekey-linkandbog-open-first-citekey-linkopen a link (or links) for a citekey.bog-open-first-citekey-linkis particularly useful if you place the main link for the study (usually a DOI link) as the first link in the citekey’s subtree. The citekey is either taken from at point or selected from all heading citekeys. - New commands
bog-next-non-heading-citekeyandbog-previous-non-heading-citekey - New command
bog-list-orphan-citekeysfinds citekeys that are referred to in the notes but don’t have their own heading. bog-create-combined-bibnow supports collecting citekeys from marked files in a Dired buffer.bog-goto-citekey-heading-in-notesnow works when citekeys are stored are stored as property values.- New command
bog-list-duplicate-heading-citekeysfinds citekeys that have more than one heading in the notes. - New command
bog-jump-to-topic-headingprovides quick navigation to topic headings in any note file. - New variable
bog-subdirectory-groupcontrols whether BibTeX and citekey-associated files are organized into subdirectories generated from abog-citekey-formatregexp group. - New minor mode Bog View sets the buffer to read-only and provides single-letter key for bindings for many Bog commands.
- The command
bog-goto-citekey-heading-in-bufferhas been removed. Similar behavior is now available when a double C-u is used as the prefix argument tobog-goto-citekey-heading-in-notes. bog-goto-citekey-heading-in-notesnow widens the buffer if the heading is outside of the narrowed region.- The format for citekeys is now restricted to letters, digits, underscores, and hyphens.
bog-notes-directoryhas been renamed tobog-note-directory.- New variable
bog-citekey-web-search-groupsspecifies which parts of the citekey are used for the search.
- Citekeys can now be stored as a property in addition to as a heading title.
- Make functions compatible with a single BibTeX file.
- Add new command
bog-refile. - Multiple PDFs can be associated with a citekey.
- Add commands
bog-goto-citekey-heading-in-bufferandbog-goto-citekey-heading-in-notes. - Make PDF file separator customizable.
- Add agenda search commands
bog-search-notesandbog-search-notes-for-citekey. - Add commands
bog-sort-topic-headings-in-bufferandbog-sort-topic-headings-in-notes. - Read a new name if renaming to PDF that exists (instead of giving an error).
- Allow numbers to be in the title word of citekey.
- Fix a logic bug in citekey selection.
- In addition to renaming PDF files, use the stage for renaming and cleaning BibTeX files.
- Remove the path when presenting choices for renaming a PDF.
- Define a keymap and minor mode for Bog.