• Journal of Digital History Jupyter Stack
  • Quick Start
  • For R's user
  • Developing and building local images
  • Resources
  • License

Journal of Digital History Jupyter Stack is a set of ready-to-run Docker images containing specific version of Jupyter notebook along with the extensions needed to write and publish article for the Journal of digital history.

You can use the docker image to:

• start a personal Jupyter Notebook server on your local machine;
• connect your Zotero library to cite2c extension to integrate your references in your notebooks;
• test your local notebook using the the local notebook viewer of the Journal of Digital History.

If you want to run it locally (or in your own server), first you need to install docker and docker-compose. The latter is recommended to speed up the installation process.

NOTE For Windows OS, see our step-by-step guide pdf format

Clone the project:

git clone https://github.com/C2DH/journal-of-digital-history-jupyter-stack.git

Then open a terminal and run the command below at the root of the directory journal-of-digital-history-jupyter-stack

docker-compose up

The docker-compose up command pulls the latest c2dhunilu/journal-of-digital-history-jupyter image if it is not already present on your local machine. It then starts a container running a Jupyter Server and exposes the container's internal port 8888 to port 8889 of the host machine.

Open http://localhost:8889` in a browser to get your Jupyter Notebook ready.

You will be asked for a token that you can find on the terminal console:

Once Jupyter Notebook has started, visit the page Nbextensions, uncheck the option disable configuration for nbextensions without explicit compatibility (they may break your notebook environment, but can be useful to show for nbextension development) to enable the installed extensions. In this docker image we have included:

• the cite2c extension to integrate Zotero and use bibliographic references in your notebooks;
• the table of contents extension;
• the code prettify extension.

Visit the Journal of Digital History guidelines to understand the correct procedure to write compatible articles from your notebooks.

Enjoy!

Based on the Rocker project

docker-compose -f docker-compose.dev.R.yml up --build

By default the R version 4.2.0 (2022-04-22) is used. If you want to use another version of R, please update the Dockerfile-R, by upadting the: FROM instruction. The appropriate tag image can be found here: https://registry.hub.docker.com/r/rocker/binder/tags

RStudio can be started and used in the browser by lauching the following url http://localhost:8889/rstudio/

The official image will work for 90% of the use cases but if like to modify our official Dockerfile to fit your specific needs you will need to build your images in your machine. We have a local docker-compose file to speed up the development:

docker-compose -f docker-compose.dev.yml up --build

• Guidelines of Journal of Digital History
• Author guidelines template for python's user
• Author guidelines template for R's user

GNU Affero General Public License (AGPL) 3 © University of Luxembourg