Bob Mottram преди 8 години
родител
ревизия
55b11d8294
No account linked to committer's email
променени са 2 файла, в които са добавени 356 реда и са изтрити 148 реда
  1. 32
    0
      doc/EN/usage.org
  2. 324
    148
      website/EN/usage.html

+ 32
- 0
doc/EN/usage.org Целия файл

@@ -169,6 +169,7 @@ If you have an Android device then go to F-Droid (if you don't already have it i
169 169
 The DLNA service will only work within your local home network, and isn't remotely accessible from other locations via the internet. That can be both a good and a bad thing. Another consideration is that there are no access controls on DLNA services, so any music or videos on the USB drive will be playable by anyone within your home network.
170 170
 
171 171
 * Microblogging (GNU Social)
172
+** Initial setup
172 173
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
173 174
 
174 175
 #+BEGIN_SRC bash
@@ -183,6 +184,37 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
183 184
 
184 185
 [[file:images/gnusocial_mobile.jpg]]
185 186
 
187
+** Direct Messages (DMs) and privacy
188
+One important point about GNU Social is that although direct messages (DMs) are treated as being private their security is quite poor. If you want real communications privacy then use other systems such as XMPP+OMEMO/OTR, Tox or email with GPG. GNU Social is primarily about /fully public communications/.
189
+** Using with Emacs
190
+If you are an Emacs user it's also possible to set up GNU Social mode as follows:
191
+
192
+#+begin_src bash :tangle no
193
+mkdir ~/elisp
194
+git clone git://git.savannah.nongnu.org/gnu-social-mode ~/elisp/gnu-social-mode
195
+sed -i 's|"http"|"https"|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
196
+sed -i 's|http:|https:|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
197
+sed -i 's|http?|https?|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
198
+echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs
199
+echo "(require 'gnu-social-mode)" >> ~/.emacs
200
+echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs
201
+echo "      gnu-social-server \"yourgnusocialdomain\"" >> ~/.emacs
202
+echo "	  gnu-social-username \"yourusername\"" >> ~/.emacs
203
+echo "	  gnu-social-password \"gnusocialpassword\")" >> ~/.emacs
204
+#+end_src
205
+
206
+And as a quick reference the main keys are:
207
+
208
+| Key           | Function              |
209
+|---------------+-----------------------|
210
+| i             | Show profile icons    |
211
+| CTRL-c CTRL-s | Post status update    |
212
+| r             | Repeat                |
213
+| F             | Favourite             |
214
+| CTRL-c CTRL-h | Highlight             |
215
+| R             | Reply to user         |
216
+| g             | Show current timeline |
217
+
186 218
 * Sharing things
187 219
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.
188 220
 

+ 324
- 148
website/EN/usage.html Целия файл

@@ -3,7 +3,7 @@
3 3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6
-<!-- 2016-06-18 Sat 21:49 -->
6
+<!-- 2016-06-21 Tue 17:51 -->
7 7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 9
 <title></title>
@@ -56,13 +56,96 @@
56 56
     border: 1px solid black;
57 57
   }
58 58
   pre.src:hover:before { display: inline;}
59
-  pre.src-sh:before    { content: 'sh'; }
60
-  pre.src-bash:before  { content: 'sh'; }
59
+  /* Languages per Org manual */
60
+  pre.src-asymptote:before { content: 'Asymptote'; }
61
+  pre.src-awk:before { content: 'Awk'; }
62
+  pre.src-C:before { content: 'C'; }
63
+  /* pre.src-C++ doesn't work in CSS */
64
+  pre.src-clojure:before { content: 'Clojure'; }
65
+  pre.src-css:before { content: 'CSS'; }
66
+  pre.src-D:before { content: 'D'; }
67
+  pre.src-ditaa:before { content: 'ditaa'; }
68
+  pre.src-dot:before { content: 'Graphviz'; }
69
+  pre.src-calc:before { content: 'Emacs Calc'; }
61 70
   pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
62
-  pre.src-R:before     { content: 'R'; }
63
-  pre.src-perl:before  { content: 'Perl'; }
64
-  pre.src-java:before  { content: 'Java'; }
65
-  pre.src-sql:before   { content: 'SQL'; }
71
+  pre.src-fortran:before { content: 'Fortran'; }
72
+  pre.src-gnuplot:before { content: 'gnuplot'; }
73
+  pre.src-haskell:before { content: 'Haskell'; }
74
+  pre.src-java:before { content: 'Java'; }
75
+  pre.src-js:before { content: 'Javascript'; }
76
+  pre.src-latex:before { content: 'LaTeX'; }
77
+  pre.src-ledger:before { content: 'Ledger'; }
78
+  pre.src-lisp:before { content: 'Lisp'; }
79
+  pre.src-lilypond:before { content: 'Lilypond'; }
80
+  pre.src-matlab:before { content: 'MATLAB'; }
81
+  pre.src-mscgen:before { content: 'Mscgen'; }
82
+  pre.src-ocaml:before { content: 'Objective Caml'; }
83
+  pre.src-octave:before { content: 'Octave'; }
84
+  pre.src-org:before { content: 'Org mode'; }
85
+  pre.src-oz:before { content: 'OZ'; }
86
+  pre.src-plantuml:before { content: 'Plantuml'; }
87
+  pre.src-processing:before { content: 'Processing.js'; }
88
+  pre.src-python:before { content: 'Python'; }
89
+  pre.src-R:before { content: 'R'; }
90
+  pre.src-ruby:before { content: 'Ruby'; }
91
+  pre.src-sass:before { content: 'Sass'; }
92
+  pre.src-scheme:before { content: 'Scheme'; }
93
+  pre.src-screen:before { content: 'Gnu Screen'; }
94
+  pre.src-sed:before { content: 'Sed'; }
95
+  pre.src-sh:before { content: 'shell'; }
96
+  pre.src-sql:before { content: 'SQL'; }
97
+  pre.src-sqlite:before { content: 'SQLite'; }
98
+  /* additional languages in org.el's org-babel-load-languages alist */
99
+  pre.src-forth:before { content: 'Forth'; }
100
+  pre.src-io:before { content: 'IO'; }
101
+  pre.src-J:before { content: 'J'; }
102
+  pre.src-makefile:before { content: 'Makefile'; }
103
+  pre.src-maxima:before { content: 'Maxima'; }
104
+  pre.src-perl:before { content: 'Perl'; }
105
+  pre.src-picolisp:before { content: 'Pico Lisp'; }
106
+  pre.src-scala:before { content: 'Scala'; }
107
+  pre.src-shell:before { content: 'Shell Script'; }
108
+  pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
109
+  /* additional language identifiers per "defun org-babel-execute"
110
+       in ob-*.el */
111
+  pre.src-cpp:before  { content: 'C++'; }
112
+  pre.src-abc:before  { content: 'ABC'; }
113
+  pre.src-coq:before  { content: 'Coq'; }
114
+  pre.src-groovy:before  { content: 'Groovy'; }
115
+  /* additional language identifiers from org-babel-shell-names in
116
+     ob-shell.el: ob-shell is the only babel language using a lambda to put
117
+     the execution function name together. */
118
+  pre.src-bash:before  { content: 'bash'; }
119
+  pre.src-csh:before  { content: 'csh'; }
120
+  pre.src-ash:before  { content: 'ash'; }
121
+  pre.src-dash:before  { content: 'dash'; }
122
+  pre.src-ksh:before  { content: 'ksh'; }
123
+  pre.src-mksh:before  { content: 'mksh'; }
124
+  pre.src-posh:before  { content: 'posh'; }
125
+  /* Additional Emacs modes also supported by the LaTeX listings package */
126
+  pre.src-ada:before { content: 'Ada'; }
127
+  pre.src-asm:before { content: 'Assembler'; }
128
+  pre.src-caml:before { content: 'Caml'; }
129
+  pre.src-delphi:before { content: 'Delphi'; }
130
+  pre.src-html:before { content: 'HTML'; }
131
+  pre.src-idl:before { content: 'IDL'; }
132
+  pre.src-mercury:before { content: 'Mercury'; }
133
+  pre.src-metapost:before { content: 'MetaPost'; }
134
+  pre.src-modula-2:before { content: 'Modula-2'; }
135
+  pre.src-pascal:before { content: 'Pascal'; }
136
+  pre.src-ps:before { content: 'PostScript'; }
137
+  pre.src-prolog:before { content: 'Prolog'; }
138
+  pre.src-simula:before { content: 'Simula'; }
139
+  pre.src-tcl:before { content: 'tcl'; }
140
+  pre.src-tex:before { content: 'TeX'; }
141
+  pre.src-plain-tex:before { content: 'Plain TeX'; }
142
+  pre.src-verilog:before { content: 'Verilog'; }
143
+  pre.src-vhdl:before { content: 'VHDL'; }
144
+  pre.src-xml:before { content: 'XML'; }
145
+  pre.src-nxml:before { content: 'XML'; }
146
+  /* add a generic configuration mode; LaTeX export needs an additional
147
+     (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
148
+  pre.src-conf:before { content: 'Configuration File'; }
66 149
 
67 150
   table { border-collapse:collapse; }
68 151
   caption.t-above { caption-side: top; }
@@ -170,15 +253,15 @@ for the JavaScript code in this tag.
170 253
 </colgroup>
171 254
 <tbody>
172 255
 <tr>
173
-<td class="org-left"><a href="#orgcbeaf75">Readme</a></td>
256
+<td class="org-left"><a href="#org5d3cd75">Readme</a></td>
174 257
 </tr>
175 258
 
176 259
 <tr>
177
-<td class="org-left"><a href="#org58fe816">Improving ssh security</a></td>
260
+<td class="org-left"><a href="#orgbb85ebf">Improving ssh security</a></td>
178 261
 </tr>
179 262
 
180 263
 <tr>
181
-<td class="org-left"><a href="#org108ba2e">Administrating the system via an onion address (Tor)</a></td>
264
+<td class="org-left"><a href="#org302836e">Administrating the system via an onion address (Tor)</a></td>
182 265
 </tr>
183 266
 
184 267
 <tr>
@@ -190,46 +273,46 @@ for the JavaScript code in this tag.
190 273
 </tr>
191 274
 
192 275
 <tr>
193
-<td class="org-left"><a href="#org4e37c17">Syncing to the Cloud</a></td>
276
+<td class="org-left"><a href="#org01570a8">Syncing to the Cloud</a></td>
194 277
 </tr>
195 278
 
196 279
 <tr>
197
-<td class="org-left"><a href="#org62c5422">Play Music</a></td>
280
+<td class="org-left"><a href="#orgeea91f8">Play Music</a></td>
198 281
 </tr>
199 282
 
200 283
 <tr>
201
-<td class="org-left"><a href="#orgaf303fc">Microblogging (GNU Social)</a></td>
284
+<td class="org-left"><a href="#org69eb610">Microblogging (GNU Social)</a></td>
202 285
 </tr>
203 286
 
204 287
 <tr>
205
-<td class="org-left"><a href="#orgb623bbd">Sharing things</a></td>
288
+<td class="org-left"><a href="#orge8d9e63">Sharing things</a></td>
206 289
 </tr>
207 290
 
208 291
 <tr>
209
-<td class="org-left"><a href="#orgf2c8242">Social Network</a></td>
292
+<td class="org-left"><a href="#org3e63c50">Social Network</a></td>
210 293
 </tr>
211 294
 
212 295
 <tr>
213
-<td class="org-left"><a href="#org7d98aeb">Chat Services</a></td>
296
+<td class="org-left"><a href="#orgcc55b7a">Chat Services</a></td>
214 297
 </tr>
215 298
 
216 299
 <tr>
217
-<td class="org-left"><a href="#org825bbe8">RSS Reader</a></td>
300
+<td class="org-left"><a href="#org2698611">RSS Reader</a></td>
218 301
 </tr>
219 302
 
220 303
 <tr>
221
-<td class="org-left"><a href="#org53e17e1">Git Projects</a></td>
304
+<td class="org-left"><a href="#org384c251">Git Projects</a></td>
222 305
 </tr>
223 306
 
224 307
 <tr>
225
-<td class="org-left"><a href="#org421f565">Adding or removing users</a></td>
308
+<td class="org-left"><a href="#org774064d">Adding or removing users</a></td>
226 309
 </tr>
227 310
 </tbody>
228 311
 </table>
229 312
 
230
-<div id="outline-container-orgcbeaf75" class="outline-2">
231
-<h2 id="orgcbeaf75">Readme</h2>
232
-<div class="outline-text-2" id="text-orgcbeaf75">
313
+<div id="outline-container-org5d3cd75" class="outline-2">
314
+<h2 id="org5d3cd75">Readme</h2>
315
+<div class="outline-text-2" id="text-org5d3cd75">
233 316
 <p>
234 317
 After the system has installed a README file will be generated which contains passwords and some brief advice on using the installed systems. You can read this with the following commands:
235 318
 </p>
@@ -250,9 +333,9 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
250 333
 </p>
251 334
 </div>
252 335
 </div>
253
-<div id="outline-container-org58fe816" class="outline-2">
254
-<h2 id="org58fe816">Improving ssh security</h2>
255
-<div class="outline-text-2" id="text-org58fe816">
336
+<div id="outline-container-orgbb85ebf" class="outline-2">
337
+<h2 id="orgbb85ebf">Improving ssh security</h2>
338
+<div class="outline-text-2" id="text-orgbb85ebf">
256 339
 <p>
257 340
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
258 341
 </p>
@@ -305,9 +388,9 @@ If you wish to only use ssh keys then log in to the Freedombone, become the root
305 388
 </div>
306 389
 </div>
307 390
 
308
-<div id="outline-container-org108ba2e" class="outline-2">
309
-<h2 id="org108ba2e">Administrating the system via an onion address (Tor)</h2>
310
-<div class="outline-text-2" id="text-org108ba2e">
391
+<div id="outline-container-org302836e" class="outline-2">
392
+<h2 id="org302836e">Administrating the system via an onion address (Tor)</h2>
393
+<div class="outline-text-2" id="text-org302836e">
311 394
 <p>
312 395
 You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following:
313 396
 </p>
@@ -353,9 +436,9 @@ Subsequently even if dynamic DNS isn't working you may still be able to administ
353 436
 </p>
354 437
 </div>
355 438
 </div>
356
-<div id="outline-container-org4e37c17" class="outline-2">
357
-<h2 id="org4e37c17">Syncing to the Cloud</h2>
358
-<div class="outline-text-2" id="text-org4e37c17">
439
+<div id="outline-container-org01570a8" class="outline-2">
440
+<h2 id="org01570a8">Syncing to the Cloud</h2>
441
+<div class="outline-text-2" id="text-org01570a8">
359 442
 <p>
360 443
 <a href="https://syncthing.net/">Syncthing</a> provides a similar capability to proprietary systems such as <a href="http://www.drop-dropbox.com/">Dropbox</a>, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "<i>men in the middle</i>", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
361 444
 </p>
@@ -365,9 +448,9 @@ Freedombone provides Syncthing shared directories for each user on the system, p
365 448
 </p>
366 449
 </div>
367 450
 
368
-<div id="outline-container-orge3fa44b" class="outline-3">
369
-<h3 id="orge3fa44b">On a laptop</h3>
370
-<div class="outline-text-3" id="text-orge3fa44b">
451
+<div id="outline-container-org2097db1" class="outline-3">
452
+<h3 id="org2097db1">On a laptop</h3>
453
+<div class="outline-text-3" id="text-org2097db1">
371 454
 <p>
372 455
 Install syncthing:
373 456
 </p>
@@ -422,9 +505,9 @@ Now wait for a few minutes. Eventually you will see two messages appear within t
422 505
 </p>
423 506
 </div>
424 507
 </div>
425
-<div id="outline-container-org3133aad" class="outline-3">
426
-<h3 id="org3133aad">On Android</h3>
427
-<div class="outline-text-3" id="text-org3133aad">
508
+<div id="outline-container-orge1173f2" class="outline-3">
509
+<h3 id="orge1173f2">On Android</h3>
510
+<div class="outline-text-3" id="text-orge1173f2">
428 511
 <p>
429 512
 Install Syncthing and Connectbot from F-droid.
430 513
 </p>
@@ -455,12 +538,12 @@ Now wait for a few minutes or more. Eventually you should receive two notificati
455 538
 </div>
456 539
 </div>
457 540
 </div>
458
-<div id="outline-container-org62c5422" class="outline-2">
459
-<h2 id="org62c5422">Play Music</h2>
460
-<div class="outline-text-2" id="text-org62c5422">
461
-</div><div id="outline-container-org446333" class="outline-3">
462
-<h3 id="org446333">With the DLNA service</h3>
463
-<div class="outline-text-3" id="text-org446333">
541
+<div id="outline-container-orgeea91f8" class="outline-2">
542
+<h2 id="orgeea91f8">Play Music</h2>
543
+<div class="outline-text-2" id="text-orgeea91f8">
544
+</div><div id="outline-container-org26c149d" class="outline-3">
545
+<h3 id="org26c149d">With the DLNA service</h3>
546
+<div class="outline-text-3" id="text-org26c149d">
464 547
 <p>
465 548
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "<i>Music</i>" on a USB thumb drive and then insert it into from socket on the Beaglebone.
466 549
 </p>
@@ -501,9 +584,12 @@ The DLNA service will only work within your local home network, and isn't remote
501 584
 </div>
502 585
 </div>
503 586
 
504
-<div id="outline-container-orgaf303fc" class="outline-2">
505
-<h2 id="orgaf303fc">Microblogging (GNU Social)</h2>
506
-<div class="outline-text-2" id="text-orgaf303fc">
587
+<div id="outline-container-org69eb610" class="outline-2">
588
+<h2 id="org69eb610">Microblogging (GNU Social)</h2>
589
+<div class="outline-text-2" id="text-org69eb610">
590
+</div><div id="outline-container-org470cb1f" class="outline-3">
591
+<h3 id="org470cb1f">Initial setup</h3>
592
+<div class="outline-text-3" id="text-org470cb1f">
507 593
 <p>
508 594
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
509 595
 </p>
@@ -532,9 +618,99 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
532 618
 </div>
533 619
 </div>
534 620
 
535
-<div id="outline-container-orgb623bbd" class="outline-2">
536
-<h2 id="orgb623bbd">Sharing things</h2>
537
-<div class="outline-text-2" id="text-orgb623bbd">
621
+<div id="outline-container-org2d40253" class="outline-3">
622
+<h3 id="org2d40253">Direct Messages (DMs) and privacy</h3>
623
+<div class="outline-text-3" id="text-org2d40253">
624
+<p>
625
+One important point about GNU Social is that although direct messages (DMs) are treated as being private their security is quite poor. If you want real communications privacy then use other systems such as XMPP+OMEMO/OTR, Tox or email with GPG. GNU Social is primarily about <i>fully public communications</i>.
626
+</p>
627
+</div>
628
+</div>
629
+<div id="outline-container-orga2273f2" class="outline-3">
630
+<h3 id="orga2273f2">Using with Emacs</h3>
631
+<div class="outline-text-3" id="text-orga2273f2">
632
+<p>
633
+If you are an Emacs user it's also possible to set up GNU Social mode as follows:
634
+</p>
635
+
636
+<div class="org-src-container">
637
+
638
+<pre class="src src-bash">mkdir ~/elisp
639
+git clone git://git.savannah.nongnu.org/gnu-social-mode ~/elisp/gnu-social-mode
640
+sed -i <span class="org-string">'s|"http"|"https"|g'</span> ~/elisp/gnu-social-mode/gnu-social-mode.el
641
+sed -i <span class="org-string">'s|http:|https:|g'</span> ~/elisp/gnu-social-mode/gnu-social-mode.el
642
+sed -i <span class="org-string">'s|http?|https?|g'</span> ~/elisp/gnu-social-mode/gnu-social-mode.el
643
+<span class="org-builtin">echo</span> <span class="org-string">"(add-to-list 'load-path \"~/elisp/gnu-social-mode\")"</span> &gt;&gt; ~/.emacs
644
+<span class="org-builtin">echo</span> <span class="org-string">"(require 'gnu-social-mode)"</span> &gt;&gt; ~/.emacs
645
+<span class="org-builtin">echo</span> <span class="org-string">"(setq gnu-social-server-textlimit 2000"</span> &gt;&gt; ~/.emacs
646
+<span class="org-builtin">echo</span> <span class="org-string">"      gnu-social-server \"yourgnusocialdomain\""</span> &gt;&gt; ~/.emacs
647
+<span class="org-builtin">echo</span> <span class="org-string">"    gnu-social-username \"yourusername\""</span> &gt;&gt; ~/.emacs
648
+<span class="org-builtin">echo</span> <span class="org-string">"    gnu-social-password \"gnusocialpassword\")"</span> &gt;&gt; ~/.emacs
649
+</pre>
650
+</div>
651
+
652
+<p>
653
+And as a quick reference the main keys are:
654
+</p>
655
+
656
+<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
657
+
658
+
659
+<colgroup>
660
+<col  class="org-left" />
661
+
662
+<col  class="org-left" />
663
+</colgroup>
664
+<thead>
665
+<tr>
666
+<th scope="col" class="org-left">Key</th>
667
+<th scope="col" class="org-left">Function</th>
668
+</tr>
669
+</thead>
670
+<tbody>
671
+<tr>
672
+<td class="org-left">i</td>
673
+<td class="org-left">Show profile icons</td>
674
+</tr>
675
+
676
+<tr>
677
+<td class="org-left">CTRL-c CTRL-s</td>
678
+<td class="org-left">Post status update</td>
679
+</tr>
680
+
681
+<tr>
682
+<td class="org-left">r</td>
683
+<td class="org-left">Repeat</td>
684
+</tr>
685
+
686
+<tr>
687
+<td class="org-left">F</td>
688
+<td class="org-left">Favourite</td>
689
+</tr>
690
+
691
+<tr>
692
+<td class="org-left">CTRL-c CTRL-h</td>
693
+<td class="org-left">Highlight</td>
694
+</tr>
695
+
696
+<tr>
697
+<td class="org-left">R</td>
698
+<td class="org-left">Reply to user</td>
699
+</tr>
700
+
701
+<tr>
702
+<td class="org-left">g</td>
703
+<td class="org-left">Show current timeline</td>
704
+</tr>
705
+</tbody>
706
+</table>
707
+</div>
708
+</div>
709
+</div>
710
+
711
+<div id="outline-container-orge8d9e63" class="outline-2">
712
+<h2 id="orge8d9e63">Sharing things</h2>
713
+<div class="outline-text-2" id="text-orge8d9e63">
538 714
 <p>
539 715
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.
540 716
 </p>
@@ -561,20 +737,20 @@ The "<i>catalog</i>" button then allows you to search for shared things within t
561 737
 </div>
562 738
 </div>
563 739
 
564
-<div id="outline-container-orgf2c8242" class="outline-2">
565
-<h2 id="orgf2c8242">Social Network</h2>
566
-<div class="outline-text-2" id="text-orgf2c8242">
567
-</div><div id="outline-container-orgd19b2f8" class="outline-3">
568
-<h3 id="orgd19b2f8">Domains</h3>
569
-<div class="outline-text-3" id="text-orgd19b2f8">
740
+<div id="outline-container-org3e63c50" class="outline-2">
741
+<h2 id="org3e63c50">Social Network</h2>
742
+<div class="outline-text-2" id="text-org3e63c50">
743
+</div><div id="outline-container-org9a87f67" class="outline-3">
744
+<h3 id="org9a87f67">Domains</h3>
745
+<div class="outline-text-3" id="text-org9a87f67">
570 746
 <p>
571 747
 Both Hubzilla and GNU Social try to obtain certificates automatically at the time of installation via Let's Encrypt. This will likely mean that in order for this to work you'll need to have obtained at least one "official" domain via a domain selling service, since Let's Encrypt mostly doesn't seem to work with free subdomains from sites such as freeDNS.
572 748
 </p>
573 749
 </div>
574 750
 </div>
575
-<div id="outline-container-orgb72f874" class="outline-3">
576
-<h3 id="orgb72f874">Initial install</h3>
577
-<div class="outline-text-3" id="text-orgb72f874">
751
+<div id="outline-container-orgcea72c7" class="outline-3">
752
+<h3 id="orgcea72c7">Initial install</h3>
753
+<div class="outline-text-3" id="text-orgcea72c7">
578 754
 <p>
579 755
 On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is <b>register</b> a new user. The first user on the system then becomes its administrator.
580 756
 </p>
@@ -588,19 +764,19 @@ On first visiting your Hubzilla site you'll see the login screen. The first thin
588 764
 </div>
589 765
 </div>
590 766
 
591
-<div id="outline-container-org7d98aeb" class="outline-2">
592
-<h2 id="org7d98aeb">Chat Services</h2>
593
-<div class="outline-text-2" id="text-org7d98aeb">
594
-</div><div id="outline-container-org4f6982f" class="outline-3">
595
-<h3 id="org4f6982f">IRC</h3>
596
-<div class="outline-text-3" id="text-org4f6982f">
767
+<div id="outline-container-orgcc55b7a" class="outline-2">
768
+<h2 id="orgcc55b7a">Chat Services</h2>
769
+<div class="outline-text-2" id="text-orgcc55b7a">
770
+</div><div id="outline-container-orgabbd12f" class="outline-3">
771
+<h3 id="orgabbd12f">IRC</h3>
772
+<div class="outline-text-3" id="text-orgabbd12f">
597 773
 <p>
598 774
 IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.
599 775
 </p>
600 776
 </div>
601
-<div id="outline-container-org6a669ac" class="outline-4">
602
-<h4 id="org6a669ac">Irssi</h4>
603
-<div class="outline-text-4" id="text-org6a669ac">
777
+<div id="outline-container-orgd97adc1" class="outline-4">
778
+<h4 id="orgd97adc1">Irssi</h4>
779
+<div class="outline-text-4" id="text-orgd97adc1">
604 780
 <p>
605 781
 The easiest way to use irssi is to connect to your system, like this:
606 782
 </p>
@@ -616,9 +792,9 @@ Then select <b>IRC</b> from the menu. However, other than via this method using
616 792
 </p>
617 793
 </div>
618 794
 </div>
619
-<div id="outline-container-orgfe17db7" class="outline-4">
620
-<h4 id="orgfe17db7">HexChat</h4>
621
-<div class="outline-text-4" id="text-orgfe17db7">
795
+<div id="outline-container-org5e5309b" class="outline-4">
796
+<h4 id="org5e5309b">HexChat</h4>
797
+<div class="outline-text-4" id="text-org5e5309b">
622 798
 <p>
623 799
 HexChat (formerly XChat) is compatible with proxying via Tor and so provides the best security when connecting to your IRC server. It will allow you to connect to your IRC server's onion address.
624 800
 </p>
@@ -796,9 +972,9 @@ Click <b>close</b> and then <b>connect</b>.
796 972
 </div>
797 973
 </div>
798 974
 
799
-<div id="outline-container-orga727c72" class="outline-4">
800
-<h4 id="orga727c72">Emacs</h4>
801
-<div class="outline-text-4" id="text-orga727c72">
975
+<div id="outline-container-orge9c153d" class="outline-4">
976
+<h4 id="orge9c153d">Emacs</h4>
977
+<div class="outline-text-4" id="text-orge9c153d">
802 978
 <p>
803 979
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
804 980
 </p>
@@ -831,9 +1007,9 @@ Add the following to your Emacs configuration file:
831 1007
 </div>
832 1008
 </div>
833 1009
 </div>
834
-<div id="outline-container-orga72df58" class="outline-4">
835
-<h4 id="orga72df58">Changing or removing the IRC password</h4>
836
-<div class="outline-text-4" id="text-orga72df58">
1010
+<div id="outline-container-org7e67160" class="outline-4">
1011
+<h4 id="org7e67160">Changing or removing the IRC password</h4>
1012
+<div class="outline-text-4" id="text-org7e67160">
837 1013
 <p>
838 1014
 By default the IRC server is set up to require a password for users to log in. The password is the same for all users. If you want to change or remove the password:
839 1015
 </p>
@@ -851,20 +1027,20 @@ Select <i>Administrator controls</i> then <b>IRC Menu</b> and then change the pa
851 1027
 </div>
852 1028
 </div>
853 1029
 
854
-<div id="outline-container-orgc1579b5" class="outline-3">
855
-<h3 id="orgc1579b5">XMPP/Jabber</h3>
856
-<div class="outline-text-3" id="text-orgc1579b5">
857
-</div><div id="outline-container-orgebe762f" class="outline-4">
858
-<h4 id="orgebe762f">About XMPP</h4>
859
-<div class="outline-text-4" id="text-orgebe762f">
1030
+<div id="outline-container-org75a632b" class="outline-3">
1031
+<h3 id="org75a632b">XMPP/Jabber</h3>
1032
+<div class="outline-text-3" id="text-org75a632b">
1033
+</div><div id="outline-container-org079966e" class="outline-4">
1034
+<h4 id="org079966e">About XMPP</h4>
1035
+<div class="outline-text-4" id="text-org079966e">
860 1036
 <p>
861 1037
 A well written article on the state of XMPP and how it compares to other chat protocols <a href="https://gultsch.de/xmpp_2016.html">can be found here</a>.
862 1038
 </p>
863 1039
 </div>
864 1040
 </div>
865
-<div id="outline-container-org470be5f" class="outline-4">
866
-<h4 id="org470be5f">Using with Gajim</h4>
867
-<div class="outline-text-4" id="text-org470be5f">
1041
+<div id="outline-container-org2c65a1e" class="outline-4">
1042
+<h4 id="org2c65a1e">Using with Gajim</h4>
1043
+<div class="outline-text-4" id="text-org2c65a1e">
868 1044
 <p>
869 1045
 In mid 2016 <a href="https://gajim.org/">Gajim</a> became the first desktop XMPP client to support the <a href="https://en.wikipedia.org/wiki/OMEMO">OMEMO end-to-end security standard</a>, which is superior to the more traditional <a href="https://en.wikipedia.org/wiki/Off-the-Record_Messaging">OTR</a> since it also includes multi-user chat and the ratcheting mechanism pioneered by Open Whisper Systems. To install it:
870 1046
 </p>
@@ -910,9 +1086,9 @@ If you wish to use OpenPGP to encrypt your messages then go to <b>Edit/Accounts<
910 1086
 </div>
911 1087
 </div>
912 1088
 
913
-<div id="outline-container-orgc74ad6f" class="outline-4">
914
-<h4 id="orgc74ad6f">Using with Profanity</h4>
915
-<div class="outline-text-4" id="text-orgc74ad6f">
1089
+<div id="outline-container-orgc58464e" class="outline-4">
1090
+<h4 id="orgc58464e">Using with Profanity</h4>
1091
+<div class="outline-text-4" id="text-orgc58464e">
916 1092
 <p>
917 1093
 The <a href="http://profanity.im/">Profanity</a> shell based user interface and is perhaps the simplest way to use XMPP from a laptop. It's also a good way to ensure that your OTR keys are the same even when logging in from different laptops or devices, and it also means that if those devices later become compomised then there are no locally stored OTR keys to be found.
918 1094
 </p>
@@ -1002,9 +1178,9 @@ When accessed via the user control panel the client is automatically routed thro
1002 1178
 </p>
1003 1179
 </div>
1004 1180
 </div>
1005
-<div id="outline-container-orgb23df4a" class="outline-4">
1006
-<h4 id="orgb23df4a">Using with Jitsi</h4>
1007
-<div class="outline-text-4" id="text-orgb23df4a">
1181
+<div id="outline-container-org1302616" class="outline-4">
1182
+<h4 id="org1302616">Using with Jitsi</h4>
1183
+<div class="outline-text-4" id="text-org1302616">
1008 1184
 <p>
1009 1185
 Jitsi is the recommended communications client for desktop or laptop systems, since it includes the <i>off the record</i> (OTR) feature which provides some additional security beyond the usual SSL certificates.
1010 1186
 </p>
@@ -1034,9 +1210,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
1034 1210
 </p>
1035 1211
 </div>
1036 1212
 </div>
1037
-<div id="outline-container-org137d56" class="outline-4">
1038
-<h4 id="org137d56">Using with Ubuntu</h4>
1039
-<div class="outline-text-4" id="text-org137d56">
1213
+<div id="outline-container-orgd636da4" class="outline-4">
1214
+<h4 id="orgd636da4">Using with Ubuntu</h4>
1215
+<div class="outline-text-4" id="text-orgd636da4">
1040 1216
 <p>
1041 1217
 The default XMPP client in Ubuntu is Empathy.  Using Empathy isn't as secure as using Jitsi, since it doesn't include the <i>off the record</i> feature, but since it's the default it's what many users will have easy access to.
1042 1218
 </p>
@@ -1054,17 +1230,17 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
1054 1230
 </p>
1055 1231
 </div>
1056 1232
 </div>
1057
-<div id="outline-container-org1e890b0" class="outline-4">
1058
-<h4 id="org1e890b0">Using Tor Messenger</h4>
1059
-<div class="outline-text-4" id="text-org1e890b0">
1233
+<div id="outline-container-org09b5df0" class="outline-4">
1234
+<h4 id="org09b5df0">Using Tor Messenger</h4>
1235
+<div class="outline-text-4" id="text-org09b5df0">
1060 1236
 <p>
1061 1237
 Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from <a href="https://torproject.org/">torproject.org</a> and the setup is pretty simple.
1062 1238
 </p>
1063 1239
 </div>
1064 1240
 </div>
1065
-<div id="outline-container-orgba9a7f3" class="outline-4">
1066
-<h4 id="orgba9a7f3">Using with Android/Conversations</h4>
1067
-<div class="outline-text-4" id="text-orgba9a7f3">
1241
+<div id="outline-container-org212ead8" class="outline-4">
1242
+<h4 id="org212ead8">Using with Android/Conversations</h4>
1243
+<div class="outline-text-4" id="text-org212ead8">
1068 1244
 <p>
1069 1245
 Install <a href="https://f-droid.org/">F-Droid</a>
1070 1246
 </p>
@@ -1100,16 +1276,16 @@ Then select <b>Next</b>. When chatting you can use the lock icon to encrypt your
1100 1276
 </div>
1101 1277
 </div>
1102 1278
 </div>
1103
-<div id="outline-container-org3244e3a" class="outline-3">
1104
-<h3 id="org3244e3a">Tox</h3>
1105
-<div class="outline-text-3" id="text-org3244e3a">
1279
+<div id="outline-container-orgc3f0bf1" class="outline-3">
1280
+<h3 id="orgc3f0bf1">Tox</h3>
1281
+<div class="outline-text-3" id="text-orgc3f0bf1">
1106 1282
 <p>
1107 1283
 Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within the README within your home directory. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available.
1108 1284
 </p>
1109 1285
 </div>
1110
-<div id="outline-container-orgb600cf6" class="outline-4">
1111
-<h4 id="orgb600cf6">Using the Toxic client</h4>
1112
-<div class="outline-text-4" id="text-orgb600cf6">
1286
+<div id="outline-container-org6ef34e9" class="outline-4">
1287
+<h4 id="org6ef34e9">Using the Toxic client</h4>
1288
+<div class="outline-text-4" id="text-org6ef34e9">
1113 1289
 <p>
1114 1290
 Log into your system with:
1115 1291
 </p>
@@ -1133,20 +1309,20 @@ Then from the menu select <b>Tox Chat</b>. Tox is encrypted by default and also
1133 1309
 </div>
1134 1310
 </div>
1135 1311
 
1136
-<div id="outline-container-org2d25fd9" class="outline-3">
1137
-<h3 id="org2d25fd9">VoIP (Voice and text chat)</h3>
1138
-<div class="outline-text-3" id="text-org2d25fd9">
1139
-</div><div id="outline-container-org5930c44" class="outline-4">
1140
-<h4 id="org5930c44">Text chat</h4>
1141
-<div class="outline-text-4" id="text-org5930c44">
1312
+<div id="outline-container-org9e74f7b" class="outline-3">
1313
+<h3 id="org9e74f7b">VoIP (Voice and text chat)</h3>
1314
+<div class="outline-text-3" id="text-org9e74f7b">
1315
+</div><div id="outline-container-org1ba94db" class="outline-4">
1316
+<h4 id="org1ba94db">Text chat</h4>
1317
+<div class="outline-text-4" id="text-org1ba94db">
1142 1318
 <p>
1143 1319
 In addition to voice it is also possible to do text chat via mumble. The security of this is pretty good provided that you do it via Plumble and Orbot on mobile, but compared to other options such as XMPP/Conversations or Tox the security is not as good, since the mumble server currently doesn't support forward secrecy.
1144 1320
 </p>
1145 1321
 </div>
1146 1322
 </div>
1147
-<div id="outline-container-orgd3e2d35" class="outline-4">
1148
-<h4 id="orgd3e2d35">Using with Ubuntu</h4>
1149
-<div class="outline-text-4" id="text-orgd3e2d35">
1323
+<div id="outline-container-org3461191" class="outline-4">
1324
+<h4 id="org3461191">Using with Ubuntu</h4>
1325
+<div class="outline-text-4" id="text-org3461191">
1150 1326
 <p>
1151 1327
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
1152 1328
 </p>
@@ -1156,9 +1332,9 @@ Click on "add new" to add a new server and enter the default domain name for the
1156 1332
 </p>
1157 1333
 </div>
1158 1334
 </div>
1159
-<div id="outline-container-org9d77246" class="outline-4">
1160
-<h4 id="org9d77246">Using with Android</h4>
1161
-<div class="outline-text-4" id="text-org9d77246">
1335
+<div id="outline-container-org6f7ec87" class="outline-4">
1336
+<h4 id="org6f7ec87">Using with Android</h4>
1337
+<div class="outline-text-4" id="text-org6f7ec87">
1162 1338
 <p>
1163 1339
 Install <a href="https://f-droid.org/">F-Droid</a>
1164 1340
 </p>
@@ -1193,24 +1369,24 @@ Selecting the server by pressing on it then connects you to the server so that y
1193 1369
 </div>
1194 1370
 </div>
1195 1371
 </div>
1196
-<div id="outline-container-org5d67398" class="outline-3">
1197
-<h3 id="org5d67398">SIP phones</h3>
1198
-<div class="outline-text-3" id="text-org5d67398">
1372
+<div id="outline-container-org27d2fad" class="outline-3">
1373
+<h3 id="org27d2fad">SIP phones</h3>
1374
+<div class="outline-text-3" id="text-org27d2fad">
1199 1375
 <p>
1200 1376
 Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.
1201 1377
 </p>
1202 1378
 </div>
1203
-<div id="outline-container-org2a68d3a" class="outline-4">
1204
-<h4 id="org2a68d3a">About ZRTP</h4>
1205
-<div class="outline-text-4" id="text-org2a68d3a">
1379
+<div id="outline-container-org4e1970a" class="outline-4">
1380
+<h4 id="org4e1970a">About ZRTP</h4>
1381
+<div class="outline-text-4" id="text-org4e1970a">
1206 1382
 <p>
1207 1383
 <a href="https://jitsi.org/Documentation/ZrtpFAQ">ZRTP</a> appears to be the current best standard to end-to-end encrypted voice calls, combining good security with simplicity of use. When the initial cryptographic negotiation between phones is done at the start of a call a short authentication string (SAS) is calculated and displayed at both ends. To check that there isn't anyone intercepting the call and acting as a <i>man in the middle</i> - as <a href="https://en.wikipedia.org/wiki/Stingray_phone_tracker">stingray type devices</a> try to do - the short authentication string can be read out and verbally confirmed between the callers. If it's the same then you can be pretty confident that the call is secure.
1208 1384
 </p>
1209 1385
 </div>
1210 1386
 </div>
1211
-<div id="outline-container-org4024859" class="outline-4">
1212
-<h4 id="org4024859">Using with CSIPSimple</h4>
1213
-<div class="outline-text-4" id="text-org4024859">
1387
+<div id="outline-container-org75a89f1" class="outline-4">
1388
+<h4 id="org75a89f1">Using with CSIPSimple</h4>
1389
+<div class="outline-text-4" id="text-org75a89f1">
1214 1390
 <p>
1215 1391
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
1216 1392
 </p>
@@ -1266,9 +1442,9 @@ If everything is working the account should appear in green with a status of <b>
1266 1442
 </p>
1267 1443
 </div>
1268 1444
 </div>
1269
-<div id="outline-container-orgec83f9" class="outline-4">
1270
-<h4 id="orgec83f9">Using with Ring</h4>
1271
-<div class="outline-text-4" id="text-orgec83f9">
1445
+<div id="outline-container-orgee807b9" class="outline-4">
1446
+<h4 id="orgee807b9">Using with Ring</h4>
1447
+<div class="outline-text-4" id="text-orgee807b9">
1272 1448
 <p>
1273 1449
 From the menu select <b>Manage accounts</b>.
1274 1450
 </p>
@@ -1321,9 +1497,9 @@ Select the <b>Security</b> tab. Under <b>SRTP Key Exchange</b> select <b>ZRTP</b
1321 1497
 </div>
1322 1498
 </div>
1323 1499
 
1324
-<div id="outline-container-org825bbe8" class="outline-2">
1325
-<h2 id="org825bbe8">RSS Reader</h2>
1326
-<div class="outline-text-2" id="text-org825bbe8">
1500
+<div id="outline-container-org2698611" class="outline-2">
1501
+<h2 id="org2698611">RSS Reader</h2>
1502
+<div class="outline-text-2" id="text-org2698611">
1327 1503
 <p>
1328 1504
 The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.
1329 1505
 </p>
@@ -1335,9 +1511,9 @@ The way that RSS reading is set up on Freedombone gives you strong reading priva
1335 1511
 </div>
1336 1512
 </div>
1337 1513
 
1338
-<div id="outline-container-org2ba05bf" class="outline-3">
1339
-<h3 id="org2ba05bf">Finding the onion address</h3>
1340
-<div class="outline-text-3" id="text-org2ba05bf">
1514
+<div id="outline-container-orga56a4fe" class="outline-3">
1515
+<h3 id="orga56a4fe">Finding the onion address</h3>
1516
+<div class="outline-text-3" id="text-orga56a4fe">
1341 1517
 <p>
1342 1518
 See the control panel for the RSS reader onion address.
1343 1519
 </p>
@@ -1362,9 +1538,9 @@ To set up the system open <a href="http://rss_reader_onion_address/">http://rss_
1362 1538
 </div>
1363 1539
 </div>
1364 1540
 
1365
-<div id="outline-container-orgdac4fa1" class="outline-3">
1366
-<h3 id="orgdac4fa1">On mobile</h3>
1367
-<div class="outline-text-3" id="text-orgdac4fa1">
1541
+<div id="outline-container-orgc936562" class="outline-3">
1542
+<h3 id="orgc936562">On mobile</h3>
1543
+<div class="outline-text-3" id="text-orgc936562">
1368 1544
 <p>
1369 1545
 To access the RSS reader from a mobile device you can install a Tor compatible browser such as OrFox. It will try to automatically change to the mobile version of the user interface. Remember to add the site to the NoScript whitelist, and you may also need to turn HTTPS Everywhere off.
1370 1546
 </p>
@@ -1376,9 +1552,9 @@ A note for the paranoid is that on mobile devices you get redirected to a differ
1376 1552
 </blockquote>
1377 1553
 </div>
1378 1554
 </div>
1379
-<div id="outline-container-org4788f3c" class="outline-3">
1380
-<h3 id="org4788f3c">With Emacs</h3>
1381
-<div class="outline-text-3" id="text-org4788f3c">
1555
+<div id="outline-container-org2e04357" class="outline-3">
1556
+<h3 id="org2e04357">With Emacs</h3>
1557
+<div class="outline-text-3" id="text-org2e04357">
1382 1558
 <p>
1383 1559
 If you are an Emacs user then you can also read your RSS feeds via the <a href="https://github.com/dk87/avandu">Avandu</a> mode.
1384 1560
 </p>
@@ -1420,9 +1596,9 @@ And ensure that the Tor daemon is installed:
1420 1596
 </div>
1421 1597
 </div>
1422 1598
 </div>
1423
-<div id="outline-container-org53e17e1" class="outline-2">
1424
-<h2 id="org53e17e1">Git Projects</h2>
1425
-<div class="outline-text-2" id="text-org53e17e1">
1599
+<div id="outline-container-org384c251" class="outline-2">
1600
+<h2 id="org384c251">Git Projects</h2>
1601
+<div class="outline-text-2" id="text-org384c251">
1426 1602
 <p>
1427 1603
 Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm happens.
1428 1604
 </p>
@@ -1460,9 +1636,9 @@ This will stop any spam accounts being created by random strangers or bots. You
1460 1636
 </p>
1461 1637
 </div>
1462 1638
 </div>
1463
-<div id="outline-container-org421f565" class="outline-2">
1464
-<h2 id="org421f565">Adding or removing users</h2>
1465
-<div class="outline-text-2" id="text-org421f565">
1639
+<div id="outline-container-org774064d" class="outline-2">
1640
+<h2 id="org774064d">Adding or removing users</h2>
1641
+<div class="outline-text-2" id="text-org774064d">
1466 1642
 <p>
1467 1643
 Log into the system with:
1468 1644
 </p>