describe the features
[enigma2-curlytx.git] / README.rst
index 28aeb523da9866543e71f81136f6b9e215326ddc..f497390ab7b89769edb1ed7856313fea9069a0f9 100644 (file)
@@ -1,20 +1,96 @@
-=======
+*******
 CurlyTx
-=======
+*******
 Enigma2 (Dreambox) plugin that lets you view the contents of remote
-plain text files, e.g. HTTP.
+*plain text* files, e.g. HTTP URLs.
 
 Multiple URLs can be configured and navigated.
 
+.. contents::
+   :depth: 2
+
+
+========
+Features
+========
+- Load any remote plain text files, e.g. via HTTP
+- Unlimited number of remote URLs/pages
+- Reload pages
+- Show HTTP headers
+- Configurable page titles
+- Configurable default page
+- Import complete page list from Atom feed
+- Visible in the main menu or the extension menu (configurable)
+- Configurable menu title
+- Help screen for main window and settings window
+
+
+=====
+Usage
+=====
+
+FIXME
+
+
+
+=================
+Modifying CurlyTx
+=================
+
+
+Translation
+===========
+Beginning a new translation
+---------------------------
+Replace ``$lang_code`` with your two-letter language code::
+
+    $ cd po
+    $ cp messages.po $lang_code.po
+    ... edit $lang_code.po now
+    $ ./compile.sh
+
+
+Editing an existing translation
+-------------------------------
+Simply run ::
+
+    $ cd po
+    $ ./update.sh
+
+This will update the translation template ``messages.pot`` from the source code
+and will merge the changes into the single translation files.
+
+
+Testing a translation
+---------------------
+Link your compiled translation file into ::
+
+    src/locale/$lang_code/LC_MESSAGES/CurlyTx.mo
+
+Enigma2 will pick it up automatically.
+
+
+Building
+========
+First upgrade the version number in ``CONTROL/control``.
+
+Then simply run ::
+
+    ./build.sh
+
+You will need the ``ipkg-build`` script from
+ http://reichholf.net/files/dreambox/tools/ipkg-build
+
+Also see http://dream.reichholf.net/wiki/Howto:IPK_Pakete_erstellen
 
 
 Open issues
 ===========
-- makefile
-- German translation
-- help screens
-- page import via atom feed/opml
 - move mode to re-order pages
-- show current page when multiple ones are defined: "2/6"
-- configurable text size per page
-- show in plugin/extension menu (blue button)
+- how to show clock in lcd?
+
+
+=======
+License
+=======
+The plugin is subject to the GPLv3 or later.