diff options
Diffstat (limited to 'template/use.html.j2')
-rw-r--r-- | template/use.html.j2 | 105 |
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>. |