organicmaps · biodranik · Apr 20, 2022 · Sep 27, 2023 · Sep 27, 2023 · Sep 27, 2023
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -4,7 +4,7 @@ env:
   ZOLA_VERSION: 0.17.2
 
 on:
-  workflow_dispatch:  # keep manual Github Action trigger in case of any issues with CF pages
+  workflow_dispatch:  # keep manual Github Action trigger in case of any issues with CF section
 #  push:
 
 jobs:
@@ -26,7 +26,7 @@ jobs:
           ./zola build
 
       - name: Publish to Cloudflare Pages
-        uses: cloudflare/pages-action@v1
+        uses: cloudflare/section-action@v1
         with:
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

diff --git a/.gitignore b/.gitignore
@@ -3,3 +3,4 @@
 node_modules
 public
 translations.yaml
+.idea/
diff --git a/README.md b/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

diff --git a/config.toml b/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"
 
@@ -215,11 +221,11 @@ token = "Токен"
 [languages.ca.translations]
 address = "Adreça"
 back = "Torna a Notícies"
-contact = "Contacteu amb nosaltres"
-install-appgallery = "Instal·leu l’Organic Maps des de l’AppGallery de Huawei"
-install-appstore = "Instal·leu l’Organic Maps des de l’AppStore"
-install-googleplay = "Instal·leu l’Organic Maps des del Google Play"
-install-fdroid = "Instal·leu l’Organic Maps des del F-Droid"
+contact = "Contacta'ns"
+install-appgallery = "Instal·la l’Organic Maps des de l’AppGallery de Huawei"
+install-appstore = "Instal·la l’Organic Maps des de l’AppStore"
+install-googleplay = "Instal·la l’Organic Maps des del Google Play"
+install-fdroid = "Instal·la l’Organic Maps des del F-Droid"
 language = "Català"
 name = "Nom"
 token = "Testimoni"

diff --git a/content/_index.ar.md b/content/_index.ar.md
@@ -4,10 +4,10 @@ extra:
   menu_title: الرئيسية
 page_template: index.html
 sort_by: weight
-title: 'Organic Maps: تنزَّه وقد دراجتك وشُدَّ الرحال حيثما أردت بدون الإنترنت'
+title: 'Organic Maps: خرائط بدون إنترنت للتنزه، الدراجة، المسارات والتوجيه'
 ---
 
-**Organic Maps** هو تطبيق أندرويد و آيفون مجاني ولا يحتاج الإتصال بالإنترنت لأجل المسافرين، السياح، السائقين، المتنزهين و راكبي الدراجات مبني على بيانات المصدر العام **[OpenStreetMap][openstreetmap]**. مهتم بخصوصية المستخدمين، مفتوح المصدر، متفرع من تطبيق **Maps.Me** (المعروف سابقا بـ [**MapsWithMe**][mapswithme])، يقوم بصيانته نفس الأشخاص الذين أسسو **MapsWithMe** سنة 2011.
+**Organic Maps** هو تطبيق أندرويد و آيفون مجاني ولا يحتاج الإتصال بالإنترنت من أجل المسافرين،السياح ، المتنزهين والدراجين مبني على بيانات المصدر العام **[OpenStreetMap][openstreetmap]**. مهتم بخصوصية المستخدمين، مفتوح المصدر، متفرع من تطبيق **Maps.Me** (المعروف سابقا بـ [**MapsWithMe**][mapswithme])، يقوم بصيانته نفس الأشخاص الذين أسسو **MapsWithMe** سنة 2011.
 
 **Organic Maps** من التطبيقات القليلة في يومنا هذا التي توفر 100% من المزايا بدون اتصال مباشر بشبكة الإنترنت. ثبّت Organic Maps، نزل الخرائط، ارمي بطاقة الشبكة خاصتك (بالمناسبة، مزود الخدمة يتتبعك باستمرار)، واذهب في رحلة اسبوعية بشحن البطارية مرة واحدة ودون أي بايت مرسل من خلال الشبكة.
 
@@ -17,8 +17,7 @@ title: 'Organic Maps: تنزَّه وقد دراجتك وشُدَّ الرحال
 
 {{ screenshot(src='/images/screenshots/hiking.jpg', alt='Hiking') }}
 
-{{ لقطة شاشة(src='/images/screenshots/hiking.jpg', alt='محبي المشي لمسافات
-طويلة') }}
+{{ screenshot(src='/images/screenshots/prague.jpg', alt='Prague') }}
 
 {{ screenshot(src='/images/screenshots/search.jpg', alt='البحث دون اتصال')
 }}
@@ -28,7 +27,7 @@ title: 'Organic Maps: تنزَّه وقد دراجتك وشُدَّ الرحال
 
 ## المميزات
 
-تطبيق Organic Maps هو الرفيق الأفضل للمسافرين، السياح، المتنزهين و راكبي
+تطبيق Organic Maps هو الرفيق الأفضل للمسافرين،السياح، المتنزهين و راكبي
 الدراجات:
 
 - خرائط تفصيلية بدون إنترنت مع أماكن غير متواجدة في تطبيقات أخرى، بفضل
@@ -77,7 +76,7 @@ Organic Maps لا يطلب أذونات مفرطة للتجسس عليك:
 
 في Organic Maps نعتقد أن الخصوصية هي حق أساسي من حقوق الإنسان:
 
-- Organic Maps هو مشروع مفتوح المصدر مُدار من طرف مُجتمع مستقل
+- Organic Maps هو مشروع مفتوح المصدر يحركه المجتمع المستقل
 - نحن نحمي خصوصيتك من أعين المتطفلين لدى شركات التقنيات الكبيرة
 - ابق آمنًا بغض النظر عن مكان وجودك
 
@@ -115,8 +114,9 @@ Organic Maps هو [برنامج مفتوح المصدر][github] مرخّص تح
   التحديثات.
 - انضم إلى [مجموعة Telegram][telegram_chat] للمناقشة مع المستخدمين الآخرين.
 - زُر [صفحة Github][github].
-- تابع تحديثاتنا في [ماستودون ][mastodon]، [فيسبوك][facebook]،
-  [تويتر][twitter]، [Instagram][instagram]، [Reddit][reddit].
+- Follow our updates in [Mastodon][mastodon], [Facebook][facebook],
+  [Twitter][twitter], [Instagram][instagram], [Reddit][reddit],
+  [LinkedIn][LinkedIn].
 
 [fork]: https://en.wikipedia.org/wiki/Fork_(software_development)
 

diff --git a/content/_index.ca.md b/content/_index.ca.md
@@ -22,7 +22,7 @@ L’**Organic Maps** és una de les poques aplicacions actuals que admet fer ser
 {{ screenshot(src='/images/screenshots/search.jpg', alt='Cerca fora de
 línia') }}
 
-{{ screenshot(src='/images/screenshots/dark.jpg', alt='Navegació en mode
+{{ screenshot(src='/images/screenshots/dark.jpg', alt='Navegació en el mode
 fosc') }}
 
 ## Funcionalitats
@@ -31,12 +31,13 @@ L’Organic Maps és l’aplicació definitiva per a viatgers, turistes,
 excursionistes i ciclistes:
 
 - Mapes detallats fora de línia amb llocs que no existeixen en altres mapes,
-  gràcies a l'[OpenStreetMap][openstreetmap]
+  gràcies a [OpenStreetMap][openstreetmap]
 - Rutes ciclistes, pistes de senderisme i camins
 - Línies de contorn, perfils d'elevació, pics i pendents
 - Navegació pas a pas a peu, amb bicicleta i amb cotxe amb guia de veu
 - Cerques ràpides al mapa, sense connexió
-- Marcadors i rutes en format KML, KMZ i GPX
+- Els marcadors s'exporten i importen en els formats KML/KMZ (GPX està
+  [planificat][gpx_issue])
 - Mode fosc per a protegir els vostres ulls
 - Els països i les regions usen poc espai
 - De codi lliure i obert
@@ -58,7 +59,7 @@ dolentes:
 - No es connecta en secret a cap servidor
 - Sense registres incòmodes
 - No hi ha tutorials obligatoris
-- No us enviem correu brossa per correu electrònic
+- Sense spam per correu electrònic
 - Notificacions emergents
 - Sense components brossa
 - ~~Sense pesticides~~ Completament orgànic!
@@ -72,31 +73,31 @@ iOS][trackercontrol]:
 
 {{ trackercontrol_screenshot() }}
 
-L'Organic Maps no us espia ni demana permisos excessius:
+Organic Maps no demana permisos excessius per a espiar-li:
 
 {{ privacy_screenshots() }}
 
-En Organic Maps, creiem que la privadesa és un dret humà fonamental:
+En Organic Maps, creiem que la privacitat és un dret humà fonamental:
 
 - Organic Maps és un projecte independent, comunitari i obert
-- Protegim la vostra privadesa de la mirada espia de les grans tecnològiques
-- Utilització segura sense importar on sou
+- Protegim la seva privacitat dels ulls espies de les grans tecnològiques
+- Mantingui's fora de perill sense importar on estigui
 
-Rebutgeu la vigilància. Assumiu la vostra llibertat.
+Rebutgi la vigilància. Assumeixi la seva llibertat.
 
-**[Proveu l'Organic Maps!](#install)**
+**[¡Provi Organic Maps!](#install)**
 
 ## Qui paga per l'aplicació gratuïta?
 
-L'aplicació és gratuïta per a tothom. Si us plau,
-[doneu](@/donate/index.ca.md) per a ajudar-nos!
+L'aplicació és gratuïta per a tothom. Si us plau
+[donar](@/donate/index.ca.md) per a donar-nos suport!
 
 Per a fer un donatiu immediatament, feu clic a la icona del mètode de
 pagament preferit:
 
 {{ donate_buttons() }}
 
-### Els nostres socis:
+### Els nostres patrocinadors
 
 El proveïdor [Mythic Beasts](https://www.mythic-beasts.com/) [ens
 aporta][mythic_beasts_donation] dos servidors virtuals amb 400 TB/mes
@@ -106,26 +107,26 @@ actualitzacions i descàrregues dels mapes.
 ## Comunitat
 
 Organic Maps és un [programa lliure][github] disponible en virtut de la
-Llicència Apache 2.0.
+Llicència Apatxe 2.0.
 
-- Uniu-vos al nostre programa beta i suggeriu funcionalitats o informeu
+- Uneix-te al nostre programa beta per a suggerir funcionalitats i informar
   d'errors:
-  * [Beta d'iOS (TestFlight)][testflight]
-  * [Beta d'Android (Firebase)][firebase]
+  * [Beta de iOS (TestFlight)][testflight]
+  * [Beta de Android (Firebase)][firebase]
   * [Beta de PC Linux (Flatpak)][flatpak]
-  * [Beta de PC Linux (paquets)][repology]
-- Informeu d'errors o problemes mitjançant el [rastrejador d'errors][issues]
-  o [enviant-nos un correu electrònic][email].
-- [Debateu][ideas] idees o proposeu característiques.
-- Uniu-vos al nostre [canal del Telegram][telegram] o al [Matrix][matrix]
-  per a estar al dia.
-- Uniu-vos al nostre [grup del Telegram][telegram_chat] i converseu amb
+  * [Beta de PC Linux (paquetes)][repology]
+- Informi d'errors o problemes en el [rastrejador d'errors][issues] o
+  [enviant-nos un correu electrònic][email].
+- [Debati][ideas] idees o proposa sol·licituds de funcions.
+- Subscriu-te al nostre [canal de Telegram][telegram] o al [espai
+  matriu][matrix] per a estar al dia.
+- Uneix-te al nostre [grup de Telegram][telegram_chat] per a parlar amb
   altres usuaris.
-- Visiteu el nostre [GitHub][github].
-- Seguiu les nostres novetats al [Mastodon][mastodon], [Facebook][facebook],
-  [Twitter][twitter], [Instagram][instagram], [Reddit][reddit] i
-  [LinkedIn][LinkedIn].
+- Visiteu la nostra [pàgina al GitHub][github].
+- Segueix les nostres novetats en [Mastodon][mastodon],
+  [Facebook][facebook], [Twitter][twitter], [Instagram][instagram],
+  [Reddit][reddit] i [LinkedIn][LinkedIn].
 
-[fork]: https://ca.wikipedia.org/wiki/Fork
+[fork]: https://en.wikipedia.org/wiki/Fork_(software_development)
 
 {{ references() }}
diff --git a/content/_index.md b/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() }}
diff --git a/content/donate/index.ar.md b/content/donate/index.ar.md
@@ -15,7 +15,7 @@ weight: 10
 - لا إشعارات مزعجة
 - مفتوح المصدر
 
-انقر على أيقونة طريقة الدفع المفضلة أدناه:
+Click on your preferred payment method icon below:
 
 {{ donate_buttons() }}
 
@@ -50,7 +50,7 @@ weight: 10
 
 ## كيف تتبرع؟
 
-انقر على أيقونة طريقة الدفع المفضلة أدناه:
+Click on your preferred payment method icon below:
 
 {{ donate_buttons() }}
 

diff --git a/content/donate/index.ca.md b/content/donate/index.ca.md
@@ -1,13 +1,13 @@
 ---
 description: "Els vostres diners paguen totes les despeses relacionades amb el projecte i ens motiven a millorar l’Organic Maps."
 extra:
-  menu_title: "Feu una donació"
+  menu_title: "Fes una donació"
   preview_image: donate/donate.png
-title: "Doneu per a ajudar al desenvolupament de l'Organic Maps"
+title: "Donar per a fer costat al desenvolupament d'Organic Maps"
 weight: 10
 ---
 
-L'Organic Maps és _gratis per a tothom_ gràcies a les seves
+Organic Maps és _gratis per a tothom_ gràcies a les seves
 **[donacions][stripe]**:
 
 - Sense anuncis
@@ -22,36 +22,37 @@ Feu clic a la icona de pagament preferit:
 
 ## Per què fer donatius a l’Organic Maps?
 
-1. Depenem dels vostres donatius per a continuar amb la nostra missió de
-   mantenir l'Organic Maps obert i gratuït. I lliure d'anuncis.
+1. Depenem dels seus donatius per a seguir amb la nostra missió de mantenir
+   Organic Maps oberta i gratuïta. I lliure d'anuncis.
 2. Som un grup d'entusiastes contribuint en el nostre temps lliure, i
    gastant els diners de les nostres famílies en el projecte. Ens encanta el
    que fem, i estimem als nostres usuaris ❤️.
-3. Amb el vostre suport, volem convertir-nos en una millor versió de Google
-   Maps, centrada en la privadesa.
+3. Amb el seu suport, volem convertir-nos en una millor versió de Google
+   Maps, centrada en la privacitat.
 
 ## Per a què es faran servir els diners?
 
-1. Paguem per servidors ràpids, perquè qualsevol persona pugui accedir a les
-   actualitzacions de característiques dels mapes de forma ràpida i sense
-   esperes. Són centenars de terabytes al mes, i la quantitat està creixent.
+1. Paguem per servidors ràpids, per la qual cosa qualsevol en el món pot
+   descarregar actualitzacions de les característiques dels mapes ràpid i
+   sense esperes. Són centenars de terabytes al mes, i la quantitat està
+   creixent.
 2. L'assistència als usuaris, l'arranjament d'errors i la millora de
    l'estabilitat de l'aplicació són les nostres principals prioritats. Hi ha
    més de [1800 informes en GitHub][github issues], i aquest número creix
    cada dia. AppStore, Google Play i els correus d'atenció estan inundats
    amb comentaris i informes. Volem lliurar un producte de qualitat.
 3. Amb suficients diners, poden desenvolupar-se més ràpidament prestacions
-   noves, com ara:
+   noves, per exemple:
    - Actualitzacions setmanals i automatitzades dels mapes
    - Còpia de seguretat i sincronització dels llocs d’interès
    - Android Auto
    - Gravadora GPS amb compatibilitat per a GPX
    - Millors estils cartogràfics per a diferents activitats
    - Ombreig de pujols i terreny 3D
    - Millorar l'editor de OpenStreetMap
-   - Millor cerca de direccions sense connexió, encaminament i navegació
+   - Millor cerca de direccions sense connexió, enrutament i navegació
    - Transport públic
-   - ... i [moltes altres][github issues] funcionalitats que vulgueu
+   - ... i [moltes altres][github issues] funcionalitats que desitja
 
 ## Com donar?
 
@@ -69,14 +70,14 @@ també pots fer donació una vegada.
 
 ### Criptomonedes
 
-Si us plau, considereu fer donacions anuals per a reduir les quotes totals.
+Si us plau, considera fer donacions anuals per a reduir les quotes totals.
 
 {{ crypto_table() }}
 
-## Voleu ajudar-nos de cap altra forma?
+## Pots ajudar-nos d'alguna altra forma?
 
-Perfecte! Hi ha diverses maneres d'ajudar a l'Organic Maps. Consulteu la
-pàgina [Suport](@/support-us/index.ca.md) per a més informació.
+Sí! Hi ha diverses maneres de fer costat a Organic Maps. Consulta la pàgina
+[Dona'ns suport](@/support-us/index.ca.md) per a més detalls.
 
-[stripe]: https://donate.organicmaps.app/ «Donació amb Stripe»
-[github issues]: https://github.com/organicmaps/organicmaps/issues «Informes al GitHub»
+[stripe]: https://donate.organicmaps.app/ "Donar via Stripe"
+[github issues]: https://github.com/organicmaps/organicmaps/issues "Informes en GitHub"