From f5416a450134091a8cd5d234a5baf704257d9d5c Mon Sep 17 00:00:00 2001 From: Disassembler Date: Tue, 2 Jun 2020 18:30:08 +0200 Subject: [PATCH] More doc updated --- doc/applications/frontlinesms.rst | 14 ++++++++++++++ doc/applications/sahana.rst | 7 +++++++ 2 files changed, 21 insertions(+) diff --git a/doc/applications/frontlinesms.rst b/doc/applications/frontlinesms.rst index 8318f04..29b6f5b 100644 --- a/doc/applications/frontlinesms.rst +++ b/doc/applications/frontlinesms.rst @@ -6,13 +6,27 @@ Overview FrontlineSMS is a system for both manual and automatic processing of SMS, supporting creation of various SMS workflows. The application is written in Java (resp. Groovy) and uses Grails layout engine. It has its own installer which deploys single-tenant Jetty lightweight applicaiton server. To work efficiently, FrontlineSMS requires a device with SMS capabilities or a connection to third-party service such as Twilio. +The version of FrontlineSMS is no longer maintained by the original developers and no new updates are expected to appear. The manufacturer currently offers and supports only a cloud version of FrontlineSMS. + Upstream URL: https://github.com/frontlinesms/frontlinesms2 +Fork URL: https://github.com/trendspotter/frontlinesms2 - the fork contains the last known working version of installer as a release. + Modem capabilities ------------------ There are special considerations to be taken whenever an application witch direct access to hardware is run in a container. Currently FrontlineSMS has not been tested with such device and it is expected that some extra work or container configuration not present in any other application needs to be done in order to make the hardware device available and usable by the container. +Localization +------------ + +FrontlineSMS is localized to Czech only locally on SpoterVM. Upstream doesn't contain the localization as the application is not developed anymore. The localization is supplied as a Java property file ``WEB-INF/grails-app/i18n/messages_cs.properties`` and then once again as the same file packed and minifies as ``assets/i18n/frontlinesms-core_messages_cs.js``. The minified file can be created using ``frontlinesms-lang-js.py`` helper script in SpotterVM repository. + +Java support +------------ + +Due to the age of the application (latest release somewhere in 2014), FrontlineSMS doesn't work well with current versions of Java runtime. The last know working version is Java 8.222.10 supplied by Alpine 3.8. More recent version, e.g. Java 8.242 cause HTTP connection accept failures. + X server -------- diff --git a/doc/applications/sahana.rst b/doc/applications/sahana.rst index 5793cfd..178b618 100644 --- a/doc/applications/sahana.rst +++ b/doc/applications/sahana.rst @@ -19,3 +19,10 @@ Python 3.8 compatibility ------------------------ Sahana Eden is currently recommended to be run on web2py R2.18.5 (commit hash `59700b8 `_). Recommended version is tracked in eden_deploy project in `main.yml for common playbook `_. This version however doesn't fully support python 3.8, so a series of patches needs to applied to achieve the full support for python 3.8. This includes compatibility patches for gluon and pydal tracked in `_compat.patch `_ and scheduler patch tracked separately in `scheduler.diff `_. + +Localization +------------ + +Czech localization for Sahana Eden is currently not a part of upstream code. It is currently held in SpotterVM repository and there are currently no plans to submit a pull request with the translation. + +The localization is done via translation export function of Sahana Eden found in the administration menu. The exported CSV or XLS file is then manually translated and fed back to ``sahana-lang-convert.py`` helper script which generated the appropriate python dictionary file used as translation. Some strings are not output by the translation function and are either hardcoded or composed, so there is also ``sahana-lang-compare.py`` helper script which traverses installed Sahana Eden instance and tries to locate and supply all missing strings from the previous translation file. Both helper scripts are also contained in the SpotterVM repository.