Merge pull request #3957 from tobiasd/20171125-docEvents

calendar documentation

doc/de/events.md

@@ -0,0 +1,66 @@
+# Veranstaltungen
+
+* [Home](Zur Startseite der Hilfe)
+
+Veranstaltungen sind spezielle Postings.
+Die Veranstaltungen, die Du und deine Kontakte teilen, können unter [/events](/events) auf deiner Instanz aufgefunden werden.
+Um da hinzukommen gehe über den Tab "Veranstalltungen", abhänig von dem Theme, das du benutzt, ist der eventuell ein zusätzlicher link im Navigationsmenü der Seite vorhanden.
+
+
+## Veranstaltungsübersicht
+
+Die Übersichtsseite zeigt den Kalender des aktuellen Monats an, plus einige Tage am Beginn und am Ende.
+Angezeit werden alle Veranstalltungen des aktuellen Monats, die von dir angelegt wurden oder die von deinen Kontakten geteilt wurden.
+Dies beinhaltet auch Geburstagserinnerungen, welche mit dir geteilt wurden.
+
+Es gibt Buttons mit denen die Ansicht zwischen Monatlich/Wöchentlich und Täglich wechseln kann.
+Um eine neue Veranstaltung anzulegen, kannst du dem Link "Veranstaltung erstellen" folgen oder einen Doppel-Klick in das Kalenderfeld, in dem die Veranstalltung stehen soll, machen.
+Mit einem Klick auf eine bereits existierende Veranstalltung, öffnet sich ein Pop-up Fenster, welches dir die Veranstaltung anzeigt.
+
+## Erstelle eine neue Veranstaltung
+
+Folge einer der oben beschriebenen Methoden, dann erreichst du das Formular um die Veranstaltungsdaten einzutragen. Felder mit *** müsen ausgefüllt werden.
+
+* **Veranstaltungsbeginn**: trage den Anfang der Veranstaltung ein.
+* **Veranstaltungsende**: trage das Ende der Veranstaltung ein.
+
+Wenn du in eines dieser Felder klickst, wird sich ein Popup Fesnster öffnen, wo du Tag und Uhrzeit eintragen kannst.
+Wenn du einen Doppel-Klick auf die Box im Kalender machst, werden diese Felder automatisch ausgefüllt.
+Das Veranstaltungsende muss nach dem Veranstaltungsanfang liegen.
+Aber du musst es nicht angeben. Wenn eine Veranstaltung ein offenes Ende hat oder das Veranstaltungsende nicht wichtig ist, klicke in die Box zwei Felder darunter.
+
+* **An Zeitzone des Betrachters anpassen**: Wenn du die Box anklickst, wird die Anfangs und Endzeit der Veranstaltung automatisch an die lokale Zeitzone, wie in den Zeitzonen-Einstellung angepasst.
+
+Dies vermeidet verfrühte Geburstagsglückwünsche, oder die Beführchtung, das du den Geburstag deines Freundes auf der anderen Seite der Welt vergisst und ähnliche Ereignisse.
+
+* **Titel**: Titel der Veranstaltung
+* **Beschreibung**: eine längere Beschreibung der Veranstaltung
+* **Ort**: Ort, wo die Veranstaltung stattfinden wird
+
+Diese 3 Felder beschreiben deine Veranstaltung.
+Im Beschreibungs- und Orts-Feld kannst du BBCode zum formatieren des Textes verwenden.
+
+* **Veranstaltung teilen**: wenn diese Box aktiviert wird, kannst du in der ACL auswählen mit wem du diese Veranstaltung teilen willst. Dies funktioniert wie die Kontrolle jedes anderen Postings.
+
+Wenn du Veranstaltungen teilst, werden diese auf deine Pinnwand gepostet mit den Zugriffsberechtigungen, die du ausgewählt hast. Bevor du das machst, kannst du dir die Veranstaltung als Vorschau in einem Popup-Fenster anzeigen lassen.
+
+### Interaktionen mit Veranstaltungen
+
+Wenn du eine Veranstaltung veröffendlichst, kannst du auswählen, wer sie bekommen wird, wie bei einem normalen Posting.
+Die Empfänger sehen deine Veranstaltung in einem Posting in ihrem Network-Stream.
+Zusätzlich wird die Veranstaltung zu ihrem Kalender hinzugefügt und somit in ihrer Veranstaltungsübersicht angezeigt.
+
+Empfänger von einem Veranstaltungs-Posting, können dies kommentieren oder dis-/liken, wie bei einem normalen Posting.
+Zusätzlich können sie sagen ob sie teilnehmen, oder vielleicht teilnehmen an der Veranstaltung mit einem einzigen Klick.
+
+### Kalender exportieren
+
+Wenn du deine öffentlichen Kalender Einträge exportieren möchtest, kannst du dies in den Einstellungen aktivieren (Einstellungen -> Zusätzliche Features -> Allgemeine Features -> Öffentlichen Kalender exportieren).
+Im Anschluss sind auf der Veranstaltungs-Übersichtsseite zwei Links zu den exportierten Einträgen (im ical oder csv Format) verfügbar.
+
+### Addons
+
+#### OpenStreetMap
+
+Wenn du diese Addon aktivierst auf deinem Frendica-Knoten, wird der Inhalt des Ort-Feldes mit den Identifikations-Service von OpenStreetMap verbunden, wenn du die Veranstaltung postest.
+Wenn Openstreetmap etwas passendes findet, wird eine Karte mit dem Ort automatisch eingebettet, am Ende der Veranstalltungsanzeige.

doc/events.md

@@ -62,6 +62,11 @@ Additionally it will be added to their calendar and thus be shown in their event
 Recipients of the event-posting can comment or dis-/like the event, as with a regular posting.
 Furthermore they can announce that they will attend, not attend or may-be attend the event with a single click.
 
+### Calendar Export
+
+If you want to export your public events to ical or csv, you can activate an additional feature in your user settings (Additional features -> General Features -> Export Public Calendar).
+Afterwards a link will be shown in the events page of your profile to access the calendar.
+
 ### Addons
 
 #### OpenStreetMap
@@ -69,7 +74,3 @@ Furthermore they can announce that they will attend, not attend or may-be attend
 If this addon is activated on your friendica node, the content of the location field will be matched with the identification service of OSM when you submit the event.
 Should OSM find anything matching, a map for the location will be embedded automatically at the end of the events view.
 
-#### Calendar Export
-
-If this addon is activated the public events you have created will be published in ical or csv file.
-The URL of the published file is ``example.com/cal/nickname/export/format`` (where format is either ical of csv).