minor changes

src/01_setup/agenda.qmd

@@ -8,13 +8,13 @@ Im zweiten Schritt werden wir in einem Notebook mit Hilfe großer Sprachmodelle
 
 Schließlich, im letzten Schritt, sollen die erlernten Kenntnisse auf konkrete Anwendungsfälle angewandt werden, um die praktische Nutzung und den Mehrwert dieser Techniken zu demonstrieren.
 
-### Zeitplan
+### Ablauf
 
-- 1 Begrüßung und Einführung 16:00 Uhr
-- 2 No Code Tutorials 
-- 3 Low Code Tutorials
-- 4 Anwendungsfälle 
-- 5 Abschluss und Ausblick 18:20 Uhr
+1. Begrüßung und Einführung ab 16:00 Uhr
+2. No Code Tutorials 
+3. Low Code Tutorials
+4. Anwendungsfälle 
+5. Abschluss und Ausblick ca. 18:20 Uhr
 
 ### Flussdiagramm Tutorials
 

src/01_setup/erforderlich/colab.qmd

@@ -7,20 +7,14 @@ image: _c6cbaab4-a264-43bf-8b0f-311e210cd959.jpeg
 ## Google Colab nutzen
 
 ### 1: Öffne Google Colab
-
-* **Gehe zu Google Colab**:
    - Besuche [Google Colab](https://colab.research.google.com/).
    - Melde dich mit deinem Google-Konto an, falls erforderlich.
 
 ### 2: Neues Notebook erstellen
-
-* **Erstelle ein neues Notebook**:
    - Klicke auf "Datei" in der oberen linken Ecke.
    - Wähle "Neues Notebook".
 
 ### 3: Upload von Dateien 📁
-
-* **Dateien hochladen**:
    - Klicke im linken Seitenbereich auf das Ordnersymbol.
    - Klicke auf das Upload-Symbol (Pfeil nach oben) und wähle die Dateien aus, die du hochladen möchtest.
 
@@ -55,7 +49,7 @@ image: _c6cbaab4-a264-43bf-8b0f-311e210cd959.jpeg
 
 ## ChatGPT für die Code-Erstellung 📝
 
-Um Sprachmodelle optimal zu nutzen, ist es wichtig, klare und präzise Prompts zu erstellen. Ein guter Prompt enthält alle notwendigen Informationen, die ChatGPT benötigt, um eine hilfreiche Antwort zu geben.
+Um Sprachmodelle zu nutzen, helfen klare und präzise Prompts. Ein guter Prompt enthält alle notwendigen Informationen.
 
 #### Prompterstellung:
 

src/01_setup/vorbereitung.qmd

@@ -13,31 +13,35 @@ Einrichten der Nutzerkonten zur Nutzung der kostenlosen Ressourcen Google Colab
 
 ## Inhaltliche Vorbereitung
 
-**Wählt eine Webseite aus, über die ihr mehr erfahren möchtet.**
-
+::: {.callout-note collapse="true"}
+### Wählt eine Webseite aus, über die ihr mehr erfahren möchtet.
 * "Ich möchte Informationen über die Webseite 'Avaaz' sammeln, um mehr über globale Kampagnen zu erfahren."
 * "Ich bin daran interessiert, mehr über 'Change.org' zu lernen, insbesondere im Hinblick auf Petitionen und deren Wirkung."
 * "Die Webseite 'Amnesty International' interessiert mich, da ich dort viele Ressourcen zu Menschenrechten finde."
+:::
 
-**Denkt über einen Themenbereich nach, über den ihr gerne PDFs recherchieren würdet.**
-
+::: {.callout-note collapse="true"}
+### Denkt über einen Themenbereich nach, über den ihr gerne PDFs recherchieren würdet.
 * "Ich möchte PDFs über Strategien zur Förderung von Partizipation und Demokratie recherchieren."
 * "Ich suche nach PDFs, die sich mit den Auswirkungen von Klimawandel auf soziale Gerechtigkeit befassen."
 * "PDFs über die Rolle und Organisation von NGOs in globalen Kontexten interessieren mich."
+:::
 
-**Überlegt euch einen Bereich, über den ihr euch gerne über Apps informieren lassen möchtet.**
-
+::: {.callout-note collapse="true"}
+### Überlegt euch einen Bereich, über den ihr euch gerne über Apps informieren lassen möchtet.
 * "Ich möchte Apps kennenlernen, die zur Unterstützung von Gemeinschaftsprojekten beitragen."
 * "Ich interessiere mich für Apps, die den Austausch und die Vernetzung von Aktivisten erleichtern."
 * "Apps, die zur Mobilisierung und Organisation von Bürger*inneninitiativen nützlich sind, interessieren mich."
+:::
 
-**Bringt eine Liste von YouTube-Videos oder eine YouTube-Playliste mit, deren Umfang eure erfügbare Zeit strapazieren würde und sich daher für Zusammenfassungen anbietet.**
-
+::: {.callout-note collapse="true"}
+### Bringt eine Liste von YouTube-Videos oder eine YouTube-Playliste mit, deren Umfang eure erfügbare Zeit strapazieren würde und sich daher für Zusammenfassungen anbietet.
 * "Eine Playlist von Vorträgen über globale Klimapolitik von verschiedenen internationalen Konferenzen, die zusammen mehrere Stunden dauern."
 * "Ein Kanal, der ausführliche Dokumentationen über Menschenrechtsverletzungen weltweit zeigt, wobei jedes Video mindestens eine Stunde lang ist."
 * "Eine Serie von Interviews mit zivilgesellschaftlichen Akteuren und Experten zum Thema Demokratieförderung, die insgesamt einen ganzen Tag ansehen würde."
 * "Lange Diskussionsrunden und Panelgespräche über soziale Gerechtigkeit, die aufgrund ihrer Tiefe und Länge schwer in einer Sitzung zu bearbeiten sind."
 * "Eine Sammlung von Workshops und Tutorials zu organisatorischen Strategien für NGOs, die zusammen mehrere Tage in Anspruch nehmen würden."
+:::
 
 ## Nutzerkonten einrichten 
 

src/02_basics/webspider/website-url-extractor.qmd

@@ -4,10 +4,15 @@ description: "Ein Tool zur Extraktion und Darstellung aller Links von einer ange
 image: _1fca0884-d58a-4271-b90f-90afcb2c4be9.jpeg
 ---
 
+## Lernziele
+
+* Was ist eine URLs?
+* Aus welchen Bestandteilen besteht eine URLs?
+
 ## Funktionen  
 - **Webseitenanalyse**: Automatische Extraktion aller URLs von einer Webseite.  
 - **Filterung**: Nur vollständige Links (z. B. beginnend mit `http`) werden angezeigt.  
-- **Einfaches Interface**: Eingabefeld für die URL und eine klare Liste der extrahierten Links.
+- **Einfaches Interface**: Eingabefeld für die URLs und eine klare Liste der extrahierten Links.
 
 ## Anleitung
 
@@ -15,7 +20,7 @@ image: _1fca0884-d58a-4271-b90f-90afcb2c4be9.jpeg
    - Zur [Webseiten-URL-Extraktor-App](https://huggingface.co/spaces/datenwerkzeuge/Webseiten-URL-Extraktor) auf Hugging Face navigieren.
 
 ### 2. Eingabemethode wählen
-   - Eingabemethode auswählen: **URL** oder **HTML-Datei hochladen**.
+   - Eingabemethode auswählen: **URLs** oder **HTML-Datei hochladen**.
 
 ### 3. URLs extrahieren
 
@@ -56,6 +61,41 @@ Die Auflistungsfunktion wiederholt die Extraktion für jeden Link im Dokument un
 
 Das Webseiten-URL-Extraktor-Tool bietet verdeutlicht das Filtern von Links auf Webseiten oder aus HTML-Dateien, indem es nur vollständige URLs darstellt.
 
+### Was ist eine URL?
+
+Eine **URL** (Uniform Resource Locator) ist die Adresse eines bestimmten Dokuments oder Ressourcen im Internet. Sie dient dazu, Webanwendungen und -dienste eindeutig zu identifizieren und darauf zuzugreifen. 
+
+### Bestandteile einer URL
+
+Eine typische URL besteht aus mehreren Teilen:
+
+- **Schema**: Gibt das Protokoll an, das verwendet wird, um die Ressource zu erreichen (z.B. `http`, `https`, `ftp`).
+
+- **Host**: Der Name oder die IP-Adresse des Servers, auf dem die Ressource gespeichert ist (z.B. `example.com`).
+
+- **Port**: Optional; spezifiziert den Port, über den die Verbindung hergestellt wird, wenn es nicht der Standardport ist (z.B. `80` für HTTP oder `443` für HTTPS).
+
+- **Pfad**: Zeigt den spezifischen Ort der Ressource auf dem Server an (z.B. `/pfad/zur/ressource.html`).
+
+- **Query-Parameter**: Optional; verwendet, um zusätzliche Daten an den Server zu übergeben, oft nach einem `?` (z.B. `?id=123&name=test`).
+
+- **Fragment**: Optional; identifiziert einen bestimmten Teil der Ressource, häufig verwendet in HTML-Dokumenten für interne Navigation (z.B. `#abschnitt`).
+
+### Beispiel einer vollständigen URL:
+
+```plaintext
+https://www.example.com:443/pfad/zur/ressource.html?id=123&name=test#abschnitt
+```
+
+* Schema: `https`
+* Host: `www.example.com`
+* Port: `443`
+* Pfad: `/pfad/zur/ressource.html`
+* Query-Parameter: `id=123&name=test`
+* Fragment: `abschnitt`
+
+Mit dieser Struktur kann ein Browser oder ein anderes Netzwerkprogramm die genaue Adresse einer Ressource im Internet bestimmen und darauf zugreifen.
+
 ## Anwendungsfall
 
-[Dead Link Checker](https://www.deadlinkchecker.com/) ist ein Online-Tool das nicht funktionierende Links (Dead Links) auf Webseiten identifiziert. An diesem Fall ist erkennbar wie eine einfache Anwendung, wie der URL-Extraktor, als Bestandteil in einer Geschäftsanwendung eingesetzt werden kann.
+[Dead Link Checker](https://www.deadlinkchecker.com/) ist ein Online-Tool das nicht funktionierende Links (Dead Links) auf Webseiten identifiziert. An diesem Fall ist erkennbar wie eine einfache Anwendung, wie der URL-Extraktor, als Bestandteil in einer Geschäftsanwendung eingesetzt werden kann.

src/02_basics/webspider/webspider.qmd

@@ -4,6 +4,13 @@ description: "Eine private Webanwendung zur Extraktion strukturierter Daten von
 image: _24e522b8-a6d0-4212-a02e-7738b3098105.jpeg
 ---
 
+## Lernziel
+
+- Start-URLs und URL-Verwaltung
+- HTTP-Anfragen und Datenextraktion
+- Links folgen und Crawl-Tiefe
+- Datenverarbeitung und -speicherung
+
 ## Anleitung
 
 1. **Anwendung aufrufen**:
@@ -34,4 +41,4 @@ Die Anwendung eignet sich für die Datenerfassung aus öffentlich zugänglichen
 
 ## Fazit
 
-Die Webspider-Anwendung bietet eine praktische Einführung in die Welt des Webscrapings, indem sie Nutzern die Möglichkeit gibt, Daten von Webseiten zu extrahieren, zu analysieren und zu exportieren. Sie vermittelt wesentliche Kenntnisse in der Handhabung von Scraping-Parametern.
+Die Webspider-Anwendung bietet eine praktische Einführung in die Welt des Webscrapings, indem sie Nutzern die Möglichkeit gibt, Daten von Webseiten zu extrahieren, zu analysieren und zu exportieren. Sie vermittelt wesentliche Kenntnisse in der Handhabung von Scraping-Parametern.

src/index.qmd

@@ -6,7 +6,7 @@ Herzlich willkommen zum Webscraping Workshop! Egal, ob Erste-Schritte oder Fortg
 * Hast du ein Google Nutzerkonto?
 * Hast du ein Huggingface Nutzerkonto?
 * Hast du schon einmal Daten aus dem Internet extrahiert?
-* Hast du schonmal Daten über eine [API](01_setup/glossar.html#a-wie-asynchrones-scraping) bezogen?
+* Hast du schonmal Daten über eine API bezogen?
 * Nutzt du Große Sprachmodelle?
 
 ## Navigation auf der Workshop Webseite 🧭