Merge pull request #332 from zzottel/master

First steps at German doco

5 files changed, 223 insertions, 23 deletions

diff --git a/doc/Account-Basics.md b/doc/Account-Basics.md
index 5d937cb1c..c4a8f3bc4 100644
--- a/doc/Account-Basics.md
+++ b/doc/Account-Basics.md
@@ -18,7 +18,7 @@ Enter a password of your choice, and repeat it in the second box to ensure it wa
 
 *Terms Of Service*
 
-Click the link to read the site's terms of service.  This will open in a new tab.  Once you've read them, tick the box to confirm.
+Click the link to read the site's terms of service. Once you've read them, tick the box in the register form to confirm.
 
 *Register*
 
@@ -38,4 +38,4 @@ When your channel is created you will be taken straight to your settings page wh
 
 * [Remove Account](help/Remove-Account)
 
- 
\ No newline at end of file
+ 
diff --git a/doc/Profiles.md b/doc/Profiles.md
index 249ea4f29..1e9e0fe5e 100644
--- a/doc/Profiles.md
+++ b/doc/Profiles.md
@@ -3,46 +3,34 @@ Profiles
 
 * [Home](help)
 
-Red has unlimited profiles. You may use different profiles to show different "sides of yourself" to different audiences.  This is different to having different _channels_.  Different channels allow for completely sets of information.  You may have a channel for yourself, a channel for your sports team, a channel for your website, or whatever else.  A profile allows for finely graded "sides" of each channel.  For example, your default public profile might say "Hello, I'm Fred, and I like laughing".  You may show your close friends a profile that adds "and I also enjoy dwarf tossing".
+Red has unlimited profiles. You may use different profiles to show different "sides of yourself" to different audiences.  This is different to having different _channels_.  Different channels allow for completely different sets of information.  You may have a channel for yourself, a channel for your sports team, a channel for your website, or whatever else.  A profile allows for finely graded "sides" of each channel.  For example, your default public profile might say "Hello, I'm Fred, and I like laughing".  You may show your close friends a profile that adds "and I also enjoy dwarf tossing".
 
 You always have a profile known as your "default" or "public" profile. This profile is always available to the general public and cannot be hidden (there may be rare exceptions on privately run or disconnected sites). You may, and probably should restrict the information you make available on your public profile.
 
 That said, if you want other friends to be able to find you, it helps to have the following information in your public profile...
 
-* Your real name
+* Your real name or at least a nickname everybody knows
 * A photo of **you**
 * Your location on the planet, at least to a country level. 
 
 Without this basic information, you could get very lonely here. Most people (even your best friends) will not try and connect with somebody that has a fake name or doesn't contain a real photo.  
 
-In addition, if you'd like to meet people that share some general interests with you, please take a moment and add some "Public Keywords" to your profile. Such as "music, linux, photography" or whatever. You can add as many keywords as you like. 
+In addition, if you'd like to meet people that share some general interests with you, please take a moment and add some "Keywords" to your profile. Such as "music, linux, photography" or whatever. You can add as many keywords as you like. 
 
-Your default or public profile is also shown to contacts on other networks, since they do not have the ability to view your private profiles. Only members of the Friendica network can see alternate/private profiles.
+To create an alternate profile, select "View Profile" from the menu of your Red Matrix site, then click on the pencil at your profile photo. You may edit an existing profile, change the profile photo, add things to a profile or create a new profile. You may also create a "clone" of an existing profile if you only wish to change a few items but don't wish to enter all the information again.  To do that, click on the profile you want to clone and choose "Clone this profile" there.
 
-
-To create an alternate profile, select "Profiles" from the menu of your Friendica site. You may edit an existing profile, change the profile photo, or create a new profile. You may also create a "clone" of an existing profile if you only wish to change a few items but don't wish to enter all the information again. 
-
-To assign a profile to specific persons, select the person from your "Connections" page and click the pencil "Edit" icon. You will find a dropdown box listing the various profiles available. If this box is not selectable, the person is not in a supported network and cannot be assigned a specific profile.
+In the list of your profiles, you can also choose the contacts who can see a specific profile.  Just click on "Edit visibility" next to the profile in question (only available for the profiles that are not your default profile) and then click on user images to add them to or remove them from the group of people who can see this profile.
 
 Once a profile has been selected, when the person views your profile, they will see the private profile you have assigned. If they are not authenticated, they will see your public profile. 
 
-You may also discover that (assuming you have the proper permissions) you may be able to post directly on the other person's channel (often called a "wall-to-wall" post). You may also be able to comment directly on posts from while visiting the other person's profile page. 
-
-There is a setting which allow you to publish your profile to a directory and ensure that it can be found by others.  You can change this setting on the "Settings" page. 
+There is a setting which allows you to publish your profile to a directory and ensure that it can be found by others.  You can change this setting on the "Settings" page. 
 
-If you do not wish to be visible to any of these sites, you may leave your profile unpublished.   
-
-Although you may have multiple profiles, you only have one profile photo. This is intentional. In early tests we experimented with different photos for each profile and found it was very confusing for people. They might see a different picture depending on what website they visited or what conversation they were in, and often alerted them to the fact that other people might be able to see different profiles of you than they could see.
-
-(But you can use the rich-text information boxes within a profile such as "Tell us about yourself" and link other photos onto the page.)
+If you do not wish to be found be people unless you give them your channel address, you may leave your profile unpublished.   
 
 **Keywords and Directory Search**
 
-On the site Directory page, you may search for people with published profiles. The search is typically for your nickname or part of your full name. However this search will also match against other profile fields - such as gender, location, "about", work, and education. You may also include "Keywords" in your default profile - which may be used to search for common interests with other members. You have two sets of keywords available - public and private. Private keywords are *not* visible to anybody. You could use these keywords to locate people who share membership in secret societies, or that share a love of fishing (for example) - without making this information visible on your public profile. Public keywords are used in the friend suggestion tool and although they aren't readily visible, they may be seen by viewing the HTML of your profile page.
+On the directory page, you may search for people with published profiles. The search is typically for your nickname or part of your full name. However this search will also match against other profile fields - such as gender, location, "about", work, and education. You may also include "Keywords" in your default profile - which may be used to search for common interests with other members. Keywords are used in the channel suggestion tool and although they aren't visible in the directory, they are shown if people visit your profile page.
 
 Directory searches are also able to use "boolean" logic so that you can search for "+lesbian +Florida" and find those who's sexual preference (or keywords) contain the world "lesbian" and that live in Florida. See the section on "Topical Tags" on the [Tags-and-Mentions](help/Tags-and-Mentions) page for more information on performing boolean searches. 
 
-On your Contacts page is a link to "Find People with Shared Interests". This will combine both your public and private keywords, and find people who have matching and/or similar keywords. The more keywords you provide, the more relevant the search results that are returned. These are sorted by relevance. You may discover that you are the first person on the list - because you are very likely the most relevant match for your keywords in the directory.
-
-  
-    
\ No newline at end of file
+On your Connnections page and in the directory there is a link to "Suggestions" or "Channel Suggestions", respectively. This will find channels who have matching and/or similar keywords. The more keywords you provide, the more relevant the search results that are returned. These are sorted by relevance.
diff --git a/doc/de/Home.md b/doc/de/Home.md
new file mode 100644
index 000000000..d603af11b
--- /dev/null
+++ b/doc/de/Home.md
@@ -0,0 +1,43 @@
+Dokumentation und Ressourcen zur Red-Matrix
+===========================================
+
+
+**Inhalt**
+
+* [Grundlagen zu Red-Konten](help/Kontengrundlagen)
+* [Profile](help/Profile)
+* [Channels](help/Channels)
+* [Connecting to Channels](help/Connecting-to-Channels)
+* [Permissions](help/Permissions)
+* [Cloud Storage](help/Cloud)
+* [But Wait - There's More. MUCH More...](help/Features) 
+* [Tags and Mentions](help/Tags-and-Mentions)
+* [Web Pages](help/Webpages)
+* [Remove Account](help/Remove-Account)
+* [BBcode reference for posts and comments](help/bbcode)
+
+**Technische Dokumentation**
+
+* [Install](help/Install)
+* [Comanche Page Descriptions](help/Comanche)
+* [Plugins](help/Plugins)
+* [Schemas](help/Schema-development)
+* [Developers](help/Developers)
+* [Intro for Developers](help/Intro-for-Developers)
+* [API functions](help/api_functions)
+* [Red Functions 101](help/dev-function-overview)
+* [Code-Referenz (mit doxygen generiert, Englisch)](doc/html)
+* [To-Do list for the Red Documentation Project](help/To-Do)
+* [To-Do list for Developers](help/To-Do-Code)
+
+**Externe Ressourcen**
+
+* [External Resource Links](help/External-Resources)
+* [Haupt-Website](https://github.com/friendica/red)
+* [Plugins/Addons-Website](https://github.com/friendica/red-addons)
+* [Assets-Website](https://github.com/friendica/red-assets)
+* [Entwickler-Kanal](http://zothub.com/channel/one)
+
+**Über**
+
+* [Server- und Versionsinformationen](siteinfo)
diff --git a/doc/de/Kontengrundlagen.md b/doc/de/Kontengrundlagen.md
new file mode 100644
index 000000000..23a8da87a
--- /dev/null
+++ b/doc/de/Kontengrundlagen.md
@@ -0,0 +1,72 @@
+Grundlagen zu Red-Konten
+========================
+
+* [Zurück zur Hilfe-Startseite](help)
+
+
+**Registrieren**
+
+Nicht alle Server in der Red-Matrix erlauben jedem, sich zu registrieren.
+Wenn eine Registrierung möglich ist, erscheint unter dem Anmelde-Formular
+ein Link mit dem Titel „Registrieren“, der Dich zur Registrierungs-Seite
+des Servers führt. Auf manchen Servern wirst Du auf einen anderen Server
+weitergeleitet, der Registrierungen erlaubt. Da alle Red-Server
+miteinander verbunden sind, ist es egal, auf welchem Du Dich registrierst.
+
+*Deine E-Mail-Adresse*
+
+Bitte gib eine funktionierende E-Mail-Adresse an. Sie wird **nie**
+veröffentlicht. Wenn Du willst, kannst Du Dir an diese Adresse
+Benachrichtigungen schicken lassen, wenn Du neue Nachrichten oder Beiträge
+erhalten hast. Sie wird außerdem benutzt, um vergessene Passwörter
+wiederherstellen zu können.
+
+*Passwort*
+
+Gib ein Passwort Deiner Wahl ein und wiederhole es in der zweiten Box, um
+sicherzugehen, dass Du Dich nicht vertippt hast. Da die Red-Matrix
+dezentralisierten Identitäsnachweis beherrscht, kannst Du Dich mit Deinem
+Konto auf vielen anderen Webseiten anmelden.
+
+*Nutzungsbedingungen*
+
+Klicke auf den Link, um die Nutzungsbedingungen dieses Servers zu lesen.
+Wenn Du sie gelesen hast, setze den Haken im Registrierungsformular, um
+sie zu akzeptieren.
+
+*Registrieren*
+
+Wenn Du alles ausgefüllt hast, klicke auf den „Registrieren“-Knopf. Bei
+manchen Servern muss der Administrator Deiner Registrierung erst noch
+zustimmen, bevor Du Dein Konto nutzen kannst. Falls das der Fall ist,
+wird Dir das entsprechend angezeigt. Du erhältst dann eine E-Mail, wenn
+die Registrierung vollendet wurde. (Sicherheitshalber auch Spam-Ordner
+überprüfen!)
+
+*Einen Kanal anlegen*
+
+Als nächstes kommst Du direkt auf den „Kanal hinzufügen“-Bildschirm. Dein
+erster Kanal wird normalerweise der sein, der Dich selbst repräsentiert.
+Es ist also sinnvoll, Deinen Namen oder Dein Pseudonym als Kanal-Namen zu
+verwenden.
+
+Der Kanal-Name ist der Titel oder eine kurze Beschreibung des Kanals. Der
+„Spitzname“ ist so etwas wie ein Benutzername. Was Du hier eingibst wird
+Teil Deiner Kanal-Adresse, die Andere benutzen, um sich mit Dir zu
+verbinden, und die Du selbst benutzt, um Dich auf anderen Servern
+anzumelden. Die Kanal-Adresse sieht aus wie eine E-Mail-Adresse, zum
+Beispiel so: spitzname@deinserver.xyz
+
+Wenn Dein Kanal angelegt ist, geht es direkt weiter zu den Einstellungen.
+Dort kannst Du Zugriffsrechte setzen, Funktionen zu- oder abschalten und
+so weiter. Diese Punkte werden auf den entsprechenden Hilfeseiten erklärt.
+
+**Siehe auch**
+
+* [Permissions](help/Permissions)
+
+* [Profile](help/Profile)
+
+* [Remove Account](help/Remove-Account)
+
+ 
diff --git a/doc/de/Profile.md b/doc/de/Profile.md
new file mode 100644
index 000000000..6ee06a55d
--- /dev/null
+++ b/doc/de/Profile.md
@@ -0,0 +1,97 @@
+Profile
+=======
+
+* [Zurück zur Hilfe-Startseite](help)
+
+In Red kannst Du beliebig viele Profile anlegen. Du kannst mehrere Profile
+nutzen, um verschiedenen Kontakten und Profilbesuchern unterschiedliche
+Seiten Deiner Persönlichkeit zu zeigen. Das ist nicht das gleiche wie das
+Anlegen mehrerer _Kanäle_.
+
+Mehrere Kanäle erlauben es, komplett voneinander getrennte Informationen
+zu verwalten. Du könntest zum Beispiel einen Kanal für Dich selbst
+anlegen, einen für Deinen Schwimmverein, einen für Dein Blog und so weiter
+und so fort.
+
+Ein Profil erlaubt es, unterschiedlichen Leuten unterschiedliche
+Informationen über einen Kanal zu präsentieren. Beispiel: In Deinem
+Standard-Profil, das alle Profilbesucher zu sehen bekommen, könnte nur
+Dein Vorname stehen, sonst keine weiteren Informationen. Freunde und
+Bekannte könnten Deinen kompletten Realnamen und Deine Postadresse zu
+sehen bekommen, und im Profil für Deinen engsten Freundeskreis könnten
+peinliche Hobbies Trinkrekorde ihren Platz finden.
+
+Jeder Kanal hat ein Standard-Profil (öffentliches Profil), das vor niemandem
+versteckt werden kann (außer evtl. auf privaten Servern, die nicht mit der
+Matrix verbunden sind). Du kannst und solltest Dich in der Auswahl dessen, was
+Du im Standard-Profil von Dir preisgibst, stark einschränken.
+
+Trotzdem: Wenn Du willst, dass Freunde Dich finden können, macht es Sinn,
+folgende Informationen ins öffentliche Profil einzutragen:
+
+* Deinen Realnamen oder zumindest einen Spitznamen, unter dem Dich jeder kennt
+* Ein Foto, das auch wirklich Dich zeigt
+* Deinen Wohnort, oder zumindest Land oder Bundesland
+
+Ohne diese Informationen könnte es passieren, dass Du hier sehr einsam
+bist. Die meisten Leute verbinden sich nicht mit jemandem, von dem sie nur
+einen Fake-Namen und ein Foto sehen, das noch nicht einmal einen Menschen
+zeigt.
+
+Wenn Du Leute kennenlernen möchtest, die ähnliche Interessen haben wie Du,
+nimm Dir einen Moment Zeit und füge einige Schlüsselwörter hinzu. Zum
+Beispiel „Musik, Linux, Fotografie“ oder was auch immer. Danach können
+andere dann im Verzeichnis suchen. Du kannst so viele Schlüsselwörter
+eingeben wie Du möchtest.
+
+Um alternative Profile zu erstellen, klicke auf „Profil ansehen“ im Menü
+Deines Red-Servers und dann auf den Bleistift am Profilfoto. Dann kannst
+Du existierende Profile bearbeiten, Dein Profilfoto verändern, Dinge zu
+einem Profil hinzufügen oder ein neues Profil erstellen. Du kannst auch
+ein Profil „klonen“, wenn Du nur einige wenige Einträge ändern willst,
+ohne die ganzen Informationen noch einmal einzugeben. Klicke dazu auf das
+Profil, das Du klonen willst, und wähle dann „Dieses Profil klonen“.
+
+In der Liste Deiner Profile kannst Du auch bestimmen, wer ein bestimmtes
+Profil zu sehen bekommt. Klicke dazu auf „Sichtbarkeit bearbeiten“ neben
+dem Profil, um das es geht (gibt es nur bei Profilen, die nicht Dein
+Standard-Profil sind). Klicke dann auf die Bilder derjenigen Kontakte, die
+dieses Profil sehen sollen – sie sind dann oben zu sehen. Wenn Du oben auf
+ein Bild klickst, wird dieser Kontakt wieder aus der Gruppe derjenigen
+herausgenommen, die dieses Profil zu sehen bekommen.
+
+Hast Du einem Kontakt ein Profil zugeordnet, wird er immer dieses Profil
+sehen, wenn er sich Dein Profil ansieht. Besucht er Deinen Red-Server,
+ohne sich anzumelden, sieht er aber weiterhin Dein Standard-Profil.
+
+Auf der allgemeinen „Einstellungen“-Seite gibt es eine Einstellung, mit
+der Du festlegen kannst, ob Dein Standard-Profil in den Red-Verzeichnissen
+veröffentlicht werden soll.
+
+Wenn Du nicht möchtest, dass andere Dich finden können, ohne dass Du ihnen
+Deine Kanal-Adresse gibst, kannst Du so verhindern, dass Dein Profil
+veröffentlicht wird.
+
+**Schlüsselwörter und Verzeichnissuche**
+
+Im Verzeichnis (Kanal-Anzeiger) kannst Du nach Leuten suchen, die ihre
+Profile veröffentlichen. Zum Beispiel, indem Du Namen oder Spitznamen
+eingibst. Es werden aber auch viele andere Profilfelder durchsucht, zum
+Beispiel Geschlecht, Wohnort, Hobbys, Arbeit/Anstellung und
+Schule/Ausbildung und die Schlüsselwörter. Wenn Du Schlüsselwörter in Dein
+Profil einträgst, können Dich Leute mit ähnlichen Interessen finden. Sie
+werden außerdem bei den Kanal-Vorschlägen benutzt. Sie sind im Verzeichnis
+nicht direkt sichtbar, wohl aber auf Deiner Profil-Seite.
+
+In Verzeichnis-Suchen kann auch boolesche Logik benutzt werden. Du kannst
+also nach „+lesbisch +Hamburg“ suchen, um Leute zu finden, deren sexuelle
+Orientierung lesbisch ist (oder deren Schlüsselwörter „lesbisch“
+enthalten), und die in Hamburg leben. Mehr Informationen über boolesche
+Suchen findest Du im Abschnitt „Topical Tags“ auf der Hilfeseite
+[Tags-and-Mentions](help/Tags-and-Mentions).
+
+Auf Deiner „Verbindungen“-Seite und im Verzeichnis (Kanal-Anzeiger) gibt
+es einen Link „Vorschläge“ bzw. „Kanal-Vorschläge“. Dort findest Du
+Kanäle, die gleiche oder ähnliche Schlüsselwörter im Profil haben wie Du.
+Je mehr Schlüsselwörter Du in Dein Standard-Profil einträgst, desto besser
+werden die Suchergebnisse. Sie sind nach relevanz sortiert.