Add another faq ru example

Signed-off-by: Alexander Borsuk <me@alex.bio>

.gitignore

@@ -3,3 +3,4 @@
 node_modules
 public
 translations.yaml
+.idea/*

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,6 +34,7 @@ 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"
@@ -37,6 +42,7 @@ install-fdroid="Install Organic Maps from F-Droid"
 language = "English"
 name = "Name"
 token = "Token"
+faq-menu-title = "F.A.Q"
 
 # Please sort all other translation sections and values in alphabetical order.
 [languages.de]
@@ -88,10 +94,14 @@ language = "Polski"
 name = "Nazwa"
 token = "Token"
 [languages.ru]
+taxonomies = [
+  {name = "faq", feed = false},
+]
 [languages.ru.translations]
 address = "Адрес"
 back = "Назад к новостям"
 contact = "Связаться с нами"
+engines = "Поддерживаемые TTS движки"
 install-appgallery = "Установите Organic Maps из Huawei AppGallery"
 install-appstore = "Установите Organic Maps из AppStore"
 install-googleplay = "Установите Organic Maps из Google Play"
@@ -99,6 +109,8 @@ install-fdroid = "Установите Organic Maps из F-Droid"
 language = "Русский"
 name = "Название"
 token = "Токен"
+faq-menu-title = "Справка"
+
 [languages.tr]
 [languages.tr.translations]
 address = "Adres"

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/_index.md

@@ -0,0 +1,9 @@
+---
+title: Android FAQ
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 30
+---

content/faq/android/_index.ru.md

@@ -0,0 +1,9 @@
+---
+title: Android ЧАВО
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 30
+---

content/faq/android/how-to-enable-logs/index.md

@@ -0,0 +1,20 @@
+---
+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 the action that reproduces the problem.
+
+<img src="/faq/android/how-to-enable-logs/settings-enable-logging.png" style="width:100%; max-width:400px"/>
+
+Finally, tap on the button with Organic Maps icon on main screen and press "Report a bug" button.
+Don't forget to disable logging after reporting.
+
+<img src="/faq/android/how-to-enable-logs/about-report-a-bug.png" style="width:100%; max-width:400px"/>

content/faq/android/how-to-enable-logs/index.ru.md

@@ -0,0 +1,20 @@
+---
+title: Как включить логи?
+description: "Часто задаваемые вопросы по Organic Maps"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 40
+---
+
+Если вы хотите сообщить об ошибке, включение логов в приложении поможет быстрее найти проблему.
+Чтобы включить запись лог файлов, перейдите в раздел "Настройки → Включить логи". После этого выполните действие, которое воспроизводит ошибку.
+
+<img src="/faq/android/how-to-enable-logs/settings-enable-logging.png" style="width:100%; max-width:400px"/>
+
+Наконец, нажмите на кнопку со значком Organic Maps на главном экране и нажмите кнопку "Сообщить об ошибке".
+Не забудьте отключить ведение журнала после отправки сообщения.
+
+<img src="/faq/android/how-to-enable-logs/about-report-a-bug.png" style="width:100%; max-width:400px"/>

content/faq/android/what-android-version-can-run-organic-maps/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 least Android 5 to run the app. Devices with later Android versions can run Organic Maps.
+
+Organic Maps can work on devices with Google Services installed and without Google support.
+

content/faq/android/what-android-version-can-run-organic-maps/index.ru.md

@@ -0,0 +1,14 @@
+---
+title: Какие версии Android поддерживает Organic Maps?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Андроид"]
+
+extra:
+  order: 10
+---
+
+Для работы Organic Maps достаточно устройства с Android 5 или выше. Если у вас самая свежая версия Android, значит Organic Maps точно заработает.
+
+Карта может работать как при наличии Google сервисов, так и без них.

content/faq/android/what-if-app-crashes-on-start/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/android/whats-the-difference-between-f-droid-and-google-play/index.md

@@ -0,0 +1,14 @@
+---
+title: What's the difference between F-Droid and Google Play versions of the app?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Android"]
+
+extra:
+  order: 20
+---
+
+[F-Droid](https://f-droid.org/) 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/why-organic-maps-is-slow-on-my-device/index.md

@@ -0,0 +1,19 @@
+---
+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.
+
+<img src="/faq/android/why-organic-maps-is-slow-on-my-device/settings-save-map-to.png" style="width:100%; max-width:400px"/>
+
+Or you can replace SD card with faster one to improve map performance.
+

content/faq/bookmarks/how-to-edit-or-move-bookmarks/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/how-to-edit-or-move-bookmarks/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/how-to-edit-or-move-bookmarks/android-edit-bookmark.jpg" width="400"/>

content/faq/bookmarks/how-to-find-bookmarks-and-tracks-files/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.
+
+On iOS, 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/how-to-import-gpx-track/index.md

@@ -0,0 +1,18 @@
+---
+title: How 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/how-to-import-gpx-track/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/how-to-import-gpx-track/android-share-1.jpg" width="200px"/> <img src="/faq/bookmarks/how-to-import-gpx-track/android-share-2.jpg" width="200px"/>

content/faq/bookmarks/how-to-import-multiple-bookmarks-on-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/how-to-import-multiple-bookmarks-on-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/how-to-move-imported-track-to-another-folder/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/how-to-remove-bookmark-or-track/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 the bookmarks list using longtap menu.
+
+On iOS: ???

content/faq/bookmarks/what-would-happen-after-uninstalling-app/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/how-to-send-a-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/project-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/what-are-advantages-of-OM-compared-to-other-maps/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/what-is-your-product-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/where-to-read-latest-news-updates/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/general/who-is-working-on-the-project/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/why-you-should-always-update-app-to-the-latest-version/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/index.md

@@ -0,0 +1,13 @@
+---
+title: "F.A.Q."
+description: "Frequently asked questions for Organic Maps application"
+weight: 1000
+
+extra:
+  menu_title: F.A.Q.
+
+sort_by: weight
+---
+
+### 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.

content/faq/index.ru.md

@@ -0,0 +1,13 @@
+---
+title: Справка
+description: Справка и часто задаваемые вопросы по Organic Maps
+weight: 1000
+
+extra:
+  menu_title: Справка
+
+sort_by: weight
+---
+
+### 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.

content/faq/ios/what-ios-version-can-run-organic-maps/index.md

@@ -0,0 +1,12 @@
+---
+title: What iOS version can run Organic Maps?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["iOS"]
+
+extra:
+  order: 10
+---
+
+Organic Maps runs on devices with iOS/iPadOS 12+.

content/faq/ios/why-carplay-is-always-dark/index.md

@@ -0,0 +1,12 @@
+---
+title: Why CarPlay is always dark?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["iOS"]
+
+extra:
+  order: 20
+---
+
+Check your CarPlay settings (NOT Organic Maps settings) when the device is connected, and select "auto" instead of "always dark".

content/faq/map/how-edits-are-uploaded-on-openstreetmap-org/index.md

@@ -0,0 +1,15 @@
+---
+title: How edits are uploaded on OpenStreetMap.org, how conflicts are resolved?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 150
+---
+
+Organic Maps application stores POI changes locally till internet connection is available.
+You can make changes while offline. Edits are uploaded to [OpenStreetMap.org](https://osm.org) in background.
+
+If there are edit conflicts ???

content/faq/map/how-to-catch-gps-signal-from-satelites/index.md

@@ -0,0 +1,12 @@
+---
+title: How to catch GPS signal from satelites? How to tell if device got precise or rough position?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 100
+---
+
+???

content/faq/map/how-to-deal-with-maps-download-errors/index.md

@@ -0,0 +1,12 @@
+---
+title: How to deal with maps download errors?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 130
+---
+
+???

content/faq/map/how-to-get-map-legend/index.md

@@ -0,0 +1,16 @@
+---
+title: How to get map legend?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 20
+---
+
+<img src="/faq/map/how-to-get-map-legend/legend.jpg" width="400px"/>
+
+Use long tap on any object to get it's type and name.
+You can find road type or forest kind in the bottom panel.
+By the way you search objects by type also.

content/faq/map/how-to-get-my-coordinates-speed-and-altitude/index.md

@@ -0,0 +1,15 @@
+---
+title: How to get my coordinates, speed, and altitude?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 60
+---
+
+<img src="/faq/map/how-to-get-my-coordinates-speed-and-altitude/my-position.jpg" width="400px"/>
+
+Tap on blue arrow indicating your position to see GPS coordinates, speed, and height above mean sea level.
+Push share button to give you coordinates to friends.

content/faq/map/how-to-make-changes-to-the-map/index.md

@@ -0,0 +1,14 @@
+---
+title: How to make changes to the map?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 140
+---
+
+<img src="/faq/map/how-to-make-changes-to-the-map/edit-button.jpg" width="400px"/>
+
+Organic Maps works with map data from [OpenStreetMap.org](https://osm.org) project. You can improve place details using "Edit Place" button. To make your changes publicly available you need an account on [OpenStreetMap.org](https://osm.org). If you want to change POI position, or clarify footway, or add buildings and bridges, please use [OpenStreetMap.org](https://osm.org) site with powerful editing tools.

content/faq/map/how-to-make-sure-i-have-latest-app/index.md

@@ -0,0 +1,16 @@
+---
+title: How to make sure I have latest application installed and up-to-date maps?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 120
+---
+
+First make sure you installed updated app from [AppStore][appstore], [Google Play][googleplay], [FDroid][fdroid], or [Huawei AppGallery][appgallery]. If maps data is outdated you will see red dot. Please download latest maps from menu.
+
+<img src="/faq/map/how-to-make-sure-i-have-latest-app/ios-data-updates.png" width="400px"/>
+
+{{ references() }}

content/faq/map/how-to-maximize-map/index.md

@@ -0,0 +1,13 @@
+---
+title: How to maximize map?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 30
+---
+
+Perform single tap on empty space to hide app interface and get fullscreen map.
+Tap on the map again to get UI back.

content/faq/map/how-to-use-long-tap/index.md

@@ -0,0 +1,18 @@
+---
+title: How to use Long Tap?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 10
+---
+
+You can do a lot of things in the app using long tap:
+
+- Add markers
+- Copy place details such as name, address, links, coordinates, etc
+- Add route points
+
+Try long tap in Organic Maps to discover hidden features.

content/faq/map/how-to-use-search/index.md

@@ -0,0 +1,14 @@
+---
+title: How to use search?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 180
+---
+
+You can search places, addresses, cities, sites and many other interests. Organic Maps looks not only by name but by type. You can find nearest drinking water, bicycle parking, bookstore or cave from search field.
+
+Organic Maps can search by coordinates in many formats: `41.9142, 12.4849`, `N 41° 54' 51.12" E 12° 29' 5.639"`, `33T 291418 4643309` (UTM).

content/faq/map/how-to-zoom-in-zoom-out-with-one-hand/index.md

@@ -0,0 +1,19 @@
+---
+title: How to zoom in/zoom out with one hand?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 50
+---
+
+<video width="300px" controls="enabled">
+  <source src="/faq/map/how-to-zoom-in-zoom-out-with-one-hand/one-finger-zoom-Mauritius.mp4" type="video/mp4"/>
+  (Your browser does not support the video tag.)
+</video>
+
+Tap twice on map and on the second tap just slide your finger up and down to zoom in and zoom out respectively.
+
+This gesture works on Android and iOS and not only in Organic Maps.

content/faq/map/what-are-secret-search-queries/index.md

@@ -0,0 +1,16 @@
+---
+title: What are secret search queries?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 190
+---
+
+`?vulkan`, `?gl` - ???
+
+`?edits` - will show changes you made lately and its status. You can see if changes are already uploaded to [OpenStreetMap.org](https://osm.org) or there were any problems?
+
+See [documentation](https://github.com/organicmaps/organicmaps/blob/master/docs/DEBUG_COMMANDS.md) for the full list of commands.

content/faq/map/what-does-gray-circle-around-my-position-mean/index.md

@@ -0,0 +1,17 @@
+---
+title: What does gray circle around my position mean?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 70
+---
+
+<img src="/faq/map/what-does-gray-circle-around-my-position-mean/grey-circle.jpg" width="400px"/>
+
+GPS sensors have accuracy rate. Gray circle indicates this accuracy. Your actual position is somewhere inside this circle.
+Accuracy degrade inside buildings, near steal constructions or radiation sources.
+To improve GPS precision go outside to be under clear sky.
+Enabling [Google Location Accuracy](https://support.google.com/maps/answer/2839911?co=GENIE.Platform%3DAndroid) on Android improves precision significantly.

content/faq/map/what-does-icon-bellow-zoom-buttons-mean/index.md

@@ -0,0 +1,18 @@
+---
+title: What does icon bellow zoom buttons mean?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 90
+---
+
+| Icon                                                                                           | Meaning |
+|------------------------------------------------------------------------------------------------| ------- |
+| <img src="/faq/map/what-does-icon-bellow-zoom-buttons-mean/location-icon-1.png" width="75px"/> | Location search is not initiated |
+| <img src="/faq/map/what-does-icon-bellow-zoom-buttons-mean/location-icon-2.png" width="75px"/> | App is looking for location |
+| <img src="/faq/map/what-does-icon-bellow-zoom-buttons-mean/location-icon-3.png" width="75px"/> | Current position is found. Map is centered on current position and oriented to North. |
+| <img src="/faq/map/what-does-icon-bellow-zoom-buttons-mean/location-icon-4.png" width="75px"/> | Map is centered on current position and rotates according to device compass. |
+

content/faq/map/what-gestures-does-organic-maps-support/index.md

@@ -0,0 +1,16 @@
+---
+title: What gestures does Organic Maps support?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 40
+---
+
+(On iOS and iPadOS) Tap and hold on zoom buttons then drag up or down to zoom.
+
+Use double tap to zoom in.
+
+You can rotate, pan and zoom map with two fingers gestures.

content/faq/map/what-is-the-purpose-of-little-blue-arrow/index.md

@@ -0,0 +1,16 @@
+---
+title: What is the purpose of little blue arrow?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 80
+---
+
+<img src="/faq/map/what-is-the-purpose-of-little-blue-arrow/blue-arrow.jpg" width="400px"/>
+
+This arrow shows direction and distance from your location to selected POI. You should enable location to see it.
+Pressing this button gets fullscreen indicator of orientation and distance.
+You can use it for azimuth navigation if step-by-step routing is not possible for some reason.

content/faq/map/who-moderates-changes/index.md

@@ -0,0 +1,12 @@
+---
+title: Who moderates changes?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 160
+---
+
+???

content/faq/map/why-do-i-see-blue-circle-instead-of-an-arrow/index.md

@@ -0,0 +1,13 @@
+---
+title: Why do I see blue circle instead of an arrow indicating my position?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 110
+---
+
+Tablets don't have compass sensor that's why circle is drawn instead of directed arrow.
+You can find your model on [gsmarena.com](https://www.gsmarena.com) to see if compass is present.

content/faq/map/why-edit-place-button-is-disabled-or-hidden/index.md

@@ -0,0 +1,13 @@
+---
+title: Why "Edit place" button is disabled or hidden?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Map"]
+
+extra:
+  order: 170
+---
+
+If your maps data is more than 2 month then edit button is unavailable.
+Please install latest app and download up-to-date maps to enable editting.

content/faq/routing/how-to-add-intermediate-points/index.md

@@ -0,0 +1,12 @@
+---
+title: Добавить промежуточные точки для обхода/объезда (как?)
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 60
+---
+
+???

content/faq/routing/how-to-add-intermediate-route-points/index.md

@@ -0,0 +1,18 @@
+---
+title: How to add intermediate route points?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 20
+---
+
+In route planning or routing mode pick a point on map and tap "Add Stop" button. New intermediate point would be added to the route.
+
+<img src="/faq/routing/how-to-add-intermediate-route-points/add-stop.jpg" width="400px"/>
+
+In routing mode you can search for gas stations, parking, food, stores and ATMs with search button
+
+<img src="/faq/routing/how-to-add-intermediate-route-points/route-search.jpg" width="75px"/>

content/faq/routing/how-to-build-a-route/index.md

@@ -0,0 +1,28 @@
+---
+title: How to build a route?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 10
+---
+
+Organic Maps can build a route for car trip, bycicle ride or foot walk.
+
+Pick destination point with tap on a POI or by long tap on any place. Use "Route to" button to start route planning.
+
+<img src="/faq/routing/how-to-build-a-route/route-to-button.jpg" width="400px"/>
+
+
+You can change route type from top menu:
+* Car
+* By foot
+* Metro
+* Bycicle
+* Ruller
+
+<img src="/faq/routing/how-to-build-a-route/routing-types.jpg" width="400px"/>
+
+Push "Start" to begin step-by-step routing.

content/faq/routing/how-to-enable-north-up-in-navigation-mode/index.md

@@ -0,0 +1,14 @@
+---
+title: How to enable north up in navigation mode?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 80
+---
+
+<img src="/faq/map/what-does-icon-bellow-zoom-buttons-mean/location-icon-4.png" width="75px"/>
+
+Press triangle icon to rotate map north up. Press again to get perspective view.

content/faq/routing/how-to-enable-route-aviodance-rules/index.md

@@ -0,0 +1,20 @@
+---
+title: How to enable route aviodance rules?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 50
+---
+
+Go to Settings → Routing options and select types of road you want to avoid:
+
+<img src="/faq/routing/how-to-enable-route-aviodance-rules/avoidance.jpg" width="400px"/>
+
+If you want to avoid unpaved roads pick selector near "Unpaved roads" as on screenshot.
+
+If Organic Maps builds a route with some avoidable roads you will see button "Define roads to avoid" for quick setup.
+
+<img src="/faq/routing/how-to-enable-route-aviodance-rules/define-roads.jpg" width="400px"/>

content/faq/routing/how-to-measure-distances-with-organic-maps/index.md

@@ -0,0 +1,20 @@
+---
+title: How to measure distances with Organic Maps? Is there a ruler?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 70
+---
+
+To measure distance from your current position to some object pick that object on map, tap "Route to" button, and select Ruler route type:
+
+<img src="/faq/routing/how-to-measure-distances-with-organic-maps/ruler-type.jpg" width="400px"/>
+
+With ruler enabled tap anywhere on map to continue polyline.
+
+<img src="/faq/routing/how-to-measure-distances-with-organic-maps/ruler-line.jpg" width="400px"/>
+
+You can choose any start point with "Route from" button.

content/faq/routing/location-arrow-points-to-wrong-direction/index.md

@@ -0,0 +1,14 @@
+---
+title: Location arrow points to wrong direction. How to fix?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 100
+---
+
+Probably you have problem with compass sensor.
+
+To improve compass use callibration moves according to [instruction](https://www.youtube.com/watch?v=-Uq7AmSAjt8).

content/faq/routing/why-map-rotates-around-my-position/index.md

@@ -0,0 +1,14 @@
+---
+title: Why map rotates around my position?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 90
+---
+
+The reason could be magnet on your phone case or radiation source near the phone. It could interfere compass sensor.
+
+To improve compass use callibration moves according to [instruction](https://www.youtube.com/watch?v=-Uq7AmSAjt8).

content/faq/routing/why-organic-maps-builds-crooked-route/index.md

@@ -0,0 +1,14 @@
+---
+title: Why Organic Maps builds crooked route?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 40
+---
+
+This could happen if map is outdated. We work on routing constantly. Please update the app regularly.
+
+Sometimes near country or region borders route could be unoptimal. This is known issue.

content/faq/routing/why-osm-route-are-truthful/index.md

@@ -0,0 +1,12 @@
+---
+title: Почему маршруты в ОМ честные и отличаются от других приложений?
+description: "Frequently asked questions for Organic Maps application"
+
+taxonomies:
+  faq: ["Routing"]
+
+extra:
+  order: 30
+---
+
+???

content/faq/tts/tts.md

@@ -0,0 +1,83 @@
+---
+title: Text-to-Speech on Android
+description: Guide on how to make TTS work on Android
+
+taxonomies:
+  faq: ["TTS"]
+
+extra:
+  order: 10
+---
+
+## Summary
+
+Organic Maps uses the system text-to-speech (TTS) engine for voice instructions. The default engines vary by device. The choices can include Google Text-to Speech, device manufacturer's engine or a third-party one. 
+
+The official recommendation from Organic Maps is [RHVoice](https://rhvoice.org/), which is a free and open source speech engine that can be downloaded from [Google Play](https://play.google.com/store/apps/details?id=com.github.olga_yakovleva.rhvoice.android) and [F-Droid](https://f-droid.org/en/packages/com.github.olga_yakovleva.rhvoice.android/).
+
+## Instructions
+
+- Open the Settings app on your Android device.
+- Select Additional Settings and then select Accessibility.
+- Choose your preferred engine, speech rate and pitch.
+
+If you cannot find the relevant setting, open the settings app and search for Text-to-speech.
+
+P.S: Do note that these steps will vary based on the phone brand you are using.
+
+Said options may not appear if you don't have a TTS already installed on your device. Please refer to the table below to install any one of them that supports your native language.
+
+## Screenshots
+
+|             |             |             |
+| ----------- | ----------- | ----------- |
+| <img src='/images/screenshots/tts_config_1.jpg' width='400' alt='Screenshot 1'> | <img src='/images/screenshots/tts_config_2.jpg' width='400' alt='Screenshot 2'> | <img src='/images/screenshots/tts_config_3.jpg' width='400' alt='Screenshot 3'> |
+
+## Engines
+
+Below is a comprehensive list showing several engines and the languages they support (download links can be found after the table):
+
+{{ tts_table() }}
+
+## Downloads
+
+- [Acapela Voices TTS](https://play.google.com/store/apps/details?id=com.acapelagroup.android.tts)
+- [Amazon Ivona TTS](https://apkpure.com/ivona-text-to-speech-hq/com.ivona.tts/download)
+- [eSpeak TTS](https://f-droid.org/en/packages/com.reecedunn.espeak/)
+- [Google Speech Services](https://play.google.com/store/apps/details?id=com.google.android.tts)
+- [RHVoice TTS (Recommended)](https://play.google.com/store/apps/details?id=com.github.olga_yakovleva.rhvoice.android)
+- [Vocalizer (Code Factory)](https://play.google.com/store/apps/details?id=es.codefactory.vocalizertts)
+- [Vocalizer 2 (Nuance)](https://nvda.ru/sintezatory-rechi-vocalizer-expressive2-dlja-nvda#)
+- [Yandex SpeechKit TTS](https://4pda.to/forum/index.php?showtopic=200728&st=4200#download)
+
+## Workarounds
+
+If you’re having trouble initializing the RHVoice TTS engine on LineageOS or other custom ROMs, try this workaround. RHVoice may not initialize properly and the app may crash, especially if you haven’t used any TTS engine on your phone before (e.g., new installation, factory reset, etc.). If you’re using a custom ROM like LineageOS <ins>without Google Play services and Speech Services by Google</ins>, and you want to use RHVoice as your preferred TTS engine, follow the instructions below as a workaround:
+
+- Install the [eSpeak TTS engine](https://f-droid.org/en/packages/com.reecedunn.espeak) available on F-Droid
+
+- Set it as the preferred system engine
+
+    - Go to LineageOS main **Settings**.
+
+    - Scroll down to **Accessibility**.
+
+    - Select **text-to-speech output** and **Preferred engine** (left side) and make sure **eSpeak** is selected.
+
+- Go back and press **play** to see if it is working
+
+- Install [RHVoice](https://f-droid.org/en/packages/com.github.olga_yakovleva.rhvoice.android/) available on F-droid.
+
+    - Open it, select the language you want to use, tap on the cloud icon (far left) to download voices.
+
+    - Press play button to verify if it is working
+    
+- Set **RHVoice** as preferred engine (see step 2)
+
+- Now, you should be able to use RHVoice without any problems
+
+## Testing
+
+In order to test the voice instructions, you can tap on "Test Voice Directions (TTS, Text-To-Speech)" in OM "Settings → Voice Instructions" menu or you can actually start a navigation to receive any voice output. Organic Maps will not give you any voice instructions while you're standing still.
+
+<img src='/images/screenshots/tts_test.png' style='width:100%; max-width:400px' alt='Screenshot TTS Test'>

content/faq/tts/tts.ru.md

@@ -0,0 +1,83 @@
+---
+title: Синтез речи (Text-to-Speech, TTS) на Android
+description: Как настроить озвучку навигатора в Organic Maps на Android
+
+taxonomies:
+  faq: ["Голосовые подсказки"]
+
+extra:
+  order: 10
+---
+
+## Общая информация
+
+Organic Maps uses the system text-to-speech (TTS) engine for voice instructions. The default engines vary by device. The choices can include Google Text-to Speech, device manufacturer's engine or a third-party one.
+
+The official recommendation from Organic Maps is [RHVoice](https://rhvoice.org/), which is a free and open source speech engine that can be downloaded from [Google Play](https://play.google.com/store/apps/details?id=com.github.olga_yakovleva.rhvoice.android) and [F-Droid](https://f-droid.org/en/packages/com.github.olga_yakovleva.rhvoice.android/).
+
+## Instructions
+
+- Open the Settings app on your Android device.
+- Select Additional Settings and then select Accessibility.
+- Choose your preferred engine, speech rate and pitch.
+
+If you cannot find the relevant setting, open the settings app and search for Text-to-speech.
+
+P.S: Do note that these steps will vary based on the phone brand you are using.
+
+Said options may not appear if you don't have a TTS already installed on your device. Please refer to the table below to install any one of them that supports your native language.
+
+## Screenshots
+
+|             |             |             |
+| ----------- | ----------- | ----------- |
+| <img src='/images/screenshots/tts_config_1.jpg' width='400' alt='Screenshot 1'> | <img src='/images/screenshots/tts_config_2.jpg' width='400' alt='Screenshot 2'> | <img src='/images/screenshots/tts_config_3.jpg' width='400' alt='Screenshot 3'> |
+
+## Engines
+
+Below is a comprehensive list showing several engines and the languages they support (download links can be found after the table):
+
+{{ tts_table() }}
+
+## Downloads
+
+- [Acapela Voices TTS](https://play.google.com/store/apps/details?id=com.acapelagroup.android.tts)
+- [Amazon Ivona TTS](https://apkpure.com/ivona-text-to-speech-hq/com.ivona.tts/download)
+- [eSpeak TTS](https://f-droid.org/en/packages/com.reecedunn.espeak/)
+- [Google Speech Services](https://play.google.com/store/apps/details?id=com.google.android.tts)
+- [RHVoice TTS (Recommended)](https://play.google.com/store/apps/details?id=com.github.olga_yakovleva.rhvoice.android)
+- [Vocalizer (Code Factory)](https://play.google.com/store/apps/details?id=es.codefactory.vocalizertts)
+- [Vocalizer 2 (Nuance)](https://nvda.ru/sintezatory-rechi-vocalizer-expressive2-dlja-nvda#)
+- [Yandex SpeechKit TTS](https://4pda.to/forum/index.php?showtopic=200728&st=4200#download)
+
+## Workarounds
+
+If you’re having trouble initializing the RHVoice TTS engine on LineageOS or other custom ROMs, try this workaround. RHVoice may not initialize properly and the app may crash, especially if you haven’t used any TTS engine on your phone before (e.g., new installation, factory reset, etc.). If you’re using a custom ROM like LineageOS <ins>without Google Play services and Speech Services by Google</ins>, and you want to use RHVoice as your preferred TTS engine, follow the instructions below as a workaround:
+
+- Install the [eSpeak TTS engine](https://f-droid.org/en/packages/com.reecedunn.espeak) available on F-Droid
+
+- Set it as the preferred system engine
+
+    - Go to LineageOS main **Settings**.
+
+    - Scroll down to **Accessibility**.
+
+    - Select **text-to-speech output** and **Preferred engine** (left side) and make sure **eSpeak** is selected.
+
+- Go back and press **play** to see if it is working
+
+- Install [RHVoice](https://f-droid.org/en/packages/com.github.olga_yakovleva.rhvoice.android/) available on F-droid.
+
+    - Open it, select the language you want to use, tap on the cloud icon (far left) to download voices.
+
+    - Press play button to verify if it is working
+
+- Set **RHVoice** as preferred engine (see step 2)
+
+- Now, you should be able to use RHVoice without any problems
+
+## Testing
+
+In order to test the voice instructions, you can tap on "Test Voice Directions (TTS, Text-To-Speech)" in OM "Settings → Voice Instructions" menu or you can actually start a navigation to receive any voice output. Organic Maps will not give you any voice instructions while you're standing still.
+
+<img src='/images/screenshots/tts_test.png' style='width:100%; max-width:400px' alt='Screenshot TTS Test'>

content/news/2021-05-06/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-05-06
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-05-09/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-05-09
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-05-24/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-05-24
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-05-25/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-05-25
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-06/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-06
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-17/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-17
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-20/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-20
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-23/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-23
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-24/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-24
 sort_by: date
+template: news/date_section.html
 ---

content/news/2021-06-28/_index.md

@@ -1,4 +1,5 @@
 ---
 date: 2021-06-28
 sort_by: date
+template: news/date_section.html
 ---