Add F.A.Q. section

README.md

@@ -25,6 +25,48 @@ Every merge into the _master_ branch deploys changes into the production at http
 Run `npm run news` to automatically download news from our [Telegram channel](https://t.me/OrganicMapsApp),
 then create a git commit and push it.
 
+## Taxonomy and F.A.Q. architecture
+
+Each MD page in `/faq/` has one or more taxonomy defined in header. E.g.:
+
+```yaml
+taxonomies:
+  faq: ["Android"]
+```
+
+Zola collects all such taxonomies:
+
+| File                 | Taxonomy key | Taxonomy value |
+| -------------------- | ------------ | -------------- |
+| android-lags.md      | `faq`        | `Android`      |
+| android-logs.md      | `faq`        | `Android`      |
+| general-team.md      | `faq`        | `General`      |
+| general-bugreport.md | `faq`        | `General`      |
+| ios-versions.md      | `faq`        | `iOS`          |
+| map-longtap.md       | `faq`        | `Map`          |
+| ...                  | ...          | ...            |
+
+After that Zola gets all values for `faq` taxonomy: `[General, Android, iOS, Map, ...]`. And generates pages:
+
+* For key `/faq/` with the list of values (see `templates/faq/list.html`)
+* For each value `/faq/general`, `/faq/android`, etc. with the list of questions (see `templates/faq/single.html`)
+
+If you want to add new question then create .md file with header:
+
+```yaml
+taxonomies:
+  faq: ["iOS"]
+```
+
+Zola will add your question to specific F.A.Q. sub-page.
+
+**Limitation**: List of taxonomies at `/faq/` page is always alphabetical. So 'Android' is always the first, 'Bookmarks' is the second, 'General' is the third and so on.
+
+**Limitation**: You can't sort questions at any F.A.Q. sub-page. So questions at `/faq/general` are always sorted by filename. We can create additional extra field like `extra.order` and sort questions by this field. But reordering would be hard.
+
+**Limitation**: Each F.A.Q. sub-page has only a name. No description, no icon. Only name 'Android', or 'iOS', or 'Routing', etc.
+
+
 ## Contribution
 
 Any good ideas and help with web site improvement are appreciated. And it's always better to discuss

config.toml

@@ -15,6 +15,10 @@ build_search_index = false
 
 ignored_content = [".DS_Store"]
 
+taxonomies = [
+  {name = "faq", feed = false},
+]
+
 [markdown]
 external_links_target_blank = true
 
@@ -30,11 +34,13 @@ stripe = "https://donate.organicmaps.app/"
 address = "Address"
 back = "Back to News"
 contact = "Contact Us"
+engines = "Supported TTS Engines"
 install-appgallery = "Install Organic Maps from Huawei AppGallery"
 install-appstore = "Install Organic Maps from the AppStore"
 install-googleplay = "Install Organic Maps from Google Play"
 install-fdroid="Install Organic Maps from F-Droid"
 language = "English"
+const_lang = "Language"
 name = "Name"
 token = "Token"
 

content/_index.md

@@ -110,4 +110,4 @@ Organic Maps is an [open-source software][github] licensed under the Apache Lice
 
 [fork]: https://en.wikipedia.org/wiki/Fork_(software_development)
 
-{{ references() }}
+{{ references() }}

content/faq/android-01-version/index.md

@@ -0,0 +1,15 @@
+---
+title: What Android version can run Organic Maps?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 10
+---
+
+You need at leat Android 5 to run the app. Devices with latest Android can run Organic Maps.
+
+Organic Maps can work on devices with Google Services installed and without Google support.
+

content/faq/android-02-fdroid/index.md

@@ -0,0 +1,14 @@
+---
+title: What's the difference between F-Droid and Google Play versions of tha app?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 20
+---
+
+F-Droid version comes without [Google Play Services](https://en.wikipedia.org/wiki/Google_Play_Services). These Services improve location accuracy using nearest cell towers and wifi hotspots if internet connection is available. F-Droid version uses only device GPS sensor.
+
+With Organic Maps from Google Play you can disable Google Play Services for location search in app settings.

content/faq/android-03-lags/index.md

@@ -0,0 +1,17 @@
+---
+title: Why Organic Maps is slow on my device, UI is laggy, and it crashes randomly?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 30
+---
+
+Most likely you configured to store maps data on SD card. Usually switchable SD cards in Android phones are slow and unreliable.
+
+Change Organic Maps config to store maps data in internal storage. Open Settings → Save maps to → Internal private storage.
+
+Or you can replace SD card with faster one to improve map performance.
+

content/faq/android-04-logs/index.md

@@ -0,0 +1,15 @@
+---
+title: How to enable logs?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 40
+---
+
+If you want to report a bug then additional app logs could help locate a problem.
+To get useful logs go to Settings → Enable logging. After that do action to reproduce the problem.
+Finally tap on icon with Organic Maps icon on main screen and press "Report a bug" button.
+Don't forget to disable logging after reporting.

content/faq/android-05-webview/index.md

@@ -0,0 +1,12 @@
+---
+title: What if app crashes on start?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 50
+---
+
+You need to enable Android WebView component.

content/faq/bookmarks-01-edit/index.md

@@ -0,0 +1,18 @@
+---
+title: How to edit or move bookmarks?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 10
+---
+
+To edit a bookmark use longtap menu or hit "Edit bookmark" when bookmark is selected on map.
+
+<img src="/faq/bookmarks-01-edit/android-selected-bookmark.jpg" width="400"/>
+
+You can change bookmark name, description, color, and folder. Don't forget to tap "Save".
+
+<img src="/faq/bookmarks-01-edit/android-edit-bookmark.jpg" width="400"/>

content/faq/bookmarks-02-remove/index.md

@@ -0,0 +1,14 @@
+---
+title: How to remove bookmark or track?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 20
+---
+
+On Android you can remove bookmark from from bookmarks list using longtap menu.
+
+On iOS: ???

content/faq/bookmarks-03-import-android/index.md

@@ -0,0 +1,14 @@
+---
+title: How to import multiple bookmarks on Android?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 30
+---
+
+<img src="/faq/bookmarks-03-import-android/android-import-bookmarks.jpg" width="400px"/>
+
+Push "Import Bookmarks and tracks" button. Choose folder on your phone with KML/KMZ/GPX files. Organic Maps will scan picked folder and import all bookmarks and tracks.

content/faq/bookmarks-04-import-gpx/index.md

@@ -0,0 +1,18 @@
+---
+title: Hot to import GPX track on Android and iOS?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 40
+---
+
+If you received GPX file in email, messenger, or cloud drive you can import it directly to Organic Maps app.
+
+On iOS tap on GPX file and press Share button: <img src="/faq/bookmarks-04-import-gpx/ios-share.png" width="50px"/>. Then select Organic Maps to open the file.
+
+On Android tap on received GPX file to see Share menu. Select Organic Maps to import the file.
+
+<img src="/faq/bookmarks-04-import-gpx/android-share-1.jpg" width="200px"/> <img src="/faq/bookmarks-04-import-gpx/android-share-2.jpg" width="200px"/>

content/faq/bookmarks-05-move-track/index.md

@@ -0,0 +1,14 @@
+---
+title: How to move imported track to another folder?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 50
+---
+
+On Android : ???
+
+On iOS : ???

content/faq/bookmarks-06-files-location/index.md

@@ -0,0 +1,16 @@
+---
+title: How to find bookmarks and tracks files on phone?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 70
+---
+
+Bookmarks and tracks are stored in private app folder and are not accessible from 3rd party apps.
+
+You can access these files on iPhone/iPad from desktop using iTunes app.
+
+On Android device with Root enabled you can find bookmarks in `/data/data/app.organicmaps`.

content/faq/bookmarks-07-uninstall/index.md

@@ -0,0 +1,14 @@
+---
+title: What would happen with my bookmarks and tracks after uninstalling app?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Bookmarks"]
+
+extra:
+  order: 60
+---
+
+All you tracks and bookmarks are removed from device when Organic Maps is uninstalled. Please backup your bookmarks and tracks using export button.
+
+Cloud bookmarks backup and sync is planned in future releases.

content/faq/general-01-history/index.md

@@ -0,0 +1,12 @@
+---
+title: Project history
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 10
+---
+
+???

content/faq/general-02-team/index.md

@@ -0,0 +1,19 @@
+---
+title: Who is working on the project?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 20
+---
+
+Core team consists of:
+* Alexander Borsuk
+* Konstantin Pastbin
+* Viktor Govako
+* Roman Tsisyk
+
+Also contributors from around the world help with new features, bugfixing, testing, graphical design and translations.
+

content/faq/general-03-advantages/index.md

@@ -0,0 +1,14 @@
+---
+title: What are the advantages of OM compared to other maps?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 30
+---
+
+Organic Maps is focused on speed, privacy, battery efficiency and minimization of network utilization.
+You can use offline map for navigation in places far from civilization or in cities with complex traffic network.
+Also compare our [privacy policy](/privacy) with other maps apps. Tell your friends about the difference. 

content/faq/general-04-updates/index.md

@@ -0,0 +1,12 @@
+---
+title: Why you should always update app to the latest version?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 40
+---
+
+We constantly work on improvements and fixing bugs. New map data is distributed only with regular application updates.

content/faq/general-05-roadmap/index.md

@@ -0,0 +1,12 @@
+---
+title: What is your product roadmap?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 50
+---
+
+Crunch till the end of our days!!

content/faq/general-06-bugreport/index.md

@@ -0,0 +1,15 @@
+---
+title: How to send up a bugreport?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 60
+---
+
+Report bugs or issues to [the issue tracker][issues] or [email us][email]. You can submit feedback directly from app.
+Just click icon with "?" on iOS or with green Organic Maps icon on Android. You'll find "Report a bug" button there.
+
+{{ references() }}

content/faq/general-07-news/index.md

@@ -0,0 +1,17 @@
+---
+title: Where to read latest news updates?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["General"]
+
+extra:
+  order: 70
+---
+
+- Subscribe to our [Telegram Channel][telegram] or to the [matrix space][matrix] for updates.
+- Join our [Telegram Group][telegram_chat] to discuss with other users.
+- Visit our [GitHub page][github].
+- Follow our updates in [Mastodon][mastodon], [Facebook][facebook], [Twitter][twitter], [Instagram][instagram], [Reddit][reddit], [LinkedIn][LinkedIn].
+
+{{ references() }}

content/faq/index.md

@@ -0,0 +1,11 @@
+---
+title: "F.A.Q."
+description: "Frequently asked questions for Organic Maps application"
+weight: 1000
+
+extra:
+  menu_title: F.A.Q.
+---
+
+### This page is replaced with taxonomy "faq" from templates/faq/list.html template
+This file is needed for top_menu.html and bottom_menu.html templates to show F.A.Q.