{"id":17491819,"url":"https://github.com/msprev/unite-bibtex","last_synced_at":"2025-04-22T20:14:50.554Z","repository":{"id":32514307,"uuid":"36095384","full_name":"msprev/unite-bibtex","owner":"msprev","description":"a BibTeX source for unite.vim","archived":false,"fork":false,"pushed_at":"2018-11-05T11:12:22.000Z","size":39,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-22T20:14:44.003Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msprev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-22T21:10:30.000Z","updated_at":"2023-11-14T17:44:32.000Z","dependencies_parsed_at":"2022-09-12T19:31:57.467Z","dependency_job_id":null,"html_url":"https://github.com/msprev/unite-bibtex","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msprev%2Funite-bibtex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msprev%2Funite-bibtex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msprev%2Funite-bibtex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msprev%2Funite-bibtex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msprev","download_url":"https://codeload.github.com/msprev/unite-bibtex/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250316065,"owners_count":21410476,"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":[],"created_at":"2024-10-19T08:05:15.257Z","updated_at":"2025-04-22T20:14:50.535Z","avatar_url":"https://github.com/msprev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](http://d.pr/i/13kC8+ \"screenshot\")\n\n**This plugin is no longer being maintained.** Unite is no\nlonger maintained, so it makes sense to wind down this too.  **Here\nis a much faster replacement for this source, designed for fzf:\n[fzf-bibtex](https://github.com/msprev/fzf-bibtex)**\n\nI can confirm that unite-bibtex still works under the last version of\nUnite with vim built with Python 2 (although not vim built with Python\n3, Neovim, or Denite).\n\nFor a variety of reasons (some hinted above), I have switched from Unite\nto [fzf](https://github.com/junegunn/fzf.vim).  The new source linked\nabove has no dependency on vim's python version, or indeed on vim (it could be\nused with another text editor).  It looks similar to the picture above,\nbut it is a lot faster than unite-bibtex.\n\n\n# unite-bibtex\n\nA BibTeX source for unite.vim\n\nThe keys of the selected candidates are inserted at the cursor.\n\nBibTeX files are listed in the variable `g:unite_bibtex_bib_files`.\n    The buffer-specific variable `b:unite_bibtex_bib_files` overrides this.\n    Multiple BibTeX files can be passed to both.\n\nCitations are by default inserted in [pandoc][]'s citation format (e.g. `@SomeKey93; @AnotherKey94`).\nYou can change this, on a per buffer basis, by setting the variables:\n\n- `let b:unite_bibtex_prefix = '\\citet{`\n- `let b:unite_bibtex_postfix = '}`\n- `let b:unite_bibtex_separator = ', '`\n\n\nParsing BibTeX databases is computationally intensive, so the source caches the results.\n    The cache is updated if the underlying BibTeX file has been changed.\n    The cache directory is set by `g:unite_bibtex_cache_dir`.\n    This variable must be set for the source to work.\n\n# Requirements\n\n- [unite][]\n- [bibtexparser][]: A BibTeX parser in Python\n- vim built with Python 2\n\n# Use\n\n1.  Install [bibtexparser][]: `pip2 install bibtexparser`\n2.  Install [unite][]\n3.  Install this plugin (e.g. via [vim-plug][])\n4.  Set variable: `let g:unite_bibtex_bib_files=['/path/to/your/bib/file1.bib']`\n5.  Set variable: `let g:unite_bibtex_cache_dir='/path/to/your/temp_dir'`\n6.  `:Unite bibtex` in vim\n7.  `:messages` to see any errors or warnings from the BibTeX parser\n\n# Variables\n\nThe following variables can be set:\n\n- `g:unite_bibtex_bib_files`, `b:unite_bibtex_bib_files` \u003c-- at least 1 of these must be set\n- `g:unite_bibtex_cache_dir` \u003c-- must be set\n- `b:unite_bibtex_prefix`, if not set assumes `'@'`\n- `b:unite_bibtex_postfix`, if not set assumes `''`\n- `b:unite_bibtex_separator`, if not set assumes `'; '`\n\n# bibwatch.py\n\nThis plugin includes a separate Python executable, `bibwatch`.\n\nbibwatch runs in the background in the terminal and watches for changes to selected BibTeX files.\n    Once it detect a change, it updates the corresponding unite-bibtex cache.\n    This means your Unite bibtex source in vim will be populated with zero or minimal lag, even for very large BibTeX databases.\n\nbibwatch is in `unite-bibtex/pythonx/core` inside the unite-bibtex plugin.\n    Go to this directory in the terminal to run `./bibwatch.py`\n    Pass paths to any BibTeX files you want watched.\n    Pass your cache directory (as defined in `g:unite_bibtex_cache_dir`) as the value of `--cache`.\n    For example:\n\n    ./bibwatch.py /path/to/your/bib/file1.bib /path/to/your/bib/file2.bib --cache /path/to/your/temp_dir\n\nPress Control+C to terminate bibwatch.\n\n# Troubleshooting\n\nYou can correct your .bib file with [pybtex](http://pypi.python.org/pypi/pybtex):\n\n```\npip2 install pybtex\npybtex-convert /path/to/your.bib out.bib\n```\n\n# Similar projects\n\n- \u003chttps://github.com/termoshtt/unite-bibtex\u003e (same name, but completely different program)\n\n# Release notes\n\n-   1.0 (25 September 2015):\n    - new: implement bibwatch, separate executable\n    - new: implement persistent cache\n    - new: support multiple BibTeX files\n    - new: support buffer local and global settings\n    - new: configuration variables for prefix, postfix, and separator for citations\n    - fix: refactor code base\n    - fix: update to work with latest version of bibtexparser\n    - breaking change: BibTeX files now set with new variable `g:unite_bibtex_bib_files`\n\n [pandoc]: http://johnmacfarlane.net/pandoc/index.html\n [bibtexparser]: https://bibtexparser.readthedocs.org/en/latest/\n [unite]: https://github.com/Shougo/unite.vim\n [vim-plug]: https://github.com/junegunn/vim-plug\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsprev%2Funite-bibtex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsprev%2Funite-bibtex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsprev%2Funite-bibtex/lists"}