====== Zotero Source Code ======

**Note:** If you do not plan to make any code changes yourself, and only wish to run the latest prerelease versions of Zotero, you can just install a [[/support/beta_builds|beta build]].


===== Licensing =====

Zotero code is available under the [[http://www.gnu.org/licenses/agpl.html|AGPLv3]] license, except where the source code specifies otherwise.

===== Code Repositories =====

==== Zotero Code ====

Zotero source code is hosted [[https://github.com/zotero|on GitHub]].

==== Third-Party Components ====

^ Component ^ URL ^
|[[http://gsl-nagoya-u.net/http/pub/citeproc-doc.html|citeproc-js]]|https://github.com/juris-m/citeproc-js|
|[[http://citationstyles.org|Citation Style Language (CSL)]] styles|https://github.com/citation-style-language/styles|
|[[http://citationstyles.org|Citation Style Language (CSL)]] locales|https://github.com/citation-style-language/locales|

===== Issue Tracking =====

We don't use GitHub Issues for bug reports or feature requests regarding the Zotero client or website. Please post all such requests to the [[/forum|Zotero Forums]], where Zotero developers and many others can help. Keeping product discussions in the Zotero Forums allows the entire Zotero community to participate, including domain experts that can address many questions better than Zotero developers. See [[:zotero_support|How Zotero Support Works]] for more information.

For confirmed bugs or agreed-upon changes, Zotero developers will create new issues in the relevant repositories.
===== Working with the Zotero Source Code =====

==== Zotero ====

See [[dev/client coding/building_the_desktop_app|Building the Desktop App]].

=== Zotero Connector ===

To run a Git build of the Google Chrome Connector, you need to:
  * ''%%git clone --recursive https://github.com/zotero/zotero-connectors/%%''
  * ''cd zotero-connectors''
  * ''npm i''
  * ''./build -d && gulp''
  * Run Zotero and Chrome
  * Load the Connector extension in Chrome
    - Browse to [[chrome://extensions/]]
    - Expand the "Developer mode" bar
    - Click the button "Load unpacked extension...", and give the path to the ''build/browserExt''  directory within the local repository

You should now see a Zotero icon in the address bar when visiting translatable webpages (e.g., [[https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2018JC014784|this article]] or [[http://www.amazon.com/gp/product/B002B3YBZO/ref=s9_pop_gw_ir03/190-5343882-9824666?pf_rd_m=ATVPDKIKX0DER&pf_rd_s=center-2&pf_rd_r=00JVFZE24KQ87CV9QJ59&pf_rd_t=101&pf_rd_p=1263340922&pf_rd_i=507846|this book]]), and clicking the icon should add the item to your Zotero library.

After making changes, click Reload for the Connector entry in the Chrome Extensions pane and reload any open pages where you want to use the Connector. (If ''gulp'' isn't running, you'll need to run ''./build -d'' after each change.)

See the [[https://github.com/zotero/zotero-connectors|Zotero Connector GitHub repo]] for more details.

==== Contributing patches ====

The preferred way to contribute code is to fork the relevant Git repository, commit your changes, and submit a pull request on GitHub.

See [[dev:client_coding|Client Coding]] for more information on coding for Zotero.