{"id":16567665,"url":"https://github.com/zepinglee/citeproc-lua","last_synced_at":"2025-10-07T08:28:41.842Z","repository":{"id":41328869,"uuid":"405317352","full_name":"zepinglee/citeproc-lua","owner":"zepinglee","description":"A Lua implementation of the Citation Style Language (CSL) for use with LaTeX","archived":false,"fork":false,"pushed_at":"2025-09-30T13:41:42.000Z","size":16954,"stargazers_count":80,"open_issues_count":4,"forks_count":8,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-09-30T15:27:11.061Z","etag":null,"topics":["bibliography","bibtex","citation-style-language","citations","citeproc","csl","latex","lua","luatex"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/zepinglee.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-09-11T07:49:17.000Z","updated_at":"2025-09-30T13:41:38.000Z","dependencies_parsed_at":"2023-02-04T04:04:01.709Z","dependency_job_id":"f202562c-e3f8-4bbb-b60a-1c1326c3a91b","html_url":"https://github.com/zepinglee/citeproc-lua","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/zepinglee/citeproc-lua","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zepinglee%2Fciteproc-lua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zepinglee%2Fciteproc-lua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zepinglee%2Fciteproc-lua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zepinglee%2Fciteproc-lua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zepinglee","download_url":"https://codeload.github.com/zepinglee/citeproc-lua/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zepinglee%2Fciteproc-lua/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278742759,"owners_count":26037885,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bibliography","bibtex","citation-style-language","citations","citeproc","csl","latex","lua","luatex"],"created_at":"2024-10-11T21:07:11.982Z","updated_at":"2025-10-07T08:28:41.809Z","avatar_url":"https://github.com/zepinglee.png","language":"Lua","readme":"# citeproc-lua\n\n[![CTAN](https://img.shields.io/ctan/v/citation-style-language)](https://www.ctan.org/pkg/citation-style-language)\n[![LuaRocks](https://img.shields.io/luarocks/v/zepinglee/citeproc-lua)](https://luarocks.org/modules/zepinglee/citeproc-lua)\n[![GitHub release](https://img.shields.io/github/v/release/zepinglee/citeproc-lua)](https://github.com/zepinglee/citeproc-lua/releases/latest)\n[![GitHub commits](https://img.shields.io/github/commits-since/zepinglee/citeproc-lua/latest)](https://github.com/zepinglee/citeproc-lua/commits/main)\n[![Automated testing](https://github.com/zepinglee/citeproc-lua/actions/workflows/test.yml/badge.svg)](https://github.com/zepinglee/citeproc-lua/actions/workflows/test.yml)\n\n- Homepage: https://github.com/zepinglee/citeproc-lua\n- Author: Zeping Lee\n- Email: zepinglee AT gmail DOT com\n- License: MIT\n\nThe [Citation Style Language](https://citationstyles.org/) (CSL) is an\nXML-based language that defines the formats of citations and bibliography.\nThere are currently thousands of styles in CSL including the most widely used\nAPA, Chicago, Vancouver, etc.\nThe `citeproc-lua` project is a Lua implementation of CSL v1.0.2 processor\nthat is aimed for use with LaTeX.\nThe engine reads bibliographic metadata and performs sorting and formatting on\nboth citations and bibliography according to the selected CSL style.\nA LaTeX package (`citation-style-language.sty`) is provided to communicate with\nthe processor.\n\nThis project is in early development stage and some features of CSL are not implemented yet.\nComments, suggestions and bug reports are welcome.\n\n\n## LaTeX example\n\nA full LaTeX example is in the [`examples/`](examples) directory.\n\n- LaTeX document example.tex\n\n```latex\n\\documentclass{article}\n\n\\usepackage{citation-style-language}\n\\cslsetup{style = apa}\n\\addbibresource{example.json}  % or example.bib or example.yaml\n\n\\begin{document}\n\n\\cite{ITEM-1}\n\\printbibliography\n\n\\end{document}\n```\n\n- For LuaTeX\n\n```bash\nlualatex example.tex\nlualatex example.tex\n```\n\n- For other TeX engines\n\n```bash\npdflatex example.tex\nciteproc-lua example.aux\npdflatex example.tex\n```\n\n\n\n## Installation\n\nThe above example should work out-of-the-box with TeX Live 2022 or later version.\nIf you want to install the GitHub develop version of this package,\nyou may follow the steps below.\n\nThe `citation-style-language` requires the following packages:\n`filehook`, `l3kernel`, `l3packages`, `lua-uca`, `lualibs`,\n`luatex`, `luaxml`, and `url`.\n`l3build` is also required for actually performing the installation.\nMake sure they are already installed in the TeX distribution.\n\n```bash\ngit clone https://github.com/zepinglee/citeproc-lua  # Clone the repository\ncd citeproc-lua\ngit submodule update --init --remote                 # Fetch submodules\nl3build install\n```\n\nThese commands install the package files to `TEXMFHOME` which is usually\n`~/texmf` on Linux or `~/Library/texmf` on macOS.\nBesides, the `citeproc-lua` executable needs to be copied to some directory\nin the `PATH` environmental variable so that it can be called directly in the shell.\nFor example provided `~/bin` is in `PATH`:\n\n```bash\ncp citeproc/citeproc-lua.lua \"~/bin/citeproc-lua\"\n```\n\nTo uninstall the package from `TEXMFHOME`:\n\n```bash\nl3build uninstall\n```\n\n\n## License\n\nThe LaTeX package and Lua library are released under MIT license.\nThe CSL styles and locale files are redistributed under the [Creative Commons Attribution-ShareAlike 3.0 Unported](https://creativecommons.org/licenses/by-sa/3.0/) license.\nThe journal abbreviation data are generated from \u003chttps://github.com/JabRef/abbrv.jabref.org\u003e and are redistributed under the [CC0 1.0](https://github.com/JabRef/abbrv.jabref.org/blob/main/LICENSE.md) license.\n\n\n## Related material\n\n- CSL\n  - [CSL Homepage](https://citationstyles.org/)\n  - [CSL specification](https://docs.citationstyles.org/en/stable/specification.html)\n  - [CSL schema](https://github.com/citation-style-language/schema)\n  - [CSL processors in other languages](https://citationstyles.org/developers/#csl-processors)\n    - [Juris-M/citeproc-js](https://github.com/Juris-M/citeproc-js)\n      - [documentation](https://citeproc-js.readthedocs.io/en/latest/)\n    - [brechtm/citeproc-py](https://github.com/brechtm/citeproc-py)\n    - [jgm/citeproc](https://github.com/jgm/citeproc)\n    - [andras-simonyi/citeproc-el](https://github.com/andras-simonyi/citeproc-el)\n    - [inukshuk/citeproc-ruby](https://github.com/inukshuk/citeproc-ruby)\n    - [zotero/citeproc-rs](https://github.com/zotero/citeproc-rs)\n  - [CSL locales](https://github.com/citation-style-language/locales)\n  - [CSL styles](https://github.com/citation-style-language/styles)\n  - [CSL test-suite](https://github.com/citation-style-language/test-suite)\n- Articles\n  - [A Citation Style Language (CSL) workshop](https://tug.org/TUGboat/tb35-3/tb111stender.pdf) (TUGboat article)\n- Discussions\n  - [Citation Style Language vs. biblatex](https://tex.stackexchange.com/questions/434946/citation-style-language-vs-biblatex-vs-possibly-other-citing-systems)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzepinglee%2Fciteproc-lua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzepinglee%2Fciteproc-lua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzepinglee%2Fciteproc-lua/lists"}