Merge pull request #12 from Traewelling/better-faq-integration

Better faq integration

content/faq/_index.de.md

@@ -1,29 +1,39 @@
 ---
-title: "F.A.Q."
+title: "❓ F.A.Q."
 description: "Häufig gestellte Fragen"
+type: docs
 draft: false
 ---
-{{< faq "Was ist Träwelling? " >}}
+| [🐛 Fehler melden](https://github.com/Traewelling/traewelling/issues/new?assignees=&labels=bug%2CTo+Do&template=bug_report.md)
+| [➕ Funktion wünschen](https://github.com/Traewelling/traewelling/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=)
+| [❓ Zum Support](https://traewelling.de/support) 
+| 
+
+{{< faq "🔗 Was ist Träwelling? " >}}
 Träwelling ist ein kostenloser Check-in Service, mit dem du deinen Freunden mitteilen kannst, wo du gerade mit öffentlichen Verkehrsmitteln unterwegs bist und Fahrtenbuch führen kannst. Kurz gesagt: Man kann in Züge einchecken und bekommt dafür Punkte.
 {{</ faq >}}
-{{< faq "Wer entwickelt Träwelling?" >}}
+
+{{< faq "🧑‍💻 Wer entwickelt Träwelling?" >}}
 Träwelling ist ein Open-Source-Projekt. Seit 2013 entwickeln verschiedene Personen am Projekt.
 Teils nur Bugfixes, teils größere Änderungen.
 Auf [GitHub](https://github.com/Traewelling/traewelling/graphs/contributors) kannst du dir eine Liste von zum Code Beitragenden ansehen. 
 Zusätzlich haben ein paar Personen bei der Alpha-Version unterstützt.
 Diese findest du [hier](https://traewelling.de/humans.txt). 
 {{</ faq >}}
-{{< faq "Ich möchte auch an Träwelling mitentwickeln!" >}}
+
+{{< faq "🛠️ Ich möchte auch an Träwelling mitentwickeln!" >}}
 Träwelling ist ein Open Source Projekt und jeder kann mitentwickeln. 
 Du findest alle Informationen dazu auf unserer GitHub-Seite. 
 Wir freuen uns über jeden Beitrag - erstelle einfach einen PullRequest! 
 Du kannst entweder an eigenen Ideen arbeiten oder dir eine Aufgabe aus unseren Issues auf GitHub raussuchen. 
 Wenn du Fragen hast, kannst du dich gerne auf unserem Discord-Server an uns wenden: https://discord.gg/QypAnG2qAw
 {{</ faq >}}
-{{< faq "Woher kommt der Name?" >}}
+
+{{< faq "🤔 Woher kommt der Name?" >}}
 Der Name ist eine Anspielung auf das allseits bekannte "*Senk ju for träwelling wis Deutsche Bahn*", was man eigentlich in fast jedem Fernverkehrszug der Deutschen Bahn gehört haben sollte.
 {{</ faq >}}
-{{< faq "Was sind Veranstaltungen?" >}}
+
+{{< faq "🎉 Was sind Veranstaltungen?" >}}
 Träwelling bringt Menschen zusammen, die gemeinsam öffentliche Verkehrsmittel nutzen.
 Manchmal fahren sie sogar zu derselben Veranstaltung, ohne voneinander zu wissen!
 
@@ -34,8 +44,10 @@ Wenn du ein Event anlegen möchtest, beachte bitte, dass Veranstaltungen einen M
 Dazu gehören Events aus dem Eisenbahnwesen wie bspw. [die letzte Fahrt des Metropolitan](https://traewelling.de/statuses/event/letzte_fahrt_des_met), Events von Hackerspaces (z.B. die [GPN](https://traewelling.de/statuses/event/gpn20)), oder aus der LGBTQ-Szene wie die [Cologne Pride](https://traewelling.de/statuses/event/csd_koln_2022).
 
 Veranstaltungen sollen etwas Besonderes sein. Deswegen haben wir uns entschieden, kleine lokale Veranstaltungen wie Weihnachtsmärkte und Stadtfeste prinzipiell abzulehnen. Ausnahmen bestätigen hierbei die Regel.
+
+Weitere Informationen findest unter [Features > Veranstaltungen](/features/events).
 {{</ faq >}}
-{{< faq "Warum erhalte ich keine Bestätigungsmail?" >}}
+{{< faq "📭 Warum erhalte ich keine Bestätigungsmail?" >}}
  Bitte schaue als erstes nach, ob die E-Mail im Spamordner liegt. Wenn die E-Mail nicht im Spamordner ist, füge bitte 'gertrud@traewelling.de' zu deinen Kontakten hinzu und fordere die E-Mail erneut an. Sollte die E-Mail weiterhin nicht ankommen, kontaktiere uns bitte über unser Kontaktformular.
 
 
@@ -44,12 +56,14 @@ Bitte beachte, dass es in der Vergangenheit öfters zu Problemen bei Microsoft-A
 {{</ notice>}}
 {{</ faq >}}
 
-{{< faq "Warum wird mein Zug nicht aufgelistet? " >}}
+{{< faq "🚂 Warum wird mein Zug nicht aufgelistet? " >}}
 Wir verwenden eine Schnittstelle der Deutschen Bahn, bei der nicht alle Angebote direkt dargestellt werden.
-Leider können wir da auch nicht viel dran tun, wenn dein Zug nicht dabei ist.
+
+Wenn du eine Verbindung vermisst, kannst du sie manuell hinzufügen.
+Wie das geht, erfährst du unter [Features > Reise manuell hinzufügen](/features/manual-trips).
 {{</ faq >}}
 
-{{< faq "Wie werden Punkte berechnet?" >}}
+{{< faq "📊 Wie werden Punkte berechnet?" >}}
 Die Punkte setzen sich aus der Produktklasse und der Entfernung deiner Reise zusammen.
 
 | Produktklasse             | Basispunkte |

content/faq/_index.en.md

@@ -1,28 +1,37 @@
 ---
-title: "F.A.Q."
-description: "Häufig gestellte Fragen"
+title: "❓ F.A.Q."
+description: "Frequently asked questions"
+type: docs
 draft: false
 ---
-{{< faq "About Träwelling" >}}
+| [🐛 Report bug](https://github.com/Traewelling/traewelling/issues/new?assignees=&labels=bug%2CTo+Do&template=bug_report.md)
+| [➕ Request feature](https://github.com/Traewelling/traewelling/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=)
+| [❓ Support request](https://traewelling.de/support)
+| 
+
+{{< faq "🔗 What is Träwelling?" >}}
 Träwelling is a free check-in service that lets you tell your friends where you are and where you can log your public transit journeys.
 In short, you can check into trains and get points for it.
 {{</ faq >}}
 
-{{< faq "Wer entwickelt Träwelling?" >}}
+{{< faq "🧑‍💻 Who develops Träwelling?" >}}
 Träwelling is an open source project.
 Since 2013, various people have been developing the project.
 Partly only bugfixes, partly major changes.
 On [GitHub](https://github.com/Traewelling/traewelling/graphs/contributors) you can view a list of contributors to the code.
 Additionally, a few people have assisted with the alpha version.
 You can find them [hier](https://traewelling.de/humans.txt). 
 {{</ faq >}}
-{{< faq "I would like to contribute to Träwelling! " >}}
+
+{{< faq "🛠️ I would like to contribute to Träwelling! " >}}
 Träwelling is an open source project and everyone can contribute. You can find all the information about it on our GitHub page. We are happy about every contribution - simply create a PullRequest! You can either work on your own ideas or pick a task from our Issues on GitHub. If you have any questions, feel free to contact us on our discord server: https://discord.gg/QypAnG2qAw
 {{</ faq >}}
-{{< faq "Where does the name come from?" >}}
+
+{{< faq "🤔 Where does the name come from?" >}}
 The name is an allusion to the well-known "*Senk ju for träwelling wis Deutsche Bahn*", which you should have heard in almost every long-distance train of the Deutsche Bahn.
 {{</ faq >}}
-{{< faq "What are events? " >}}
+
+{{< faq "🎉 What are events? " >}}
 Träwelling brings people together who use the same public transport. Sometimes those people even ride to the same events, without knowing from another!
 
 That’s why we’ve created the Events feature. Anyone [can suggest an event](https://traewelling.de/events/suggest) n a specific time frame; and once accepted, all users can connect their check-ins to that event.
@@ -31,20 +40,26 @@ If you want to create an event, please make sure that events should benefit the
 Those events can be from the European railway community such as [the last course of a train model](https://traewelling.de/statuses/event/letzte_fahrt_des_met), hacking events such as [GPN](https://traewelling.de/statuses/event/gpn20), or from the LGBTQ scene such as [Cologne Pride](https://traewelling.de/statuses/event/csd_koln_2022).
 
 Events are something special. That’s why we decided to deny suggestions to smaller, local events such as Christmas Markets or city fairs. As always, there are exceptions to that rule.
+
+You'll find more information at [Features > Events](/features/events)
 {{</ faq >}}
-{{< faq "Why don't I receive a confirmation email? " >}}
+
+{{< faq "📭 Why don't I receive a confirmation email? " >}}
 First of all, please check if the email is in the spam folder. If the email is not in the spam folder, please add 'gertrud@traewelling.de' to your contacts and request the email again. If the email still does not arrive, please contact us via our contact form.
 
 {{<notice info>}}
 Please note that in the past there were often problems with Microsoft addresses (e.g. Live, Outlook, Hotmail, ...). In this case, please try an e-mail with another provider first.
 {{</ notice>}}
 {{</ faq >}}
 
-{{< faq "Why isn't my train listed?" >}}
-We use an interface of the Deutsche Bahn, where not all offers are displayed directly. Unfortunately, we can't do much with it if your train is not there.
+{{< faq "🚂 Why isn't my train listed?" >}}
+We use an interface of the Deutsche Bahn, where not all offers are displayed directly.
+
+If you're missing a connection, you can create it manually.
+You can find more information about this in the [manual trips section](/features/manual-trips).
 {{</ faq >}}
 
-{{< faq "How are points calculated?" >}}
+{{< faq "📊 How are points calculated?" >}}
 The points consist of the product class and the distance of your journey.
 
 | product category      | Base points |

content/features/manual-trips/_index.de.md

@@ -0,0 +1,44 @@
+---
+title: "Reise manuell erstellen"
+downloadBtn: false
+date: 2024-07-12
+---
+
+{{< notice important >}}
+Manuelle Reisen sind derzeit noch in einem frühen Beta-Stadium. Es kann zu Fehlern und Datenverlust kommen.
+Die Funktion wird in Zukunft verbessert und erweitert.
+{{</ notice >}}
+
+Träwelling nutzt überwiegend Fahrplandaten aus Deutschland. Hierbei kann es vorkommen, dass nicht alle Verbindungen
+oder Züge in der Datenbank vorhanden sind. Vor allem in Ländern außerhalb Deutschlands kann es zu Lücken kommen.
+Daher gibt es die Möglichkeit, manuell eine Reise zu erstellen.
+
+{{< notice info >}}
+Um manuelle Reisen nutzen zu können, musst du Experimentelle Features in den Einstellungen aktivieren.
+{{</ notice >}}
+
+## Der Weg zur manuellen Reise
+Am Ende der Abfahrtstafel findest du den Button "Fahrt erstellen". Klicke darauf, um eine neue manuelle Reise zu erstellen.
+
+{{< figure src="button-de.png" alt="Manuelle Reise erstellen" >}}
+
+## Manuelle Reise erstellen
+Gib den Namen der Station ein, an der du ein- oder aussteigen möchtest. Es werden dir Vorschläge angezeigt, die du auswählen kannst.
+
+Füge die gewünschten Stationen hinzu, welche als Zwischenhalte.
+
+Trage die Uhrzeiten ein, wann dein Fahrzeug an den Stationen abfährt oder ankommt.
+
+Trage die Linie ein, die du benutzt.
+
+Das Feld "Nummer" kannst du frei lassen. Sollte deine Fahrt eine (interne) Fahrtennummer, kannst du diese hier eintragen.
+
+Im Feld "Kategorie" musst du die Kategorie deines Verkehrsmittels auswählen.
+
+
+{{< figure src="filled-out.png" alt="Manuelle Reise erstellen" >}}
+
+{{< notice important >}}
+Bitte lege hier nur Fahrten an, deren Kategorie im Auswahlfeld "Kategorie" vorkommt.
+Manuelle Reisen in privaten KfZ, Fahrrädern, zu Fuß, etc. sind nicht vorgesehen und werden von Zeit zu Zeit gelöscht.
+{{</ notice >}}

content/features/manual-trips/_index.en.md

@@ -0,0 +1,45 @@
+---
+title: "Create trip manually"
+downloadBtn: false
+date: 2024-07-12
+
+---
+
+{{< notice important >}}
+Manual trips are currently in an early beta stage. Errors and data loss may occur.
+The feature will be improved and expanded in the future.
+{{</ notice >}}
+
+Träwelling mainly uses timetable data from Germany. It may happen that not all connections or trains are available in the database.
+Especially in countries outside of Germany, there may be gaps.
+Therefore, there is the possibility to create a trip manually.
+
+{{< notice info >}}
+To use manual trips, you have to enable Experimental Features in the settings.
+{{</ notice >}}
+
+## Where to find manual trips
+At the end of the departure board you will find the button "Create journey". Click on it to create a new manual trip.
+
+{{< figure src="button-en.png" alt="Create journey" >}}
+
+## Create manual trip
+Enter the name of the station where you want to get on or off. Suggestions will be displayed that you can select.
+
+Add the desired stations as intermediate stops.
+
+Enter the times when your vehicle departs or arrives at the stations.
+
+Enter the line you are using.
+
+You can leave the "Number" field blank. If your trip has a (internal) trip number, you can enter it here.
+
+In the "Category" field you have to select the category of your means of transport.
+
+
+{{< figure src="filled-out.png" alt="Create manual trip" >}}
+
+{{< notice important >}}
+Please only create trips here whose category is included in the selection field "Category".
+Manual trips in private motor vehicles, bicycles, on foot, etc. are not provided and will be deleted from time to time.
+{{</ notice >}}