From c652aec9704996db7d07883c0796cea200ec12df Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Mon, 19 Oct 2015 07:58:13 +0200 Subject: [PATCH] Updates to the documentations --- doc/Chats.md | 9 ++++--- doc/Developers-Intro.md | 2 ++ doc/Install.md | 60 +++++++++++++++++++++++------------------ doc/de/Chats.md | 44 +++++++++++++++--------------- doc/de/Developers.md | 11 +++++--- 5 files changed, 71 insertions(+), 55 deletions(-) diff --git a/doc/Chats.md b/doc/Chats.md index 77b21833a..3698ad15d 100644 --- a/doc/Chats.md +++ b/doc/Chats.md @@ -23,7 +23,7 @@ The following window shows some text while connecting. This text isn't importend for you, just wait for the next window. The first line shows your name and your current IP address. The right part of the window shows all users. -The lower part of the window contains an input field. +The lower part of the window contains an input field. Jappix Mini --- @@ -41,7 +41,7 @@ You can use several servers to create an account: At first you have to get the current version. You can either pull it from [Github](https://github.com) like so: - $> cd /var/www/virtual/YOURSPACE/html/addon; git pull + $> cd /var/www/virtual/YOURSPACE/html/addon; git pull Or you can download a tar archive here: [jappixmini.tgz](https://github.com/friendica/friendica-addons/blob/master/jappixmini.tgz) (click at „view raw“). @@ -63,9 +63,10 @@ At first you have to activate the addon. Now add your Jabber/XMPP name, the domain/server (without "http"; just "jappix.com"). For „Jabber BOSH Host“ you could use "https://bind.jappix.com/". +Note that you need another BOSH server if you do not use jappix.com for your XMPP account. You can find further information in the „Configuration Help“-section below this fields. At last you have enter your password (there are some more optional options, you can choose). -Finish these steps with "send" to save the entries. +Finish these steps with "send" to save the entries. Now, you should find the chatbox at the lower right corner of your browser window. -If you want to add contacts manually, you can click "add contact". +If you want to add contacts manually, you can click "add contact". diff --git a/doc/Developers-Intro.md b/doc/Developers-Intro.md index ff8c3c54c..7e5caae2b 100644 --- a/doc/Developers-Intro.md +++ b/doc/Developers-Intro.md @@ -54,6 +54,8 @@ Have a look at our [issue tracker](https://github.com/friendica/friendica) on gi * Try to reproduce a bug that needs more inquries and write down what you find out. * If a bug looks fixed, ask the bug reporters for feedback to find out if the bug can be closed. * Fix a bug if you can. Please make the pull request against the *develop* branch of the repository. + * There is a *Junior Job* label for issues we think might be a good point to start with. + But you don't have to limit yourself to those issues. ###Web interface diff --git a/doc/Install.md b/doc/Install.md index bd15f10b5..5afd5a22c 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -10,9 +10,11 @@ Not every PHP/MySQL hosting provider will be able to support Friendica. Many will. But **please** review the requirements and confirm these with your hosting provider prior to installation. -Also if you encounter installation issues, please let us know via the [helper]() or the [developer]() forum or [file an issue](https://github.com/friendica/friendica/issues). +Also if you encounter installation issues, please let us know via the [helper](http://helpers.pyxis.uberspace.de/profile/helpers) or the [developer](https://friendika.openmindspace.org/profile/friendicadevelopers) forum or [file an issue](https://github.com/friendica/friendica/issues). Please be as clear as you can about your operating environment and provide as much detail as possible about any error messages you may see, so that we can prevent it from happening in the future. -Due to the large variety of operating systems and PHP platforms in existence we may have only limited ability to debug your PHP installation or acquire any missing modules - but we will do our best to solve any general code issues. +Due to the large variety of operating systems and PHP platforms in existence we may have only limited ability to debug your PHP installation or acquire any missing modules - but we will do our best to solve any general code issues. +If you do not have a Friendica account yet, you can register a temporary one at [tryfriendica.de](https://tryfriendica.de) and join the forums mentioned above from there. +The account will expire after 7 days, but you can ask the server admin to keep your account longer, should the problem not be resolved after that. Before you begin: Choose a domain name or subdomain name for your server. Put some thought into this. Changing it after installation is currently not supported. @@ -29,7 +31,7 @@ Requirements * curl, gd, mysql, hash and openssl extensions * some form of email server or email gateway such that PHP mail() works * mcrypt (optional; used for server-to-server message encryption) -* Mysql 5.x +* Mysql 5.x or an equivalant alternative for MySQL (MariaDB etc.) * the ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks (Windows) (Note: other options are presented in Section 7 of this document.) * Installation into a top-level domain or sub-domain (without a directory/path component in the URL) is preferred. Directory paths will not be as convenient to use and have not been thoroughly tested. * If your hosting provider doesn't allow Unix shell access, you might have trouble getting everything to work. @@ -42,23 +44,23 @@ Installation procedure Unpack the Friendica files into the root of your web server document area. If you are able to do so, we recommend using git to clone the source repository rather than to use a packaged tar or zip file. This makes the software much easier to update. -The Linux command to clone the repository into a directory "mywebsite" would be +The Linux command to clone the repository into a directory "mywebsite" would be + + git clone https://github.com/friendica/friendica.git mywebsite - git clone https://github.com/friendica/friendica.git mywebsite - Make sure the folder *view/smarty3* exists and is writable by the webserver user - - mkdir view/smarty3 - chmod 777 view/smarty3 - + + mkdir view/smarty3 + chmod 777 view/smarty3 + Get the addons by going into your website folder. - - cd mywebsite - + + cd mywebsite + Clone the addon repository (separately): - - git clone https://github.com/friendica/friendica-addons.git addon - + + git clone https://github.com/friendica/friendica-addons.git addon + If you copy the directory tree to your webserver, make sure that you also copy .htaccess - as "dot" files are often hidden and aren't normally copied. ###Create a database @@ -87,14 +89,14 @@ You might wish to move/rename .htconfig.php to another name and empty (called 'd Set up a cron job or scheduled task to run the poller once every 5-10 minutes in order to perform background processing. Example: - cd /base/directory; /path/to/php include/poller.php + cd /base/directory; /path/to/php include/poller.php Change "/base/directory", and "/path/to/php" as appropriate for your situation. If you are using a Linux server, run "crontab -e" and add a line like the one shown, substituting for your unique paths and settings: - */10 * * * * cd /home/myname/mywebsite; /usr/bin/php include/poller.php + */10 * * * * cd /home/myname/mywebsite; /usr/bin/php include/poller.php You can generally find the location of PHP by executing "which php". If you run into trouble with this section please contact your hosting provider for assistance. @@ -104,25 +106,31 @@ Alternative: You may be able to use the 'poormancron' plugin to perform this ste To do this, edit the file ".htconfig.php" and look for a line describing your plugins. On a fresh installation, it will look like this: - $a->config['system']['addon'] = 'js_upload'; + $a->config['system']['addon'] = 'js_upload'; It indicates the "js_upload" addon module is enabled. You may add additional addons/plugins using this same line in the configuration file. Change it to read - $a->config['system']['addon'] = 'js_upload,poormancron'; + $a->config['system']['addon'] = 'js_upload,poormancron'; -and save your changes. +and save your changes. + +Once you have installed Friendica and created an admin account as part of the process, you can access the admin panel of your installation and do most of the server wide configuration from there Updating your installation with git --- You can get the latest changes at any time with - cd mywebsite - git pull + cd mywebsite + git pull + +The default branch to use it the ``master`` branch, which is the stable version of Friendica. +If you want to use and test bleeding edge code please checkout the ``develop`` branch. +The new features and fixes will be merged from ``develop`` into ``master`` when they are stable approx four times a year. The addon tree has to be updated separately like so: - - cd mywebsite/addon - git pull + + cd mywebsite/addon + git pull diff --git a/doc/de/Chats.md b/doc/de/Chats.md index a2d06f3c4..ae239a675 100644 --- a/doc/de/Chats.md +++ b/doc/de/Chats.md @@ -3,33 +3,33 @@ Chats * [Zur Startseite der Hilfe](help) -Du hast derzeit zwei Möglichkeiten, einen Chat auf Deiner Friendica-Seite zu betreiben +Du hast derzeit zwei Möglichkeiten, einen Chat auf Deiner Friendica-Seite zu betreiben * IRC - Internet Relay Chat * Jappix ##IRC Plugin -Sobald das Plugin aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden. -Beachte aber, dass dieser Chat auch ohne Anmeldung auf Deiner Seite zugänglich ist und somit auch Fremde diesen Chat mitnutzen können. +Sobald das Plugin aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden. +Beachte aber, dass dieser Chat auch ohne Anmeldung auf Deiner Seite zugänglich ist und somit auch Fremde diesen Chat mitnutzen können. -Wenn Du dem Link folgst, dann kommst Du zum Anmeldefenster des IR-Chats. -Wähle nun einen Spitznamen (Nickname) und wähle einen Raum aus, in dem Du chatten willst. -Hier kannst Du jeden Namen eingeben. -Es kann also auch #tollerChatdessenNamenurichkenne sein. +Wenn Du dem Link folgst, dann kommst Du zum Anmeldefenster des IR-Chats. +Wähle nun einen Spitznamen (Nickname) und wähle einen Raum aus, in dem Du chatten willst. +Hier kannst Du jeden Namen eingeben. +Es kann also auch #tollerChatdessenNamenurichkenne sein. Gib als nächstes noch die Captchas ein, um zu zeigen, dass es sich bei Dir um einen Menschen handelt und klicke auf "Connect". -Im nächsten Fenster siehst Du zunächst viel Text beim Verbindungsaufbau, der allerdings für Dich nicht weiter von Bedeutung ist. -Anschließend öffnet sich das Chat-Fenster. -In den ersten Zeilen wird Dir Dein Name und Deine aktuelle IP-Adresse angezeigt. -Rechts im Fenster siehst Du alle Teilnehmer des Chats. +Im nächsten Fenster siehst Du zunächst viel Text beim Verbindungsaufbau, der allerdings für Dich nicht weiter von Bedeutung ist. +Anschließend öffnet sich das Chat-Fenster. +In den ersten Zeilen wird Dir Dein Name und Deine aktuelle IP-Adresse angezeigt. +Rechts im Fenster siehst Du alle Teilnehmer des Chats. Unten hast Du ein Eingabefeld, um Beiträge zu schreiben. Weiter Informationen zu IRC findest Du zum Beispiel auf ubuntuusers.de, in Wikipedia oder bei icrhelp.org (in Englisch). ##Jappix Mini -Das Jappix Mini Plugin erlaubt das Erstellen einer Chatbox für Jabber/XMPP-Kontakte. +Das Jappix Mini Plugin erlaubt das Erstellen einer Chatbox für Jabber/XMPP-Kontakte. Ein Jabber/XMPP Account sollte vor der Installation bereits vorhanden sein. Die ausführliche Anleitung dazu und eine Kontrolle, ob Du nicht sogar schon über Deinen E-Mail Anbieter einen Jabber-Account hast, findest Du unter einfachjabber.de. @@ -53,29 +53,29 @@ oder als normaler Download von hier: https://github.com/friendica/friendica-addo Entpacke diese Datei (ggf. den entpackten Ordner in „jappixmini“ umbenennen) und lade sowohl den entpackten Ordner komplett als auch die .tgz Datei in den Addon Ordner Deiner Friendica Installation hoch. -Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Plugins. +Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Plugins. Aktiviere das Jappixmini Addon und gehe anschließend über die Plugins Seitenleiste (dort wo auch die Twitter-, Impressums-, GNU Social-, usw. Einstellungen gemacht werden) zu den Jappix Grundeinstellungen. -Setze hier den Haken zur Aktivierung des BOSH Proxys. +Setze hier den Haken zur Aktivierung des BOSH Proxys. Weiter gehts in den Einstellungen Deines Friendica Accounts. 2. Einstellungen -Gehe bitte zu den Plugin-Einstellungen in Deinen Konto-Einstellungen (Account Settings). +Gehe bitte zu den Plugin-Einstellungen in Deinen Konto-Einstellungen (Account Settings). Scrolle ein Stück hinunter bis zu den Jappix Mini Addon settings. Aktiviere hier zuerst das Addon. -Trage nun Deinen Jabber/XMPP Namen ein, ebenfalls die entsprechende Domain bzw. den Server (ohne http, also zb einfach so: jappix.com). +Trage nun Deinen Jabber/XMPP Namen ein, ebenfalls die entsprechende Domain bzw. den Server (ohne http, also zb einfach so: jappix.com). Um das JavaScript Applet zum Chatten im Browser verwenden zu können, benötigst du einen BOSH Proxy. Entweder betreibst du deinen eigenen (s. Dokumentation deines XMPP Servers) oder du verwendest einen öffentlichen BOSH Proxy. Beachte aber, dass der Betreiber dieses Proxies den kompletten Datenverkehr über den Proxy mitlesen kann. -Siehe dazu auch die „Configuration Help“ weiter unten. -Gebe danach noch Dein Passwort an, und damit ist eigentlich schon fast alles geschafft. -Die weiteren Einstellmöglichkeiten bleiben Dir überlassen, sind also optional. +Siehe dazu auch die „Configuration Help“ unter den Eingabefeldern. +Gebe danach noch Dein Passwort an, und damit ist eigentlich schon fast alles geschafft. +Die weiteren Einstellmöglichkeiten bleiben Dir überlassen, sind also optional. Jetzt noch auf „senden“ klicken und fertig. -Deine Chatbox sollte jetzt irgendwo unten rechts im Browserfenster „kleben“. -Falls Du manuell Kontakte hinzufügen möchtest, einfach den „Add Contact“-Knopf nutzen. +Deine Chatbox sollte jetzt irgendwo unten rechts im Browserfenster „kleben“. +Falls Du manuell Kontakte hinzufügen möchtest, einfach den „Add Contact“-Knopf nutzen. -Viel Spass beim Chatten! +Viel Spass beim Chatten! diff --git a/doc/de/Developers.md b/doc/de/Developers.md index b1d118fd5..2b44e405f 100644 --- a/doc/de/Developers.md +++ b/doc/de/Developers.md @@ -7,18 +7,23 @@ Hier erfährst Du, wie Du bei uns mitmachen kannst: Zunächst erstelle Dir per 'git clone https://github.com/friendica/friendica.git' ein funktionierendes Git-Paket auf Deinem System, auf dem Du die Entwicklung durchführst, und einen eigenen Github-Account. -Erstelle Deine eigene Kopie (fork) der Ursprungsdaten auf Github, an der Du dann entspannt arbeiten kannst. +Erstelle Deine eigene Kopie (fork) der Ursprungsdaten auf Github, an der Du dann entspannt arbeiten kannst. Deine Arbeiten sollten mit einem neuen Arbeitszweig (branch) beginnen, den du vom develop Zweig des Repositories beginnst. Die Anleitung unter [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/) erklärt Dir genau, wie Du das tun musst. Gehe dann nach getaner Arbeit zu Deiner Github-Seite und erstelle eine "Pull request", um Deine Änderungen in das Hauptprojekt einzugliedern (merge). +Solltest du keine Idee haben, an welcher Stelle du einsteigen könntest. +Wir haben einige Aufgaben auf github mit dem Schlagwort *Junior Job* versehen. +Bei diesen Aufgaben gehen wir davon aus, dass sie geeignete Einstiegsstellen sind. +Du musst dich aber natürlich nicht mit diesen Aufgaben beschäftigen um den Friendica Code zu verbeesern. + **Wichtig** -Bitte hole Dir alle Änderungen aus dem Projektverzeichnis und führe sie mit Deiner Arbeit zusammen, **bevor** Du Deine "pull request" erstellst. Wir behalten es uns vor, Patches abzulehnen, die eine große Anzahl an Fehlern hervorrufen. +Bitte hole Dir alle Änderungen aus dem Projektverzeichnis und führe sie mit Deiner Arbeit zusammen, **bevor** Du Deine "pull request" erstellst. Wir behalten es uns vor, Patches abzulehnen, die eine große Anzahl an Fehlern hervorrufen. Dies gilt vor allem für Übersetzungen, da wir hier möglicherweise nicht alle feinen Unterschiede in konfliktären Versionen erkennen können. -Außerdem: **teste Deine Änderungen!** Vergiss nicht, dass eine simple Fehlerlösung einen anderen Fehler auslösen kann. +Außerdem: **teste Deine Änderungen!** Vergiss nicht, dass eine simple Fehlerlösung einen anderen Fehler auslösen kann. Lass Deine Änderungen von einem erfahrenen Friendica-Entwickler gegenprüfen. Eine ausführliche Anleitung zu Git findest Du unter https://git-scm.com/book/de/v1.