Skip to content

Home

Jump to bottom
Mikhail Kulesh edited this page Aug 19, 2017 · 14 revisions

How to activate developer mode

Developer mode in the app allows to perform:

  • Automatic tests
  • Export documentation from the app into LaTeX format

To activate developer mode, do following:

  • Select main menu "Open source licenses"
  • In the Dialog window, 10x tap on the header "The Apache Commons Mathematics Library" until the toast "Developer mode is activated" appears:
  • Restart the app
  • In the main menu, "Developer options" is now visible

How to creating/editing locales and translating docs

If you want to translate the app, there are two types of resources:

  • The file app/src/main/res/values/strings.xml contains the elements of the user interface. It also contains an array <string-array name="activity_resources"> that describes the application documentation

  • Application documentation consist of:

    • XML-files placed in the app/src/main/assets/doc_<locale> directory. These files are worksheet files in the micrMathematics format that contain detailed documentation. Each file represents a chapter of this documentation and can be opened from application navigation drawer.
    • If you activate the "Developer options" in the main menu, you can export all these chapters including all images in the LaTeX format. The exported files for all languages are stored in the doc directory. To build the documentation, see README.md in this directory.
    • The PDF files built from LaTeX source are currently attached to the release tag

  • The array activity_resources in the app/src/main/res/values/strings.xml file contains the links to both XML-files in the corresponding language as well as to PDF files for the corresponding release.

Therefore, there are two strategies to translate the app:

  • The simplest way is to only translate app/src/main/res/values/strings.xml, but leave activity_resources array in this file unchanged (that means the documentation still be in English). This partial translation is not too good, but can be useful in some situations

  • Full translation. In this case, all XML-files placed in the app/src/main/assets/doc_en directory shall be translated first and placed into the new directory app/src/main/assets/doc_<lacale>. To do it, ether use an XML-editor or edit these files directly in the app using any tablet with hardware keyboard. After the documentation files are translated and formatted in the app, they can be exported into LaTeX format and PDF file can be created. After it, app/src/main/res/values/strings.xml can be translated, where activity_resources array will than contain links to the previously translated documentation files.

Clone this wiki locally