Binder eingerichtet und Materialien für Tag 1 (25.09.19)

2019-09-23 23:59:32 +02:00 · 2019-09-23 23:59:32 +02:00 · 9534565449
parent ce73fbe5a3
commit 9534565449
3 changed files with 185 additions and 2 deletions
--- a/README.md
+++ b/README.md
@ -10,18 +10,58 @@ Dieses Skript entsteht in der Zeit von September 2019 bis Januar 2020 im Rahmen

 ## Arbeitsumgebung

-Wir nutzen die Software [VirtualBox](https://www.virtualbox.org/), die es Ihnen ermöglicht, einen Webserver auf ihrem Computer zu installieren, ohne dass Ihr gewohntes Betriebssystem verändert wird. Sie erhalten für jede Lehreinheit eine vorkonfigurierte virtuelle Maschine, um ohne langwierige Installation die Programme ausprobieren zu können. Learning by doing.
+Wir nutzen eine vorkonfigurierte Arbeitsumgebung mit [JupyterLab](https://jupyterlab.readthedocs.io). Diese Arbeitsumgebung können Sie auf zwei Wegen nutzen:

-**Voraussetzung:** Sie benötigen einen Computer, der einigermaßen aktuell ist (etwa ab Baujahr 2013), über mindestens 4 GB RAM verfügt und auf dem Sie Software installieren können (Windows, macOS oder Linux).
+### Option 1: Binder
+
+Klicken Sie den folgenden Button an, um eine neue Arbeitsumgebung auf einem Cloud-Server des [Binder](https://mybinder.org/)-Projekts zu starten:
+
+[![Launch Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/felixlohmeier/jupyter-stacks/master?urlpath=lab/tree/home/jovyan)
+
+Bei diesem kostenfrei und ohne Registrierung nutzbaren Angebot, sind folgende [Einschränkungen](https://mybinder.readthedocs.io/en/latest/faq.html#how-much-memory-am-i-given-when-using-binder) zu beachten:
+
+* Beschränkt auf 1-2 GB Arbeitsspeicher; bei höherer Auslastung erfolgt ein Neustart.
+* Nach 10 Minuten Inaktivität wird der Server gelöscht. Um das zu vermeiden, reicht es aus, das Browserfenster geöffnet zu lassen.
+* Eine Session sollte maximal 12 Stunden dauern. Danach kann es zum Abbruch der Session kommen.
+
+### Option 2: VirtualBox
+
+Die Software [VirtualBox](https://www.virtualbox.org/) ermöglicht es Ihnen, verschiedene Arbeitsumgebungen auf Ihrem Computer zu installieren, ohne dass Ihr gewohntes Betriebssystem verändert wird. VirtualBox ist kostenfrei für Windows, macOS und Linux erhältlich.
+
+Laden Sie VirtualBox von der Webseite herunter, installieren Sie das Programm und importieren Sie dann die folgende Virtual Appliance:
+
+(Link zum Download folgt...)
+
+## Gemeinsames Dokument
+
+Für Notizen und zum Austausch verwenden wir ein gemeinsames Dokument in einer [CodiMD](https://github.com/codimd/server)-Installation [bei der GWDG](https://pad.gwdg.de/). Alle, die den Link kennen, können es bearbeiten. Zur Formatierung wird [Markdown](https://de.wikipedia.org/wiki/Markdown) verwendet.
+
+* [Gemeinsames Dokument](https://pad.gwdg.de/7X8eCDVoQB2Ng6DZlG40LQ?both)

 ## Inhalte

 1. 25.09.2019: Installation und Grundlagen
+   - Vorstellungsrunde und Organisatorisches
+   - Einführung in Markdown und CodiMD:
+     - [Präsentation zu CodiMD](https://felixlohmeier.de/slides/2019-06-13_oercamp-reader.html)
+     - [Markdown Tutorial](https://www.markdowntutorial.com/)
+   - Einführung in die Arbeitsumgebung JupyterLab:
+     - Mike Driscoll (2019-04-17): [Getting Started With JupyterLab](https://dzone.com/articles/getting-started-with-jupyterlab)
+   - Einführung in die Kommandozeile:
+     - Library Carpentry Lesson Unix Shell: [Vorschau mit nbviewer](https://nbviewer.jupyter.org/github/felixlohmeier/bibliotheks-und-archivinformatik/notebooks/01-lc-shell.ipynb) | [Launch Binder](https://mybinder.org/v2/gh/felixlohmeier/jupyter-stacks/master?urlpath=lab/tree/home/jovyan/notebooks/01-lc-shell.ipynb)
+   - VirtualBox installieren
+   - Aufgabe: Blog einrichten für Lerntagebuch
+
 2. 09.10.2019: Bibliothekssystem Koha
+
 3. 30.10.2019: Archivsystem ArchivesSpace
+
 4. 06.11.2019: Repository-Software DSpace-CRIS
+
 5. 13.11.2019: Metadaten transformieren mit OpenRefine und MarcEdit
+
 6. 27.11.2019: Discovery-System VuFind und Suchmaschine Solr
+
 7. 11.12.2019: Linked Data und Fazit

 ## Lerntagebücher
--- a/binder/Dockerfile
+++ b/binder/Dockerfile
@ -0,0 +1,22 @@
+FROM jupyter/minimal-notebook:1386e2046833
+LABEL maintainer="felixlohmeier@opencultureconsulting.com"
+
+USER root
+
+# Install bash_kernel and jupyter-server-proxy
+RUN conda install --quiet --yes -c conda-forge \
+    'bash_kernel=0.7.2' \
+    'jupyter-server-proxy=1.1.0' \
+    && conda clean --all -f -y
+
+# grant root privileges to user jovyan
+RUN sed -i -e 's/^#%sudo/%sudo/' /etc/sudoers && \
+    echo 'jovyan ALL=(ALL) NOPASSWD: ALL' >> /etc/sudoers && \
+    usermod -a -G root jovyan
+
+# copy repository content
+RUN rm -r ${HOME}/*
+COPY . ${HOME}
+RUN chown -R 1000 ${HOME}
+
+USER 1000
--- a/notebooks/01-lc-shell.ipynb
+++ b/notebooks/01-lc-shell.ipynb
@ -0,0 +1,121 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Library Carpentry: Unix Shell"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<https://librarycarpentry.org/lc-shell/>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Setup"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Archiv `shell-lesson.zip` von Library Carpentry herunterladen"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "--2019-09-02 20:49:57--  https://librarycarpentry.org/lc-shell/data/shell-lesson.zip\n",
+      "Resolving librarycarpentry.org (librarycarpentry.org)... 185.199.110.153, 185.199.108.153, 185.199.111.153, ...\n",
+      "Connecting to librarycarpentry.org (librarycarpentry.org)|185.199.110.153|:443... connected.\n",
+      "HTTP request sent, awaiting response... 200 OK\n",
+      "Length: 35142014 (34M) [application/zip]\n",
+      "Saving to: ‘shell-lesson.zip’\n",
+      "\n",
+      "shell-lesson.zip    100%[===================>]  33,51M  4,83MB/s    in 7,5s    \n",
+      "\n",
+      "2019-09-02 20:50:05 (4,46 MB/s) - ‘shell-lesson.zip’ saved [35142014/35142014]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "wget https://librarycarpentry.org/lc-shell/data/shell-lesson.zip"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Archiv in den Ordner `shell-lesson` entpacken und Archiv löschen"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Archive:  shell-lesson.zip\n",
+      "  inflating: shell-lesson/000003160_01_text.json  \n",
+      "  inflating: shell-lesson/2014-01-31_JA-africa.tsv  \n",
+      "  inflating: shell-lesson/2014-01-31_JA-america.tsv  \n",
+      "  inflating: shell-lesson/2014-01_JA.tsv  \n",
+      "  inflating: shell-lesson/2014-02-02_JA-britain.tsv  \n",
+      "  inflating: shell-lesson/33504-0.txt  \n",
+      "  inflating: shell-lesson/829-0.txt  \n",
+      "  inflating: shell-lesson/diary.html  \n",
+      "  inflating: shell-lesson/pg514.txt  \n"
+     ]
+    }
+   ],
+   "source": [
+    "unzip shell-lesson.zip -d shell-lesson && rm shell-lesson.zip"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Los geht's..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Bash",
+   "language": "bash",
+   "name": "bash"
+  },
+  "language_info": {
+   "codemirror_mode": "shell",
+   "file_extension": ".sh",
+   "mimetype": "text/x-sh",
+   "name": "bash"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}