Browse Source

Notes on installing dokuwiki

Bob Mottram 8 years ago
parent
commit
802ad58a8a
5 changed files with 136 additions and 85 deletions
  1. 42
    0
      doc/EN/app_dokuwiki.org
  2. 1
    0
      doc/EN/apps.org
  3. 1
    0
      doc/EN/usage.org
  4. 71
    68
      website/EN/apps.html
  5. 21
    17
      website/EN/usage.html

+ 42
- 0
doc/EN/app_dokuwiki.org View File

@@ -0,0 +1,42 @@
1
+#+TITLE:
2
+#+AUTHOR: Bob Mottram
3
+#+EMAIL: bob@freedombone.net
4
+#+KEYWORDS: freedombone, dokuwiki
5
+#+DESCRIPTION: How to use Dokuwiki
6
+#+OPTIONS: ^:nil toc:nil
7
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="freedombone.css" />
8
+
9
+#+BEGIN_CENTER
10
+[[file:images/logo.png]]
11
+#+END_CENTER
12
+
13
+#+BEGIN_EXPORT html
14
+<center>
15
+<h1>Mailpile</h1>
16
+</center>
17
+#+END_EXPORT
18
+
19
+Dokuwiki is a wiki which stores its content in text files. Having no database makes maintaining it simpler, and it's not tied to any particular domain name so you can easily copy the files to a different domain if you need to.
20
+
21
+
22
+* Installation
23
+Log into your system with:
24
+
25
+#+begin_src bash
26
+ssh myusername@mydomain -p 2222
27
+#+end_src
28
+
29
+Using cursor keys, space bar and Enter key select *Administrator controls* and type in your password.
30
+
31
+Select *Add/Remove Apps* then *dokuwiki*. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under *Dynamic DNS* on the FreeDNS site (the random string from "/quick cron example/" which appears after /update.php?/ and before />>/). For more details on obtaining a domain and making it accessible via dynamic DNS see the [[./faq.html][FAQ]]. Typically the domain name you use will be a subdomain, such as /wiki.mydomainname.net/. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
32
+
33
+After the install has completed go to *Security settings* and select *Create a new Let's Encrypt certificate* and enter the domain name that you are using for Dokuwiki. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
34
+
35
+* Initial setup
36
+If you have just obtained a Lets Encrypt certificate as above then go to *About* on the administrator control panel and you should see your Dokuwiki domain listed there along with an onion address. You can then navigate to your site in a browser.
37
+
38
+If you installed the system using a disk image then you can log in using the username and password which was originally shown when you installed the system. If you didn't install from a disk image then a new random password will be generated for each site and stored within a readme file. If you need to view that file then exit to the user control panel, select *Exit to the command line* and then run:
39
+
40
+#+begin_src bash
41
+editor README
42
+#+end_src

+ 1
- 0
doc/EN/apps.org View File

@@ -27,6 +27,7 @@ Enables you to use the system as a music server which any DLNA compatible device
27 27
 * Dokuwiki
28 28
 A databaseless wiki system.
29 29
 
30
+[[./app_dokuwiki.html][How to use it]]
30 31
 * Emacs
31 32
 If you use the Mutt client to read your email then this will set it up to use emacs for composing new mail.
32 33
 

+ 1
- 0
doc/EN/usage.org View File

@@ -25,6 +25,7 @@
25 25
 | [[./app_dlna.html][Play Music]]                                           |
26 26
 | [[./app_gnusocial.html][Microblogging (GNU Social)]]                           |
27 27
 | [[./app_hubzilla.html][Social Network]]                                       |
28
+| [[./app_dokuwiki.html][Wiki]]                                                 |
28 29
 | [[./app_irc.html][Multi-user chat with IRC]]                             |
29 30
 | [[./app_xmpp.html][XMPP/Jabber]]                                          |
30 31
 | [[./app_tox.html][Tox]]                                                  |

+ 71
- 68
website/EN/apps.html View File

@@ -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-11-13 Sun 16:08 -->
6
+<!-- 2016-11-14 Mon 14:34 -->
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>
@@ -257,9 +257,9 @@ The base install of the system just contains an email server and Mutt client, bu
257 257
 </div>
258 258
 </div>
259 259
 
260
-<div id="outline-container-org53750a1" class="outline-2">
261
-<h2 id="org53750a1">DLNA</h2>
262
-<div class="outline-text-2" id="text-org53750a1">
260
+<div id="outline-container-org6b0cb3c" class="outline-2">
261
+<h2 id="org6b0cb3c">DLNA</h2>
262
+<div class="outline-text-2" id="text-org6b0cb3c">
263 263
 <p>
264 264
 Enables you to use the system as a music server which any DLNA compatible devices can connect to within your home network.
265 265
 </p>
@@ -269,45 +269,48 @@ Enables you to use the system as a music server which any DLNA compatible device
269 269
 </p>
270 270
 </div>
271 271
 </div>
272
-<div id="outline-container-orgc37305d" class="outline-2">
273
-<h2 id="orgc37305d">Dokuwiki</h2>
274
-<div class="outline-text-2" id="text-orgc37305d">
272
+<div id="outline-container-org1edaf37" class="outline-2">
273
+<h2 id="org1edaf37">Dokuwiki</h2>
274
+<div class="outline-text-2" id="text-org1edaf37">
275 275
 <p>
276 276
 A databaseless wiki system.
277 277
 </p>
278
+
279
+<p>
280
+<a href="./app_dokuwiki.html">How to use it</a>
281
+</p>
278 282
 </div>
279 283
 </div>
280
-
281
-<div id="outline-container-org4e065e2" class="outline-2">
282
-<h2 id="org4e065e2">Emacs</h2>
283
-<div class="outline-text-2" id="text-org4e065e2">
284
+<div id="outline-container-org07e9247" class="outline-2">
285
+<h2 id="org07e9247">Emacs</h2>
286
+<div class="outline-text-2" id="text-org07e9247">
284 287
 <p>
285 288
 If you use the Mutt client to read your email then this will set it up to use emacs for composing new mail.
286 289
 </p>
287 290
 </div>
288 291
 </div>
289 292
 
290
-<div id="outline-container-orgf70547e" class="outline-2">
291
-<h2 id="orgf70547e">Etherpad</h2>
292
-<div class="outline-text-2" id="text-orgf70547e">
293
+<div id="outline-container-orgbbbf14d" class="outline-2">
294
+<h2 id="orgbbbf14d">Etherpad</h2>
295
+<div class="outline-text-2" id="text-orgbbbf14d">
293 296
 <p>
294 297
 Collaborate on creating documents in real time. Maybe you're planning a holiday with other family members or creating documentation for a Free Software project along with other volunteers. Etherpad is hard to beat for simplicity and speed. Only users of the system will be able to access it.
295 298
 </p>
296 299
 </div>
297 300
 </div>
298 301
 
299
-<div id="outline-container-org042ab63" class="outline-2">
300
-<h2 id="org042ab63">Ghost</h2>
301
-<div class="outline-text-2" id="text-org042ab63">
302
+<div id="outline-container-orga446976" class="outline-2">
303
+<h2 id="orga446976">Ghost</h2>
304
+<div class="outline-text-2" id="text-orga446976">
302 305
 <p>
303 306
 Modern looking blogging system.
304 307
 </p>
305 308
 </div>
306 309
 </div>
307 310
 
308
-<div id="outline-container-orgfdec06d" class="outline-2">
309
-<h2 id="orgfdec06d">GNU Social</h2>
310
-<div class="outline-text-2" id="text-orgfdec06d">
311
+<div id="outline-container-org03949bb" class="outline-2">
312
+<h2 id="org03949bb">GNU Social</h2>
313
+<div class="outline-text-2" id="text-org03949bb">
311 314
 <p>
312 315
 Federated social network. You can "<i>remote follow</i>" other users within the GNU Social federation.
313 316
 </p>
@@ -317,9 +320,9 @@ Federated social network. You can "<i>remote follow</i>" other users within the
317 320
 </p>
318 321
 </div>
319 322
 </div>
320
-<div id="outline-container-org34c3d73" class="outline-2">
321
-<h2 id="org34c3d73">Gogs</h2>
322
-<div class="outline-text-2" id="text-org34c3d73">
323
+<div id="outline-container-orge3152c7" class="outline-2">
324
+<h2 id="orge3152c7">Gogs</h2>
325
+<div class="outline-text-2" id="text-orge3152c7">
323 326
 <p>
324 327
 Lightweight git project hosting system. You can mirror projects from Github, or if Github turns evil then just host your own projects while retaining the familiar <i>fork-and-pull</i> workflow. If you can use Github then you can also use Gogs.
325 328
 </p>
@@ -329,18 +332,18 @@ Lightweight git project hosting system. You can mirror projects from Github, or
329 332
 </p>
330 333
 </div>
331 334
 </div>
332
-<div id="outline-container-org401d328" class="outline-2">
333
-<h2 id="org401d328">HTMLy</h2>
334
-<div class="outline-text-2" id="text-org401d328">
335
+<div id="outline-container-orgf79df97" class="outline-2">
336
+<h2 id="orgf79df97">HTMLy</h2>
337
+<div class="outline-text-2" id="text-orgf79df97">
335 338
 <p>
336 339
 Databaseless blogging system. Quite simple and with a markdown-like format.
337 340
 </p>
338 341
 </div>
339 342
 </div>
340 343
 
341
-<div id="outline-container-org76aa025" class="outline-2">
342
-<h2 id="org76aa025">Hubzilla</h2>
343
-<div class="outline-text-2" id="text-org76aa025">
344
+<div id="outline-container-org052cad7" class="outline-2">
345
+<h2 id="org052cad7">Hubzilla</h2>
346
+<div class="outline-text-2" id="text-org052cad7">
344 347
 <p>
345 348
 Web publishing platform with social network like features and good privacy controls so that it's possible to specify who can see which content. Includes photo albums, calendar, wiki and file storage.
346 349
 </p>
@@ -350,9 +353,9 @@ Web publishing platform with social network like features and good privacy contr
350 353
 </p>
351 354
 </div>
352 355
 </div>
353
-<div id="outline-container-org419eab7" class="outline-2">
354
-<h2 id="org419eab7">IRC Server (ngirc)</h2>
355
-<div class="outline-text-2" id="text-org419eab7">
356
+<div id="outline-container-orgbf4c5c3" class="outline-2">
357
+<h2 id="orgbf4c5c3">IRC Server (ngirc)</h2>
358
+<div class="outline-text-2" id="text-orgbf4c5c3">
356 359
 <p>
357 360
 Run your own IRC chat channel which can be secured with a password and accessible via an onion address. A bouncer is included so that you can receive messages sent while you were offline. Works with Hexchat and other popular clients.
358 361
 </p>
@@ -362,27 +365,27 @@ Run your own IRC chat channel which can be secured with a password and accessibl
362 365
 </p>
363 366
 </div>
364 367
 </div>
365
-<div id="outline-container-orgeeebcd5" class="outline-2">
366
-<h2 id="orgeeebcd5">Jitsi Meet</h2>
367
-<div class="outline-text-2" id="text-orgeeebcd5">
368
+<div id="outline-container-org69c0d7e" class="outline-2">
369
+<h2 id="org69c0d7e">Jitsi Meet</h2>
370
+<div class="outline-text-2" id="text-org69c0d7e">
368 371
 <p>
369 372
 Experimental WebRTC video conferencing system, similar to Google Hangouts. This may not be fully functional, but is hoped to be in the near future.
370 373
 </p>
371 374
 </div>
372 375
 </div>
373 376
 
374
-<div id="outline-container-org5c47c0a" class="outline-2">
375
-<h2 id="org5c47c0a">Lychee</h2>
376
-<div class="outline-text-2" id="text-org5c47c0a">
377
+<div id="outline-container-orgdb1664e" class="outline-2">
378
+<h2 id="orgdb1664e">Lychee</h2>
379
+<div class="outline-text-2" id="text-orgdb1664e">
377 380
 <p>
378 381
 Make your photo albums available on the web.
379 382
 </p>
380 383
 </div>
381 384
 </div>
382 385
 
383
-<div id="outline-container-org8d6a46b" class="outline-2">
384
-<h2 id="org8d6a46b">Mailpile</h2>
385
-<div class="outline-text-2" id="text-org8d6a46b">
386
+<div id="outline-container-org39c239b" class="outline-2">
387
+<h2 id="org39c239b">Mailpile</h2>
388
+<div class="outline-text-2" id="text-org39c239b">
386 389
 <p>
387 390
 Modern email client which supports GPG encryption.
388 391
 </p>
@@ -392,9 +395,9 @@ Modern email client which supports GPG encryption.
392 395
 </p>
393 396
 </div>
394 397
 </div>
395
-<div id="outline-container-orgc5f3f6f" class="outline-2">
396
-<h2 id="orgc5f3f6f">Mumble</h2>
397
-<div class="outline-text-2" id="text-orgc5f3f6f">
398
+<div id="outline-container-org8b10156" class="outline-2">
399
+<h2 id="org8b10156">Mumble</h2>
400
+<div class="outline-text-2" id="text-org8b10156">
398 401
 <p>
399 402
 The popular VoIP and text chat system. Say goodbye to old-fashioned telephony conferences with silly dial codes. Also works well on mobile.
400 403
 </p>
@@ -404,9 +407,9 @@ The popular VoIP and text chat system. Say goodbye to old-fashioned telephony co
404 407
 </p>
405 408
 </div>
406 409
 </div>
407
-<div id="outline-container-orgdf8d13c" class="outline-2">
408
-<h2 id="orgdf8d13c">PI-Hole</h2>
409
-<div class="outline-text-2" id="text-orgdf8d13c">
410
+<div id="outline-container-org7d319bc" class="outline-2">
411
+<h2 id="org7d319bc">PI-Hole</h2>
412
+<div class="outline-text-2" id="text-org7d319bc">
410 413
 <p>
411 414
 The black hole for web adverts. Block adverts at the domain name level within your local network. It can significantly reduce bandwidth, speed up page load times and protect your systems from being tracked by spyware.
412 415
 </p>
@@ -416,27 +419,27 @@ The black hole for web adverts. Block adverts at the domain name level within yo
416 419
 </p>
417 420
 </div>
418 421
 </div>
419
-<div id="outline-container-orga434447" class="outline-2">
420
-<h2 id="orga434447">PostActiv</h2>
421
-<div class="outline-text-2" id="text-orga434447">
422
+<div id="outline-container-org813cfb0" class="outline-2">
423
+<h2 id="org813cfb0">PostActiv</h2>
424
+<div class="outline-text-2" id="text-org813cfb0">
422 425
 <p>
423 426
 An alternative federated social networking system compatible with GNU Social. It includes some optimisations and fixes currently not available within the main GNU Social project.
424 427
 </p>
425 428
 </div>
426 429
 </div>
427 430
 
428
-<div id="outline-container-orgaeb4272" class="outline-2">
429
-<h2 id="orgaeb4272">Radicale</h2>
430
-<div class="outline-text-2" id="text-orgaeb4272">
431
+<div id="outline-container-org57c1ea4" class="outline-2">
432
+<h2 id="org57c1ea4">Radicale</h2>
433
+<div class="outline-text-2" id="text-org57c1ea4">
431 434
 <p>
432 435
 Calendar system compatible with CalDAV and CardDAV. Manage your calendar events easily across all your devices.
433 436
 </p>
434 437
 </div>
435 438
 </div>
436 439
 
437
-<div id="outline-container-org5a42817" class="outline-2">
438
-<h2 id="org5a42817">tt-rss</h2>
439
-<div class="outline-text-2" id="text-org5a42817">
440
+<div id="outline-container-org7d960e6" class="outline-2">
441
+<h2 id="org7d960e6">tt-rss</h2>
442
+<div class="outline-text-2" id="text-org7d960e6">
440 443
 <p>
441 444
 Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via an onion address. Have "<i>the right to read</i>" without the Surveillance State knowing what you're reading. Also available with a user interface suitable for viewing on mobile devices via a browser such as OrFox.
442 445
 </p>
@@ -446,9 +449,9 @@ Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via a
446 449
 </p>
447 450
 </div>
448 451
 </div>
449
-<div id="outline-container-org4c8581b" class="outline-2">
450
-<h2 id="org4c8581b">Syncthing</h2>
451
-<div class="outline-text-2" id="text-org4c8581b">
452
+<div id="outline-container-orgea64faa" class="outline-2">
453
+<h2 id="orgea64faa">Syncthing</h2>
454
+<div class="outline-text-2" id="text-orgea64faa">
452 455
 <p>
453 456
 Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.
454 457
 </p>
@@ -458,9 +461,9 @@ Possibly the best way to synchronise files across all of your devices. Once it h
458 461
 </p>
459 462
 </div>
460 463
 </div>
461
-<div id="outline-container-org11de152" class="outline-2">
462
-<h2 id="org11de152">Tox</h2>
463
-<div class="outline-text-2" id="text-org11de152">
464
+<div id="outline-container-orgf726393" class="outline-2">
465
+<h2 id="orgf726393">Tox</h2>
466
+<div class="outline-text-2" id="text-orgf726393">
464 467
 <p>
465 468
 Client and bootstrap node for the Tox chat/VoIP system.
466 469
 </p>
@@ -470,18 +473,18 @@ Client and bootstrap node for the Tox chat/VoIP system.
470 473
 </p>
471 474
 </div>
472 475
 </div>
473
-<div id="outline-container-org66c8cee" class="outline-2">
474
-<h2 id="org66c8cee">Vim</h2>
475
-<div class="outline-text-2" id="text-org66c8cee">
476
+<div id="outline-container-orgd2cad13" class="outline-2">
477
+<h2 id="orgd2cad13">Vim</h2>
478
+<div class="outline-text-2" id="text-orgd2cad13">
476 479
 <p>
477 480
 If you use the Mutt client to read your email then this will set it up to use vim for composing new mail.
478 481
 </p>
479 482
 </div>
480 483
 </div>
481 484
 
482
-<div id="outline-container-org9ef06b6" class="outline-2">
483
-<h2 id="org9ef06b6">XMPP</h2>
484
-<div class="outline-text-2" id="text-org9ef06b6">
485
+<div id="outline-container-org1c1ea0f" class="outline-2">
486
+<h2 id="org1c1ea0f">XMPP</h2>
487
+<div class="outline-text-2" id="text-org1c1ea0f">
485 488
 <p>
486 489
 Chat server which can be used together with client such as Gajim or Conversations to provide end-to-end content security and also onion routed metadata security. Includes advanced features such as <i>client state notification</i> to save battery power on your mobile devices, support for seamless roaming between networks and <i>message carbons</i> so that you can receive the same messages while being simultaneously logged in to your account on more than one device.
487 490
 </p>

+ 21
- 17
website/EN/usage.html View File

@@ -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-11-13 Sun 16:09 -->
6
+<!-- 2016-11-14 Mon 14:35 -->
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>
@@ -255,15 +255,15 @@ for the JavaScript code in this tag.
255 255
 </colgroup>
256 256
 <tbody>
257 257
 <tr>
258
-<td class="org-left"><a href="#org737a35d">Readme</a></td>
258
+<td class="org-left"><a href="#org08009e1">Readme</a></td>
259 259
 </tr>
260 260
 
261 261
 <tr>
262
-<td class="org-left"><a href="#org776090b">Improving ssh security</a></td>
262
+<td class="org-left"><a href="#org1880b3a">Improving ssh security</a></td>
263 263
 </tr>
264 264
 
265 265
 <tr>
266
-<td class="org-left"><a href="#org379ce0e">Administrating the system via an onion address (Tor)</a></td>
266
+<td class="org-left"><a href="#org6ba1d5e">Administrating the system via an onion address (Tor)</a></td>
267 267
 </tr>
268 268
 
269 269
 <tr>
@@ -291,6 +291,10 @@ for the JavaScript code in this tag.
291 291
 </tr>
292 292
 
293 293
 <tr>
294
+<td class="org-left"><a href="./app_dokuwiki.html">Wiki</a></td>
295
+</tr>
296
+
297
+<tr>
294 298
 <td class="org-left"><a href="./app_irc.html">Multi-user chat with IRC</a></td>
295 299
 </tr>
296 300
 
@@ -319,7 +323,7 @@ for the JavaScript code in this tag.
319 323
 </tr>
320 324
 
321 325
 <tr>
322
-<td class="org-left"><a href="#orgc0b4ffb">Adding or removing users</a></td>
326
+<td class="org-left"><a href="#org2486541">Adding or removing users</a></td>
323 327
 </tr>
324 328
 
325 329
 <tr>
@@ -328,9 +332,9 @@ for the JavaScript code in this tag.
328 332
 </tbody>
329 333
 </table>
330 334
 
331
-<div id="outline-container-org737a35d" class="outline-2">
332
-<h2 id="org737a35d">Readme</h2>
333
-<div class="outline-text-2" id="text-org737a35d">
335
+<div id="outline-container-org08009e1" class="outline-2">
336
+<h2 id="org08009e1">Readme</h2>
337
+<div class="outline-text-2" id="text-org08009e1">
334 338
 <p>
335 339
 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:
336 340
 </p>
@@ -350,9 +354,9 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
350 354
 </p>
351 355
 </div>
352 356
 </div>
353
-<div id="outline-container-org776090b" class="outline-2">
354
-<h2 id="org776090b">Improving ssh security</h2>
355
-<div class="outline-text-2" id="text-org776090b">
357
+<div id="outline-container-org1880b3a" class="outline-2">
358
+<h2 id="org1880b3a">Improving ssh security</h2>
359
+<div class="outline-text-2" id="text-org1880b3a">
356 360
 <p>
357 361
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
358 362
 </p>
@@ -402,9 +406,9 @@ If you wish to only use ssh keys then log in to the Freedombone, become the root
402 406
 </div>
403 407
 </div>
404 408
 
405
-<div id="outline-container-org379ce0e" class="outline-2">
406
-<h2 id="org379ce0e">Administrating the system via an onion address (Tor)</h2>
407
-<div class="outline-text-2" id="text-org379ce0e">
409
+<div id="outline-container-org6ba1d5e" class="outline-2">
410
+<h2 id="org6ba1d5e">Administrating the system via an onion address (Tor)</h2>
411
+<div class="outline-text-2" id="text-org6ba1d5e">
408 412
 <p>
409 413
 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:
410 414
 </p>
@@ -446,9 +450,9 @@ Subsequently even if dynamic DNS isn't working you may still be able to administ
446 450
 </p>
447 451
 </div>
448 452
 </div>
449
-<div id="outline-container-orgc0b4ffb" class="outline-2">
450
-<h2 id="orgc0b4ffb">Adding or removing users</h2>
451
-<div class="outline-text-2" id="text-orgc0b4ffb">
453
+<div id="outline-container-org2486541" class="outline-2">
454
+<h2 id="org2486541">Adding or removing users</h2>
455
+<div class="outline-text-2" id="text-org2486541">
452 456
 <p>
453 457
 Log into the system with:
454 458
 </p>