diff --git a/doc/freedombox-manual.xml b/doc/freedombox-manual.xml index d50a432bb..ee5c91f62 100644 --- a/doc/freedombox-manual.xml +++ b/doc/freedombox-manual.xml @@ -978,13 +978,150 @@ file = /etc/radicale/rights
News Feed Reader (Tiny Tiny RSS) Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator, designed to allow reading news from any location, while feeling as close to a real desktop application as possible. - When enabled, Tiny Tiny RSS will be available from /tt-rss path on the web server. Any user created through Plinth will be able to login and use this app. + Any user created through FreedomBox web interface will be able to login and use this app. Each user has their own feeds, state and preferences.
- Screenshot + Using the Web Interface + When enabled, Tiny Tiny RSS will be available from /tt-rss path on the web server. Any user created through Plinth will be able to login and use this app. - + + + + Tiny Tiny RSS + + + +
+ Adding a new feed + 1. Go to the website you want the RSS feed for and copy the RSS/Atom feed link from it. + + + + + + + Selecting feeds + + + + 2. Select "Subscribe to feed.." from the Actions dropdown. + + + + + + + Subscribe to feed + + + + 3. In the dialog box that appears, paste the URL for copied in step 1 and click the Subscribe button. + + + + + + + Subscription dialog box + + + + Give the application a minute to fetch the feeds after clicking Subscribe. + In some websites, the RSS feeds button isn't clearly visible. In that case, you can simply paste the website URL into the Subscribe dialog (step 3) and let TT-RSS automatically detect the RSS feeds on the page. + You can try this now with the homepage of WikiNews + As you can see in the image below, TT-RSS detected and added the Atom feed of WikiNews to our list of feeds. + + + + + + + WikiNews feed added + + + + If you don't want to keep this feed, right click on the feed shown in the above image, select Edit feed and click Unsubscribe in the dialog box that appears. + + + + + + + Unsubscribe from a feed + + + +
+
+ Importing your feeds from another feed reader + In your existing feed reader, find an option to Export your feeds to a file. Prefer the OPML file format if you have to choose between multiple formats. Let's say your exported feeds file is called Subscriptions.opml + Click on the Actions menu at the top left corner and select Preferences. You will be taken to another page. + Select the second tab called Feeds in the top header. Feeds has several sections. The second one is called OPML. Select it. + + + + + + + OPML feeds page + + + + To import your Subscriptions.opml file into TT-RSS, + + + Click Browse and select the file from your file system + + + Click Import my OPML + + + After importing, you'll be taken to the Feeds section that's above the OPML section in the page. You can see that the feeds from your earlier feed reader are now imported into Tiny Tiny RSS. You can now start using Tiny Tiny RSS as your primary feed reader. + In the next section, we will discuss setting up the mobile app, which can let you read your feeds on the go. +
+
+
+ Using the Mobile App + The official Android app from the Tiny Tiny RSS project works with FreedomBox's Tiny Tiny RSS Server. The older TTRSS-Reader application is known not to work. + The official Android app is unfortunately only available on the Google Play Store and not on F-Droid. You can still obtain the source code and build the apk file yourself. + To configure, first install the application, then in the setting page, set URL as . Set your user name and password in the Login details as well as HTTP Authentication details. If your FreedomBox does not have a valid HTTPS certificate, then in settings request allowing any SSL certificate and any host. + + + + + + + Tiny Tiny RSS + + + + + + + + Tiny Tiny RSS + + + + + + + + Tiny Tiny RSS + + + + + + + + Tiny Tiny RSS + + + + + Tiny Tiny RSS @@ -4063,7 +4200,7 @@ Password:
Hardware - FreedomBox is designed to be the software for a consumer electronics device that is easy to setup, maintain and use. The project does not aim to create a custom hardware device ourselves, but instead we plan to support/customize exiting hardware. + FreedomBox is designed to be the software for a consumer electronics device that is easy to setup, maintain and use. The project does not aim to create a custom hardware device ourselves, but instead we plan to support/customize existing hardware. In addition to supporting various single board computers and other devices, FreedomBox also supports being installed in a virtual machine. Also, any Debian machine can be turned into a FreedomBox by installing the freedombox-setup package. See the manual for more details.
Supported Hardware @@ -6603,6 +6740,78 @@ 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.15.3 (2017-10-20) +
+ Changed + + + Rename Disks to Storage. + + + Rename Snapshot to Storage Snapshots. + + + tt-rss: Enable API access by default. + + + Allow access to Plinth from outside the LAN. + + + matrix-synapse: Disable public registration by default. + + + power: Merge actions into the user dropdown. + + +
+
+ Added + + + Add locales for Kannada (kn) and for Bengali (bn). + + + ejabberd: Use Let's Encrypt certificate, also across renewals. + + + matrix-synapse: Add enable/disable public registrations. + + + Add captcha validation on 3 failed attempts. + + + matrix-synapse: Enable LDAP integration. + + + letsencrypt: Automatically obtain and revoke SSL certificates. + + +
+
+ Fixed + + + Fix front page label names. + + + Fix vertical alignment of shortcut icons. + + + storage: Fix issue with locales that use other decimal separators. + + + Make tt-rss api accessible using Apache basic auth. + + + letsencrypt: Handle case where current domain is empty. + + + Handle both admin and non-admin user names in update user template. + + +
+
Plinth v0.15.2 (2017-09-24)
diff --git a/doc/images/OPML.png b/doc/images/OPML.png new file mode 100644 index 000000000..7347fec6a Binary files /dev/null and b/doc/images/OPML.png differ diff --git a/doc/images/Select-RSS-feed.png b/doc/images/Select-RSS-feed.png new file mode 100644 index 000000000..f3b144adc Binary files /dev/null and b/doc/images/Select-RSS-feed.png differ diff --git a/doc/images/Subscribe-dialog.png b/doc/images/Subscribe-dialog.png new file mode 100644 index 000000000..91a81f7ce Binary files /dev/null and b/doc/images/Subscribe-dialog.png differ diff --git a/doc/images/Subscribe-to-feed.png b/doc/images/Subscribe-to-feed.png new file mode 100644 index 000000000..759ebdd60 Binary files /dev/null and b/doc/images/Subscribe-to-feed.png differ diff --git a/doc/images/Unsubscribe.png b/doc/images/Unsubscribe.png new file mode 100644 index 000000000..6cb0d4c84 Binary files /dev/null and b/doc/images/Unsubscribe.png differ diff --git a/doc/images/WikiNews-feed.png b/doc/images/WikiNews-feed.png new file mode 100644 index 000000000..582ff27ff Binary files /dev/null and b/doc/images/WikiNews-feed.png differ diff --git a/doc/images/ttrssapp1.png b/doc/images/ttrssapp1.png new file mode 100644 index 000000000..f548a7f54 Binary files /dev/null and b/doc/images/ttrssapp1.png differ diff --git a/doc/images/ttrssapp2.png b/doc/images/ttrssapp2.png new file mode 100644 index 000000000..6bcc762f8 Binary files /dev/null and b/doc/images/ttrssapp2.png differ diff --git a/doc/images/ttrssapp3.png b/doc/images/ttrssapp3.png new file mode 100644 index 000000000..764bca9bc Binary files /dev/null and b/doc/images/ttrssapp3.png differ diff --git a/doc/images/ttrssapp4.png b/doc/images/ttrssapp4.png new file mode 100644 index 000000000..d43743dac Binary files /dev/null and b/doc/images/ttrssapp4.png differ diff --git a/doc/images/ttrssapp5.png b/doc/images/ttrssapp5.png new file mode 100644 index 000000000..f0be1a047 Binary files /dev/null and b/doc/images/ttrssapp5.png differ