diff --git a/doc/freedombox-manual.xml b/doc/freedombox-manual.xml index ea827978f..e09d72a4c 100644 --- a/doc/freedombox-manual.xml +++ b/doc/freedombox-manual.xml @@ -1370,6 +1370,56 @@ proto udp +
+ Wiki (MediaWiki) +
+ About MediaWiki + MediaWiki is the software that powers the Wikimedia suite of wikis. + Read more about MediaWiki on Wikipedia + Available since: version 0.20.0 +
+
+ MediaWiki on FreedomBox + MediaWiki on FreedomBox is configured to be publicly readable and privately editable. Only logged in users can make edits to the wiki. This configuration prevents spam and vandalism on the wiki. +
+ User management + Users can be created by the MediaWiki administrator (user "admin") only. The "admin" user can also be used to reset passwords of MediaWiki users. The administrator password, if forgotten can be reset anytime from the MediaWiki page in the Plinth UI. +
+
+ Use cases + MediaWiki is quite versatile and can be put to many creative uses. It also comes with a lot of plugins and themes and is highly customizable. +
+ Personal Knowledge Repository + + + MediaWiki on FreedomBox can be your own personal knowledge repository. Since MediaWiki has good multimedia support, you can write notes, store images, create checklists, store references and bookmarks etc. in an organized manner. You can store the knowledge of a lifetime in your MediaWiki instance. + + +
+
+ Community Wiki + + + A community of users can use MediaWiki as their common repository of knowledge and reference material. It can used as a college notice board, documentation server for a small company, common notebook for study groups or as a fan wiki like wikia. + + +
+
+ Personal Wiki-based Website + + + Several websites on the internet are simply MediaWiki instances. MediaWiki on FreedomBox is read-only to visitors. Hence, it can be adapted to serve as your personal website and/or blog. MediaWiki content is easy to export and can be later moved to use another blog engine. + + +
+
+
+ Editing Wiki Content + MediWiki's new Visual Editor gives a WYSIWYG user interface to creating wiki pages. Unfortunately, it is not yet available in the current version of MediaWiki on Debian. + You don't have to necessarily learn the MediaWiki formatting language. You can write in your favorite format (Markdown, Org-mode, LaTeX etc.) and convert it to the MediaWiki format using Pandoc. +
+
+
Wiki and Blog (Ikiwiki)
@@ -4121,7 +4171,7 @@ nmcli con modify "<connection_name>" connection.zone internal The pre-built FreedomBox images have a default user account called "fbx". However the password is not set for this account, so it will not be possible to log in with this account by default. There is a script included in the freedom-maker program, that will allow you to set the password for this account, if it is needed. To set a password for the "fbx" user: 1. Decompress the image file. - 2. Get a copy of freedom-maker from . + 2. Get a copy of freedom-maker from . 3. Run sudo ./bin/passwd-in-image <image-file> fbx. 4. Copy the image file to SD card and boot device as normal. The "fbx" user also has superuser privileges via sudo. @@ -6312,7 +6362,7 @@ Password: Finding out the IP address of the virtual machine This depends on the network configuration you chose. With a bridged adapter, your virtual machine gets its IP address from the DHCP server of your network, most likely of your Router. You can try the first couple of IP addresses or check your router web interface for a list of connected devices. If you chose host-only adapter, the IP address is assigned by the DHCP server of your VirtualBox network. In the VirtualBox Manager, go to File -> Preferences -> Network -> Host-only Networks. You can see and edit the DHCP address range there, typically you get assigned addresses close to the Lower Address Bound. - Another possibility of finding the IP address is to login via the Virtualbox Manager (or similar software). The FreedomBox images do not have any default user accounts, so you need to set an initial user and password using the passwd-in-image script. + Another possibility of finding the IP address is to login via the Virtualbox Manager (or similar software). The FreedomBox images do not have any default user accounts, so you need to set an initial user and password using the passwd-in-image script. See also QuickStart for instructions on how to scan your network to discover the IP of the VM.
@@ -6812,6 +6862,32 @@ wget https://www.thinkpenguin.com/files/ath9k_firmware_free-version/htc_7010.fw<
Release Notes The following are the release notes for each FreedomBox version. +
+ Plinth v0.22.0 (2018-01-30) + + + matrix-synapse: Make sure configuration file does not get corrupted. + + + tor: Show enabled status properly. + + + first_setup: Fix not showing admin user creation step. + + + Migrate from GitHub to Salsa + + + Migrate from CirceCI to GitLab CI on Salsa. + + + Translation updates for Czech, Dutch, Gujarati, Hindi, Russian and Telugu. + + + Started new translation for Ukrainian. + + +
Plinth v0.21.0 (2018-01-15) @@ -7777,7 +7853,7 @@ wget https://www.thinkpenguin.com/files/ath9k_firmware_free-version/htc_7010.fw< Web design for freedomboxfoundation.org and FreedomBox wiki pages - Logo and branding (we currently have an identity manual and logos) + Logo and branding (we currently have an identity manual and logos) Possible designs for custom FreedomBox cases on single board computers @@ -7840,7 +7916,7 @@ wget https://www.thinkpenguin.com/files/ath9k_firmware_free-version/htc_7010.fw< Individual applications that FreedomBox exposes to users. - The primary user interface (Plinth) was internationalized in the 0.7 release. You can contribute to the localization effort using the web-based tool at Weblate or directly to the source tree via GitHub. + The primary user interface (Plinth) was internationalized in the 0.7 release. You can contribute to the localization effort using the web-based tool at Weblate or directly to the source tree via Salsa. If you wish to see FreedomBox available for one of your languages, please start a discussion on the FreedomBox discuss mailing list or on the #freedombox IRC channel to avoid double translations. For more information, please visit the FreedomBox translation landing page.
@@ -8391,7 +8467,7 @@ Plinth module to configure Tiny Tiny RSS. $ sudo apt-get install plinth - You can also get Plinth from its Git repository and install from source. + You can also get Plinth from its Git repository and install from source.
@@ -8464,13 +8540,13 @@ Plinth module to configure Tiny Tiny RSS. Instructions on how to contribute code are available. - The primary Git repository is hosted at FreedomBox GitHub Page. + The primary Git repository is hosted at FreedomBox Salsa Page. - Instructions for installing from source and hacking the source are available. + Instructions for installing from source and hacking the source are available. - List of bugs, TODO items and feature requests are available on the issue tracker. + List of bugs, TODO items and feature requests are available on the issue tracker. Before contributing to Plinth code, you need understand Python and Django on top which it is built. @@ -8483,10 +8559,7 @@ Plinth module to configure Tiny Tiny RSS. Debian Package - Plinth is packaged for Debian. - - - Packaging project is on Alioth along with sources. + Plinth is packaged for Debian. Plinth is a native package and packaging source code is part of the main package source code. Issues related to packaging are listed on Debian BTS. @@ -8510,7 +8583,7 @@ Plinth module to configure Tiny Tiny RSS. If you are on a Debian box, you may install FreedomBox Setup from Debian package archive. This essentially turns your Debian installation into a FreedomBox! Currently, only Sid (unstable) is supported. To install FreedomBox Setup, see instructions on setting up FreedomBox on a Debian machine. - You can also get FreedomBox Setup from its Git repository and build Debian package from source. + You can also get FreedomBox Setup from its Git repository and build Debian package from source.
@@ -8538,7 +8611,7 @@ Plinth module to configure Tiny Tiny RSS. Instructions on how to contribute code are available. - FreedomBox Setup is part of the FreedomBox Alioth Project. + FreedomBox Setup is part of the FreedomBox Salsa Project. List of bugs, TODO items, packages issues and feature requests are available on the issue tracker. @@ -8574,12 +8647,12 @@ Plinth module to configure Tiny Tiny RSS. - BeagleBone + Banana Pro - Cubietruck + BeagleBone @@ -8587,11 +8660,21 @@ Plinth module to configure Tiny Tiny RSS. Cubieboard2 + + + Cubietruck + + DreamPlug + + + pcDuino3 + + Raspberry Pi @@ -8599,7 +8682,12 @@ Plinth module to configure Tiny Tiny RSS. - Raspberry Pi 2 (also works on 3) + Raspberry Pi 2 + + + + + Raspberry Pi 3 @@ -8613,7 +8701,7 @@ Plinth module to configure Tiny Tiny RSS. - Other virtual machines (using raw disk images) + AMD64 (x86-64) Machines, X86 Machines and other virtual machines (using raw disk images) It relies on the vmdebootstrap project actually create images. If a hardware platform is capable of running Debian, it should not be too much effort adopt Freedom Maker to create FreedomBox images for the platform. @@ -8622,7 +8710,7 @@ Plinth module to configure Tiny Tiny RSS. Building FreedomBox Images - You can get Freedom Maker from its Git repository and follow the instructions in the README to build a FreedomBox image. + You can get Freedom Maker from its Git repository and follow the instructions in the README to build a FreedomBox image.
@@ -8650,10 +8738,7 @@ Plinth module to configure Tiny Tiny RSS. Instructions on how to contribute code are available. - Freedom Maker is hosted on FreedomBox Alioth Portal. The primary Git repository is hosted there. - - - Freedom Maker is also hosted on FreedomBox GitHub Page. Pull requests are accepted there. + Freedom Maker is hosted at FreedomBox Salsa Project. The primary Git repository is hosted there. You can contribute to FreedomBox by adding support for more hardware platforms. Freedom Maker can be easily adopted to newer platforms if they already support running Debian. @@ -8662,7 +8747,7 @@ Plinth module to configure Tiny Tiny RSS. You can create and test images with Freedom Maker regularly to test for new features and check for regressions. - List of bugs, TODO items and feature requests are available on the issue tracker. + List of bugs, TODO items and feature requests are available on the issue tracker. You can request for development assistance on the mailing list or the #freedombox IRC channel.