1 of 17

Workshop DH Nord

The Journal of Digital History: �Hands On Workshop

Andreas Fickers, director, C²DH and JDH editor-in-chief�Frédéric Clavert, assistant professor, C²DH and JDH managing editor

Contributors (the interdisciplinary JDH team @ C²DH):�Ori Elisar, Elisabeth Guérard, Daniele Guido, Mirjam Pfeiffer, Lars Wieneke

2 of 17

Overview

14:00 introduction round

14:30 the journal of digital history

14:40 setting up the writing environment

15:00 guidelines

15:10 exercise 1

15:40 advanced features

15:50 technical background

16:00 exercise 2

16:30 share results

16:50 advanced data preparation

introduction of the team and participants (people say why they are here, expectations, experience?)
general intro
how to write an article
start with jupyter notebook
walk through guideline (show different elements)
start by themselves - with own text or prepared text (Frédéric’s ww1 article)
show the different layers (h-layer), demo of current articles (fingerprints, make use of H-layer, code within text)
basic: copy paste text, tag a cell, caption of figure, add media, cite2c
break 1
advanced: how to run code (depends on level of literacy)
how notebook is generated into article (website), generate preview, Github workflow
present their results (what did you do? what problems did you have? how overcome them?)

goal: formatting, preview, combine three layers (N & H layer)
fingerprints are good examples of how different notebooks could be written
preparation: binderhub, zotero, requirement.txt, focus on Python
Elisabeth will prepare a Github repo for ww1 article (shows how repo structure should be like)

3 of 17

Overview

introduction round
the journal of digital history
setting up the writing environment
guidelines
exercise 1
advanced features
technical background
exercise 2
share results
advanced data preparation

introduction of the team and participants (people say why they are here, expectations, experience?)
general intro
how to write an article
start with jupyter notebook
walk through guideline (show different elements)
start by themselves - with own text or prepared text (Frédéric’s ww1 article)
show the different layers (h-layer), demo of current articles (fingerprints, make use of H-layer, code within text)
basic: copy paste text, tag a cell, caption of figure, add media, cite2c
break 1
advanced: how to run code (depends on level of literacy)
how notebook is generated into article (website), generate preview, Github workflow
present their results (what did you do? what problems did you have? how overcome them?)

goal: formatting, preview, combine three layers (N & H layer)
fingerprints are good examples of how different notebooks could be written
preparation: binderhub, zotero, requirement.txt, focus on Python
Elisabeth will prepare a Github repo for ww1 article (shows how repo structure should be like)

4 of 17

Introduction

5 of 17

Introduction

who are you?
why did you join this workshop?
your experience with notebooks
your expectations

6 of 17

The journal of digital history

Write (Digital) History.

As an international, academic, peer-reviewed and open-access journal, the Journal of Digital History (JDH) will set new standards in history publishing based on the principle of multi-layered articles.

7 of 17

Setting up the Writing Environment

8 of 17

Guideline

cell tagging
captions for figures and tables

9 of 17

Guideline

10 of 17

Exercise 1

use your own text or this one
use this template and copy the text into the notebook

11 of 17

Advanced Features

hermeneutics layer
the fingerprint

12 of 17

13 of 17

Technical Background

Git workflow
preview your notebook by using GitHub or locally

14 of 17

Exercise 2

tag “hermeneutics” to cells to move to the H-layer
commit your notebook to Github
preview your notebook here
advanced: generate a fingerprint for your current article (template here) and preview

15 of 17

Share your Results

present your notebook
what problems did you encounter?
how did you overcome them?
any other questions?

16 of 17

Advanced data preparation

binderhub
data best practices

17 of 17

We look forward

to your submissions!

journalofdigitalhistory.org

jdh.admin@uni.lu