{"id":26768879,"url":"https://github.com/sandbergja/blacklight-citeproc","last_synced_at":"2025-07-18T17:06:57.040Z","repository":{"id":36496845,"uuid":"227664983","full_name":"sandbergja/blacklight-citeproc","owner":"sandbergja","description":"Swap in really accurate citations using a wide variety of citation styles to your Blacklight app","archived":false,"fork":false,"pushed_at":"2022-05-09T23:29:45.000Z","size":495,"stargazers_count":4,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-21T11:05:12.623Z","etag":null,"topics":["bibtex","blacklight","citation-style-language","citations"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/sandbergja.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-12T17:52:11.000Z","updated_at":"2025-04-09T19:44:26.000Z","dependencies_parsed_at":"2022-08-08T20:00:09.674Z","dependency_job_id":null,"html_url":"https://github.com/sandbergja/blacklight-citeproc","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sandbergja/blacklight-citeproc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandbergja%2Fblacklight-citeproc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandbergja%2Fblacklight-citeproc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandbergja%2Fblacklight-citeproc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandbergja%2Fblacklight-citeproc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sandbergja","download_url":"https://codeload.github.com/sandbergja/blacklight-citeproc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandbergja%2Fblacklight-citeproc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265798497,"owners_count":23829951,"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":["bibtex","blacklight","citation-style-language","citations"],"created_at":"2025-03-28T21:36:36.814Z","updated_at":"2025-07-18T17:06:57.018Z","avatar_url":"https://github.com/sandbergja.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blacklight::Citeproc\nSwap in really accurate citations using a wide variety of citation styles to your Blacklight app.\n\n## Installation\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'blacklight-citeproc'\n```\n\nAnd then execute:\n```bash\n$ bundle\n```\n\nAnd then run the install generator:\n```bash\n$ rails generate blacklight:citeproc:install\n```\n\nGo into your application's catalog controller, and set the correct fields:\n```ruby\nconfig.citeproc = {\n  bibtex_field: 'bibtex_s' # Optional. If you are already indexing BibTeX into solr, this will be the preferred way to get bibliographic data\n  # If no bibtex_field defined, or if it is not found in the solr document, use these fields instead:\n  fields: {\n    address: 'published_ssm',\n    annote: 'annotation_tsim',\n    author: 'author_tsim',\n    booktitle: 'booktitle_tsim',\n    chapter: 'chapter_tsim',\n    doi: 'doi_tsim',\n    edition: 'edition_tsim',\n    editor: 'editor_tsim',\n    how_published: 'how_published_tsim',\n    institution: 'institution_tsim',\n    journal: 'journal_tsim',\n    key: 'id',\n    month: 'month_tsim',\n    note: 'note_tsim',\n    number: 'number_tsim',\n    organization: 'organization_tsim',\n    pages: 'pages_tsim',\n    publisher: 'publisher_tsim',\n    school: 'school_tsim',\n    series: 'series_tsim',\n    title: 'title_tsim',\n    type: 'type_tsim',\n    url: 'url_tsim',\n    volume: 'number_tsim',\n    year: 'pub_date_ssim'\n  },\n  styles: %w(apa chicago-fullnote-bibliography modern-language-association ieee council-of-science-editors),\n  format: {\n    field: format\n    default_format: :book\n    mappings: {\n      article: [],\n      book: ['Book', 'Musical Score', 'Ebook'],\n      booklet: [],\n      conference: [],\n      inbook: [],\n      incollection: [],\n      inproceedings: [],\n      manual: [],\n      mastersthesis: [],\n      misc: ['Map/Globe', 'Non-musical Recording', 'Musical Recording', 'Image', 'Software/Data', 'Video/Film'],\n     phdthesis: [],\n     proceedings: [],\n     techreport: [],\n     unpublished: []\n    }\n  }\n}\n```\n\nFinally, go into your locale files and make sure to add friendly versions of the citations styles you are using for each locale your app uses.\n\n```yaml\nen:\n  blacklight:\n    citeproc:\n      styles:\n        apa: APA 6th Edition\n```\n\n## Development\n\nYou can get a very simple blacklight app that uses this gem by running `docker-compose up -d`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandbergja%2Fblacklight-citeproc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsandbergja%2Fblacklight-citeproc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandbergja%2Fblacklight-citeproc/lists"}