From c7b8d9184b6d4cfda7e6e4a49739720de594ff39 Mon Sep 17 00:00:00 2001 From: Florian Hahn Date: Thu, 1 Aug 2013 21:46:48 +0200 Subject: [PATCH] add reSt versions of start_guide and start_guide.de --- docs/start_guide.de.rst | 68 +++++++++++++++++++++++++++++++++++++++++ docs/start_guide.rst | 63 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 131 insertions(+) create mode 100644 docs/start_guide.de.rst create mode 100644 docs/start_guide.rst diff --git a/docs/start_guide.de.rst b/docs/start_guide.de.rst new file mode 100644 index 00000000..b997e575 --- /dev/null +++ b/docs/start_guide.de.rst @@ -0,0 +1,68 @@ +Tox nutzen +========== + +1. Tox erstellen +2. Fehler korrigieren +3. Im IRC nach Hilfe fragen +4. Auf Debug-Reise für Entwickler +5. Tox wirklich erstellen +6. ??? + +Trotz der ganzen Arbeit, die wir bisher in Tox gesteckt haben, gibt es +noch keine richtige Anleitung, wie man Tox *benutzt*. Dies ist ein +anwenderfreundlicher Versuch. + +1. Verbinde dich zum Netzwerk! + + - Du musst dich zu einem Bootstrap-Server verbinden, um einen + öffentlichen Schlüssel zu erhalten. + - Wo finde ich einen öffentlichen Server? Zur Zeit hier: (die + Hilfe-Nachricht von nTox ohne Kommandos hilft auch) + + - 198.46.136.167 33445 + 728925473812C7AAC482BE7250BCCAD0B8CB9F737BF3D42ABD34459C1768F854 + - 192.81.133.111 33445 + 8CD5A9BF0A6CE358BA36F7A653F99FA6B258FF756E490F52C1F98CC420F78858 + - 66.175.223.88 33445 + AC4112C975240CAD260BB2FCD134266521FAAF0A5D159C5FD3201196191E4F5D + - 192.184.81.118 33445 + 5CD7EB176C19A2FD840406CD56177BB8E75587BB366F7BB3004B19E3EDC04143 + +2. Finde einen Freund! + + - Jetzt, da du im Netzwerk bist, brauchst du einen Freund. Um einen + zu bekommen, musst du eine Anfrage senden oder erhalten. Was eine + Anfrage ist? Es ist wie eine Freundschaftsanfrage, jedoch benutzen + wir unglaublich schaurige und kryptische Nummern anstatt Namen. + When nTox startet, erscheint *deine* lange, schaurige Nummer, auch + *öffentlicher Schlüssel* genannt. Diesen kannst du an andere + Personen weitergeben und sie können dich als "Freund" hinzufügen. + Oder du fügst andere Personen mit dem */f*-Befehl hinzu, wenn du + möchtest. + +3. Chatte drauf los! + + - Benutze nun den */m*-Befehl, um eine Nachricht an jemanden zu + senden. Wow, du chattest! + +4. Mach etwas kaputt! + + - Jep, pre-alpha-alpha-Software stürzt manchmal ab. Wir arbeiten + daran. + - Bitte melde alle Abstürze entweder an die GitHub-Seite oder + #tox-dev im freenode-IRC. + +5. Nichts ist kaputt, aber was bedeutet */f*? + + - nTox liest einen Text als Befehl, wenn das erste Zeichen ein + Schrägstrich ist ('/'). Du kannst alle Befehle in commands.md + nachlesen. + +6. Benutze und unterstütze Tox! + + - Programmiere, debugge, dokumentiere, übersetze für uns, oder + sprich einfach über uns! + - Je mehr Interesse wir erhalten, desto mehr Arbeit wird getan und + desto besser wird Tox. + + diff --git a/docs/start_guide.rst b/docs/start_guide.rst new file mode 100644 index 00000000..2b60bf42 --- /dev/null +++ b/docs/start_guide.rst @@ -0,0 +1,63 @@ +Using Tox +========= + +.. note:: There is a German version of this page available: :doc:`start_guide.de` + + +1. `Build Tox <../INSTALL.md>`_ +2. Fix errors +3. Consult IRC for help +4. Go on debugging journey for devs +5. Build Tox for real +6. ??? + +For all the work we've put into Tox so far, there isn't yet a decent +guide for how you *use* Tox. Here's a user-friendly attempt at it. + +1. Connect to the network! + + - You need to connect to a bootstrapping server, to give you a + public key. + - Where can I find a public server? Right here, as of now: (the help + message from running ``nTox`` with no args will help) + + - ``198.46.136.167 33445 728925473812C7AAC482BE7250BCCAD0B8CB9F737BF3D42ABD34459C1768F854`` + - ``192.81.133.111 33445 8CD5A9BF0A6CE358BA36F7A653F99FA6B258FF756E490F52C1F98CC420F78858`` + - ``66.175.223.88 33445 AC4112C975240CAD260BB2FCD134266521FAAF0A5D159C5FD3201196191E4F5D`` + - ``192.184.81.118 33445 5CD7EB176C19A2FD840406CD56177BB8E75587BB366F7BB3004B19E3EDC04143`` + +2. Find a friend! + + - Now that you're on the network, you need a friend. To get one of + those, you need to to send or receive a request. What's a request, + you ask? It's like a friend request, but we use really scary and + cryptic numbers instead of names. When ``nTox`` starts, it shows + *your* long, scary number, called your *public key*. Give that to + people, and they can add you as a "friend". Or, you can add + someone else, with the ``/f`` command, if you like. + +3. Chat it up! + + - Now use the ``/m`` command to send a message to someone. Wow, + you're chatting! + +4. But something broke! + + - Yeah, pre-alpha-alpha software tends to do that. We're working on + it. + - Please report all crashes to either the GitHub page, or + ``#tox-dev`` on freenode. + +5. Nothing broke, but what does ``/f`` mean? + + - ``nTox`` parses text as a command if the first character is a + forward-slash (``/``). You can check all commands in commands.md. + +6. Use and support Tox! + + - Code for us, debug for us, document for us, translate for us, even + just talk about us! + - The more interest we get, the more work gets done, the better Tox + is. + +