Preparing the final version of your manuscript

The final version of your article has to be submitted in one of two formats: LaTeX or Markdown. For authors unfamiliar with these formats we offer support in preparing their final versions. Please carefully read the instructions below on how to prepare your manuscript.

Authors who have written their articles in Word can convert their .docx files to Markdown or LaTeX using e.g. Pandoc: (https://pandoc.org/), which saves a lot of work. The bulk of the work that remains is  creating the bibliography in bibtex format, adding proper labels to tables and figures and proper references in the running text. If you want help with basic conversion from .docx to markdown/LaTeX, contact Marijn Koolen.

We also provide an example article formatted in LaTeX and in Markdown, with a Bibtex reference file.

Preparing a manuscript in LaTeX

Software

There are several open source software packages for different platforms (e.g. Windows, Mac, Linux, see https://www.latex-project.org/get/#tex-distributions) that you can use to create a LaTex version of your manuscript. These packages use syntax highlighting to make your files more readable, and allow you to check your files for errors. They can also transform the LaTeX sources into PDF and other file formats.

LaTeX documentation

LaTeX project documentation: https://www.latex-project.org/help/documentation/
Wikibooks LaTeX documentation: https://en.wikibooks.org/wiki/LaTeX
Overleaf documentation (including LaTeX): https://www.overleaf.com/learn/latex/Main_Page

Article format

Authors should use the built-in article class. That is, your main tex file should start with the following line:

\documentclass{article}

The article style will be adapted for the journal by the editors.

Sections and subsections

Sections and subsections should start with a header. Please use consistent capitalization.
To create a section with a heading, use \section{}:

\section{Introduction}
In this paper we report ...

\section{Experiments}
We conducted a number of experiments ...

\subsection{Experimental Results}
The results of the first experiment ...

\subsubsection{Analysis of Results}
To better understand the results, ...

Anchors for sections

If you refer to sections in your manuscript (e.g. “see Section 2.1”), please use labels and references for those sections, so they are automatically hyperlinked upon conversion to PDF and HTML:

\section{Experimental Results}
\label{sec:results}

... this is described in Section \ref{sec:results}.

Quotes

Short quotes within a sentence should be preceded by two *backticks* and followed by two single quotes (not a single double qoute):

One of the participants stressed that ``we need to develop a data literacy.''

Block quotes should marked as follows:

\begin{quote}
This is a block quote.
\end{quote}

Figures and Tables

Tables and Figures should have hyperlinked references in the running text. Numbers for tables and figures should be generated automatically and not be manually assigned. In other words, don’t use Figure 2 but an explicit latex reference, as in the following examples:

... an example of the scanned images is shown in Figure~\ref{fig:image_scan}.
... the dataset used are listed in Table~\ref{tab:datasets}.

Creating tables in LaTeX can be a frustrating experience. There are online tools that can help you generate tables in LaTeX, e.g.  https://www.tablesgenerator.com/latex_tables.

Bibliography and in-text citations

The reference list/bibliography needs to be provided in bibtex format in a separate file (see below). Bibliographic citations in the main text should use bibtex keys:

For this we used a model for research design by \citet{maxwell2013qualitative}.

Your bibtex should contain a bibtex entry with that key:

@book{maxwell2013qualitative,
  title     =   {Qualitative research design: An interactive approach, 3rd edition},
  author    =   {Maxwell, Joseph A},
  year      =   {2013},
  publisher =   {Sage publications}
} 

Copyright information

Authors retain the copyright to their articles published in the DH Benelux Journal. All published articles will contain the following copyright statement.

Copyright for the individual papers remains with the authors. Copying permitted for private and academic purposes. This volume is published and copyrighted by its editors.

Files to submit

If you prepare your manuscript in LaTeX, you should submit the following files:

  • Latex or markdown file(s) with the article text
  • Bibtex file with bibliographic references
  • Image files for all the figures

Examples

We have provided an example article formatted in LaTeX that you can use as a starting point. It is also available as a project on Overleaf: https://www.overleaf.com/read/qnjgchysjqfh. You can create a free account on Overleaf, then go to that URL and make copy of this project and adapt that copy to your own article. To make a copy, click on the Overleaf menu in the top left and select “Copy Project”.

Producing a manuscript in LaTeX with Overleaf

A handy online application for producing a LaTeX version of your manuscript is Overleaf (https://overleaf.com). It provides an easy-to-use environment that has all the basic conversion software installed and allows you to generate a PDF of your latex files and it provides helpful error messages to identify issues with the formatting.

Note that this is a commercial application, and may at any point become a subscription-only service or go offline.

An example article is provided on Overleaf: https://www.overleaf.com/read/qnjgchysjqfh. Overleaf also provides excellent documentation, including for how to use LaTeX: https://www.overleaf.com/learn/latex/Main_Page

Producing a manuscript in Markdown

Software

The are several free markdown editors, both desktop applications (VSCode, ReMarkable) and online editors (StackEdit, Dillinger) Software for writing and previewing markdown documents:

Using Pandoc to generate output files
Generating HTML with Pandoc: pandoc article.md –bibliography references.bib -o article.html
Generating PDF with Pandoc: pandoc article.md –bibliography references.bib -o article.pdf

Title Metadata

The article metadata, including title, authors and keywords, should be defined at the top of the Markdown file:

---

title: Lessons Learned from a Digital Tool Criticism Workshop

keywords: [digital tool criticism, digital humanities, reflection]

bibliography: references.bib

author:

- Marijn Koolen^1^ (<marijn.koolen@di.huc.knaw.nl>)

- Jasmijn van Gorp^2^ (​<J.vanGorp@uu.nl​>)

- Jacco van Ossenbruggen^3^ (​<Jacco.van.Ossenbruggen@cwi.nl​>)

- ^1^Royal Netherlands Academy of Arts and Sciences, Humanities Cluster

- ^2^Utrecht University, Department of Media and Culture Studies

- ^3^Centrum Wiskunde & Informatica

---

The title and authors should only be listed in the metadata. When generating the PDF and HTML versions for the webiste, they will be styled separately in the main text.

Sections and subsections

Sections and subsections should start with a numbered header, preceded by one or more hash symbols (‘#’).Please use consistent capitalization.

# 1.Introduction

In this paper we report ...

# 2.Experiments

We conducted a number of experiments ...

## 2.1 Experimental Results

The results of the first experiment ...

### 2.1.1 Analysis of Results

To better understand the results, ... 

Anchors for sections

If you refer to sections in your manuscript (e.g. “see Section 2.1”), please use anchors and markdown references for those sections, so they are automatically hyperlinked upon conversion to PDF and HTML:

## 2.1 Experimental Results {#sec:results}

... this is described in Section [2.1]({#sec:results})

Quotes

Short quotes within a sentence should be wrapped in double qoutes (“):

One of the participants stressed that "we need to develop a data literacy."

Block quotes: for block quotes, each line is preceded by a right angular bracket (‘>’):

> This is a block quote.
> Subsequent lines starting with an angular bracket
> result in a single block qoute.

Tables and Figures

Tables and figures should have captions.

Table 1. Table captions should be above the table.
Figure 1. Figure captions should be below the figures.

There are online tools that can help you generate tables in Markdown, e.g.  https://www.tablesgenerator.com/markdown_tables

Bibliography and in-text citations

The reference list/bibliography needs to be provided in bibtex format in a separate file (see below). Bibliographic citations in the main text should use bibtex keys:

For this we used a model for research design by @maxwell2013qualitative.

Your bibtex should contain a bibtex entry with that key:

@book{maxwell2013qualitative,
  title     =   {Qualitative research design: An interactive approach, 3rd edition},
  author    =   {Maxwell, Joseph A},
  year      =   {2013},
  publisher =   {Sage publications}
} 

Copyright information

Authors retain the copyright to their articles published in the DH Benelux Journal. All published articles will contain the following copyright statement.

Copyright for the individual papers remains with the authors. Copying permitted for private and academic purposes. This volume is published and copyrighted by its editors.

Files to submit

If you prepare your manuscript in markdown, you should submit the following files:

  • Markdown file(s) with the article text
  • Bibtex file with bibliographic references
  • Image files for all the figures

Examples

We have provided an example article formatted in Markdown that you can use as a starting point. The related bibtex references file is also available.

Preparing the reference list in bibtex format


Your final submission should contain a separate file that contains all references to the literature you cite in .bibtex format. The bibtex file has keys for the individual papers. Use these keys in your article at placeholders in the text. The conversion from markdown or latex will automatically replace them with readable references.

There are various ways to produce a reference list in .bibtex format:

  • Using a reference manager: many reference managers like Zotero, EndNote, Mendeley or BibDesk can export references to a .bibtex file.
  • Lookup individual references through e.g. Web of Science, Scopus, Google Scholar and export to bibtex
    • In Google Scholar: locate the bibliographic item in Google Scholar, then click on the quotation symbol. At the bottom of the popup window, select bibtex, then copy-paste to a plain text file.
  • Manually creating bibtex items: Use an online bibtex generator (e.g. https://truben.no/latex/bibtex/) and fill in the metadata for each reference manually. There are templates for specific bibliographic categories (articles, book, chapter, proceedings, miscellaneous, …): https://www.verbosus.com/bibtex-style-examples.html

Close Menu