Selaa lähdekoodia

Usage web page

Bob Mottram 10 vuotta sitten
vanhempi
commit
b9d4001406
1 muutettua tiedostoa jossa 187 lisäystä ja 227 poistoa
  1. 187
    227
      website/usage.html

+ 187
- 227
website/usage.html Näytä tiedosto

@@ -4,7 +4,7 @@
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6 6
 <title></title>
7
-<!-- 2014-12-08 Mon 15:20 -->
7
+<!-- 2014-12-17 Wed 20:07 -->
8 8
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9
 <meta  name="generator" content="Org-mode" />
10 10
 <meta  name="author" content="Bob Mottram" />
@@ -91,6 +91,10 @@
91 91
     { background-color: #ffff00; color: #000000; font-weight: bold; }
92 92
   /*]]>*/-->
93 93
 </style>
94
+<link rel="stylesheet" type="text/css"
95
+href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
96
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
97
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
94 98
 <script type="text/javascript">
95 99
 /*
96 100
 @licstart  The following is the entire license notice for the
@@ -139,85 +143,11 @@ for the JavaScript code in this tag.
139 143
 </script>
140 144
 </head>
141 145
 <body>
146
+<div id="preamble" class="status">
147
+<a name="top" id="top"></a>
148
+</div>
142 149
 <div id="content">
143 150
 <h1 class="title"></h1>
144
-<div id="table-of-contents">
145
-<h2>Table of Contents</h2>
146
-<div id="text-table-of-contents">
147
-<ul>
148
-<li><a href="#sec-1">1. Readme</a></li>
149
-<li><a href="#sec-2">2. Improving ssh security</a></li>
150
-<li><a href="#sec-3">3. Using Email</a>
151
-<ul>
152
-<li><a href="#sec-3-1">3.1. A technical note about email transport security</a></li>
153
-<li><a href="#sec-3-2">3.2. Add a password to your GPG key</a></li>
154
-<li><a href="#sec-3-3">3.3. Publishing your GPG public key</a></li>
155
-<li><a href="#sec-3-4">3.4. Mutt email client</a></li>
156
-<li><a href="#sec-3-5">3.5. Thunderbird</a>
157
-<ul>
158
-<li><a href="#sec-3-5-1">3.5.1. Initial setup</a></li>
159
-<li><a href="#sec-3-5-2">3.5.2. Import your GPG keys</a></li>
160
-<li><a href="#sec-3-5-3">3.5.3. Using for the first time</a></li>
161
-<li><a href="#sec-3-5-4">3.5.4. Making folders visible</a></li>
162
-</ul>
163
-</li>
164
-<li><a href="#sec-3-6">3.6. K9 Android client</a>
165
-<ul>
166
-<li><a href="#sec-3-6-1">3.6.1. Incoming server settings</a></li>
167
-<li><a href="#sec-3-6-2">3.6.2. Outgoing (SMTP) server settings</a></li>
168
-<li><a href="#sec-3-6-3">3.6.3. Folders</a></li>
169
-</ul>
170
-</li>
171
-<li><a href="#sec-3-7">3.7. Subscribing to mailing lists</a></li>
172
-<li><a href="#sec-3-8">3.8. Adding email addresses to a group/folder</a></li>
173
-</ul>
174
-</li>
175
-<li><a href="#sec-4">4. Mailing List</a></li>
176
-<li><a href="#sec-5">5. Syncing to the Cloud</a>
177
-<ul>
178
-<li><a href="#sec-5-1">5.1. Initial install</a></li>
179
-<li><a href="#sec-5-2">5.2. On Android</a></li>
180
-<li><a href="#sec-5-3">5.3. On Linux</a></li>
181
-</ul>
182
-</li>
183
-<li><a href="#sec-6">6. Play Music</a>
184
-<ul>
185
-<li><a href="#sec-6-1">6.1. With the DLNA service</a></li>
186
-<li><a href="#sec-6-2">6.2. With Owncloud</a></li>
187
-</ul>
188
-</li>
189
-<li><a href="#sec-7">7. Microblogging</a>
190
-<ul>
191
-<li><a href="#sec-7-1">7.1. Initial configuration</a></li>
192
-</ul>
193
-</li>
194
-<li><a href="#sec-8">8. Social Network</a>
195
-<ul>
196
-<li><a href="#sec-8-1">8.1. Certificates</a></li>
197
-<li><a href="#sec-8-2">8.2. Initial install</a></li>
198
-</ul>
199
-</li>
200
-<li><a href="#sec-9">9. Chat Services</a>
201
-<ul>
202
-<li><a href="#sec-9-1">9.1. IRC</a>
203
-<ul>
204
-<li><a href="#sec-9-1-1">9.1.1. Irssi</a></li>
205
-<li><a href="#sec-9-1-2">9.1.2. XChat</a></li>
206
-</ul>
207
-</li>
208
-<li><a href="#sec-9-2">9.2. XMPP/Jabber</a>
209
-<ul>
210
-<li><a href="#sec-9-2-1">9.2.1. Managing users</a></li>
211
-<li><a href="#sec-9-2-2">9.2.2. Using with Jitsi</a></li>
212
-<li><a href="#sec-9-2-3">9.2.3. Using with Ubuntu</a></li>
213
-<li><a href="#sec-9-2-4">9.2.4. Using with Android</a></li>
214
-</ul>
215
-</li>
216
-</ul>
217
-</li>
218
-</ul>
219
-</div>
220
-</div>
221 151
 <div class="center">
222 152
 
223 153
 <div class="figure">
@@ -251,21 +181,21 @@ for the JavaScript code in this tag.
251 181
 <tbody>
252 182
 <tr>
253 183
 <td class="left"><a href="index.html">Home</a></td>
254
-<td class="left"><a href="#sec-1">1</a></td>
255
-<td class="left"><a href="#sec-3">3</a></td>
256
-<td class="left"><a href="#sec-4">4</a></td>
257
-<td class="left"><a href="#sec-5">5</a></td>
258
-<td class="left"><a href="#sec-6">6</a></td>
259
-<td class="left"><a href="#sec-7">7</a></td>
260
-<td class="left"><a href="#sec-8">8</a></td>
261
-<td class="left"><a href="#sec-9">9</a></td>
184
+<td class="left"><a href="#unnumbered-1">Readme</a></td>
185
+<td class="left"><a href="#unnumbered-3">Using Email</a></td>
186
+<td class="left"><a href="#unnumbered-19">Mailing List</a></td>
187
+<td class="left"><a href="#unnumbered-20">Syncing to the Cloud</a></td>
188
+<td class="left"><a href="#unnumbered-24">Play Music</a></td>
189
+<td class="left"><a href="#unnumbered-27">Microblogging</a></td>
190
+<td class="left"><a href="#unnumbered-29">Social Network</a></td>
191
+<td class="left"><a href="#unnumbered-32">Chat Services</a></td>
262 192
 </tr>
263 193
 </tbody>
264 194
 </table>
265 195
 
266
-<div id="outline-container-sec-1" class="outline-2">
267
-<h2 id="sec-1"><span class="section-number-2">1</span> Readme</h2>
268
-<div class="outline-text-2" id="text-1">
196
+<div id="outline-container-unnumbered-1" class="outline-2">
197
+<h2 id="unnumbered-1">Readme</h2>
198
+<div class="outline-text-2" id="text-unnumbered-1">
269 199
 <p>
270 200
 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:
271 201
 </p>
@@ -286,9 +216,9 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
286 216
 </p>
287 217
 </div>
288 218
 </div>
289
-<div id="outline-container-sec-2" class="outline-2">
290
-<h2 id="sec-2"><span class="section-number-2">2</span> Improving ssh security</h2>
291
-<div class="outline-text-2" id="text-2">
219
+<div id="outline-container-unnumbered-2" class="outline-2">
220
+<h2 id="unnumbered-2">Improving ssh security</h2>
221
+<div class="outline-text-2" id="text-unnumbered-2">
292 222
 <p>
293 223
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
294 224
 </p>
@@ -342,20 +272,20 @@ If you wish to only use ssh keys then log in to the Freedombone and edit <b>/etc
342 272
 </div>
343 273
 </div>
344 274
 
345
-<div id="outline-container-sec-3" class="outline-2">
346
-<h2 id="sec-3"><span class="section-number-2">3</span> Using Email</h2>
347
-<div class="outline-text-2" id="text-3">
348
-</div><div id="outline-container-sec-3-1" class="outline-3">
349
-<h3 id="sec-3-1"><span class="section-number-3">3.1</span> A technical note about email transport security</h3>
350
-<div class="outline-text-3" id="text-3-1">
275
+<div id="outline-container-unnumbered-3" class="outline-2">
276
+<h2 id="unnumbered-3">Using Email</h2>
277
+<div class="outline-text-2" id="text-unnumbered-3">
278
+</div><div id="outline-container-unnumbered-4" class="outline-3">
279
+<h3 id="unnumbered-4">A technical note about email transport security</h3>
280
+<div class="outline-text-3" id="text-unnumbered-4">
351 281
 <p>
352 282
 Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are <a href="https://www.eff.org/deeplinks/2014/11/starttls-downgrade-attacks">possible attacks against STARTTLS</a> in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.
353 283
 </p>
354 284
 </div>
355 285
 </div>
356
-<div id="outline-container-sec-3-2" class="outline-3">
357
-<h3 id="sec-3-2"><span class="section-number-3">3.2</span> Add a password to your GPG key</h3>
358
-<div class="outline-text-3" id="text-3-2">
286
+<div id="outline-container-unnumbered-5" class="outline-3">
287
+<h3 id="unnumbered-5">Add a password to your GPG key</h3>
288
+<div class="outline-text-3" id="text-unnumbered-5">
359 289
 <p>
360 290
 If you didn't use existing GPG keys during the Freedombone installation then you'll need to add a password to your newly generated private key. This is highly recommended. Go through the following sequence of commands to ssh into the Freedombone and then change your GPG password.
361 291
 </p>
@@ -367,7 +297,7 @@ gpg --edit-key username@domain
367 297
 passwd
368 298
 save
369 299
 quit
370
-exit
300
+<span class="org-keyword">exit</span>
371 301
 </pre>
372 302
 </div>
373 303
 
@@ -377,9 +307,9 @@ Having a password on your GPG key will prevent someone from reading your email <
377 307
 </div>
378 308
 </div>
379 309
 
380
-<div id="outline-container-sec-3-3" class="outline-3">
381
-<h3 id="sec-3-3"><span class="section-number-3">3.3</span> Publishing your GPG public key</h3>
382
-<div class="outline-text-3" id="text-3-3">
310
+<div id="outline-container-unnumbered-6" class="outline-3">
311
+<h3 id="unnumbered-6">Publishing your GPG public key</h3>
312
+<div class="outline-text-3" id="text-unnumbered-6">
383 313
 <p>
384 314
 If you havn't already then you should publish your GPG public key so that others can find it.
385 315
 </p>
@@ -388,14 +318,14 @@ If you havn't already then you should publish your GPG public key so that others
388 318
 
389 319
 <pre class="src src-bash">ssh username@domainname -p 2222
390 320
 gpg --send-keys username@domainname
391
-exit
321
+<span class="org-keyword">exit</span>
392 322
 </pre>
393 323
 </div>
394 324
 </div>
395 325
 </div>
396
-<div id="outline-container-sec-3-4" class="outline-3">
397
-<h3 id="sec-3-4"><span class="section-number-3">3.4</span> Mutt email client</h3>
398
-<div class="outline-text-3" id="text-3-4">
326
+<div id="outline-container-unnumbered-7" class="outline-3">
327
+<h3 id="unnumbered-7">Mutt email client</h3>
328
+<div class="outline-text-3" id="text-unnumbered-7">
399 329
 <p>
400 330
 Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with:
401 331
 </p>
@@ -538,9 +468,9 @@ When reading emails you will initially need to enter your GPG password. It will
538 468
 </div>
539 469
 </div>
540 470
 
541
-<div id="outline-container-sec-3-5" class="outline-3">
542
-<h3 id="sec-3-5"><span class="section-number-3">3.5</span> Thunderbird</h3>
543
-<div class="outline-text-3" id="text-3-5">
471
+<div id="outline-container-unnumbered-8" class="outline-3">
472
+<h3 id="unnumbered-8">Thunderbird</h3>
473
+<div class="outline-text-3" id="text-unnumbered-8">
544 474
 <p>
545 475
 Another common way in which you may want to access email is via Thunderbird.  This may be especially useful if you're trying to convert former Windows users who may previously have been using some version of Outlook.
546 476
 </p>
@@ -550,9 +480,9 @@ The following instructions should be carried out on the client machines (laptop,
550 480
 </p>
551 481
 </div>
552 482
 
553
-<div id="outline-container-sec-3-5-1" class="outline-4">
554
-<h4 id="sec-3-5-1"><span class="section-number-4">3.5.1</span> Initial setup</h4>
555
-<div class="outline-text-4" id="text-3-5-1">
483
+<div id="outline-container-unnumbered-9" class="outline-4">
484
+<h4 id="unnumbered-9">Initial setup</h4>
485
+<div class="outline-text-4" id="text-unnumbered-9">
556 486
 <p>
557 487
 Install <b>Thunderbird</b> and <b>Enigmail</b>.  How you do this just depends upon your distro and software manager or "app store".
558 488
 </p>
@@ -611,9 +541,9 @@ Select "<b>yes</b>" to change default settings.
611 541
 </p>
612 542
 </div>
613 543
 </div>
614
-<div id="outline-container-sec-3-5-2" class="outline-4">
615
-<h4 id="sec-3-5-2"><span class="section-number-4">3.5.2</span> Import your GPG keys</h4>
616
-<div class="outline-text-4" id="text-3-5-2">
544
+<div id="outline-container-unnumbered-10" class="outline-4">
545
+<h4 id="unnumbered-10">Import your GPG keys</h4>
546
+<div class="outline-text-4" id="text-unnumbered-10">
617 547
 <p>
618 548
 On the Freedombone export your GPG public and private keys.
619 549
 </p>
@@ -662,9 +592,9 @@ shred -zu ~/private_key.gpg
662 592
 </div>
663 593
 </div>
664 594
 
665
-<div id="outline-container-sec-3-5-3" class="outline-4">
666
-<h4 id="sec-3-5-3"><span class="section-number-4">3.5.3</span> Using for the first time</h4>
667
-<div class="outline-text-4" id="text-3-5-3">
595
+<div id="outline-container-unnumbered-11" class="outline-4">
596
+<h4 id="unnumbered-11">Using for the first time</h4>
597
+<div class="outline-text-4" id="text-unnumbered-11">
668 598
 <p>
669 599
 Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.
670 600
 </p>
@@ -699,9 +629,9 @@ Get into the habit of using email encryption and encourage others to do so.  Rem
699 629
 </div>
700 630
 </div>
701 631
 
702
-<div id="outline-container-sec-3-5-4" class="outline-4">
703
-<h4 id="sec-3-5-4"><span class="section-number-4">3.5.4</span> Making folders visible</h4>
704
-<div class="outline-text-4" id="text-3-5-4">
632
+<div id="outline-container-unnumbered-12" class="outline-4">
633
+<h4 id="unnumbered-12">Making folders visible</h4>
634
+<div class="outline-text-4" id="text-unnumbered-12">
705 635
 <p>
706 636
 By default you won't be able to see any folders which you may have created earlier using the <i>mailinglistrule</i> script.  To make folders visible select:
707 637
 </p>
@@ -717,17 +647,17 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
717 647
 </div>
718 648
 </div>
719 649
 
720
-<div id="outline-container-sec-3-6" class="outline-3">
721
-<h3 id="sec-3-6"><span class="section-number-3">3.6</span> K9 Android client</h3>
722
-<div class="outline-text-3" id="text-3-6">
650
+<div id="outline-container-unnumbered-13" class="outline-3">
651
+<h3 id="unnumbered-13">K9 Android client</h3>
652
+<div class="outline-text-3" id="text-unnumbered-13">
723 653
 <p>
724 654
 <b>NOTE</b>: Currently the K9 email client will not work with the Freedombone since it doesn't support PGP/MIME encoding. However, there is development work taking place on that feature and it is hoped that K9 may be usable in the near future.
725 655
 </p>
726 656
 </div>
727 657
 
728
-<div id="outline-container-sec-3-6-1" class="outline-4">
729
-<h4 id="sec-3-6-1"><span class="section-number-4">3.6.1</span> Incoming server settings</h4>
730
-<div class="outline-text-4" id="text-3-6-1">
658
+<div id="outline-container-unnumbered-14" class="outline-4">
659
+<h4 id="unnumbered-14">Incoming server settings</h4>
660
+<div class="outline-text-4" id="text-unnumbered-14">
731 661
 <ul class="org-ul">
732 662
 <li>Select settings/account settings
733 663
 </li>
@@ -746,9 +676,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
746 676
 </ul>
747 677
 </div>
748 678
 </div>
749
-<div id="outline-container-sec-3-6-2" class="outline-4">
750
-<h4 id="sec-3-6-2"><span class="section-number-4">3.6.2</span> Outgoing (SMTP) server settings</h4>
751
-<div class="outline-text-4" id="text-3-6-2">
679
+<div id="outline-container-unnumbered-15" class="outline-4">
680
+<h4 id="unnumbered-15">Outgoing (SMTP) server settings</h4>
681
+<div class="outline-text-4" id="text-unnumbered-15">
752 682
 <ul class="org-ul">
753 683
 <li>Select settings/account settings
754 684
 </li>
@@ -769,9 +699,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
769 699
 </ul>
770 700
 </div>
771 701
 </div>
772
-<div id="outline-container-sec-3-6-3" class="outline-4">
773
-<h4 id="sec-3-6-3"><span class="section-number-4">3.6.3</span> Folders</h4>
774
-<div class="outline-text-4" id="text-3-6-3">
702
+<div id="outline-container-unnumbered-16" class="outline-4">
703
+<h4 id="unnumbered-16">Folders</h4>
704
+<div class="outline-text-4" id="text-unnumbered-16">
775 705
 <p>
776 706
 To view any new folders which you may have created using the <i>mailinglistrule</i> script from your inbox press the <b>K9 icon</b> at the top left to access folders, then press the <b>menu button</b> and select <b>refresh folder list</b>.
777 707
 </p>
@@ -783,9 +713,9 @@ If your folder still doesn't show up then press the <b>menu button</b>, select <
783 713
 </div>
784 714
 </div>
785 715
 
786
-<div id="outline-container-sec-3-7" class="outline-3">
787
-<h3 id="sec-3-7"><span class="section-number-3">3.7</span> Subscribing to mailing lists</h3>
788
-<div class="outline-text-3" id="text-3-7">
716
+<div id="outline-container-unnumbered-17" class="outline-3">
717
+<h3 id="unnumbered-17">Subscribing to mailing lists</h3>
718
+<div class="outline-text-3" id="text-unnumbered-17">
789 719
 <p>
790 720
 To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
791 721
 </p>
@@ -794,7 +724,7 @@ To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
794 724
 
795 725
 <pre class="src src-bash">ssh username@domainname -p 2222
796 726
 addmailinglist &lt;username&gt; &lt;mailinglistname&gt; &lt;subjecttag&gt;
797
-exit
727
+<span class="org-keyword">exit</span>
798 728
 </pre>
799 729
 </div>
800 730
 
@@ -803,9 +733,9 @@ The subject tag should be the word or phrase which appears within the brackets i
803 733
 </p>
804 734
 </div>
805 735
 </div>
806
-<div id="outline-container-sec-3-8" class="outline-3">
807
-<h3 id="sec-3-8"><span class="section-number-3">3.8</span> Adding email addresses to a group/folder</h3>
808
-<div class="outline-text-3" id="text-3-8">
736
+<div id="outline-container-unnumbered-18" class="outline-3">
737
+<h3 id="unnumbered-18">Adding email addresses to a group/folder</h3>
738
+<div class="outline-text-3" id="text-unnumbered-18">
809 739
 <p>
810 740
 Similar to adding mailing list folders you can also add specified email addresses into a folder.
811 741
 </p>
@@ -814,7 +744,7 @@ Similar to adding mailing list folders you can also add specified email addresse
814 744
 
815 745
 <pre class="src src-bash">ssh username@domainname -p 2222
816 746
 addemailtofolder &lt;username&gt; &lt;emailaddress&gt; &lt;mailinglistname&gt;
817
-exit
747
+<span class="org-keyword">exit</span>
818 748
 </pre>
819 749
 </div>
820 750
 
@@ -825,9 +755,9 @@ The mailing list name should be something short so that it is readable within th
825 755
 </div>
826 756
 </div>
827 757
 
828
-<div id="outline-container-sec-4" class="outline-2">
829
-<h2 id="sec-4"><span class="section-number-2">4</span> Mailing List</h2>
830
-<div class="outline-text-2" id="text-4">
758
+<div id="outline-container-unnumbered-19" class="outline-2">
759
+<h2 id="unnumbered-19">Mailing List</h2>
760
+<div class="outline-text-2" id="text-unnumbered-19">
831 761
 <p>
832 762
 If you want to set up a public mailing list then when installing the system remember to set the <b>PUBLIC_MAILING_LIST</b> variable within <b>freedombone.cfg</b> to the name of your list. The name should have no spaces in it. Public mailing lists are unencrypted so anyone will be able to read the contents, including non subscribers.
833 763
 </p>
@@ -847,12 +777,12 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
847 777
 </p>
848 778
 </div>
849 779
 </div>
850
-<div id="outline-container-sec-5" class="outline-2">
851
-<h2 id="sec-5"><span class="section-number-2">5</span> Syncing to the Cloud</h2>
852
-<div class="outline-text-2" id="text-5">
853
-</div><div id="outline-container-sec-5-1" class="outline-3">
854
-<h3 id="sec-5-1"><span class="section-number-3">5.1</span> Initial install</h3>
855
-<div class="outline-text-3" id="text-5-1">
780
+<div id="outline-container-unnumbered-20" class="outline-2">
781
+<h2 id="unnumbered-20">Syncing to the Cloud</h2>
782
+<div class="outline-text-2" id="text-unnumbered-20">
783
+</div><div id="outline-container-unnumbered-21" class="outline-3">
784
+<h3 id="unnumbered-21">Initial install</h3>
785
+<div class="outline-text-3" id="text-unnumbered-21">
856 786
 <p>
857 787
 Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
858 788
 </p>
@@ -877,7 +807,7 @@ You will also need to enter database details:
877 807
 
878 808
 <tr>
879 809
 <td class="left">Owncloud database password</td>
880
-<td class="left">See the <a href="#sec-1">1</a> file</td>
810
+<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
881 811
 </tr>
882 812
 
883 813
 <tr>
@@ -896,9 +826,9 @@ Log out from the administrator account and then log back in as the user you just
896 826
 </p>
897 827
 </div>
898 828
 </div>
899
-<div id="outline-container-sec-5-2" class="outline-3">
900
-<h3 id="sec-5-2"><span class="section-number-3">5.2</span> On Android</h3>
901
-<div class="outline-text-3" id="text-5-2">
829
+<div id="outline-container-unnumbered-22" class="outline-3">
830
+<h3 id="unnumbered-22">On Android</h3>
831
+<div class="outline-text-3" id="text-unnumbered-22">
902 832
 <p>
903 833
 Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
904 834
 </p>
@@ -922,9 +852,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
922 852
 </p>
923 853
 </div>
924 854
 </div>
925
-<div id="outline-container-sec-5-3" class="outline-3">
926
-<h3 id="sec-5-3"><span class="section-number-3">5.3</span> On Linux</h3>
927
-<div class="outline-text-3" id="text-5-3">
855
+<div id="outline-container-unnumbered-23" class="outline-3">
856
+<h3 id="unnumbered-23">On Linux</h3>
857
+<div class="outline-text-3" id="text-unnumbered-23">
928 858
 <p>
929 859
 Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
930 860
 </p>
@@ -935,12 +865,12 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
935 865
 </div>
936 866
 </div>
937 867
 </div>
938
-<div id="outline-container-sec-6" class="outline-2">
939
-<h2 id="sec-6"><span class="section-number-2">6</span> Play Music</h2>
940
-<div class="outline-text-2" id="text-6">
941
-</div><div id="outline-container-sec-6-1" class="outline-3">
942
-<h3 id="sec-6-1"><span class="section-number-3">6.1</span> With the DLNA service</h3>
943
-<div class="outline-text-3" id="text-6-1">
868
+<div id="outline-container-unnumbered-24" class="outline-2">
869
+<h2 id="unnumbered-24">Play Music</h2>
870
+<div class="outline-text-2" id="text-unnumbered-24">
871
+</div><div id="outline-container-unnumbered-25" class="outline-3">
872
+<h3 id="unnumbered-25">With the DLNA service</h3>
873
+<div class="outline-text-3" id="text-unnumbered-25">
944 874
 <p>
945 875
 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.
946 876
 </p>
@@ -980,9 +910,9 @@ The DLNA service will only work within your local home network, and isn't remote
980 910
 </div>
981 911
 </div>
982 912
 
983
-<div id="outline-container-sec-6-2" class="outline-3">
984
-<h3 id="sec-6-2"><span class="section-number-3">6.2</span> With Owncloud</h3>
985
-<div class="outline-text-3" id="text-6-2">
913
+<div id="outline-container-unnumbered-26" class="outline-3">
914
+<h3 id="unnumbered-26">With Owncloud</h3>
915
+<div class="outline-text-3" id="text-unnumbered-26">
986 916
 <p>
987 917
 The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
988 918
 </p>
@@ -994,12 +924,12 @@ By default a music player is installed into Owncloud, so all you need to do is t
994 924
 </div>
995 925
 </div>
996 926
 
997
-<div id="outline-container-sec-7" class="outline-2">
998
-<h2 id="sec-7"><span class="section-number-2">7</span> Microblogging</h2>
999
-<div class="outline-text-2" id="text-7">
1000
-</div><div id="outline-container-sec-7-1" class="outline-3">
1001
-<h3 id="sec-7-1"><span class="section-number-3">7.1</span> Initial configuration</h3>
1002
-<div class="outline-text-3" id="text-7-1">
927
+<div id="outline-container-unnumbered-27" class="outline-2">
928
+<h2 id="unnumbered-27">Microblogging</h2>
929
+<div class="outline-text-2" id="text-unnumbered-27">
930
+</div><div id="outline-container-unnumbered-28" class="outline-3">
931
+<h3 id="unnumbered-28">Initial configuration</h3>
932
+<div class="outline-text-3" id="text-unnumbered-28">
1003 933
 <p>
1004 934
 To set up your microblog go to:
1005 935
 </p>
@@ -1050,7 +980,7 @@ and enter the following settings:
1050 980
 
1051 981
 <tr>
1052 982
 <td class="left">DB Password</td>
1053
-<td class="left">See the MariaDB password in the <a href="#sec-1">1</a> file</td>
983
+<td class="left">See the MariaDB password in the <a href="#unnumbered-1">Readme</a> file</td>
1054 984
 </tr>
1055 985
 
1056 986
 <tr>
@@ -1060,7 +990,7 @@ and enter the following settings:
1060 990
 
1061 991
 <tr>
1062 992
 <td class="left">Administrator password</td>
1063
-<td class="left">See the <a href="#sec-1">1</a> file</td>
993
+<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
1064 994
 </tr>
1065 995
 
1066 996
 <tr>
@@ -1107,12 +1037,12 @@ When the install is complete you will see a lot of warnings but just ignore thos
1107 1037
 </div>
1108 1038
 </div>
1109 1039
 </div>
1110
-<div id="outline-container-sec-8" class="outline-2">
1111
-<h2 id="sec-8"><span class="section-number-2">8</span> Social Network</h2>
1112
-<div class="outline-text-2" id="text-8">
1113
-</div><div id="outline-container-sec-8-1" class="outline-3">
1114
-<h3 id="sec-8-1"><span class="section-number-3">8.1</span> Certificates</h3>
1115
-<div class="outline-text-3" id="text-8-1">
1040
+<div id="outline-container-unnumbered-29" class="outline-2">
1041
+<h2 id="unnumbered-29">Social Network</h2>
1042
+<div class="outline-text-2" id="text-unnumbered-29">
1043
+</div><div id="outline-container-unnumbered-30" class="outline-3">
1044
+<h3 id="unnumbered-30">Certificates</h3>
1045
+<div class="outline-text-3" id="text-unnumbered-30">
1116 1046
 <p>
1117 1047
 You will need to have a non self-signed SSL certificate in order to use Red Matrix. Put the public certificate in <b>/etc/ssl/certs/yourredmatrixdomainname.crt</b> and the private certificate in <b>/etc/ssl/private/yourredmatrixdomainname.key</b>. If there is an intermediate certificate needed (such as with StartSSL) then this will need to be concatenated onto the end of the crt file, like this:
1118 1048
 </p>
@@ -1129,9 +1059,9 @@ Then change ssl_certificate to <b>/etc/ssl/certs/yourredmatrixdomainname.bundle.
1129 1059
 </p>
1130 1060
 </div>
1131 1061
 </div>
1132
-<div id="outline-container-sec-8-2" class="outline-3">
1133
-<h3 id="sec-8-2"><span class="section-number-3">8.2</span> Initial install</h3>
1134
-<div class="outline-text-3" id="text-8-2">
1062
+<div id="outline-container-unnumbered-31" class="outline-3">
1063
+<h3 id="unnumbered-31">Initial install</h3>
1064
+<div class="outline-text-3" id="text-unnumbered-31">
1135 1065
 <p>
1136 1066
 Visit the URL of your Red Matrix site and you should be taken through the rest of the installation procedure.  Note that this may take a few minutes so don't be concerned if it looks as if it has crashed - just leave it running.
1137 1067
 </p>
@@ -1142,21 +1072,21 @@ When installation is complete you can register a new user.
1142 1072
 </div>
1143 1073
 </div>
1144 1074
 </div>
1145
-<div id="outline-container-sec-9" class="outline-2">
1146
-<h2 id="sec-9"><span class="section-number-2">9</span> Chat Services</h2>
1147
-<div class="outline-text-2" id="text-9">
1148
-</div><div id="outline-container-sec-9-1" class="outline-3">
1149
-<h3 id="sec-9-1"><span class="section-number-3">9.1</span> IRC</h3>
1150
-<div class="outline-text-3" id="text-9-1">
1075
+<div id="outline-container-unnumbered-32" class="outline-2">
1076
+<h2 id="unnumbered-32">Chat Services</h2>
1077
+<div class="outline-text-2" id="text-unnumbered-32">
1078
+</div><div id="outline-container-unnumbered-33" class="outline-3">
1079
+<h3 id="unnumbered-33">IRC</h3>
1080
+<div class="outline-text-3" id="text-unnumbered-33">
1151 1081
 <p>
1152 1082
 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.
1153 1083
 </p>
1154 1084
 </div>
1155
-<div id="outline-container-sec-9-1-1" class="outline-4">
1156
-<h4 id="sec-9-1-1"><span class="section-number-4">9.1.1</span> Irssi</h4>
1157
-<div class="outline-text-4" id="text-9-1-1">
1085
+<div id="outline-container-unnumbered-34" class="outline-4">
1086
+<h4 id="unnumbered-34">Irssi</h4>
1087
+<div class="outline-text-4" id="text-unnumbered-34">
1158 1088
 <p>
1159
-If you are using the <a href="http://www.irssi.org">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
1089
+If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
1160 1090
 </p>
1161 1091
 
1162 1092
 <div class="org-src-container">
@@ -1168,9 +1098,9 @@ If you are using the <a href="http://www.irssi.org">irssi</a> IRC client then yo
1168 1098
 </div>
1169 1099
 </div>
1170 1100
 </div>
1171
-<div id="outline-container-sec-9-1-2" class="outline-4">
1172
-<h4 id="sec-9-1-2"><span class="section-number-4">9.1.2</span> XChat</h4>
1173
-<div class="outline-text-4" id="text-9-1-2">
1101
+<div id="outline-container-unnumbered-35" class="outline-4">
1102
+<h4 id="unnumbered-35">XChat</h4>
1103
+<div class="outline-text-4" id="text-unnumbered-35">
1174 1104
 <p>
1175 1105
 If you are using the XChat client:
1176 1106
 </p>
@@ -1206,12 +1136,12 @@ Click <b>close</b> and then <b>connect</b>.
1206 1136
 </div>
1207 1137
 </div>
1208 1138
 
1209
-<div id="outline-container-sec-9-2" class="outline-3">
1210
-<h3 id="sec-9-2"><span class="section-number-3">9.2</span> XMPP/Jabber</h3>
1211
-<div class="outline-text-3" id="text-9-2">
1212
-</div><div id="outline-container-sec-9-2-1" class="outline-4">
1213
-<h4 id="sec-9-2-1"><span class="section-number-4">9.2.1</span> Managing users</h4>
1214
-<div class="outline-text-4" id="text-9-2-1">
1139
+<div id="outline-container-unnumbered-36" class="outline-3">
1140
+<h3 id="unnumbered-36">XMPP/Jabber</h3>
1141
+<div class="outline-text-3" id="text-unnumbered-36">
1142
+</div><div id="outline-container-unnumbered-37" class="outline-4">
1143
+<h4 id="unnumbered-37">Managing users</h4>
1144
+<div class="outline-text-4" id="text-unnumbered-37">
1215 1145
 <p>
1216 1146
 To add a user:
1217 1147
 </p>
@@ -1221,8 +1151,8 @@ To add a user:
1221 1151
 <pre class="src src-bash">ssh username@domainname -p 2222
1222 1152
 su
1223 1153
 prosodyctl adduser newusername@newdomainname
1224
-exit
1225
-exit
1154
+<span class="org-keyword">exit</span>
1155
+<span class="org-keyword">exit</span>
1226 1156
 </pre>
1227 1157
 </div>
1228 1158
 
@@ -1235,8 +1165,8 @@ To change a user password:
1235 1165
 <pre class="src src-bash">ssh username@domainname -p 2222
1236 1166
 su
1237 1167
 prosodyctl passwd username@domainname
1238
-exit
1239
-exit
1168
+<span class="org-keyword">exit</span>
1169
+<span class="org-keyword">exit</span>
1240 1170
 </pre>
1241 1171
 </div>
1242 1172
 
@@ -1249,8 +1179,8 @@ To remove a user:
1249 1179
 <pre class="src src-bash">ssh username@domainname -p 2222
1250 1180
 su
1251 1181
 prosodyctl deluser username@domainname.com
1252
-exit
1253
-exit
1182
+<span class="org-keyword">exit</span>
1183
+<span class="org-keyword">exit</span>
1254 1184
 </pre>
1255 1185
 </div>
1256 1186
 
@@ -1263,22 +1193,22 @@ Report the status of the XMPP server:
1263 1193
 <pre class="src src-bash">ssh username@domainname -p 2222
1264 1194
 su
1265 1195
 prosodyctl status
1266
-exit
1267
-exit
1196
+<span class="org-keyword">exit</span>
1197
+<span class="org-keyword">exit</span>
1268 1198
 </pre>
1269 1199
 </div>
1270 1200
 </div>
1271 1201
 </div>
1272 1202
 
1273
-<div id="outline-container-sec-9-2-2" class="outline-4">
1274
-<h4 id="sec-9-2-2"><span class="section-number-4">9.2.2</span> Using with Jitsi</h4>
1275
-<div class="outline-text-4" id="text-9-2-2">
1203
+<div id="outline-container-unnumbered-38" class="outline-4">
1204
+<h4 id="unnumbered-38">Using with Jitsi</h4>
1205
+<div class="outline-text-4" id="text-unnumbered-38">
1276 1206
 <p>
1277 1207
 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.
1278 1208
 </p>
1279 1209
 
1280 1210
 <p>
1281
-Jitsi can be downloaded from <a href="https://jitsi.org">https://jitsi.org</a>
1211
+Jitsi can be downloaded from <a href="https://jitsi.org/">https://jitsi.org/</a>
1282 1212
 </p>
1283 1213
 
1284 1214
 <p>
@@ -1302,9 +1232,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
1302 1232
 </p>
1303 1233
 </div>
1304 1234
 </div>
1305
-<div id="outline-container-sec-9-2-3" class="outline-4">
1306
-<h4 id="sec-9-2-3"><span class="section-number-4">9.2.3</span> Using with Ubuntu</h4>
1307
-<div class="outline-text-4" id="text-9-2-3">
1235
+<div id="outline-container-unnumbered-39" class="outline-4">
1236
+<h4 id="unnumbered-39">Using with Ubuntu</h4>
1237
+<div class="outline-text-4" id="text-unnumbered-39">
1308 1238
 <p>
1309 1239
 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.
1310 1240
 </p>
@@ -1322,9 +1252,9 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
1322 1252
 </p>
1323 1253
 </div>
1324 1254
 </div>
1325
-<div id="outline-container-sec-9-2-4" class="outline-4">
1326
-<h4 id="sec-9-2-4"><span class="section-number-4">9.2.4</span> Using with Android</h4>
1327
-<div class="outline-text-4" id="text-9-2-4">
1255
+<div id="outline-container-unnumbered-40" class="outline-4">
1256
+<h4 id="unnumbered-40">Using with Android</h4>
1257
+<div class="outline-text-4" id="text-unnumbered-40">
1328 1258
 <p>
1329 1259
 Install <a href="https://f-droid.org/">F-Droid</a>
1330 1260
 </p>
@@ -1354,10 +1284,40 @@ Go back to the initial screen and then using the menu you can add contacts and b
1354 1284
 </div>
1355 1285
 </div>
1356 1286
 <div id="postamble" class="status">
1357
-<p class="author">Author: Bob Mottram</p>
1358
-<p class="date">Created: 2014-12-08 Mon 15:20</p>
1359
-<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.4.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
1360
-<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
1287
+
1288
+<style type="text/css">
1289
+.back-to-top {
1290
+    position: fixed;
1291
+    bottom: 2em;
1292
+    right: 0px;
1293
+    text-decoration: none;
1294
+    color: #000000;
1295
+    background-color: rgba(235, 235, 235, 0.80);
1296
+    font-size: 12px;
1297
+    padding: 1em;
1298
+    display: none;
1299
+}
1300
+
1301
+.back-to-top:hover {
1302
+    background-color: rgba(135, 135, 135, 0.50);
1303
+}
1304
+</style>
1305
+
1306
+<div class="back-to-top">
1307
+<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
1308
+</div>
1309
+
1310
+<script type="text/javascript">
1311
+    var offset = 220;
1312
+    var duration = 500;
1313
+    jQuery(window).scroll(function() {
1314
+        if (jQuery(this).scrollTop() > offset) {
1315
+            jQuery('.back-to-top').fadeIn(duration);
1316
+        } else {
1317
+            jQuery('.back-to-top').fadeOut(duration);
1318
+        }
1319
+    });
1320
+</script>
1361 1321
 </div>
1362 1322
 </body>
1363 1323
 </html>