{"id":42926708,"url":"https://github.com/coderefinery/jupyter_publish","last_synced_at":"2026-01-30T18:10:35.495Z","repository":{"id":75414069,"uuid":"192487077","full_name":"coderefinery/jupyter_publish","owner":"coderefinery","description":"Publication ready scientific reports and presentations with Jupyter notebooks","archived":false,"fork":false,"pushed_at":"2019-06-24T08:28:21.000Z","size":10923,"stargazers_count":6,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-10T04:44:33.999Z","etag":null,"topics":["jupyter-notebook","jupyterlab","jupyterlab-extension","publishing","reproducible-research"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coderefinery.png","metadata":{"files":{"readme":"README.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-06-18T07:18:11.000Z","updated_at":"2021-04-23T14:42:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"e7401362-7e9a-4a21-b2e2-7c9996c3a2e0","html_url":"https://github.com/coderefinery/jupyter_publish","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coderefinery/jupyter_publish","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderefinery%2Fjupyter_publish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderefinery%2Fjupyter_publish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderefinery%2Fjupyter_publish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderefinery%2Fjupyter_publish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coderefinery","download_url":"https://codeload.github.com/coderefinery/jupyter_publish/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderefinery%2Fjupyter_publish/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28917035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T16:37:38.804Z","status":"ssl_error","status_checked_at":"2026-01-30T16:37:37.878Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["jupyter-notebook","jupyterlab","jupyterlab-extension","publishing","reproducible-research"],"created_at":"2026-01-30T18:10:34.708Z","updated_at":"2026-01-30T18:10:35.490Z","avatar_url":"https://github.com/coderefinery.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Publication ready scientific reports and presentations with Jupyter notebooks\n\n\n- All source codes are provided under [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n- All documents are provided under \n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master?urlpath=lab/tree/index.ipynb)\n\nThe main idea with this repository is to show how to share all the [research objects](http://www.researchobject.org/) that are part of a scientific workflow and provide a \"fully\" reproducible environment from one single entry point using [Binder](https://mybinder.readthedocs.io/en/latest/).\n\n\n![coderefinery logo](img/coderefinery.png)\n\nThis workshop has been developed within the [CodeRefinery](https://coderefinery.org) project. CodeRefinery is  funded by [Nordic e-Infrastructure Collaboration](https://neic.no/) (NeIC) and aims at advancing FAIRness of Software management and development practices so that research groups can collaboratively develop, review, discuss, test, share and reuse their codes.   CodeRefinery also deliver 3-day workshops within the Nordic countries, namely in Iceland, Denmark, Norway, Sweden, Finland and Estonia.\n\n# Step-1: Reproducible \"research\"\n\nReading a scientific paper is usually only the first step and far insufficient to fully re-implement and understand what has been achieved. It gives the overall idea, and details on the methodology but very little information on how to do it yourself.\n\nUsing [Binder](https://mybinder.readthedocs.io/en/latest/), you can read the paper and reproduce (and even re-generate) it.\n\nLet's try it out [here](https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master?urlpath=lab/tree/index.ipynb). \n\nThe link above will open a JupyterLab on your browser with all the files and environment contained in this repository. \n\nYou will learn later (following [jupyter_publish-5.ipynb](jupyter_publish-5.ipynb)) how we created this repository with a fully reproducible environment that includes latex, matplotlib, etc. running with Binder. \n\nThe workshop is organized with 5 sections from getting familiar with JupyterLab to share and publish your jupyter notebooks using Binder:\n\n- [Introduction to JupyterLab](jupyter_publish-1.ipynb)\n- [A first notebook to get familiar with JupyterLab](jupyter_publish-2.ipynb)\n- [JupyterLab git extension](jupyter_publish-3.ipynb)\n- [Convert your notebook with ipypublish](jupyter_publish-4.ipynb)\n- [Share and Publish Jupyter notebooks](jupyter_publish-5.ipynb)\n\nThe [pdf document](jupyter_publish.pdf) has been generated with the following command:\n\n```\nnbpublish -f latex_ipypublish_all -pdf jupyter_publish\n```\n\nWhere `jupyter_publish` is this repository.\n\n\n# Step-2: Beyond the state of the art\n\nBeing able to reproduce what someone has published is the first step but our main motivation as a researcher is to use the paper we read as a starting point to go beyond the state of the art and generate new results (using new datasets or changing/adapting algorithms, etc.).\n\nSharing your [research objects](http://www.researchobject.org/) with Binder makes this step much easier and can help you to be more visible as a researcher (by increasing the number of citations).\n\n## Using a repository as a starting point for your new research work\n\n1.  Import this repository directly on GitHub. \n\n    ![Import repository](img/Import_repo.png)\n\n**Note**: you may fork it instead if you are willing to keep a \"link\" with the original work. \n\n     \n2.  Once you have created your repository go to [https://mybinder.org/](https://mybinder.org/)\n\n3.  Enter your repository address and **make sure you replace** *coderefinery* by your github *username* and press **launch**\n    ![Import repository in Binder](img/coderefinery_binder.png)\n    \n **Note**: if you are willing to start JupyterLab instead, add add:\n \n```\n urlpath=lab/tree/index.ipynb\n```\n\nso if your URL for starting Binder is [https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master/tree/index.ipynb](https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master/tree/index.ipynb) it becomes\n\n[https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master?urlpath=lab/tree/index.ipynb](https://mybinder.org/v2/gh/coderefinery/jupyter_publish/master?urlpath=lab/tree/index.ipynb)\n\nBecause in our case, we are willing to start from `index.ipynb` in the launched JupyterLab.\n\n   \nNow we have \"copied\" the original repository with the same reproducible environment e.g. we can reproduce what has been done using Binder and we are now ready to make our own developments using our own Github repository. \n\nWe now have our own Github repository where we can modify and add new developments and share them in the same way using Binder.\n\n## Local installation (optional)\n\nIf you need to install it on your laptop or any other computing platform.\n\n- Follow [setup](setup.ipynb)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderefinery%2Fjupyter_publish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoderefinery%2Fjupyter_publish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderefinery%2Fjupyter_publish/lists"}