| Name | jupyterlab-citation-manager JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | |
| Summary | Citation Manager for JupyterLab with Zotero integration |
| upload_time | 2024-01-14 20:18:40 |
| maintainer | |
| docs_url | None |
| author | Michał Krassowski |
| requires_python | >=3.8 |
| license | BSD 3-Clause License Copyright (c) 2020, Michał Krassowski All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# jupyterlab-citation-manager
[](https://github.com/krassowski/jupyterlab-citation-manager/actions/workflows/build.yml)
[](https://mybinder.org/v2/gh/krassowski/jupyterlab-citation-manager/main?urlpath=lab)
[](https://pypi.org/project/jupyterlab-citation-manager/)
**Status: Work In Progress**. Not ready for production environments, may contains bugs.
Feedback on any aspect of this extension is welcome.
Citation Manager for JupyterLab:
- enables adding citations to Jupyter notebooks in Markdown cells,
- keeps the bibliography in sync with the citations in the document,
- supports thousands of citation styles,
- offers a way to efficiently search through your collection of references,
- integrates with the Zotero® service (Connector for Zotero) by default,
- is modular in design, allowing for integration of other reference managers in the future.
The data of each reference (a.k.a. _citable item_) is stored in the notebook metadata,
while a mapping between citation ID and the citable items is stored in the cell metadata.
- storing full data of each citable item in the notebook enables:
- collaboration between multiple users with separate Zotero collections,
- retaining the data for citation which got removed from private collection.
- storing mapping between citation and citable items in the cell metadata allows to copy cells between notebooks.
## Usage
### Authenticate with Zotero
To enable you to access your reference list you will need to obtain an access API key [from your Zotero account](https://www.zotero.org/settings/keys/new).
The most basic, read-only key is sufficient (and recommended). The key will be stored in your settings, so you will only need to enter it once.
### Insert citation
Insert citation by clicking on the insert citation button in the toolbar of your notebook (![add citation icon][book-plus]) or pressing <kbd>Alt</kbd> + <kbd>C</kbd> (hint: shortcut are customizable in Advanced Settings Editor).
Start typing to filter references by title, authors or year.
![animation of inserting citations][add-citation]
### Insert bibliography
Insert bibliography by clicking on the (![add bibliography icon][book-open-variant]) or pressing <kbd>Alt</kbd> + <kbd>B</kbd>.
![animation of inserting bibliography][add-bibliography]
### Change style
To change the citation style go to the sidebar (![sidebar icon][bookshelf]) and click on (![change style icon][palette]) or press <kbd>Alt</kbd> + <kbd>S</kbd>.
Only a subset of generic styles will be shown initially; start typing a name to find more specialised styles.
![animation of changing style][change-style]
### Synchronise references
To synchronise your collection of references go to the sidebar (![sidebar icon][bookshelf]) and click on (![refresh collection icon][refresh]) or press <kbd>Alt</kbd> + <kbd>U</kbd>.
Updating can take a few seconds; a progress bar will appear on the status bar to keep you updated (if you have it enabled).
### Explore your collection
To get the details on references in your collections without leaving JupyterLab open the sidebar (![sidebar icon][bookshelf]),
and start typing to find item of interest. You will be able to preview the abstract, check metadata and even
open the article inside JupyterLab (or in a new browser tab - depending on your preference).
References with citations in the current document will be show on top when opening the explorer
and enable a quick preview of citation context and navigation to the relevant place in the document
(by clicking on the citation context).
### Auto-migrate existing citations
When opening a notebook, the extension will automatically detect citations in the following formats:
- cite2c, e.g. `<cite data-cite="itemID"></cite>` with associated notebook-level metadata,
- DOI-links, e.g. `[(Krassowski et al, 2021)](https://doi.org/10.3389/fcell.2021.626821)`
(the parentheses in the link label are used as an indicator distinguishing citations from non-citation DOI links)
and ask for your permission to migrate them to Citation Manager format.
Only citations inside of markdown cells will be detected.
The migrated citations are stored separately from the citations from other providers (such as Zotero),
unless an exact match for given ID, DOI, URL or title and list of authors is found among items available
from reference providers (like Zotero), in which case the item from the provider is used.
![animation of migrating from cite2c and from DOIs][migrate-gif]
### Exporting to LaTeX
Citation Manager supports LaTeX as one of the output formats. For now the citations are embedded as plain-text,
while the bibliography uses semantic `thebibliography` LaTeX environment.
To configure notebook to export citations to LaTeX:
1. Go to `Advanced Settings Editor` -> `Citation Manager` and change the default `outputFormat` to `latex`.
2. Insert bibliography in a cell, but instead of using `Markdown` cell, use `Raw` cell
3. Open `Property Inspector` sidebar and change `Raw NBConvert Format` to `LaTeX` (you need to have the `Raw` cell selected for the dropdown to appear)
4. From `File` menu select `Save and Export Notebook As…` and choose `LaTeX`
5. Compile the resulting `.tex` to desired output such as PDF with preferred tool (e.g. `pdflatex` on Linux)
![LaTeX setup overview][latex-setup]
[bookshelf]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/bookshelf.svg?sanitize=true
[book-open-variant]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/book-open-variant.svg?sanitize=true
[book-plus]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/book-plus.svg?sanitize=true
[palette]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/palette.svg?sanitize=true
[refresh]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/refresh.svg?sanitize=true
[add-citation]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/add-citation.gif
[add-bibliography]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/add-bibliography.gif
[change-style]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/change-style.gif
[migrate-gif]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/migrate-cite2c-and-doi.gif
[latex-setup]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/latex.png
## Requirements
- JupyterLab >= 3.3
- Modern browser (with ES 2019 support, e.g. Firefox 64+, or Chrome 73+)
- [Zotero account](https://www.zotero.org/user/register)
## Install
To install the extension, execute:
```bash
pip install jupyterlab-citation-manager
```
## Uninstall
To remove the extension, execute:
```bash
pip uninstall jupyterlab-citation-manager
```
## Advanced Usage
### Citation clusters
This extension enables creation of citation clusters, this is a group of citations that are rendered together,
following the chosen citation style. You can create a citation cluster manually by editing cell metadata.
Support for creation and edition of citation cluster from the graphical interface is planned.
### Citation styles
This extension includes thousands citation styles form the
[official repository][csl-repository] of
[Citation Language Styles][csl] (CSL) project.
If you want to add a custom citation style, you can do so by placing a `.csl` file in `csl-styles` folder in one of the `data` locations as returned by:
```bash
jupyter --paths
```
The `.csl` file should follow CSL v1.0.1 specification (see [official CSL specification](https://docs.citationstyles.org/en/stable/specification.html)).
#### Example
If `jupyter --paths` looks like:
```
config:
/home/your_name/.jupyter
/usr/local/etc/jupyter
/etc/jupyter
data:
/home/your_name/.local/share/jupyter
/usr/local/share/jupyter
/usr/share/jupyter
runtime:
/home/your_name/.local/share/jupyter/runtime
```
and you want to add your modified version of APA style, you would put `my-custom-apa.csl` in `/home/your_name/.local/share/jupyter/csl-styles` (you will need to create this folder), so that the final structure looks similar to:
```
/home/your_name/.local/share/jupyter
├── csl-styles
│ └── my-custom-apa.csl
├── nbsignatures.db
├── notebook_secret
└── runtime
```
## Contributing
### Development install
Note: You will need NodeJS to build the extension package.
The `jlpm` command is JupyterLab's pinned version of
[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
`yarn` or `npm` in lieu of `jlpm` below.
```bash
# Clone the repo to your local environment
# Change directory to the jupyterlab-citation-manager directory
# Fetch build requirements
jlpm run bootstrap
# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Rebuild extension Typescript source after making changes
jlpm run build
```
You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
```bash
# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm run watch
# Run JupyterLab in another terminal
jupyter lab
```
With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).
By default, the `jlpm run build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:
```bash
jupyter lab build --minimize=False
```
### Development uninstall
```bash
pip uninstall jupyterlab-citation-manager
```
In development mode, you will also need to remove the symlink created by `jupyter labextension develop`
command. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`
folder is located. Then you can remove the symlink named `jupyterlab-citation-manager` within that folder.
### Updating citation styles
The citation styles are retrieved from the CSL repository using git submodules
and reside in the [jupyterlab-citation-data](https://github.com/krassowski/jupyterlab-citation-data) repository.
You can update the submodule to fetch the most recent citation styles:
```bash
# fetch the latest styles from the currently tracked CSL version branch
git submodule update csl-styles
# store the information about the most recent commit in version control
git commit csl-styles
```
To update the version branch:
```bash
# replace v1.0.1 with the version to track
git submodule set-branch --branch v1.0.1 csl-styles
git commit csl-styles
```
### Legal notes
#### Connector for Zotero
Zotero is a registered trademark of the [Corporation for Digital Scholarship](http://digitalscholar.org/);
our extension (Connector for Zotero) is not affiliated with the Corporation in any way.
#### CSL styles
The CSL styles are contributed by individual authors to the [CSL project][csl];
all the styles distributed with this extension come from the [Citation Language Styles][csl-repository]
and are released under the [Creative Commons Attribution-ShareAlike 3.0 Unported license][cc-by-sa-3.0].
[csl]: https://citationstyles.org/
[csl-repository]: https://github.com/citation-style-language/styles
[cc-by-sa-3.0]: https://creativecommons.org/licenses/by-sa/3.0/
#### Icons
Please see the [`style/icons/README.md`](https://github.com/krassowski/jupyterlab-citation-manager/blob/main/style/icons/README.md)
for information on the creators and licences of icons included in the distribution.
### citeproc-js
`jupyterlab-citation-manager` uses `citeproc-js` to format citations and bibliography text; `citeproc-js` is
dual-licenced under CPAL 1.0 (or newer) or AGPLv3 (or newer); in order to allow for the distribution of this extension
with other works the CPAL 1.0 licence was adopted for re-distribution of `cireproc-js` together with this extension.
The Exhibit A of `citeproc-js` CPAL 1.0 licence is presented below for informational purposes:
> EXHIBIT A. Common Public Attribution License Version 1.0.
> “The contents of this file are subject to the Common Public Attribution License Version 1.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://opensource.org/license/cpal_1-0/ The License is based on the Mozilla Public License Version 1.1 but Sections 14 and 15 have been added to cover use of software over a computer network and provide for limited attribution for the Original Developer. In addition, Exhibit A has been modified to be consistent with Exhibit B.
> Software distributed under the License is distributed on an “AS IS” basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.
> The Original Code is citeproc-js.
> The Original Developer is not the Initial Developer and is `________`. If left blank, the Original Developer is the Initial Developer.
> The Initial Developer of the Original Code is Frank Bennett. All portions of the code written by Frank Bennett are Copyright (c) 2009-2015. All Rights Reserved.
> Contributor `___________`.
> Alternatively, the contents of this file may be used under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE (the AGPLv3 License), in which case the provisions of AGPLv3 License are applicable instead of those above.
> If you wish to allow use of your version of this file only under the terms of the AGPLv3 License and not to allow others to use your version of this file under the CPAL, indicate your decision by deleting the provisions above and replace them with the notice and other provisions required by the AGPLv3 License. If you do not delete the provisions above, a recipient may use your version of this file under either the CPAL or the AGPLv3 License.”
Raw data
{
"_id": null,
"home_page": "",
"name": "jupyterlab-citation-manager",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Micha\u0142 Krassowski",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/ab/98/cfe2a8e68994abcb69bd33c6cb660ce183162eef9b6e82c6ef5e5bf3309a/jupyterlab_citation_manager-1.0.0.tar.gz",
"platform": null,
"description": "# jupyterlab-citation-manager\n\n[](https://github.com/krassowski/jupyterlab-citation-manager/actions/workflows/build.yml)\n\n[](https://mybinder.org/v2/gh/krassowski/jupyterlab-citation-manager/main?urlpath=lab)\n[](https://pypi.org/project/jupyterlab-citation-manager/)\n\n**Status: Work In Progress**. Not ready for production environments, may contains bugs.\nFeedback on any aspect of this extension is welcome.\n\nCitation Manager for JupyterLab:\n\n- enables adding citations to Jupyter notebooks in Markdown cells,\n- keeps the bibliography in sync with the citations in the document,\n- supports thousands of citation styles,\n- offers a way to efficiently search through your collection of references,\n- integrates with the Zotero\u00ae service (Connector for Zotero) by default,\n- is modular in design, allowing for integration of other reference managers in the future.\n\nThe data of each reference (a.k.a. _citable item_) is stored in the notebook metadata,\nwhile a mapping between citation ID and the citable items is stored in the cell metadata.\n\n- storing full data of each citable item in the notebook enables:\n - collaboration between multiple users with separate Zotero collections,\n - retaining the data for citation which got removed from private collection.\n- storing mapping between citation and citable items in the cell metadata allows to copy cells between notebooks.\n\n## Usage\n\n### Authenticate with Zotero\n\nTo enable you to access your reference list you will need to obtain an access API key [from your Zotero account](https://www.zotero.org/settings/keys/new).\nThe most basic, read-only key is sufficient (and recommended). The key will be stored in your settings, so you will only need to enter it once.\n\n### Insert citation\n\nInsert citation by clicking on the insert citation button in the toolbar of your notebook (![add citation icon][book-plus]) or pressing <kbd>Alt</kbd> + <kbd>C</kbd> (hint: shortcut are customizable in Advanced Settings Editor).\nStart typing to filter references by title, authors or year.\n\n![animation of inserting citations][add-citation]\n\n### Insert bibliography\n\nInsert bibliography by clicking on the (![add bibliography icon][book-open-variant]) or pressing <kbd>Alt</kbd> + <kbd>B</kbd>.\n\n![animation of inserting bibliography][add-bibliography]\n\n### Change style\n\nTo change the citation style go to the sidebar (![sidebar icon][bookshelf]) and click on (![change style icon][palette]) or press <kbd>Alt</kbd> + <kbd>S</kbd>.\nOnly a subset of generic styles will be shown initially; start typing a name to find more specialised styles.\n\n![animation of changing style][change-style]\n\n### Synchronise references\n\nTo synchronise your collection of references go to the sidebar (![sidebar icon][bookshelf]) and click on (![refresh collection icon][refresh]) or press <kbd>Alt</kbd> + <kbd>U</kbd>.\nUpdating can take a few seconds; a progress bar will appear on the status bar to keep you updated (if you have it enabled).\n\n### Explore your collection\n\nTo get the details on references in your collections without leaving JupyterLab open the sidebar (![sidebar icon][bookshelf]),\nand start typing to find item of interest. You will be able to preview the abstract, check metadata and even\nopen the article inside JupyterLab (or in a new browser tab - depending on your preference).\n\nReferences with citations in the current document will be show on top when opening the explorer\nand enable a quick preview of citation context and navigation to the relevant place in the document\n(by clicking on the citation context).\n\n### Auto-migrate existing citations\n\nWhen opening a notebook, the extension will automatically detect citations in the following formats:\n\n- cite2c, e.g. `<cite data-cite=\"itemID\"></cite>` with associated notebook-level metadata,\n- DOI-links, e.g. `[(Krassowski et al, 2021)](https://doi.org/10.3389/fcell.2021.626821)`\n (the parentheses in the link label are used as an indicator distinguishing citations from non-citation DOI links)\n\nand ask for your permission to migrate them to Citation Manager format.\nOnly citations inside of markdown cells will be detected.\n\nThe migrated citations are stored separately from the citations from other providers (such as Zotero),\nunless an exact match for given ID, DOI, URL or title and list of authors is found among items available\nfrom reference providers (like Zotero), in which case the item from the provider is used.\n\n![animation of migrating from cite2c and from DOIs][migrate-gif]\n\n### Exporting to LaTeX\n\nCitation Manager supports LaTeX as one of the output formats. For now the citations are embedded as plain-text,\nwhile the bibliography uses semantic `thebibliography` LaTeX environment.\nTo configure notebook to export citations to LaTeX:\n\n1. Go to `Advanced Settings Editor` -> `Citation Manager` and change the default `outputFormat` to `latex`.\n2. Insert bibliography in a cell, but instead of using `Markdown` cell, use `Raw` cell\n3. Open `Property Inspector` sidebar and change `Raw NBConvert Format` to `LaTeX` (you need to have the `Raw` cell selected for the dropdown to appear)\n4. From `File` menu select `Save and Export Notebook As\u2026` and choose `LaTeX`\n5. Compile the resulting `.tex` to desired output such as PDF with preferred tool (e.g. `pdflatex` on Linux)\n\n![LaTeX setup overview][latex-setup]\n\n[bookshelf]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/bookshelf.svg?sanitize=true\n[book-open-variant]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/book-open-variant.svg?sanitize=true\n[book-plus]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/book-plus.svg?sanitize=true\n[palette]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/palette.svg?sanitize=true\n[refresh]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/style/icons/refresh.svg?sanitize=true\n[add-citation]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/add-citation.gif\n[add-bibliography]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/add-bibliography.gif\n[change-style]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/change-style.gif\n[migrate-gif]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/migrate-cite2c-and-doi.gif\n[latex-setup]: https://raw.githubusercontent.com/krassowski/jupyterlab-citation-manager/main/docs/images/latex.png\n\n## Requirements\n\n- JupyterLab >= 3.3\n- Modern browser (with ES 2019 support, e.g. Firefox 64+, or Chrome 73+)\n- [Zotero account](https://www.zotero.org/user/register)\n\n## Install\n\nTo install the extension, execute:\n\n```bash\npip install jupyterlab-citation-manager\n```\n\n## Uninstall\n\nTo remove the extension, execute:\n\n```bash\npip uninstall jupyterlab-citation-manager\n```\n\n## Advanced Usage\n\n### Citation clusters\n\nThis extension enables creation of citation clusters, this is a group of citations that are rendered together,\nfollowing the chosen citation style. You can create a citation cluster manually by editing cell metadata.\n\nSupport for creation and edition of citation cluster from the graphical interface is planned.\n\n### Citation styles\n\nThis extension includes thousands citation styles form the\n[official repository][csl-repository] of\n[Citation Language Styles][csl] (CSL) project.\n\nIf you want to add a custom citation style, you can do so by placing a `.csl` file in `csl-styles` folder in one of the `data` locations as returned by:\n\n```bash\njupyter --paths\n```\n\nThe `.csl` file should follow CSL v1.0.1 specification (see [official CSL specification](https://docs.citationstyles.org/en/stable/specification.html)).\n\n#### Example\n\nIf `jupyter --paths` looks like:\n\n```\nconfig:\n /home/your_name/.jupyter\n /usr/local/etc/jupyter\n /etc/jupyter\ndata:\n /home/your_name/.local/share/jupyter\n /usr/local/share/jupyter\n /usr/share/jupyter\nruntime:\n /home/your_name/.local/share/jupyter/runtime\n```\n\nand you want to add your modified version of APA style, you would put `my-custom-apa.csl` in `/home/your_name/.local/share/jupyter/csl-styles` (you will need to create this folder), so that the final structure looks similar to:\n\n```\n/home/your_name/.local/share/jupyter\n\u251c\u2500\u2500 csl-styles\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 my-custom-apa.csl\n\u251c\u2500\u2500 nbsignatures.db\n\u251c\u2500\u2500 notebook_secret\n\u2514\u2500\u2500 runtime\n```\n\n## Contributing\n\n### Development install\n\nNote: You will need NodeJS to build the extension package.\n\nThe `jlpm` command is JupyterLab's pinned version of\n[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use\n`yarn` or `npm` in lieu of `jlpm` below.\n\n```bash\n# Clone the repo to your local environment\n# Change directory to the jupyterlab-citation-manager directory\n# Fetch build requirements\njlpm run bootstrap\n# Install package in development mode\npip install -e .\n# Link your development version of the extension with JupyterLab\njupyter labextension develop . --overwrite\n# Rebuild extension Typescript source after making changes\njlpm run build\n```\n\nYou can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.\n\n```bash\n# Watch the source directory in one terminal, automatically rebuilding when needed\njlpm run watch\n# Run JupyterLab in another terminal\njupyter lab\n```\n\nWith the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).\n\nBy default, the `jlpm run build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:\n\n```bash\njupyter lab build --minimize=False\n```\n\n### Development uninstall\n\n```bash\npip uninstall jupyterlab-citation-manager\n```\n\nIn development mode, you will also need to remove the symlink created by `jupyter labextension develop`\ncommand. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`\nfolder is located. Then you can remove the symlink named `jupyterlab-citation-manager` within that folder.\n\n### Updating citation styles\n\nThe citation styles are retrieved from the CSL repository using git submodules\nand reside in the [jupyterlab-citation-data](https://github.com/krassowski/jupyterlab-citation-data) repository.\n\nYou can update the submodule to fetch the most recent citation styles:\n\n```bash\n# fetch the latest styles from the currently tracked CSL version branch\ngit submodule update csl-styles\n# store the information about the most recent commit in version control\ngit commit csl-styles\n```\n\nTo update the version branch:\n\n```bash\n# replace v1.0.1 with the version to track\ngit submodule set-branch --branch v1.0.1 csl-styles\ngit commit csl-styles\n```\n\n### Legal notes\n\n#### Connector for Zotero\n\nZotero is a registered trademark of the [Corporation for Digital Scholarship](http://digitalscholar.org/);\nour extension (Connector for Zotero) is not affiliated with the Corporation in any way.\n\n#### CSL styles\n\nThe CSL styles are contributed by individual authors to the [CSL project][csl];\nall the styles distributed with this extension come from the [Citation Language Styles][csl-repository]\nand are released under the [Creative Commons Attribution-ShareAlike 3.0 Unported license][cc-by-sa-3.0].\n\n[csl]: https://citationstyles.org/\n[csl-repository]: https://github.com/citation-style-language/styles\n[cc-by-sa-3.0]: https://creativecommons.org/licenses/by-sa/3.0/\n\n#### Icons\n\nPlease see the [`style/icons/README.md`](https://github.com/krassowski/jupyterlab-citation-manager/blob/main/style/icons/README.md)\nfor information on the creators and licences of icons included in the distribution.\n\n### citeproc-js\n\n`jupyterlab-citation-manager` uses `citeproc-js` to format citations and bibliography text; `citeproc-js` is\ndual-licenced under CPAL 1.0 (or newer) or AGPLv3 (or newer); in order to allow for the distribution of this extension\nwith other works the CPAL 1.0 licence was adopted for re-distribution of `cireproc-js` together with this extension.\nThe Exhibit A of `citeproc-js` CPAL 1.0 licence is presented below for informational purposes:\n\n> EXHIBIT A. Common Public Attribution License Version 1.0.\n> \u201cThe contents of this file are subject to the Common Public Attribution License Version 1.0 (the \u201cLicense\u201d); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://opensource.org/license/cpal_1-0/ The License is based on the Mozilla Public License Version 1.1 but Sections 14 and 15 have been added to cover use of software over a computer network and provide for limited attribution for the Original Developer. In addition, Exhibit A has been modified to be consistent with Exhibit B.\n> Software distributed under the License is distributed on an \u201cAS IS\u201d basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.\n> The Original Code is citeproc-js.\n> The Original Developer is not the Initial Developer and is `________`. If left blank, the Original Developer is the Initial Developer.\n> The Initial Developer of the Original Code is Frank Bennett. All portions of the code written by Frank Bennett are Copyright (c) 2009-2015. All Rights Reserved.\n> Contributor `___________`.\n> Alternatively, the contents of this file may be used under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE (the AGPLv3 License), in which case the provisions of AGPLv3 License are applicable instead of those above.\n> If you wish to allow use of your version of this file only under the terms of the AGPLv3 License and not to allow others to use your version of this file under the CPAL, indicate your decision by deleting the provisions above and replace them with the notice and other provisions required by the AGPLv3 License. If you do not delete the provisions above, a recipient may use your version of this file under either the CPAL or the AGPLv3 License.\u201d\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License Copyright (c) 2020, Micha\u0142 Krassowski All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.",
"summary": "Citation Manager for JupyterLab with Zotero integration",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/krassowski/jupyterlab-citation-manager/issues",
"Homepage": "https://github.com/krassowski/jupyterlab-citation-manager",
"Repository": "https://github.com/krassowski/jupyterlab-citation-manager.git"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bafa34bd8064887c9585e77982bcfd02613f689da312d3bf5a084cfaf8bd0354",
"md5": "d902cc5f9b0ea391d1a5bfeb0e61593c",
"sha256": "9316f37b2d0d03897d74df44591408ef34c8ad7529c4f3053b84693d8efc82ce"
},
"downloads": -1,
"filename": "jupyterlab_citation_manager-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d902cc5f9b0ea391d1a5bfeb0e61593c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 167056,
"upload_time": "2024-01-14T20:18:33",
"upload_time_iso_8601": "2024-01-14T20:18:33.106222Z",
"url": "https://files.pythonhosted.org/packages/ba/fa/34bd8064887c9585e77982bcfd02613f689da312d3bf5a084cfaf8bd0354/jupyterlab_citation_manager-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ab98cfe2a8e68994abcb69bd33c6cb660ce183162eef9b6e82c6ef5e5bf3309a",
"md5": "d3e8c9c88ee1de3d388b02f0709dcc98",
"sha256": "f610f3f950dd901897a6fad77343131af78f4ec881115833dd4a1b2c2b67067e"
},
"downloads": -1,
"filename": "jupyterlab_citation_manager-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d3e8c9c88ee1de3d388b02f0709dcc98",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3113796,
"upload_time": "2024-01-14T20:18:40",
"upload_time_iso_8601": "2024-01-14T20:18:40.031477Z",
"url": "https://files.pythonhosted.org/packages/ab/98/cfe2a8e68994abcb69bd33c6cb660ce183162eef9b6e82c6ef5e5bf3309a/jupyterlab_citation_manager-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-14 20:18:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "krassowski",
"github_project": "jupyterlab-citation-manager",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "jupyterlab-citation-manager"
}
