add reSt versions of start_guide and start_guide.de

2024-03-22 13:30:51 +08:00 · 2013-08-01 21:46:48 +02:00 · 2013-08-01 21:46:48 +02:00 · c7b8d9184b
commit c7b8d9184b
parent d4b1598d93
2 changed files with 131 additions and 0 deletions
--- a/docs/start_guide.de.rst
+++ 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.
+
+
--- a/docs/start_guide.rst
+++ 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.
+
+