Library Carpentry, Universitätsbibliothek Leipzig

04. - 05. November 2019

09:00 - 16:30

Instructors: Martin Czygan, Ronny Gey, Tracy Hoffmann, Peter Mühleder, Florian Rämisch

Helpers: Stefan Dombek, Istvan-Tibor Nebel

Allgemeine Informationen

Library Carpentry wird von Personen mit bibliothekarischem und informationswissenschaftlichem Hintergrund organisiert, um Ihnen zu helfen:

Library Carpentry führt Sie in die Grundlagen der Datenverarbeitung ein und bietet Ihnen eine Plattform für weiteres selbstorganisiertes Lernen. Für weitere Informationen darüber, was wir unterrichten und warum, lesen Sie bitte unsere Veröffentlichung. "Library Carpentry: software skills training for library professionals".

Wer: Der Kurs richtet sich an Personen, die in bibliothekarischen und informationsbezogenen Funktionen tätig sind. Sie müssen keine Vorkenntnisse über die Werkzeuge haben, die auf dem Workshop vorgestellt werden.

Wo: Schulungsraum (1. OG) der Bibliothek Medizin/Naturwissenschaften, Liebigstraße 23/25, 04103 Leipzig. Wegbeschreibung mit OpenStreetMap oder Google Maps.

Wann: 04. - 05. November 2019. Add to your Google Calendar.

Anforderungen: Die Teilnehmer müssen einen Laptop mit einem Mac-, Linux- oder Windows-Betriebssystem (kein Tablett, Chromebook usw.) mitbringen, auf dem sie über Administratorrechte verfügen. Sie sollten ein paar spezifische Softwarepakete installiert haben (aufgeführt hier).

Verhaltenskodex: Jeder, der an einer Carpentries-Veranstaltung teilnimmt, ist verpflichtet, sich an den Verhaltenskodex zu halten. Dieses Dokument beschreibt auch, wie man bei Bedarf einen Vorfall melden kann.

Zugang: Wir sind bestrebt, diesen Workshop für alle zugänglich zu machen. Die Organisatoren des Workshops haben überprüft, dass:

Die Materialien werden vor dem Workshop zur Verfügung gestellt und bei Bedarf können großformatige Handzettel gereicht werden, was den Organisatoren vorab mitgeteilt werden sollte. Um Ihnen das Lernen zu erleichtern (z.B. Gebärdensprachdolmetscher, Vorkehrungen für stillende Mütter), bitten wir Sie, uns vorab zu informieren. Nehmen Sie Kontakt auf (unter Verwendung der untenstehenden Kontaktdaten) und wir werden versuchen, Ihnen weiterzuhelfen.

Zahlungsinformationen: 60 € (VDB-Mitglieder) bzw. 120 € (Nichtmitglieder). (Weitere Informationen: https://www.vdb-online.org/landesverbaende/sst/)

Anmeldung: Per Mail bis 21.10.2019 an rv.sa-sa-thue@vdb-online.org.

Organisation: Wir freuen uns über die finanzielle Unterstützung dieses Workshops durch den VDB (Verein Deutscher Bibliothekarinnen und Bibliothekare). Der Workshop wird gemeinsam vom Regionalverband Sachsen - Sachsen-Anhalt - Thüringen und der Universitätsbibliothek Leipzig organisiert.

Kontakt: Sie erreichen uns unter gey@ub.uni-leipzig.de oder czygan@ub.uni-leipzig.de für weitere Informationen.


VDB UB Leipzig


Umfragen

Bitte stellen Sie sicher, dass Sie diese Umfragen vor und nach dem Workshop ausfüllen (Umfragen auf Englisch).

Umfrage vor dem Workshop

Umfrage nach dem Workshop


Schedule

Tag 1

08:30 Notfall-Laptop-Setup
09:00 Ankommen und Begrüßung
09:30 Einführung Library Carpentry
10:00 Shell
11:30 Mittagspause
12:30 Python
14:30 Nachmittagspause
16:00 Zusammenfassung
16:30 ENDE

Tag 2

09:00 Git
10:30 Frühstückspause
12:00 Mittagspause
13:00 OpenRefine
14:30 Nachmittagspause
16:00 Zusammenfassung
16:30 ENDE

Wir werden dieses kollaborative Dokument zum Chatten, Notieren und Teilen von URLs und Code verwenden.


Ablauf

The Unix Shell

  • Files and Directories
  • History and Tab Completion
  • Counting and Sorting Contents in Files
  • Pipes and Redirection
  • Reference...

Introduction to Python

  • Introduction to Python
  • Variables
  • Data types
  • Lists
  • Functions
  • Conditions
  • Reference...

Version control with Git

  • Creating a repository
  • Configuring Git
  • Recording Changes to Files: add, commit, ...
  • Viewing State Changes with status
  • Working on the Web: clone, pull, push, ...
  • Where to Host Work, and Why
  • Reference...

OpenRefine

  • Introduction to OpenRefine
  • Importing Data
  • Basic Functions
  • Advanced Functions
  • Reference...

Setup

Um an einem Library Carpentry Workshop teilzunehmen, benötigen Sie Zugriff auf die unten beschriebene Software. Außerdem benötigen Sie einen aktuellen Webbrowser. Die Installationsanleitungen sind momentan lediglich auf Englisch verfügbar.

Wir führen eine Liste der häufigsten Probleme, die während der Installation auftreten können: Wiki-Seite Konfigurationsprobleme und Lösungen.

Die Bash Shell

Bash ist eine häufig verwendete Shell, die Ihnen die Möglichkeit gibt, einfache Aufgaben schneller zu erledigen.

Video Tutorial
  1. Download the Git for Windows installer.
  2. Run the installer and follow the steps below:
    1. Click on "Next" four times (two times if you've previously installed Git). You don't need to change anything in the Information, location, components, and start menu screens.
    2. Select "Use the nano editor by default" and click on "Next".
    3. Keep "Git from the command line and also from 3rd-party software" selected and click on "Next". If you forgot to do this programs that you need for the workshop will not work properly. If this happens rerun the installer and select the appropriate option.
    4. Click on "Next".
    5. Select "Use the native Windows Secure Channel library", and click "Next".
    6. Keep "Checkout Windows-style, commit Unix-style line endings" selected and click on "Next".
    7. Select "Use Windows' default console window" and click on "Next".
    8. Leave all three items selected, and click on "Next".
    9. Do not select the experimental option. Click "Install".
    10. Click on "Finish".
  3. If your "HOME" environment variable is not set (or you don't know what this is):
    1. Open command prompt (Open Start Menu then type cmd and press [Enter])
    2. Type the following line into the command prompt window exactly as shown:

      setx HOME "%USERPROFILE%"

    3. Press [Enter], you should see SUCCESS: Specified value was saved.
    4. Quit command prompt by typing exit then pressing [Enter]

This will provide you with both Git and Bash in the Git Bash program.

The default shell in all versions of macOS is Bash, so no need to install anything. You access Bash from the Terminal (found in /Applications/Utilities). See the Git installation video tutorial for an example on how to open the Terminal. You may want to keep Terminal in your dock for this workshop.

The default shell is usually Bash, but if your machine is set up differently you can run it by opening a terminal and typing bash. There is no need to install anything.

Git

Git ist ein Versionskontrollsystem, mit dem Sie verfolgen können, wer wann welche Änderungen vorgenommen hat. Es verfügt über Optionen, um freigegebene oder öffentliche Versionen Ihres Quellcodes auf github.com einfach zu aktualisieren. Sie benötigen einen unterstützten Webbrowser.

Sie benötigen ein Konto unter github.com für Teile des Git-Workshops. GitHub-Basiskonten sind kostenlos. Wir empfehlen Ihnen, ein GitHub-Konto zu erstellen, wenn Sie noch kein Konto haben. Bitte überlegen Sie, welche persönlichen Daten Sie preisgeben möchten. Zum Beispiel können Sie Sich diese Anleitung ansehen, um Ihre E-Mail-Adresse privat zu halten, die Sie bei GitHub nutzen.

Git should be installed on your computer as part of your Bash install (described above).

Video Tutorial

For OS X 10.9 and higher, install Git for Mac by downloading and running the most recent "mavericks" installer from this list. Because this installer is not signed by the developer, you may have to right click (control click) on the .pkg file, click Open, and click Open on the pop up window. After installing Git, there will not be anything in your /Applications folder, as Git is a command line program. For older versions of OS X (10.5-10.8) use the most recent available installer labelled "snow-leopard" available here.

If Git is not already available on your machine you can try to install it via your distro's package manager. For Debian/Ubuntu run sudo apt-get install git and for Fedora run sudo dnf install git.

Text Editor

Wenn Sie Code schreiben, ist es sehr nützlich, einen Texteditor zu haben, der für das Schreiben von Code optimiert ist, mit Funktionen wie der automatischen Farbcodierung von Schlüsselwörtern. Der Standard-Text-Editor unter MacOS und Linux ist normalerweise auf Vim eingestellt, der nicht gerade für seine intuitive Bedienung bekannt ist. Wenn Sie versehentlich darin stecken geblieben sind, drücken Sie die Taste Esc, gefolgt von :+Q+! (Doppelpunkt, Kleinbuchstabe 'q', Ausrufezeichen) und drücken Sie dann Return, um zur Shell zurückzukehren.

nano is a basic editor and the default that instructors use in the workshop. It is installed along with Git.

Others editors that you can use are Notepad++ or Sublime Text. Be aware that you must add its installation directory to your system path. Please ask your instructor to help you do this.

nano is a basic editor and the default that instructors use in the workshop. See the Git installation video tutorial for an example on how to open nano. It should be pre-installed.

Others editors that you can use are BBEdit or Sublime Text.

nano is a basic editor and the default that instructors use in the workshop. It should be pre-installed.

Others editors that you can use are Gedit, Kate or Sublime Text.

Python

Python ist eine beliebte Sprache für die Verarbeitung von Forschungsdaten und eignet sich auch hervorragend für allgemeine Programmieraufgaben. Die Einzelinstallation aller Forschungspakete kann etwas schwierig sein, daher empfehlen wir Anaconda, einen All-in-One-Installer.

Unabhängig davon, wie Sie sich für die Installation entscheiden, stellen Sie bitte sicher, dass Sie Python Version 3.x installieren (z.B. 3.6 ist in Ordnung).

Wir unterrichten Python mit dem Jupyter Notebook, eine Programmierumgebung, die in einem Webbrowser läuft. Damit dies funktioniert, benötigen Sie einen aktuellen Browser. Die aktuellen Versionen der Chrome, Safari und der Firefox-Browser werden alle unterstützt (einige ältere Browser, einschließlich Internet Explorer Version 9 und älter, werden nicht unterstützt).

  1. Open https://www.anaconda.com/download/#linux with your web browser.
  2. Download the Python 3 installer for Linux.
    (The installation requires using the shell. If you aren't comfortable doing the installation yourself stop here and request help at the workshop.)
  3. Open a terminal window.
  4. Type
    bash Anaconda3-
    and then press Tab. The name of the file you just downloaded should appear. If it does not, navigate to the folder where you downloaded the file, for example with:
    cd Downloads
    Then, try again.
  5. Press Return. You will follow the text-only prompts. To move through the text, press Spacebar. Type yes and press enter to approve the license. Press enter to approve the default location for the files. Type yes and press enter to prepend Anaconda to your PATH (this makes the Anaconda distribution the default Python).
  6. Close the terminal window.

OpenRefine

Für diese Lektion benötigen Sie OpenRefine und einen Webbrowser. Hinweis: Dies ist ein Java-Programm, das auf Ihrem Rechner läuft (nicht in der Cloud). Es läuft in einem Webbrowser, aber es wird keine Internetverbindung benötigt.

Check that you have either the Firefox or the Chrome browser installed and set as your default browser. OpenRefine runs in your default browser. It will not run correctly in Internet Explorer.

Download software from http://openrefine.org/

Create a new directory called OpenRefine.

Unzip the downloaded file into the OpenRefine directory by right-clicking and selecting "Extract ...".

Go to your newly created OpenRefine directory.

Launch OpenRefine by clicking openrefine.exe (this will launch a command prompt window, but you can ignore that - just wait for OpenRefine to open in the browser).

If you are using a different browser, or if OpenRefine does not automatically open for you, point your browser at http://127.0.0.1:3333/ or http://localhost:3333 to use the program.

Check that you have either the Firefox or the Chrome browser installed and set as your default browser. OpenRefine runs in your default browser. It may not run correctly in Safari.

Download software from http://openrefine.org/.

Create a new directory called OpenRefine.

Unzip the downloaded file into the OpenRefine directory by double-clicking it.

Go to your newly created OpenRefine directory.

Launch OpenRefine by dragging the icon into the Applications folder.

Use Ctrl-click/Open ... to launch it.

If you are using a different browser, or if OpenRefine does not automatically open for you, point your browser at http://127.0.0.1:3333/ or http://localhost:3333 to use the program.

Check that you have either the Firefox or the Chrome browser installed and set as your default browser. OpenRefine runs in your default browser.

Download software from http://openrefine.org/.

Make a directory called OpenRefine.

Unzip the downloaded file into the OpenRefine directory.

Go to your newly created OpenRefine directory.

Launch OpenRefine by entering ./refine into the terminal within the OpenRefine directory.

If you are using a different browser, or if OpenRefine does not automatically open for you, point your browser at http://127.0.0.1:3333/ or http://localhost:3333 to use the program.