Docs/add german translation (#1005)

* feat: add German getting started page

* feat: add missing links to German page to config and LanguageSelect

* feat: remove two dashes because that's considered bad practice

* Update LanguageSelect.tsx

Co-authored-by: Joshua <joshua.stuebner@bloxxter.com>
Co-authored-by: Fred K. Schott <fkschott@gmail.com>

docs/src/components/Header/LanguageSelect.tsx

@@ -49,6 +49,9 @@ const LanguageSelect: FunctionalComponent<{ lang: string }> = ({ lang }) => {
         <option value="en">
           <span>English</span>
         </option>
+        <option value="de">
+          <span>Deutsch</span>
+        </option>
         <option value="nl">
           <span>Nederlands</span>
         </option>

docs/src/config.ts

@@ -33,6 +33,10 @@ export const SIDEBAR = {
     },
     { text: 'Renderer Reference', link: 'reference/renderer-reference' },
   ],
+  de: [
+    { text: 'Willkommen', header: true },
+    { text: 'Einführung', link: 'de/getting-started' },
+  ],
   nl: [
     { text: 'Welkom', header: true },
     { text: 'Beginnen', link: 'nl/getting-started' },

docs/src/pages/de/getting-started.md

@@ -0,0 +1,69 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Einführung
+lang: de
+---
+
+Astro ist ein moderner Generator für Statische Webseiten (SSG). Um mehr über Astro zu erfahren, schau dir [unsere Homepage](https://astro.build/) an und lies [unseren Release Blogpost](https://astro.build/blog/introducing-astro).
+
+Diese Seite dient als Übersicht der Astro Dokumentation und alle damit verbundenen Ressourcen.
+
+Du willst erstmal einen kurzen Überblick, um zu verstehen, was Astro ist? [Besuch unsere Homepage.](https://astro.build)
+
+## Astro ausprobieren
+
+Der einfachste Weg, Astro auszuprobieren ist `npm init astro` in einem neuen Verzeichnis deiner Wahl auszuführen. Der CLI wizard hilft dir dann dabei, ein neues Astro Projekt aufzusetzen.
+
+Um mit Astro in 5 einfachen Schritten loszulegen, lies [unsere Schnellstart Anleitung](/quick-start)
+
+Alternativ kannst du unsere [Installations Anleitung](/installation) für eine ausführliche Beschreibung des Installationsprozesses lesen.
+
+### Online Spielplätze
+
+Falls du lieber erstmal mit Astro in deinem Browser herumspielen willst, kannst du einen online Code Spielplatz benutzen. Probier unsere "Hello World" Vorlage auf [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3).
+
+_Hinweis: Einige Funktionen (z.B. Fast Refresh) funktionieren aktuell nur begrenzt auf CodeSandbox._
+
+## Astro lernen
+
+Es kommen eine Menge verschiedener Menschen mit unterschiedlichen Hintergründen und nochmal anderen Lernweisen zu Astro. Unabhängig davon, ob du lieber theoretisch oder praktisch lernst, hoffen wir, dass dir dieser Abschnitt hilfreich ist.
+
+- Falls du lieber **praktisch lernst**, such dir ein Beispiel aus unserer [Beispiel Liste](https://github.com/snowpackjs/astro/tree/main/examples) aus und fang direkt an.
+
+- Falls du lieber **theoretisch lernst**, kannst du mit unseren [grundlegenden Konzepten und Anleitungen](/core-concepts/project-structure) anfangen.
+
+Wie alle unbekannten Technologien, hat auch Astro einen leichte Lernkurve. Mit ein bisschen Übung und Geduld, sind wir aber _sicher_, dass du schnell lernst, wie du mit Astro umgehen kannst.
+
+### Lerne die `.astro` Syntax
+
+When du mit Astro anfängst, wirst du schnell Dateien mit der `.astro` Dateiendung finden. Das ist die **Astro Komponenten Syntax**: ein spezielles, HTML-ähnliches Dateiformat, welches Astro für Vorlagen benutzt. Es wurde angelehnt an HTML und JSX entworfen und sollte jedem, der damit Erfahrung hat, direkt bekannt vorkommen.
+
+Unsere Anleitung zu [Astro Komponenten](/core-concepts/astro-components) sollte eine gute Einführung in die Astro Syntax sein und ist der beste Weg, um diese zu lernen.
+
+### API Dokumentation
+
+Dieser Dokumentationsabschnitt sollte für dich nützlich sein, wenn du mehr Details über eine bestimme Astro API erfahren möchtest.
+
+So listet z.B. die [Konfigurations Dokumentation](/reference/configuration-reference) alle möglichen Konfigurationseigenschaften auf, die dir zur Verfügung stehen. In der [Dokumentation über eingebaute Komponenten](/reference/builtin-components) findest du alle verfügbaren Kernkomponenten wie `<Markdown />` und `<Prism />`.
+
+### Versionierte Dokumentation
+
+Diese Dokumentation ist immer auf dem Stand der letzte _stable_ Version von Astro. Sobald wir den v1.0 Meilenstein erreicht haben, wollen wir versionierte Dokumentation einführen.
+
+## Bleib auf dem Laufenden
+
+Unser [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter Account ist die offizielle Quelle für Neuigkeiten vom Astro Team.
+
+Zusätzlich veröffentlichen wir alle Release Ankündigungen in unserer [Discord Community](https://astro.build/chat) im `#announcements` Kanal.
+
+Obwohl nicht jeder Astro Release einenen eigenen Blogpost verdient, kannst du alle Änderungen für jedes Release in unserem detaillierten [`CHANGELOG.md` im Astro Repository](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) nachlesen.
+
+## Fehlt etwas?
+
+Falls dir etwas in der Dokumentation fehlt oder du einen Teil verwirrend findest, [erstell bitte ein Issue](https://github.com/snowpackjs/astro/issues/new/choose) mit deinen Verbesserungsvorschlägen für die Dokumentation oder tweete an den [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter account.
+
+Wir freuen uns, von dir zu hören.
+
+## Credit
+
+Diese Einführung basierte ursprünglich auf dem der Einführung von [React](https://reactjs.org/).