still notes

Jakob Voss authored
revision 6cc35cff596c79ba0ae2d6400abdd7676bc7666d
README
This git repository contains source code of paper and slides of *Collaborative
creation of a Wikidata handbook* by Jakob Voß (2014). The publication has been
submitted, accepted and presented at [OpenSym 2014](http://opensym.org/os2014/)
(formerly WikiSym) Community Track in Berlin.

A PDF copy of the paper has been deposited with DOI
[10.5281/zenodo.11249](http://dx.doi.org/10.5281/zenodo.11249).

The paper is not included in the official proceedings just because the
publisher ACM requires a ridiculous Open Access fee or exclusive rights.

**Abstract**: This article describes the theoretical and practical background
of a collaborative writing project resulting in a handbook on Wikidata and
authority control. The handbook was created by an untrained group of students
during three month in spring 2014. It was written in Pandoc Markdown in a git
repository at Penflip.com.

![](slides/cc-by-sa.png)
slides/cc-by-sa
  • 2-up
  • Swipe
  • Onion skin
slides/frontcover
slides/slides
---
title: Collaborative Creation of a Wikidata handbook
date: 2014-08-28
author: Jakob Voß
place: OpenSym (WikiSym), Berlin
institute: Verbunzentrale des GBV (VZG) /& Hochschule Hannover
...

# Topic

* Create a book on authority files and Wikidata
* Hochschule Hannover
* 9 students
* ...
\begin{columns}[T]
\begin{column}{.5\textwidth}

{\large{\bf Normdaten in Wikidata}}
\vskip 0pt
{\emph{Authority files in Wikidata}}
\vskip 1em
ISBN 978-1-291-85658-3
\vskip 0pt
68 pages
\vskip 1em
Available as HTML, ePUB, PDF \& print on demand
\vskip 1em
\url{http://hshdb.github.io/normdaten-in-wikidata/}
\vskip 1.2em
\includegraphics{cc-by-sa.png}

\end{column}
\begin{column}{.5\textwidth}
{
\setlength{\fboxsep}{0pt}
\fbox{\includegraphics[width=\textwidth]{frontcover.png}}
}
\end{column}
\end{columns}

# Project Background

* Conducted by 9 students and me
* 6th semester Bachelor of Information Management
* Hannover University of Applied Sciences
* March -- June 2014 (13 meetings á 5 hours)

*book sprint by non-experts*

# Wikidata

IMG

* Wiki database that anyone can edit
* It's great!
* *See tomorrow's Wikidata talk for details!*


# Authority files

* Entities with unique **identifiers**, possibly connected.
* Also known as **knowledge organization systems**
* Encodable with SKOS in RDF
(SKOS)
* Related to a major part of Wikidata content


Examples
: Dewey Decimal Classification (DDC)\
Medical Subject Headings (MEeSH)\
ORCID author identifier\
IMDb movie ID\
...

# Wikidata

...

*see talk tomorrow!*

# How we created the handbook

...


# Lessons learned

...cross-media publishing (HTML, PDF & PoD, ePUB...) is possible with Markdown and
Pandoc


# References

paper
: Voß, Jakob (2014). *Collaborative creation of a Wikidata handbook*.
[![](zenodo-11249.png)](http://dx.doi.org/10.5281/zenodo.11249)
book
: Voß, Jakob et al. (2014). *Normdaten in Wikidata*.\
ISBN 978-1-291-85658-3\
urn:nbn:de:bsz:960-opus4-4381
sources
: ..github

# The handbook

* Introduction (Wikidata, authority files)
* Basic Wikidata concepts (items, properties, statements)
* How to search, edit, configure, reuse Wikidata
* Glossary, FAQ, Bibliography

# Project management

* face2face meetings & discussion
* trello for organizing (TODO lists, appointments...)

**Trello / Project Management**

...screenshot...

# How we created the handbook

* Collaborative Writing tool
* Project management
* Continuous delivery

...

# Penflip

* One of several collaborativ writing platforms
* Visual web editor
* Based on Markdown and git


# Continuous delivery

Every edit should automatically build the final book.

**commit** (git) --> **build** (pandoc) --> **deploy** (HTML & PDF)

Not fully supported by current tools.

Layout templating requires skills in LaTeX & HTM/CSS/JS.

# Pandoc & its document model

Conversion between Markdown and other document formats
(HTML, LaTeX, ODT, DOCX, ePUB...)

* Document Model with sections, lists, tables, images...
* References, citations, mathematical equations...

Some custom processing required for specialized content
(e.g. examples)


# Revision & Proofreading

* GitHub issues (not used)
* Penflip issues
* Annotator (not stable)

TODO: image of The Annotator

=> Printed copies


# Lessons learned

...cross-media publishing (HTML, PDF & PoD, ePUB...) is possible with Markdown and
Pandoc

# Shortcomings

Many collaborative writing tools, many limitations.

...
... intrinsic motivation?

* Moving around & rearranging content is poorly supported

# References

book
: Voß, Jakob et al. (2014). *Normdaten in Wikidata*.\
ISBN 978-1-291-85658-3\
urn:nbn:de:bsz:960-opus4-4381
paper
: Voß, Jakob (2014). *Collaborative creation of a Wikidata handbook*.
[![](zenodo-11249.png)](http://dx.doi.org/10.5281/zenodo.11249)
sources
: At GitHub (book, paper & slides)




![](cc-by-sa.png)

slides/vzg-slides
% requires:
% texlive-lang-german
% ...
\documentclass[$if(fontsize)$$fontsize$,$endif$$if(handout)$handout,$endif$$if(beamer)$ignorenonframetext,$endif$]{$documentclass$}

%\usepackage{etex}
%\reserveinserts{28}

$if(theme)$
\usetheme{$theme$}
$endif$

$if(colortheme)$
\usecolortheme{$colortheme$}
$endif$

\usepackage{tikz}
\usepackage{amssymb,amsmath}
\usepackage{ifxetex,ifluatex}
\usepackage{fixltx2e} % provides \textsubscript
\ifxetex
\usepackage{fontspec,xltxtra,xunicode}
\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}

%%% VZG TODO:
% \setmainfont{Calibri}
\setmainfont{DejaVu Serif}

\else
\ifluatex
\usepackage{fontspec}
\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
\else
\usepackage[utf8]{inputenc}
\fi
\fi
$if(natbib)$
\usepackage{natbib}
\bibliographystyle{plainnat}
$endif$
$if(biblatex)$
\usepackage{biblatex}
$if(biblio-files)$
\bibliography{$biblio-files$}
$endif$
$endif$
$if(listings)$
\usepackage{listings}
$endif$
$if(highlighting-macros)$
$highlighting-macros$
$endif$
$if(verbatim-in-note)$
\usepackage{fancyvrb}
$endif$
$if(fancy-enums)$
\usepackage{enumerate}
$endif$
$if(tables)$
\usepackage{ctable}
\usepackage{float} % provides the H option for float placement
$endif$
$if(url)$
\usepackage{url}
$endif$
$if(graphics)$
\usepackage{graphicx}
$endif$

%% VZG:
%\setbeamertemplate{items}[ball]

\definecolor{VZGblau}{RGB}{49,97,163}


ewtranslation[to=ngerman]{Section}{Abschnitt}

\defbeamertemplate{section page}{mine}[1][]{%
\centering
\begin{beamercolorbox}[sep=8pt,center,#1]{section title}
\usebeamerfont{section title}\insertsection\par
\end{beamercolorbox}
}
\setbeamertemplate{section page}[mine]


\usebackgroundtemplate{
\begin{tikzpicture}[remember picture, overlay]

ode[inner sep=0] at (current page.center) {
\includegraphics[width=\paperwidth,height=\paperheight]{vzg-slides-background.png}
};

ode[anchor=south,text=white,yshift=0.5mm] at (current page.south)
{\footnotesize $title$ $if(date)$($date$)$endif$};

ode[anchor=east,text=white,yshift=-31.5mm] at (current page.east)
{\scriptsize \insertframenumber};
\end{tikzpicture}
}
\addtobeamertemplate{title page}{
\begin{tikzpicture}[remember picture, overlay]

ode[inner sep=0] at (current page.center) {
\includegraphics[width=\paperwidth,height=\paperheight]{vzg-slides-titlebackground.png}
};
\end{tikzpicture}
}

\setbeamercolor{structure}{fg=VZGblau}
\setbeamerfont{title}{size=\huge}
\setbeamerfont{subtitle}{size=\Large} %,fg=black}
\setbeamercolor{subtitle}{fg=black}
\setbeamercolor{author}{fg=VZGblau}
\setbeamercolor{date}{fg=VZGblau}

% Comment these out if you don't want a slide with just the
% part/section/subsection/subsubsection title:
\AtBeginPart{\frame{\partpage}}
\AtBeginSection{\frame{\sectionpage}}
\AtBeginSubsection{\frame{\subsectionpage}}
\AtBeginSubsubsection{\frame{\subsubsectionpage}}
$if(strikeout)$
\usepackage[normalem]{ulem}
% avoid problems with \sout in headers with hyperref:
\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
$endif$
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setlength{\emergencystretch}{3em} % prevent overfull lines
$if(numbersections)$
$else$
\setcounter{secnumdepth}{0}
$endif$
$if(verbatim-in-note)$
\VerbatimFootnotes % allows verbatim text in footnotes
$endif$

$if(lang)$
\usepackage[$lang$]{babel}
$else$
%\usepackage[ngerman]{babel}
$endif$

$if(title)$\title{$title$}$endif$
$if(subtitle)$\subtitle{$subtitle$}$endif$
$if(institute)$\institute{$institute$}$endif$
$if(author)$
\author{$for(author)$$author$$sep$ \and $endfor$}
$endif$
$if(date)$
\date{$if(place)$$place$, $endif$$date$}
$endif$

% remove navigation bar
\setbeamertemplate{navigation symbols}{}

\begin{document}

$if(title)$ { \frame{\titlepage} } $endif$

$if(toc)$
\begin{frame}{Übersicht}
\tableofcontents[hideallsubsections]
\end{frame}

$endif$
$body$

$if(natbib)$
$if(biblio-files)$
$if(biblio-title)$
$if(book-class)$
\renewcommand\bibname{$biblio-title$}
$else$
\renewcommand\refname{$biblio-title$}
$endif$
$endif$
\bibliography{$biblio-files$}

$endif$
$endif$
$if(biblatex)$
\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$
$endif$
\end{document}