Sync

README.md

@@ -1,11 +1 @@
-# Documentation for [The Kovri Project](https://github.com/monero-project/kovri)
-
-This repository contains all documentation for Kovri.
-This documentation is used heavily in [kovri-site](https://github.com/monero-project/kovri-site).
-Changes here will reflect upon the website, so be sure to work in only markdown .md files.
-
-For the most recent/up-to-date documentation, read the English documentation.
-
-Is your language missing? Simply create a directory for your language in the i18n directory then copy all English files to that directory and make your translations.
-
-For help, see the most recent contact info [here](https://github.com/monero-project/kovri/blob/master/README.md).
+NOTICE: THIS REPOSITORY HAS BEEN MOVED TO GitLab. See https://github.com/monero-project/kovri-docs/issues/102 for details.

i18n/da/faq.md

@@ -131,7 +131,7 @@ Da denne slags uregelmæssige adfærd ville kun skade I2P-netværket og projekte
 
 ### Jeg har fundet en sikkerhedsfejl! Jeg har fundet en fejl! Hvad gør jeg?
 - Sikkerhedsfejle: læs vores [README](https://github.com/monero-project/kovri/blob/master/README.md)
-- Bugs: Læs vores [Developer Guide](https://github.com/monero-project/kovri-docs/blob/master/i18n/da/developer_guide.md)
+- Bugs: Læs vores [Udviklerguide](https://github.com/monero-project/kovri-docs/blob/master/i18n/da/developer_guide.md)
 
 ### Hvorfor viser min log mig en dato/tid forskellig for min tidszone?
 Logfiler registreres i UTC for at beskytte dit privatliv. Ved at bruge UTC har du bedre mulighed for at uploade logs, til at dele dem med udviklere eller fællesskabet uden at påvirke din anonymitet.

i18n/da/monero_guide.md

@@ -0,0 +1,92 @@
+# Monero via Kovri
+
+## Getting Started
+
+1. Follow the instructions for building and/or installing [Kovri](https://github.com/monero-project/kovri) & [Monero](https://github.com/monero-project/monero)
+2. Review the [User Guide](https://github.com/monero-project/kovri-docs/blob/master/i18n/en/user_guide.md) in your language of choice
+3. Configure Kovri server and client tunnels to connect to `monerod` nodes over the I2P network
+
+## Kovri server tunnel
+
+First, configure a server tunnel on one node.
+
+To setup a server tunnel, see `tunnels.conf` located in your data directory. To locate your data directory, see `kovri.conf`.
+
+```
+[XMR_P2P_Server]
+type = server
+address = 127.0.0.1
+port = 28080
+in_port = 28080
+keys = xmr-p2p-keys.dat
+;white_list =
+;black_list =
+```
+
+This configuration will open a Kovri listener on `monerod`'s default testnet P2P port. Next, read the [User Guide](https://github.com/monero-project/kovri-docs/blob/master/i18n/en/user_guide.md) for how to obtain the base32 destination address.
+
+If you have already started your kovri router, run `$ kill -HUP $(pgrep kovri)` to load the new tunnel. More drastically, you can also do a hard restart by stopping and starting kovri.
+
+## Kovri client tunnel
+
+Now that the server tunnel is setup, begin the client tunnel setup by pointing to the server tunnel.
+
+Example:
+
+```
+[XMR_Client]
+type = client
+address = 127.0.0.1
+port = 24040
+dest = your-copied-server-destination.b32.i2p
+dest_port = 28080
+keys = xmr-client-keys.dat
+```
+
+Repeat the process for each node you would like to connect using Kovri.
+
+If you have already started your kovri router, run `$ kill -HUP $(pgrep kovri)` to load the new tunnel. More drastically, you can also do a hard restart by stopping and starting kovri.
+
+## Monero P2P via Kovri
+
+Pointing `monerod` to your new Kovri client tunnel is just as easy.
+
+Here is an example for starting a mining testnet node:
+
+```bash
+monerod --testnet --start-mining your-testnet-wallet-address --add-exclusive-node 127.0.0.1:24040
+```
+
+If you notice connectivity issues, wait for your Kovri nodes to integrate into the network (~5-10 min after start).
+
+## Monero RPC via Kovri
+
+Exposing Monero's RPC service via Kovri is a similar process.
+
+Configure a server tunnel on your Kovri node:
+
+```
+[XMR_RPC_Server]
+type = server
+address = 127.0.0.1
+port = 28081
+in_port = 28081
+keys = xmr-rpc-keys.dat
+;white_list =
+;black_list =
+```
+
+This will generate a new set of keys, and a new destination address.
+
+To use the same destination address as P2P, simply replace `xmr-rpc-keys.dat` with `xmr-p2p-keys.dat` in the above configuration.
+
+If you have already started your kovri router, run `$ kill -HUP $(pgrep kovri)` to load the new tunnel. More drastically, you can also do a hard restart by stopping and starting kovri.
+
+This tunnel exposes `monerod`'s default testnet JSON RPC, and one can use Kovri's HTTP client tunnel to connect.
+
+Here is an example for connecting with curl from a Kovri client node:
+
+```bash
+export http_proxy=127.0.0.1:4446 rpc_server=http://your-copied-rpc-destination.b32.i2p:28081
+curl -X POST ${rpc_server}/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_height"}' -H 'Content-Type: application/json'
+```

i18n/de/README.md

@@ -18,8 +18,6 @@ Dies ist eine Übersetzung der Kovri-Readme-Datei, das (englischsprachige) Origi
 
 ### Versionen
 
-Die Veröffentlichung der Alpha-Version steht kurz bevor.
-
 ### [Nightly Releases (bleeding edge)](https://build.getmonero.org/waterfall)
 
 | Installer | Prüfsumme | Status |

i18n/de/developer_guide.md

@@ -7,7 +7,7 @@
 - Wir sind auch via [HackerOne](https://hackerone.com/monero) erreichbar
 
 ## Stil
-1. Lies dir [Googles C++-Stilhandbuch](https://google.github.io/styleguide/cppguide.html) durch (insbesondere für nicht formattierende Stilverweise)
+1. Lies dir [Googles C++-Stilhandbuch](https://google.github.io/styleguide/cppguide.html) durch (insbesondere für nicht formatierende Stilverweise)
     - Bei Bash-Programmierung, lies [Googles Shell-Stilhandbuch](https://github.com/google/styleguide/blob/gh-pages/shell.xml)
 2. Bei Dateien, die nur Neues enthalten, lasse [clang-format](http://clang.llvm.org/docs/ClangFormat.html) mit ```-style=file``` (das unser bereitgestelltes [.clang-format](https://github.com/monero-project/kovri/blob/master/.clang-format) nutzt) laufen
 ```bash
@@ -50,7 +50,7 @@ Um deine Arbeit beizusteuern, gehe bitte wie folgt vor:
 1. [Forke](https://help.github.com/articles/fork-a-repo/) Kovri
 2. Gehe nochmals den Stil-Abschnitt dieses Dokuments durch
 3. Erstelle einen [themenspezifischen Branch](https://git-scm.com/book/de/v1/Git-Branching-Einfaches-Branching-und-Merging)
-   - Wir haben momentan keine Tags, da da wir uns noch im Pre-Alpha-Stadium befinden. Du kannst deine Arbeit fürs Erste auf dem master-Branch aufbauen
+   - Wir haben momentan keine Tags, da da wir uns noch im Alpha-Stadium befinden. Du kannst deine Arbeit fürs Erste auf dem master-Branch aufbauen
 4. Nimm Änderungen vor
    - Commits sollten wann immer möglich [atomar (*atomic*)](https://en.wikipedia.org/wiki/Atomic_commit#Atomic_commit_convention) und Diffs einfach zu lesen sein
    - Versuche bitte, keine Ausbesserungen der Formatierung mit Nicht-Formatierungs-Commits zu vermischen

i18n/de/faq.md

@@ -73,9 +73,9 @@ Zweitens, während die Java-Implementierung von I2P großartig ist, kommt sie mi
 - Ausführen deines Hundes oder Lieblingstieres, Zahlen deiner Steuern
 
 ### Was ist der aktuelle Stand von Kovri?
-Kovri befindet sich in aktiver Entwicklung und ist derzeit in einem Pre-Alpha-Stadium. Es ist noch *nicht* in Monero integriert, aber neben einigen Kernfunktionen entwickeln wir eine [Client](https://github.com/monero-project/kovri/issues/351)- und eine [Core](https://github.com/monero-project/kovri/issues/350)-API, die Monero und andere Anwendungen nutzen können.
+Kovri befindet sich in aktiver Entwicklung und ist derzeit in einem Alpha-Stadium. Es ist noch *nicht* in Monero integriert, aber neben einigen Kernfunktionen entwickeln wir eine [Client](https://github.com/monero-project/kovri/issues/351)- und eine [Core](https://github.com/monero-project/kovri/issues/350)-API, die Monero und andere Anwendungen nutzen können.
 
-Aber nur weil wir in Pre-Alpha sind, bedeutet das nicht, dass man Kovri nicht nutzen kann. Derzeit kann man Kovri verwenden, um eine Verbindung mit dem I2P-Netzwerk herzustellen (und daran teilzunehmen), um auf Eepsites zu browsen, sich mit IRC zu verbinden sowie Client- und Server-Tunnel zu betreiben.
+Aber nur weil wir in Alpha sind, bedeutet das nicht, dass man Kovri nicht nutzen kann. Derzeit kann man Kovri verwenden, um eine Verbindung mit dem I2P-Netzwerk herzustellen (und daran teilzunehmen), um auf Eepsites zu browsen, sich mit IRC zu verbinden sowie Client- und Server-Tunnel zu betreiben.
 
 ### Wann gibt es die Alpha-Version?
 Eine Alpha-Version ist in Arbeit und wird (hoffentlich!!) vor Ende 2017 veröffentlicht. Sobald wir in der Alpha-Phase sind, beginnt sofort die Arbeit an der Beta-Version, die Folgendes erfordert: eine vollständig implementierte API, die Lösung wesentlicher Qualitätssicherungsprobleme und verschiedene Bugfixes.
@@ -84,11 +84,11 @@ Eine Alpha-Version ist in Arbeit und wird (hoffentlich!!) vor Ende 2017 veröffe
 Derzeit konzentrieren wir uns auf alles, was in unserem [Issue-Tracker](https://github.com/monero-project/kovri/issues/) aufgeführt ist. Das deckt einen Großteil dessen ab, was wir vor der offiziellen Alpha-Version fertigstellen müssen.
 
 ### Wie einsatzfähig sind Kovri und die Privatsphäre, die es bietet, zurzeit?
-Kovri ist im Rahmen dessen, was `./kovri --help` zu bieten hat, verwendbar. Kovri hat gegenwärtig keine Interaktion mit Monero. Im Hinblick auf den Schutz der Privatsphäre haben wir seit der Einführung viele Sicherheitsprobleme behoben, aber wir möchten dich daran erinnern, dass wir uns noch immer in der Pre-Alpha-Phase befinden.
+Kovri ist im Rahmen dessen, was `./kovri --help` zu bieten hat, verwendbar. Kovri hat gegenwärtig keine Interaktion mit Monero. Im Hinblick auf den Schutz der Privatsphäre haben wir seit der Einführung viele Sicherheitsprobleme behoben, aber wir möchten dich daran erinnern, dass wir uns noch immer in der Alpha-Phase befinden.
 
 Es gibt immer noch viel Code zu schreiben, erwarte also keine starke Anonymitätsgarantie wie mit Tor oder selbst Java-I2P. Diese Projekte haben mehr als 10 Jahre Erfahrung in der Forschung und Implementierung, und wir fangen gerade erst an.
 
-Du kannst gerne die Rolle des Entwicklers spielen und mit Kovri experimentieren, aber nur, wenn dich die Tatsache, dass du **nicht** anonym bist, nicht in Gefahr bringt, da immer das Risiko einer möglichen Deanonymisierung besteht, weil wir uns noch in Pre-Alpha befinden (das ist nicht Kovri-spezifisch).
+Du kannst gerne die Rolle des Entwicklers spielen und mit Kovri experimentieren, aber nur, wenn dich die Tatsache, dass du **nicht** anonym bist, nicht in Gefahr bringt, da immer das Risiko einer möglichen Deanonymisierung besteht, weil wir uns noch in Alpha befinden (das ist nicht Kovri-spezifisch).
 
 
 ### Wie kann ich die Kovri-Entwickler erreichen?
@@ -137,7 +137,7 @@ Da die restlichen Entwickler erkannten, dass ein solch erratisches Verhalten nur
 
 ### Ich habe eine Schwachstelle gefunden! Ich habe einen Bug gefunden! Was soll ich tun?
 - Schwachstellen: siehe unser [README](https://github.com/monero-project/kovri/blob/master/README.md)
-- Bugs: siehe unseren [Beitragsleitfaden](https://github.com/monero-project/kovri-docs/blob/master/i18n/de/developer_guide.md)
+- Bugs: siehe unser [Entwicklerhandbuch](https://github.com/monero-project/kovri-docs/blob/master/i18n/de/developer_guide.md)
 
 ### Warum zeigt mein Log ein anderes Datum/eine andere Uhrzeit als meine Zeitzone?
 Logs werden in UTC aufgezeichnet, um deine Privatsphäre zu schützen. Durch die Verwendung von UTC kannst du Logs besser hochladen, um sie mit anderen Entwicklern oder der Community zu teilen, ohne deine Anonymität zu beeinträchtigen.

i18n/de/monero_guide.md

@@ -0,0 +1,92 @@
+# Monero über Kovri
+
+## Erste Schritte
+
+1. Folge den Anleitungen zum Kompilieren und/oder Installieren von [Kovri](https://github.com/monero-project/kovri) & [Monero](https://github.com/monero-project/monero)
+2. Sieh das [Benutzerhandbuch](https://github.com/monero-project/kovri-docs/blob/master/i18n/de/user_guide.md) in der Sprache deiner Wahl durch
+3. Konfiguriere Kovri-Server- und -Client-Tunnel für die Verbindung mit `monerod`-Nodes über das I2P-Netzwerk
+
+## Kovri-Server-Tunnel
+
+Konfiguriere zunächst einen Server-Tunnel auf einem Node.
+
+Infos zum Einrichten eines Server-Tunnels sind in der Datei `tunnels.conf` in deinem Datenverzeichnis. Um dein Datenverzeichnis zu finden, siehe `kovri.conf`.
+
+```
+[XMR_P2P_Server]
+type = server
+address = 127.0.0.1
+port = 28080
+in_port = 28080
+keys = xmr-p2p-keys.dat
+;white_list =
+;black_list =
+```
+
+Diese Konfiguration öffnet einen Kovri-Listener auf dem standardmäßigen Testnet-P2P-Port von `monerod`. Lese als nächstes im [Benutzerhandbuch](https://github.com/monero-project/kovri-docs/blob/master/i18n/de/user_guide.md), wie man die Base32-Zieladresse erhält.
+
+Falls du bereits deinen Kovri-Router gestartet hast, führe `$ kill -HUP $(pgrep kovri)` aus, um den neuen Tunnel zu laden. Eine drastischere Möglichkeit besteht darin, einen harten Neustart durchzuführen, durch Stoppen und Starten von Kovri.
+
+## Kovri-Client-Tunnel
+
+Jetzt, wo der Server-Tunnel eingerichtet ist, kannst du die Einrichtung des Client-Tunnels durch Zeigen auf den Server-Tunnel starten.
+
+Beispiel:
+
+```
+[XMR_Client]
+type = client
+address = 127.0.0.1
+port = 24040
+dest = dein-kopiertes-server-ziel.b32.i2p
+dest_port = 28080
+keys = xmr-client-keys.dat
+```
+
+Wiederhole den Prozess für jeden Node, den du mittels Kovri verbinden möchtest.
+
+Falls du bereits deinen Kovri-Router gestartet hast, führe `$ kill -HUP $(pgrep kovri)` aus, um den neuen Tunnel zu laden. Eine drastischere Möglichkeit besteht darin, einen harten Neustart durchzuführen, durch Stoppen und Starten von Kovri.
+
+## Monero P2P über Kovri
+
+Es ist genauso einfach, `monerod` auf deinen neuen Kovri-Client-Tunnel zeigen zu lassen.
+
+Hier ist ein Beispiel für das Starten eines minenden Testnet-Nodes:
+
+```bash
+monerod --testnet --start-mining deine-Testnet-Wallet-Adresse --add-exclusive-node 127.0.0.1:24040
+```
+
+Falls du Verbindungsprobleme bemerkst, warte, bis sich deine Kovri-Nodes ins Netzwerk integrieren (~5-10 Minuten nach dem Start).
+
+## Monero RPC über Kovri
+
+Moneros RPC-Service über Kovri verfügbar zu machen, ist ein ähnlicher Prozess.
+
+Konfiguriere einen Server-Tunnel auf deinem Kovri-Node:
+
+```
+[XMR_RPC_Server]
+type = server
+address = 127.0.0.1
+port = 28081
+in_port = 28081
+keys = xmr-rpc-keys.dat
+;white_list =
+;black_list =
+```
+
+Dies wird einen neuen Schlüsselsatz und eine neue Zieladresse erzeugen.
+
+Um dieselbe Zieladresse als P2P zu nutzen, ersetze einfach `xmr-rpc-keys.dat` durch `xmr-p2p-keys.dat` in der obigen Konfiguration.
+
+Falls du bereits deinen Kovri-Router gestartet hast, führe `$ kill -HUP $(pgrep kovri)` aus, um den neuen Tunnel zu laden. Eine drastischere Möglichkeit besteht darin, einen harten Neustart durchzuführen, durch Stoppen und Starten von Kovri.
+
+Dieser Tunnel macht `monerod`s standardmäßiges Testnet-JSON-RPC verfügbar und man kann Kovris HTTP-Client-Tunnel verwenden, um sich zu verbinden.
+
+Hier ist ein Beispiel zur Verbindung mit curl von einem Kovri-Client-Node aus:
+
+```bash
+export http_proxy=127.0.0.1:4446 rpc_server=http://dein-kopiertes-rpc-ziel.b32.i2p:28081
+curl -X POST ${rpc_server}/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_height"}' -H 'Content-Type: application/json'
+```

i18n/de/user_guide.md

@@ -11,16 +11,16 @@ Hinweise:
 - Wenn du keinen Zugang zu deinem NAT hast, verwende die Laufzeitoption `--enable-upnp` oder schalte die Option in `kovri.conf` ein.
 - **Teile deine Portnummer mit niemandem, da dies deine Anonymität beeinträchtigen wird!**
 
-## Schritt 2. (Empfohlen) Betriebssicherheit (Opsec)
+## Schritt 2. (Empfohlen) Operative Sicherheit (Opsec)
 
-- Erwäge, einen festgelegten `kovri`-Benutzer zu erstellen und führe kovri nur mit diesem Benutzer aus
+- Erwäge, einen eigenen `kovri`-Benutzer zu erstellen und führe kovri nur mit diesem Benutzer aus
 - Wenn du Linux nutzt, denke über die Verwendung eines gehärteten Kernels nach (wie etwa [grsec](https://en.wikibooks.org/wiki/Grsecurity) mit RBAC)
 - Nachdem du die entsprechenden Ressourcen in deinem kovri-Datenpfad installiert hast, solltest du eine angemessene Zugriffssteuerung (Access Control) einstellen mit [setfacl](https://linux.die.net/man/1/setfacl), [umask](https://en.wikipedia.org/wiki/Umask) oder was auch immer dein Betriebssystem als ACL (Access Control List) verwendet
 - Teile deine Portnummer mit niemandem, da dies deine Anonymität beeinträchtigen wird!
 
 **Hinweis: Deinen Datenpfad für Linux/OSX/Windows findest du in kovri.conf**
 
-## Schritt 3. Kovri konfigurieren, Tunnel einrichten
+## Schritt 3. Kovri konfigurieren
 
 Für eine vollständige Liste der Optionen:
 
@@ -41,18 +41,19 @@ Für vollständige Optionen mit Details:
 
 ## Schritt 4. (Optional) Tunnel einrichten
 
-Kurz gesagt, *Client-Tunnel* sind Tunnel, über die du Verbindungen zu anderen Diensten herstellst, und *Server-Tunnel* werden verwendet, wenn du Dienste hostest (und andere Personen sich mit deinem Dienst verbinden).
+Kurz gesagt, *Client-Tunnel* sind Tunnel, über die du Verbindungen zu anderen Diensten herstellst. *Server-Tunnel* werden verwendet, wenn du Dienste hostest, sodass sich andere Personen mit deinem Dienst (Website, SSH, etc.) verbinden können.
 
 Du hast standardmäßig Client-Tunnel für IRC (Irc2P) und E-Mail (i2pmail) eingerichtet. Zum Hinzufügen/Entfernen von Client-Tunneln, siehe `tunnels.conf`.
 
-Beim Erstellen von Server-Tunneln musst du *persistente private Schlüssel* erzeugen. Entferne dafür das Kommentarzeichen bei bzw. schreibe `keys = your-keys.dat` und ersetze `your-keys` mit einem geeigneten Namen. **Teile deine private `.dat`-Datei mit niemandem und stelle sicher, dass du eine Sicherungskopie erstellst!**
+Beim Erstellen von Server-Tunneln musst du *dauerhafte private Schlüssel* erzeugen, die für dein Ziel verwendet werden. Entferne dafür das Kommentarzeichen bei bzw. schreibe `keys = your-keys.dat` und ersetze `your-keys` mit einem geeigneten Namen. **Teile deine private `.dat`-Datei mit niemandem (hier besteht eine einzige Ausnahme und zwar, falls du Multihoming einsetzen möchtest) und stelle sicher, dass du eine Sicherungskopie der Datei erstellst!**
 
-Nach der Einrichtung wird deine [Base32-Adresse](https://getmonero.org/resources/moneropedia/base32-address) in deinem Log angezeigt, nachdem du kovri gestartet hast. Du findest die Adresse auch in einer Textdatei zusammen mit der privaten Schlüsseldatei in deinem kovri-Datenpfad im `client/keys`-Ordner. Die Adresse in dieser `.txt`-Textdatei kann gefahrlos weitergegeben werden, damit sich andere Personen mit deinem Dienst verbinden können.
+Nach der Einrichtung wird dein [Base32](https://getmonero.org/resources/moneropedia/base32-address)- und [Base64](https://getmonero.org/resources/moneropedia/base64-address)-codiertes Ziel in deinem Log angezeigt, nachdem du kovri gestartet hast. Du findest diese Codierungen auch in einer Textdatei zusammen mit der `.dat`-Datei in deinem kovri-Datenpfad im `client/keys`-Ordner. Das codierte Ziel in den **Textdateien** `.dat.b32.txt` und `.dat.b64.txt`kann gefahrlos an andere weitergegeben werden, damit sie sich mit deinem Dienst verbinden können.
 
 Beispiel:
 
 - Private Schlüsseldatei: `client/keys/your-keys.dat`
-- Öffentliche [Base32](https://getmonero.org/resources/moneropedia/base32-address)-/[Base64](https://getmonero.org/resources/moneropedia/base64-address)-Adresse: `client/keys/your-keys.dat.txt`
+- Öffentliche [Base32](https://getmonero.org/resources/moneropedia/base32-address): `client/keys/your-keys.dat.b32.txt`
+- Öffentliche [Base64](https://getmonero.org/resources/moneropedia/base64-address): `client/keys/your-keys.dat.b64.txt`
 
 **Hinweis: Deinen Datenpfad für Linux/OSX/Windows findest du in kovri.conf**