{"id":15679919,"url":"https://github.com/basnijholt/yaml2bib","last_synced_at":"2025-06-22T19:05:31.775Z","repository":{"id":62590348,"uuid":"224835065","full_name":"basnijholt/yaml2bib","owner":"basnijholt","description":"📖 Convert a yaml file to bib file with the correct journal abbreviations.","archived":false,"fork":false,"pushed_at":"2025-06-10T23:24:23.000Z","size":115,"stargazers_count":14,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-19T02:52:01.433Z","etag":null,"topics":["bib","bibtex","convert","crossref","doi","latex","python","yaml","yaml-to-bib","yaml-to-bibtex","yaml2bib"],"latest_commit_sha":null,"homepage":"https://yaml2bib.readthedocs.io/","language":"Python","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/basnijholt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-29T10:48:24.000Z","updated_at":"2025-05-04T19:25:07.000Z","dependencies_parsed_at":"2023-12-25T20:38:59.889Z","dependency_job_id":"9e50817b-462a-4bb7-b0f4-1fe6c5b8cb38","html_url":"https://github.com/basnijholt/yaml2bib","commit_stats":{"total_commits":60,"total_committers":3,"mean_commits":20.0,"dds":"0.050000000000000044","last_synced_commit":"f2f44ad605815dc0b22681166be475aef2a05893"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/basnijholt/yaml2bib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basnijholt%2Fyaml2bib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basnijholt%2Fyaml2bib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basnijholt%2Fyaml2bib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basnijholt%2Fyaml2bib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basnijholt","download_url":"https://codeload.github.com/basnijholt/yaml2bib/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basnijholt%2Fyaml2bib/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261348269,"owners_count":23145305,"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":["bib","bibtex","convert","crossref","doi","latex","python","yaml","yaml-to-bib","yaml-to-bibtex","yaml2bib"],"created_at":"2024-10-03T16:39:10.387Z","updated_at":"2025-06-22T19:05:26.758Z","avatar_url":"https://github.com/basnijholt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📘 `yaml2bib`: Convert YAML to BibTeX with Correct Journal Abbreviations Using Only DOIs 🚀\n\n[![license](https://img.shields.io/github/license/basnijholt/yaml2bib)](https://github.com/basnijholt/yaml2bib/blob/main/LICENSE)\n[![tests](https://github.com/basnijholt/yaml2bib/workflows/pytest/badge.svg)](https://github.com/basnijholt/yaml2bib/actions?query=workflow%3Apytest)\n[![codecov](https://img.shields.io/codecov/c/github/basnijholt/yaml2bib)](https://codecov.io/gh/basnijholt/yaml2bib)\n[![docs](https://img.shields.io/readthedocs/yaml2bib)](https://yaml2bib.readthedocs.io)\n[![version](https://img.shields.io/pypi/v/yaml2bib)](https://pypi.org/project/yaml2bib/)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/yaml2bib)](https://pypi.org/project/yaml2bib/)\n\nIntroducing 🌟 `yaml2bib`, an easy-to-use and powerful Python library and command-line tool that seamlessly converts YAML files to BibTeX format, all while maintaining the correct journal abbreviations using only DOIs! 🎉\nWhether you're a researcher or a student, `yaml2bib` will simplify and streamline your bibliography management process. With an intuitive interface, customizable options, and compatibility as both a library and a command-line tool, it's never been more convenient to create and maintain your citation records.\nSay goodbye to manual conversions and hello to `yaml2bib`! 🚀\n\n### 🛠️ Installation\n\n```bash\npip install yaml2bib\n```\n\n## 🚀 Usage\n\n### Command Line Tool\n\nCheck out the help message `yaml2bib --help`:\n\n\u003c!-- CODE:BASH:START --\u003e\n\u003c!-- echo '```bash' --\u003e\n\u003c!-- yaml2bib --help --\u003e\n\u003c!-- echo '```' --\u003e\n\u003c!-- CODE:END --\u003e\n\u003c!-- OUTPUT:START --\u003e\n\u003c!-- ⚠️ This content is auto-generated by `markdown-code-runner`. --\u003e\n```bash\nUsage: yaml2bib [OPTIONS]\n\nOptions:\n  --bib_fname TEXT          Output file. (default: 'dissertation.bib')\n  --dois_yaml TEXT          The `key: doi` YAML file, may contain wildcards\n                            (*). (default: 'bib.yaml', example: '*/*.yaml')\n  --replacements_yaml TEXT  Replacements to perform, might be None. (default:\n                            None, example: 'replacements.yaml')\n  --static_bib TEXT         Static bib entries, might be None, may contain\n                            wildcards (*). (default: None, example:\n                            'chapter_*/not_on_crossref.bib')\n  --doi2bib_database TEXT   The doi2bib database folder 📁 to not query doi.org\n                            more than needed. (default: 'yaml2bib-doi2bib.db')\n  --crossref_database TEXT  The Crossref database folder 📁 to not query\n                            crossref.org more than needed. (default:\n                            'yaml2bib-doi2bib.db')\n  --email TEXT              E-mail 📧 for crossref.org, such that one can make\n                            more API calls without getting blocked. (default:\n                            'anonymous', example: 'bas@nijho.lt')\n  --help                    Show this message and exit.\n```\n\n\u003c!-- OUTPUT:END --\u003e\n\nExample invocation for Bas Nijholt's [thesis](https://github.com/basnijholt/thesis):\n\n```bash\nyaml2bib \\\n  --bib_fname \"dissertation.bib\" \\\n  --dois_yaml \"*/*.yaml\" \\\n  --replacements_yaml \"replacements.yaml\" \\\n  --static_bib \"chapter_*/not_on_crossref.bib\" \\\n  --email \"bas@nijho.lt\"\n```\n\n### Python Library\n\n```python\nfrom yaml2bib import yaml2bib\n\nyaml2bib(\n    bib_fname=\"dissertation.bib\",\n    dois_yaml=\"*/*.yaml\",\n    replacements_yaml=\"replacements.yaml\",\n    static_bib=\"chapter_*/not_on_crossref.bib\",\n    email=\"bas@nijho.lt\",\n)\n```\n\n## 🌟 Full Example\n\nCheck out the [`examples`](https://github.com/basnijholt/yaml2bib/tree/main/examples) folder for a full example.\n\nConvert with:\n\n```bash\nyaml2bib \\\n  --bib_fname \"example.bib\" \\\n  --dois_yaml \"example.yaml\" \\\n  --replacements_yaml \"replacements.yaml\" \\\n  --static_bib \"not_on_crossref.bib\" \\\n  --email \"bas@nijho.lt\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasnijholt%2Fyaml2bib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbasnijholt%2Fyaml2bib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasnijholt%2Fyaml2bib/lists"}