update starting pages

src/_quarto.yml

@@ -7,10 +7,12 @@ website:
     search: true
     collapse-level: 3
     contents:
-      - section: "About"
+      - section: "Erste Schritte"
         contents:
           - href: index.qmd
-            text: About Quarto
+            text: "Willkommen"
+          - href: quarto-lokal.qmd
+            text: "Quarto lokal"
       - section: "Webscraping Made Easy"
         contents:
         - section: "Aufbau eines Webscraping-Prozesses"

src/about.qmd

@@ -1,5 +0,0 @@
----
-title: "About"
----
-
-About this site

src/index.qmd

@@ -1,78 +1,49 @@
 ---
-title: "About Quarto"
+title: "Willkommen"
 ---
 
-[Quarto](https://quarto.org/) is a Markdown-based documentation system that lets you write documents in Markdown or Jupyter Notebooks, and render them to a variety of formats including HTML, PDF, PowerPoint, and more. 
-You can also use Quarto to write [books](https://quarto.org/docs/books/), create [dashboards](https://quarto.org/docs/dashboards/), and embed web applications with [Observable](https://quarto.org/docs/interactive/ojs/) and [Shinylive](https://quarto.org/docs/blog/posts/2022-10-25-shinylive-extension/).
+Herzlich willkommen zum Webscraping Workshop! In diesem Workshop lernen Sie, wie Sie Daten aus dem Web extrahieren und analysieren können. Egal, ob Sie Anfänger oder Fortgeschrittener sind, dieser Workshop bietet Ihnen wertvolle Einblicke und praktische Erfahrungen.
 
-## Getting started with Quarto
+## Navigation auf der Quarto-Webseite 🧭
 
-Once you've created the space, click on the `Files` tab in the top right to take a look at the files which make up this Space. 
-There are a couple of important files which you should pay attention to:
+Unsere Quarto-Webseite ist so strukturiert, dass Sie sich leicht zurechtfinden und dem Workshop effizient folgen können.
 
-- `Dockerfile`: This contains the system setup to build and serve the Quarto site on Hugging Face. You probably won't need to change this file that 
-often unless you need to add additional system dependencies or modify the Quarto version.
-- `requirements.txt`: This is where you should include any Python dependencies which you need for your website. 
-These are installed when the Dockerfile builds.
-- The `src` directory contains the source files for the Quarto website. You can include Jupyter notebooks or markdown (`.qmd` or `.md`) files. 
-- `src/_quarto.yml` defines the navigation for your website. If you want to add new pages or reorganize the existing ones, you'll need to change this file.
+### Links: Überblick 🗂️
 
+Auf der linken Seite finden Sie eine Übersicht aller Inhalte und Module des Workshops. Diese Navigationsleiste ermöglicht es Ihnen, schnell zu den verschiedenen Kapiteln und Abschnitten zu springen, die Sie interessieren.
 
-## Recommended Workflow
+### Rechts: Seitenübersicht 📋
 
-1. **Clone the space locally**
-2. **Install Quarto**: In order to render your Quarto site without Docker, we recommend installing Quarto by following the instructions on the [official Quarto website](https://quarto.org/docs/get-started/).
-3. **Install Quarto VS Code extension**: The [Quarto VS Code Extension](https://quarto.org/docs/tools/vscode.html) includes a number of productivity tools including YAML Autocomplete, a preview button, and a visual editor. Quarto works great with VS Code, but the extension does make it easier to get the most out of Quarto.
-4. **Edit the site**: The website files are contained in the `src` directory, and the site navigation is defined in `src/_quarto.yml`. Try editing these files and either clicking the "Preview" button in VS Code, or calling `quarto preview src` from the command line.
-5. **Learn more about Quarto**: You can do a lot of things with Quarto, and they are all documented on the [Quarto Website](https://quarto.org/guide/). In particular, you may be interested in:
+Auf der rechten Seite finden Sie eine Übersicht der aktuellen Seite. Diese Seitenübersicht hilft Ihnen, den Überblick über die Struktur und die Unterthemen des aktuellen Kapitels zu behalten. Sie können leicht zwischen den Abschnitten navigieren, ohne die Hauptseite zu verlassen.
 
-    - All about building [websites](https://quarto.org/docs/websites/)
-    - Building Static [Dashboards](https://quarto.org/docs/dashboards/)
-    - How to write [books](https://quarto.org/docs/books/index.html) and [manuscripts](https://quarto.org/docs/manuscripts/)
-    - Reproducible [presentations](https://quarto.org/docs/presentations/)
-    - Including [Observable](https://quarto.org/docs/interactive/ojs/) or [Shiny](https://quarto.org/docs/interactive/shiny/) applications in your Quarto site
+### Links oben: Suchfunktion 🔍
 
-::: {.callout-warning}
-It can take a couple of minutes for the Space to deploy to Hugging Face after the Docker build process completes. Two see your changes you will need to do two things: 
+Oben links befindet sich die Suchfunktion. Hier können Sie nach spezifischen Themen, Begriffen oder Kapiteln suchen, um schnell die Informationen zu finden, die Sie benötigen. Geben Sie einfach ein Stichwort ein, und die Suchfunktion zeigt Ihnen relevante Ergebnisse aus dem gesamten Workshop.
 
-1) Wait for your space's status to go from 'Building' to 'Running'(this is visible in the status bar above the Space)
-2) Force-reload the web page by holding Shift and hitting the reload button in your browser.
-:::
+---
+
+## Workshop-Inhalte 📚
 
-## Code Execution
+### Einleitung 🚀
 
-One of the main virtues of Quarto is that it lets you combine code and text in a single document.
-By default, if you include a code chunk in your document, Quarto will execute that code and include the output in the rendered document.
-This is great for reproducibility and for creating documents that are always up-to-date.
-For example you can include code which generates a plot like this:
+Wir beginnen mit einer Einführung in die Grundlagen des Webscrapings, einschließlich der wichtigsten Konzepte und Werkzeuge, die Sie benötigen.
 
-```{python}
-import seaborn as sns
-import matplotlib.pyplot as plt
+### Tools und Technologien 🛠️
 
-# Sample data
-tips = sns.load_dataset("tips")
-# Create a seaborn plot
-sns.set_style("whitegrid")
-g = sns.lmplot(x="total_bill", y="tip", data=tips, aspect=2)
-g = g.set_axis_labels("Total bill (USD)", "Tip").set(xlim=(0, 60), ylim=(0, 12))
+Erfahren Sie mehr über die verschiedenen Tools und Technologien, die im Webscraping verwendet werden, wie zum Beispiel BeautifulSoup, Scrapy und Selenium.
 
-plt.title("Tip by Total Bill")
-plt.show()
-```
+### Praktische Übungen ✍️
 
-When the website is built the Python code will run and the output will be included in the document. 
+Setzen Sie Ihr Wissen in die Praxis um! Durch praktische Übungen und Projekte können Sie das Gelernte anwenden und wertvolle Erfahrungen sammeln.
 
-You can also include [inline code](https://quarto.org/docs/computations/inline-code.html) to insert computed values into text. 
-For example we can include the maximum tip value in the `tips` data frame like this: ``{python} tips['tip'].max()``. 
-You can control [code execution](https://quarto.org/docs/computations/execution-options.html), or [freeze code output](https://quarto.org/docs/projects/code-execution.html#freeze) to capture the output of long running computations. 
+### Weiterführende Themen 🔍
 
+Entdecken Sie weiterführende Themen wie das Scraping von APIs, das Management großer Datenmengen und ethische Überlegungen beim Webscraping.
 
-## About the Open Source AI Cookbook
+---
 
-To provide a realistic example of how Quarto can help you organize long-form documentation, 
-we've implemented the Hugging Face [Open-Source AI Cookbook](https://github.com/huggingface/cookbook) in Quarto. 
-The Open-Source AI Cookbook is a collection of notebooks illustrating practical aspects of building AI applications and solving various machine learning tasks using open-source tools and models.
-You can read more about it, or contribute your own Notebook on the [Github Repo](https://github.com/huggingface/cookbook)
+Wir hoffen, dass Sie viel Spaß und Erfolg beim Lernen und Anwenden des Webscrapings haben! Wenn Sie Fragen haben oder Unterstützung benötigen, zögern Sie nicht, sich an uns zu wenden.
 
+---
 
+Viel Erfolg und willkommen zum Workshop! 🎉

src/quarto-lokal.qmd

@@ -0,0 +1,79 @@
+---
+title: "Quarto lokal"
+---
+
+
+## Quarto lokal starten 🚀
+
+Hier sind die Schritte, um das Repository `https://huggingface.co/spaces/datenwerkzeuge/CDL-Webscraping-Workshop-2025` lokal zu klonen, Quarto zu installieren und die Website zu starten.
+
+### Schritt 1: Repository klonen 🖥️
+
+1. **Öffne dein Terminal oder die Eingabeaufforderung**: Dies ist notwendig, um die folgenden Befehle einzugeben.
+2. **Führe den folgenden Befehl aus, um das Repository zu klonen**:
+   ```bash
+   git clone https://huggingface.co/spaces/datenwerkzeuge/CDL-Webscraping-Workshop-2025
+   ```
+   📂 Dies erstellt eine lokale Kopie des Repositories auf deinem Computer.
+
+### Schritt 2: In das Repository-Verzeichnis wechseln 📁
+
+1. **Navigiere in das Verzeichnis**, in dem du das Repository geklont hast:
+   ```bash
+   cd CDL-Webscraping-Workshop-2025
+   ```
+   🔄 Jetzt befindest du dich im Verzeichnis des Projekts.
+
+### Schritt 3: Quarto installieren 🛠️
+
+#### Installation auf Windows:
+
+1. **Besuche die Quarto-Download-Seite**: Gehe zu [Quarto Download Seite](https://quarto.org/docs/download/index.html) und lade die Installationsdatei herunter.
+2. **Lade die Installationsdatei herunter**: Wähle die Datei `quarto-1.6.39-win.msi` für Windows und speichere sie auf deinem Computer.
+3. **Führe die Installationsdatei aus**: Doppelklicke auf die heruntergeladene Datei und folge den Anweisungen des Installationsassistenten.
+4. **Überprüfe die Installation**: Öffne dein Terminal oder die Eingabeaufforderung und führe den Befehl `quarto --version` aus, um sicherzustellen, dass Quarto korrekt installiert wurde.
+
+#### Installation auf Linux:
+
+1. **Lade das Quarto-Tarball herunter**:
+   ```bash
+   wget https://github.com/quarto-dev/quarto-cli/releases/download/v1.6.39/quarto-1.6.39-linux-arm64.deb
+   ```
+2. **Installiere das Tarball-Paket**:
+   ```bash
+   sudo dpkg -i quarto-1.6.39-linux-arm64.deb
+   ```
+3. **Löse eventuelle Abhängigkeiten**:
+   ```bash
+   sudo apt-get install -f
+   ```
+
+### Schritt 4: Quarto-Website lokal starten 🌐
+
+1. **Starte den lokalen Server**:
+   ```bash
+   quarto preview
+   ```
+
+Du solltest die Quarto-Website jetzt lokal sehen und interagieren können. 🌟
+
+### Schritt 5: Inhalte bearbeiten ✏️
+
+1. **Bearbeite die Inhalte der Website** in den `.qmd` Dateien. Änderungen werden automatisch aktualisiert, wenn der lokale Server läuft.
+
+## Erstellung einer PDF mit Quarto 📄
+
+Um mit Quarto PDF-Dateien zu erstellen, kannst du den Befehl `quarto render -to pdf` verwenden. Hier ist eine kurze Anleitung dazu:
+
+### Schritte zur Erstellung einer PDF mit Quarto 📋
+
+1. **Navigiere in dein Projektverzeichnis**:
+   Öffne dein Terminal und navigiere in das Verzeichnis, das die Quarto-Datei enthält, die du in eine PDF umwandeln möchtest.
+   ```bash
+   cd CDL-Webscraping-Workshop-2025
+   ```
+2. **Führe den Quarto-Befehl aus**:
+   Verwende den Befehl `quarto render` mit der Option `-to pdf`, um die gewünschte Quarto-Datei in eine PDF zu rendern.
+   ```bash
+   quarto render dateiname.qmd -to pdf
+   ```