{"id":20885883,"url":"https://github.com/zotero/zoterobib","last_synced_at":"2025-04-07T07:17:41.171Z","repository":{"id":35712221,"uuid":"81584116","full_name":"zotero/zoterobib","owner":"zotero","description":"ZoteroBib is a free online bibliography generator from the makers of Zotero","archived":false,"fork":false,"pushed_at":"2024-10-23T15:21:29.000Z","size":7950,"stargazers_count":69,"open_issues_count":28,"forks_count":19,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-10-23T20:01:42.891Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://zbib.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zotero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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}},"created_at":"2017-02-10T16:32:31.000Z","updated_at":"2024-10-23T15:21:33.000Z","dependencies_parsed_at":"2024-10-25T20:36:51.084Z","dependency_job_id":null,"html_url":"https://github.com/zotero/zoterobib","commit_stats":null,"previous_names":["zotero/bib-web"],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotero%2Fzoterobib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotero%2Fzoterobib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotero%2Fzoterobib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotero%2Fzoterobib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zotero","download_url":"https://codeload.github.com/zotero/zoterobib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247608160,"owners_count":20965953,"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-11-18T08:14:54.363Z","updated_at":"2025-04-07T07:17:41.148Z","avatar_url":"https://github.com/zotero.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/zotero/zoterobib/actions/workflows/ci.yml/badge.svg)](https://github.com/zotero/zoterobib/actions/workflows/ci.yml)\n# Zotero Bib\n\nOverview\n--------\nThis repo contains code for [Zotero Bib](https://zbib.org/), including React components, translation client, stylesheets and entry-point website.\n\nPrerequisites\n------------\n\n1. Node JS with npm\n1. Basic command-line tools including rsync\n1. Existing translation-server\n1. Existing bib-server\n1. Existing styles-repo\n\nLocal Development version\n----------\n\nGetting The Library\n\n1. `git clone --recursive git@github.com:zotero/zoterobib.git`\n\n1. `cd zoterobib`\n\n1. `npm install`\n\n1. `npm start`\n\nThis will serve demo on http://127.0.0.1:8001. \n\nYou might need to provide configuration options (see below) in order to get storage and translation to work. \n\nBy default, the development server **proxies translations server requests to localhost:1969**. If your server is located elsewhere you need to provide the url, e.g. the last step above would look like this:\n\n1. `TRANSLATE_URL=http://localhost:1234 npm start`\n\nThis will proxy requests from the browser to the specified translation server.\n\nUsing in Production\n-------------------\n\nTo obtain production-ready files use the following npm command:\n\n`npm run build`\n\nConfiguration\n-------------\n\nIt's possible to provide configuration parameters for the build (both in development and production) using configuration files and/or environment variables. \n\nThe easiest way is to copy `config/default.json` to `config/local.json` and place variables there (this file is git ignored and should not be committed). Alternatively environment variables listed in `config/custom-environment-variables.json` can be used. For more details how to provide configurations, see [config npm package](https://github.com/lorenwest/node-config).\n\nConfiguration options\n--------------\n\nThe following configuration options are accepted:\n\n**storeURL**\nSpecifies url for the *bib-server* api where bibliographies are stored. \n\n**stylesURL**\nSpecifies url for the *styles-repo* website. When left empty, default will be used which is https://www.zotero.org/styles-files/styles.json\n\n**translatePrefix**\nSpecifies an additional prefix for where translation server request should be send. Useful in cases where `translateURL` is left empty so that it's possible to direct requests to a specific endpoint at wherever zotero-bib is being hosted.\n\n**translateURL**\nSpecifies URL for the *translation-server*. By default localhost is assumed to proxy request to the translation server.\n\n**apiAuthorityPart**\nSpecifies the authority part of the URL for Zotero API requests. Defaults to `api.zotero.org`.\n\nDevelopment server configuration\n--------------\n\nRunning `npm start` checks for the following environment variables:\n\n**TRANSLATE_URL**\nWhere to proxy translation requests, defaults to http://localhost:1969. By default ZoteroBib will send translation requests to `window.location.origin` and dev server should be configured to proxy these requests to a translation server.\n\n**PORT**\nOn which port should the dev server listen, defaults to 8001.\n\n**NO_HYDRATE**\nWhen accessing a remote bibliography, ZoteroBib can hydrate from pre-rendered HTML to avoid a spinner while loading. For development purposes, a hard-coded bibliography is stored in `hydrate.hbs` and is used to serve any request that includes a remote bibliography ID. To disable this behavior, set `NO_HYDRATE` to `1`, which will serve `index.hbs` instead, meaning the bibliography is always rendered client-side with a spinner.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzotero%2Fzoterobib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzotero%2Fzoterobib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzotero%2Fzoterobib/lists"}