{"id":13440776,"url":"https://github.com/papis/papis-zotero","last_synced_at":"2025-04-05T06:02:10.851Z","repository":{"id":57450657,"uuid":"146955435","full_name":"papis/papis-zotero","owner":"papis","description":"Zotero compatibility layer for papis ","archived":false,"fork":false,"pushed_at":"2024-11-16T13:53:24.000Z","size":1884,"stargazers_count":76,"open_issues_count":4,"forks_count":17,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-29T05:01:43.407Z","etag":null,"topics":["bibtex","crossref","papers","papis","publications","scihub","zotero"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/papis.png","metadata":{"files":{"readme":"README.rst","changelog":null,"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}},"created_at":"2018-09-01T00:51:59.000Z","updated_at":"2025-03-06T16:33:07.000Z","dependencies_parsed_at":"2023-11-13T08:28:50.128Z","dependency_job_id":"4f651daf-a07a-43c9-9103-ac05d35858b2","html_url":"https://github.com/papis/papis-zotero","commit_stats":{"total_commits":30,"total_committers":3,"mean_commits":10.0,"dds":0.09999999999999998,"last_synced_commit":"00911a6a94191715429649b36f99f32005db530a"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis-zotero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis-zotero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis-zotero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis-zotero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/papis","download_url":"https://codeload.github.com/papis/papis-zotero/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294514,"owners_count":20915340,"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","crossref","papers","papis","publications","scihub","zotero"],"created_at":"2024-07-31T03:01:26.092Z","updated_at":"2025-04-05T06:02:10.822Z","avatar_url":"https://github.com/papis.png","language":"Python","funding_links":[],"categories":["HarmonyOS","others"],"sub_categories":["Windows Manager"],"readme":"|pypi| |ci|\n\nZotero compatibility for Papis\n==============================\n\nInstallation\n------------\n\nPip\n^^^\n\nTo install the latest release from PyPI\n\n.. code:: bash\n\n    python -m pip install papis-zotero\n\nTo install the latest development version\n\n.. code:: bash\n\n    python -m pip install papis-zotero@https://github.com/papis/papis-zotero.git#egg=papis-zotero\n\nNix\n^^^\n\nFor Nix and NixOS users, a Nix flake is included in this repository and can be\nused to install the package. There are many ways of doing so, for instance like so:\n\n.. code:: nix\n\n    {\n      pkgs,\n      inputs,\n      ...\n    }: {\n      home.packages = with pkgs; [\n        (\n          python3.withPackages\n          (\n            ps: [\n              inputs.papis.packages.${system}.default\n              inputs.papis-zotero.packages.${system}.default\n              # you can add other packages you might want to make available for papis\n              # ps.jinja2\n            ]\n          )\n        )\n        # Here you can list other packages, such as\n        # typst\n        # hayagriva\n        # zotero_7\n      ];\n    }\n\nArch\n^^^^\n\nArch users can use the AUR to install `the package\n\u003chttps://aur.archlinux.org/packages/papis-zotero\u003e`__.\n\nImporting from Zotero SQLite (preferred)\n----------------------------------------\n\nZotero also maintains a database of all its files and collections under a\n``zotero.sqlite`` file. You can check where this file is located by going to\n``Edit \u003e Preferences \u003e Advanced \u003e Data Directory Location`` (may vary depending\non the Zotero version). The Zotero data directory should contain the ``zotero.sqlite``\nfile and a ``storage`` directory with the files for each document.\n\nThe SQLite database maintained by Zotero can be imported directly (without\nusing a BibTeX export) by ``papis-zotero``. This can be done with:\n\n.. code:: bash\n\n  papis zotero import --from-sql-folder \u003cZOTERO_DATA_DIRECTORY\u003e\n\nHere, ``ZOTERO_DATA_DIRECTORY`` is the folder containing the ``zotero.sqlite``\nfile. By default, ``papis-zotero`` will add the imported documents to your\ncurrent library directory, but it can be customized using the\n``--outfolder`` argument.\n\nImporting from BibTeX (alternative)\n-----------------------------------\n\nZotero can export different variants of BibTeX or BibLaTeX files\n(from ``Files \u003e Export Library``). You could import the resulting ``.bib`` file\ndirectly with Papis (with the ``papis bibtex`` command), but ``papis-zotero``\nprovides a specialised command. This command has better support for special Zotero\nfields. To import a given exported library run:\n\n.. code:: bash\n\n    papis zotero import --from-bibtex library.bib\n\nBibTeX files exported by Zotero can include attached files as shown in the below\nexample:\n\n.. code:: bibtex\n\n    @article{Einstein1905Photon,\n        author = { A. Einstein },\n        doi = { 10.1002/andp.19053220607 },\n        journal = { Ann. Phys. },\n        pages = { 132--148 },\n        title = { Über einen die Erzeugung und Verwandlung des Lichtes\n            betreffenden heuristischen Gesichtspunkt },\n        file = { Full Text:path/to/some/relative/file.pdf },\n        volume = { 322 },\n        year = { 1905 },\n    }\n\nGiven this, ``papis-zotero`` will interpret the path of the ``file`` entry\nas a relative path to the ``library.bib`` passed to the import command using\n``--from-bibtex``. The files are skipped if they do not exist at the expected\nlocation.\n\nBy default, ``papis-zotero`` will add the documents to your current library.\nWhen initially importing a big library, it is recommended to always import it\ninto a scratch folder, so that you can verify the import. This can be easily done\nusing:\n\n.. code:: bash\n\n    papis zotero import --from-bibtex library.bib --outfolder some/folder/lib\n\nWhen you are ready you can move this folder to a final Papis library.\n\nUsing Zotero connectors\n-----------------------\n\nThis plugin can also connect to a Zotero connector browser plugin. First, such\na plugin should be installed from the\n`Zotero website \u003chttps://www.zotero.org/download/\u003e`__. Then, make sure that\nZotero itself is not running (and connected to the connector) and run:\n\n.. code:: bash\n\n    papis zotero serve\n\nPapis now starts listening to your browser for incoming data. Whenever you click the\nZotero button to add a paper, ``papis-zotero`` will add this paper to the Papis\nlibrary instead.\n\nDevelopment\n-----------\n\nThis project uses ``pyproject.toml`` and ``hatchling`` for its build system.\nTo develop the code, it is recommended to start up a\n`virtual environment \u003chttps://docs.python.org/3/library/venv.html\u003e`__ and\ninstall the project in editable mode using, e.g.::\n\n    python -m pip install -e '.[develop]'\n\nAfter installation, always check that the command is correctly recognized, e.g.\nby looking at the help output\n\n.. code:: bash\n\n    papis zotero --help\n\nIf you use the Nix flake, you can also use the included ``devShell`` with\n``nix develop``.\n\n\n.. |pypi| image:: https://badge.fury.io/py/papis-zotero.svg\n   :target: https://badge.fury.io/py/papis-zotero\n.. |ci| image:: https://github.com/papis/papis-zotero/workflows/CI/badge.svg\n   :target: https://github.com/papis/papis-zotero/actions?query=branch%3Amain+workflow%3ACI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpapis%2Fpapis-zotero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpapis%2Fpapis-zotero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpapis%2Fpapis-zotero/lists"}