Skip to content
/ cite Public
forked from seifferth/cite

A simple alternative to bloated reference managers, written in 21 lines of shell script

Notifications You must be signed in to change notification settings

jgarte/cite

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Cite

cite is a fzf-based citekey-fuzzyfinder for use in a pandoc-markdown / plain-biblatex workflow. The command will search the current working directory and all subdirectories (both real and symlinked) for filenames ending in .bib. From all those files (expected to be biblatex files) a list of citekeys will be extracted and passed to fzf on stdin for interactive selection. Selecting multiple keys is possible by marking them by pressing Tab before hitting Enter. All arguments to cite are interpreted as a single initial query. If only one citekey matches this query, interactive selection will be skipped and the matching citekey will be output directly.

Installation

Simply save cite in some directory included in your PATH, mark it as executable and make sure all dependencies are satisfied.

Dependencies

Usage

cite is used most efficiently when combined with a text editor. I personally use it with vis, using a custom plugin to insert the output of arbitrary shell commands, but use with different (command-line-oriented) text editors should be possible as well.

Known Issues

  • Whitespace in filenames is not supported.
  • Large numbers of subdirectories seem to introduce notable latency. Large numbers of citekeys, on the other hand, are handled very well.

About

A simple alternative to bloated reference managers, written in 21 lines of shell script

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%