Merge branch 'paper' into 'master'

Schriftfassung

Closes #3, #4, and #2

See merge request !3

.gitlab-ci.yml

@@ -41,6 +41,17 @@ presentation:
     paths:
       - presentation/presentation.pdf
 
+paper:
+  stage: build
+  script:
+    - make paper/paper.pdf
+  needs:
+    - job: grafiken
+      artifacts: true
+  artifacts:
+    paths:
+      - paper/paper.pdf
+
 package-example:
   stage: build
   image: alpine

Makefile

 # Targets
 
+paper=\
+	paper/paper.pdf
+
 mindmap=\
 	mindmap/MindMap.pdf \
 	mindmap/ProjectGraph.pdf
@@ -7,7 +10,6 @@ mindmap=\
 presentation=\
 	presentation/presentation.pdf
 
-
 versionsgraphen=\
 	grafiken/example-graph.pdf \
 	grafiken/ex1-graph.pdf \
@@ -35,7 +37,7 @@ bilder=\
 	presentation/github-userpage.png \
 	presentation/kinda-sus.png
 
-dokumente=$(mindmap) $(presentation)
+dokumente=$(mindmap) $(presentation) $(paper)
 
 example=\
 	example/Makefile \
@@ -46,7 +48,7 @@ example=\
 	example/workdir/.versions/* \
 	example/README.md
 
-latex=$(mindmap) $(presentation) $(grafiken)
+latex=$(mindmap) $(presentation) $(grafiken) $(paper)
 
 buildirs=$(latex:pdf=out)
 
@@ -64,6 +66,8 @@ mindmap: $(mindmap)
 
 presentation: $(presentation)
 
+paper: $(paper)
+
 
 # Dependencies
 
@@ -73,17 +77,27 @@ $(versionsgraphen) git-object: grafiken/versiongraph.tex
 
 $(presentation): $(grafiken) $(bilder) presentation/theme.tex
 
+$(paper): paper/paper.md $(grafiken)
+paper/paper.md: references.bib
+
 example/example.tar.gz: $(example)
 	tar -acf $@ $^
 
+
 # Generic Recipes
 
+%.tex: %.md
+	pandoc --biblatex -s -o $@ -i $<
+
 %.pdf: %.tex
 	@echo "make: Entering directory '$(@D)'"
 	cd $(@D) && \
-		latexrun --latex-cmd lualatex -o $(@F) -O $(*F).out $(<F)
+		latexrun \
+			--latex-cmd lualatex \
+			--bibtex-cmd biber \
+			-o $(@F) -O $(*F).out $(<F)
 	@echo "make: Leaving directory '$(@D)'"
-	touch -c $@ # latexrun quirk
+	@touch -c $@ # latexrun quirk
 
 %.gif: %.pdf
 	convert \
@@ -102,6 +116,8 @@ clean: polish
 
 polish:
 	rm -rf $(buildirs)
+	rm -rf paper/paper.bib
+
 
 
 # Docker
@@ -115,4 +131,4 @@ docker: .docker
 with-docker: | docker
 	docker run --rm -v ${PWD}:/build:rw $${DOCKER_TAG:-itt:latest} "make -C /build $(RULE)"
 
-.PHONY: presentation mindmap clean docker polish
+.PHONY: paper presentation mindmap clean docker polish

README.md

@@ -7,6 +7,7 @@ Sammlung aller Quellen, sowie MindMap über Themen/Begriffe.
   * [MindMap][mindmap pdf]
   * [ProjectGraph][projectgraph pdf]
   * [Präsentation][slides]
+  * [Schriftfassung][paper]
   * [Ausführbares Beispiel][example]
 
 ## Mind Map
@@ -80,6 +81,8 @@ Sammlung aller Quellen, sowie MindMap über Themen/Begriffe.
 	https://git.cs.uni-paderborn.de/lukasngl/itt/-/jobs/artifacts/master/raw/mindmap/ProjectGraph.pdf?job=mindmap
 [slides]:
 	https://git.cs.uni-paderborn.de/lukasngl/itt/-/jobs/artifacts/master/raw/presentation/presentation.pdf?job=presentation
+[paper]:
+	https://git.cs.uni-paderborn.de/lukasngl/itt/-/jobs/artifacts/master/raw/paper/paper.pdf?job=paper
 [example]:
 	https://git.cs.uni-paderborn.de/lukasngl/itt/-/jobs/artifacts/master/raw/example/example.tar.gz?job=package-example
 [projectgraph preview]:

literatur.yaml

+references:
+- id: hamano2006
+  title: GIT--A stupid content tracker
+  author:
+  - family: Hamano
+    given: Junio C
+  issued: 2006
+  container-title: Proc. Ottawa Linux Sympo
+  page: 385-394
+  type: article-journal
+  volume: 1
+
+- id: chacon2014
+  title: Pro Git
+  author:
+  - family: Chacon
+    given: Scott
+  - family: Straub
+    given: Ben
+  issued: 2014
+  publisher: Apress
+  type: book
+
+- id: haenel2015
+  title: "Git: Verteilte Versionsverwaltung für Code und Dokumente"
+  author:
+  - family: Haenel
+    given: Valentin
+  - family: Plenz
+    given: Julius
+  issued: 2015
+  publisher: Open Source Press
+  title-short: Git
+  type: book
+
+- id: blishak2016
+  title: A Quick Introduction to Version Control with Git and GitHub
+  author:
+  - family: Blischak
+    given: John D.
+  - family: Davenport
+    given: Emily R.
+  - family: Wilson
+    given: Greg
+  container-title: PLOS Computational Biology
+  issued: 2016
+  page: e1004668
+  type: article-journal
+  volume: 12
+
+- accessed: 2021-10-16
+  id: herron2019
+  issued: 2019
+  author:
+    - family: Herron
+      given: David
+  type: webpage
+  url: "https://towardsdatascience.com/why-git-and-git-lfs-is-not-enough-to-solve-the-machine-learning-reproducibility-crisis-f733b49e96e8"
+
+- id: perkel2016
+  title: "Democratic databases: science on GitHub"
+  author:
+  - family: Perkel
+    given: Jeffrey
+  container-title: Nature
+  issued: 2016-10-01
+  page: 127-128
+  title-short: Democratic databases
+  type: article-journal
+  volume: 538
+
+- id: baerisch2005
+  title: Versionskontrollsysteme in der Softwareentwicklung
+  author:
+  - family: Baerisch
+    given: Stefan
+  container-title: IZ-Arbeitsbericht
+  issued: 2005
+  page: 97
+  type: article-journal
+  volume: 36
+
+- id: gitman
+  title: Git Manual
+  author: Git Manual
+  url: "https://git-scm.com/docs/"
+  issued: 2021
+  accessed: 2021-10-30
+  type: webpage
+
+- id: silva2020
+  title: Detecting Semantic Conflicts via Automated Behavior Change
+  author:
+  - family: Silva
+    given: Leuson Da
+  - family: Borba
+    given: Paulo
+  - family: Mahmood
+    given: Wardah
+  - family: Berger
+    given: Thorsten
+  - family: Moisakis
+    given: João
+  container-title: 2020 IEEE International Conference on Software
+    Maintenance and Evolution (ICSME)
+  doi: 10.1109/ICSME46990.2020.00026
+  issued: 2020
+  page: 174-184
+    Detection
+  type: paper-conference
+
+- id: devsurvey
+  title: StackOverflow Developer Survey
+  author: StackOverflow
+  issued: 2018
+  url: "https://insights.stackoverflow.com/survey/2018#work-_-version-control"
+  accessed: 2021-12-10
+  type: webpage
+

paper/references.bib

+../references.bib
\ No newline at end of file

references.bib

 @article{hamano2006,
-  title={GIT--A stupid content tracker},
-  author={Hamano, Junio C},
-  journal={Proc. Ottawa Linux Sympo},
-  volume={1},
-  pages={385--394},
-  year={2006},
-  publisher={Citeseer}
+	title={GIT--A stupid content tracker},
+	author={Hamano, Junio C},
+	journal={Proc. Ottawa Linux Sympo},
+	volume={1},
+	pages={385--394},
+	year={2006},
 }
+
 @book{chacon2014,
 	author = {Chacon, Scott and Straub, Ben},
 	title = {Pro Git},
 	year = {2014},
 	publisher = {Apress}
 }
+
 @book{haenel2015,
 	author = {Haenel, Valentin and Plenz, Julius},
-  title = {Git},
+	title = {Git},
 	subtitle = {Verteilte Versionsverwaltung für Code und Dokumente},
 	year = {2015},
 	publisher = {Open Source Press}
 }
+
 @article{blishak2016,
- author = {Blischak, John D. and Davenport, Emily R. and Wilson, Greg},
- doi = {10.1371/journal.pcbi.1004668},
- journal = {PLOS Computational Biology},
- keywords = {},
- number = {1},
- pages = {e1004668},
- title = {A Quick Introduction to Version Control with Git and GitHub},
- url = {https://journals.plos.org/ploscompbiol/article/file?id=10.1371/journal.pcbi.1004668},
- volume = {12},
- year = {2016}
+	author = {Blischak, John D. and Davenport, Emily R. and Wilson, Greg},
+	doi = {10.1371/journal.pcbi.1004668},
+	journal = {PLOS Computational Biology},
+	keywords = {},
+	number = {1},
+	pages = {e1004668},
+	title = {A Quick Introduction to Version Control with Git and GitHub},
+	volume = {12},
+	year = {2016}
 }
+
 @online{herron2019,
-  title={Why Git and Git-LFS is not enough to solve the Machine Learning Reproducibility crisis},
-  url={https://towardsdatascience.com/why-git-and-git-lfs-is-not-enough-to-solve-the-machine-learning-reproducibility-crisis-f733b49e96e8},
-  urldate=16.10.2021},
+	url={https://towardsdatascience.com/why-git-and-git-lfs-is-not-enough-to-solve-the-machine-learning-reproducibility-crisis-f733b49e96e8},
+	urldate={2021-10-16},
 }
+
 @article{perkel2016,
-  author="Perkel, Jeffrey",
-  title="Democratic databases: science on GitHub",
-  journal="Nature",
-  year="2016",
-  month="Oct",
-  day="01",
-  volume="538",
-  number="7623",
-  pages="127--128",
-  abstract="Scientists are turning to a software--development site to share data and code.",
-  issn="1476-4687",
-  doi="10.1038/538127a",
-  url="https://doi.org/10.1038/538127a"
+	author="Perkel, Jeffrey",
+	title="Democratic databases: science on GitHub",
+	journal="Nature",
+	year="2016",
+	month="10",
+	day="01",
+	volume="538",
+	number="7623",
+	pages="127--128",
+	abstract="Scientists are turning to a software--development site to share data and code.",
+	issn="1476-4687",
+	doi="10.1038/538127a",
 }
-@book{baerisch2005,
- title = {Versionskontrollsysteme in der Softwareentwicklung},
- author = {Baerisch, Stefan},
- year = {2005},
- series = {IZ-Arbeitsbericht},
- pages = {97},
- volume = {36},
- address = {Bonn},
- publisher = {Informationszentrum Sozialwissenschaften},
- issn = {1431-6943},
- url = {https://nbn-resolving.org/urn:nbn:de:0168-ssoar-50733-4},
+
+@article{baerisch2005,
+	title = {Versionskontrollsysteme in der Softwareentwicklung},
+	author = {Baerisch, Stefan},
+	year = {2005},
+	series = {IZ-Arbeitsbericht},
+	pages = {97},
+	volume = {36},
+	publisher = {Informationszentrum Sozialwissenschaften},
 }
+
 @online{gitman,
-  title={Git - Reference},
-  url={https://git-scm.com/docs/},
-  urldate=30.10.2021},
+	url={https://git-scm.com/docs/},
+	urldate={2021-10-30},
 }
-@inproceedings{silve2020,
-  author={Silva, Leuson Da and Borba, Paulo and Mahmood, Wardah and Berger, Thorsten and Moisakis, João},
-  booktitle={2020 IEEE International Conference on Software Maintenance and Evolution (ICSME)},
-  title={Detecting Semantic Conflicts via Automated Behavior Change Detection},
-  year={2020},
-  volume={},
-  number={},
-  pages={174-184},
-  doi={10.1109/ICSME46990.2020.00026}
-  url = {https://ieeexplore.ieee.org/document/9240661},
+
+@inproceedings{silva2020,
+	author={Silva, Leuson Da and Borba, Paulo and Mahmood, Wardah and Berger, Thorsten and Moisakis, João},
+	booktitle={2020 IEEE International Conference on Software Maintenance and Evolution (ICSME)},
+	title={Detecting Semantic Conflicts via Automated Behavior Change Detection},
+	year={2020},
+	volume={},
+	number={},
+	pages={174-184},
+	doi={10.1109/ICSME46990.2020.00026}
+}
+
+@online{devsurvey,
+	url={https://insights.stackoverflow.com/survey/2018#work-_-version-control},
+	urldate={2021-10-30},
 }