aboutsummaryrefslogtreecommitdiff
path: root/template/use.html.j2
diff options
context:
space:
mode:
Diffstat (limited to 'template/use.html.j2')
-rw-r--r--template/use.html.j2105
1 files changed, 44 insertions, 61 deletions
diff --git a/template/use.html.j2 b/template/use.html.j2
index 5ee408cf..d2617386 100644
--- a/template/use.html.j2
+++ b/template/use.html.j2
@@ -11,7 +11,7 @@
11 <nav class="nav subnav position-fixed flex-column border-right" style="position:fixed"> 11 <nav class="nav subnav position-fixed flex-column border-right" style="position:fixed">
12 <a class="nav-link" href="#filesharing">{{ _("Filesharing") }}</a> 12 <a class="nav-link" href="#filesharing">{{ _("Filesharing") }}</a>
13 <a class="nav-link" href="#cadet">{{ _("CADET") }}</a> 13 <a class="nav-link" href="#cadet">{{ _("CADET") }}</a>
14 <a class="nav-link" href="#groupchat">{{ _("Minimal Groupchat") }}</a> 14 <a class="nav-link" href="#messenger">{{ _("Convenient Messenger") }}</a>
15 <a class="nav-link" href="#gns_cli">{{ _("GNS with CLI") }}</a> 15 <a class="nav-link" href="#gns_cli">{{ _("GNS with CLI") }}</a>
16 <a class="nav-link" href="#gns_browser">{{ _("GNS with Browser") }}</a> 16 <a class="nav-link" href="#gns_browser">{{ _("GNS with Browser") }}</a>
17 <a class="nav-link" href="#vpn">{{ _("VPN") }}</a> 17 <a class="nav-link" href="#vpn">{{ _("VPN") }}</a>
@@ -213,69 +213,52 @@
213 </p> 213 </p>
214 </section> 214 </section>
215 215
216
217
218 <section> 216 <section>
219 <h3><a name="groupchat" class="subnav-anchor"></a>{{ _("Chatting with a (simple) client") }}</h3> 217 <h3><a name="messenger" class="subnav-anchor"></a>{{ _("Chatting with a convenient client") }}</h3>
220 <div class="alert" style="background-color: #419edb;"> 218 <p>
221 <div class="alert-content"> 219 To make chatting a tiny bit easier and prettier, we need to install additional software.
222 Notice: The groupchat code is not working with the actual GNUnet release atm! 220 </p>
223 </div> 221 <p>
224 </div> 222 You can select one of the options listed <a href="applications.html">here</a> under applications
225 <p> 223 using the Messenger service. Those are generally compatible with each other using the same
226 To make chatting a tiny bit easier and prettier, we need to install and compile additional software. 224 underlying <a href="https://git.gnunet.org/libgnunetchat.git/">library</a> but tell apart in their
227 </p> 225 user interface and design.
228 <p> 226 </p>
229 First we have to install the Nim programming language. Please refer to their <a href="https://nim-lang.org/install.html">project site</a> for further details. The preferred method is using you distributions package manager, e.g. for Debian it would look like this: 227 <p>
230 </p> 228 In other words: You can choose by your own preference how to chat.
231 <code> 229 </p>
232 $ sudo apt install nim<br> 230 <p>
233 $ nim --version<br> 231 After you have picked an application (for example <a href="https://git.gnunet.org/messenger-gtk.git/">Messenger-GTK</a>
234 Nim Compiler Version 1.2.2 [Linux: amd64]<br> 232 or <a href="https://git.gnunet.org/messenger-cli.git/">messenger-cli</a>), follow the instructions for build and installation.
235 Compiled at 2020-06-16<br> 233 Notice that depending on the picked application, you might need additional dependencies besides the library for the chatting
236 Copyright (c) 2006-2020 by Andreas Rumpf<br> 234 functionality.
237 <br> 235 </p>
238 active boot switches: -d:release -d:nativeStackTrace<br> 236 <p>
239 </code> 237 Once you installed the application and started it, a dialog should open to ask you for an account to use or whether you want
240 <p> 238 to create a new one. An account is pretty much an identity which can also be used for <a href="#gns_cli">GNS</a> capabilities.
241 If the displayed version is <b>1.2.2 or newer</b>, we have a compatible version and can continue downloading and compiling the groupchat. If the version is older (like on Ubuntu 18.04) we can install Nim using a tool called <i>choosenim</i>: 239 Accounts don't require any information besides a chosen identifier or nick.
242 </p> 240 </p>
243 <code> 241 <p>
244 $ curl https://nim-lang.org/choosenim/init.sh -sSf | sh 242 Next step is to enter a chat room via your application. The easiest step is choosing a public chat room which is similar to
245 </code> 243 communicate via <a href="#cadet">CADET</a> through a shared port. Look for a function to add a new room or "platform".
246 <p> 244 You should be able to enter any sort of text as key for the room and confirm.
247 Then we follow the onscreen instructions. More information can be found in the <a href="https://nim-lang.org/install.html">official documentation</a>. 245 </p>
248 </p> 246 <p>
249 <p>In the onscreen instructions you'll be ask to add a line to your bashrc - once you've done that, re-read your bash environment to make the change active: 247 A chat room should open using the entered key as identifier and any other person you share the key with should be able to join
250 </p> 248 this room as well using one of the compatible applications as linked above. From here you can simply write text in a proper field
251 <code> 249 and send it as a message to communicate.
252 $ source ~/.bashrc 250 </p>
253 </code> 251 <p>
254 252 In case of any more advanced functionality it is recommended to look for a guide or more detailed information on the source of the
255 <p> 253 used application since implementations can vary, especially the design of user interface.
256 After we have installed (and maybe upgraded) Nim we download and compile the GNUnet groupchat application: 254 </p>
257 </p> 255 <p>
258 <p> 256 Also you can always use the simplified command line tool `gnunet-messenger` provided by GNUnet itself to open or join a chat with
259 <code> 257 its key in a similar way as described above. See the more detailed information in the
260 $ git clone https://git.gnunet.org/groupchat.git<br> 258 <a href="https://docs.gnunet.org/handbook/gnunet.html#Using-the-GNUnet-Messenger">handbook</a> to use it.
261 $ cd groupchat<br> 259 </p>
262 $ make<br>
263 </code>
264 <p>
265 <p>
266 We can now try to enter a chat server running on another GNUnet node using the command:
267 </p>
268 <p>
269 <code>
270 $ LD_LIBRARY_PATH=/path/to/gnunetlibs ./groupchat --config=/path/to/gnunet.conf --server=88RXABKJNMT426FY81N2DXN0M2X37SW5Q1NR005YPDZ1Q7A22CHG --port=t3ss --nick=YOURNICK<br>
271 </code>
272 <p>
273 The peer key and port name given in this example should work as they are almost always online and running groupchat on port "t3ss".
274 <p>
275 </section> 260 </section>
276 261
277
278
279 <section> 262 <section>
280 <h3><a name="gns_cli" class="subnav-anchor"></a>{{ _("Name resolution using GNS on the command line") }}</h3> 263 <h3><a name="gns_cli" class="subnav-anchor"></a>{{ _("Name resolution using GNS on the command line") }}</h3>
281 <p>The GNU Name Service (GNS) is a fully decentralized alternative to the Domain Name System (DNS). Where GNS does not suffer the same major <a href="https://en.wikipedia.org/wiki/Domain_Name_System#Security_issues">security flaws as DNS</a>. 264 <p>The GNU Name Service (GNS) is a fully decentralized alternative to the Domain Name System (DNS). Where GNS does not suffer the same major <a href="https://en.wikipedia.org/wiki/Domain_Name_System#Security_issues">security flaws as DNS</a>.