-
Notifications
You must be signed in to change notification settings - Fork 33
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
FAQ updates from main repo #242
Changes from 32 commits
f52d107
287cc1b
5c0ff3f
a9fe924
718f50d
c2da37c
2ddf7d5
b781799
db5dc23
8c7a22b
5d27770
7b09e83
0eaa024
92d931b
94aaa23
aef97f2
eab5bbd
e2e50a5
8fb295c
407d6ba
cc41607
7f966cb
20a4de6
20b45d2
8fb3f8e
19c24af
e62854b
ccb339a
bf655e0
1a31262
e9ffd1a
cf37fe9
7aed8ed
69bd99a
f8056c7
9f182c0
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -48,34 +48,33 @@ Each MD page in `/faq/` has one or more taxonomy defined in header. E.g.: | |
|
||
```yaml | ||
taxonomies: | ||
faq: ["Android"] | ||
faq: ["app"] | ||
``` | ||
|
||
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` | | ||
| ... | ... | ... | | ||
| File | Taxonomy key | Taxonomy value | | ||
|-----------------------------------------| ------------ |----------------| | ||
| map/can-find-position/index.md | `faq` | `map` | | ||
| map/search-cannot-find-a-place/index.md | `faq` | `map` | | ||
| editing/map-errors/index.md | `faq` | `editing` | | ||
| app/crash/index.md | `faq` | `app` | | ||
| text-to-speech-android-tts/index.md | `faq` | `tts` | | ||
| ... | ... | ... | | ||
|
||
After that Zola gets all values for `faq` taxonomy: `[General, Android, iOS, Map, ...]`. And generates pages: | ||
After that Zola gets all values for `faq` taxonomy: `[app, map, editing, tts, ...]`. 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`) | ||
- For each value `/faq/app`, `/faq/map`, etc. with the list of questions (see `templates/faq/single.html`) | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Does it make sense to mention that for other languages taxonomies should be translated for better SEO? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Added translated taxonomies samples: |
||
|
||
If you want to add new question then create .md file with header: | ||
|
||
```yaml | ||
title: A full question that is the title of the page | ||
description: More detailed info with necessary keywords for better SEO | ||
slug: the-url-of-the-page-that-can-be-localized-for-better-seo | ||
|
||
taxonomies: | ||
faq: ["General"] | ||
faq: ["bookmarks"] | ||
extra: | ||
order: 40 | ||
``` | ||
|
@@ -91,13 +90,16 @@ taxonomies = [ | |
] | ||
[languages.XX.translations] | ||
faq-menu-title = "{Translation of 'F.A.Q.' to a new language}" | ||
faq_section_app = "App" | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is it still needed? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Removed. |
||
faq_section_bookmarks = "Bookmarks and Tracks" | ||
faq_section_editing = "Map Editing" | ||
faq_section_map = "Map" | ||
faq_section_tts = "Voice Directions" | ||
``` | ||
|
||
**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**: Questions at any F.A.Q. sub-page are sorted by file name. An `extra.order` variable in .md content files is used for sorting articles. | ||
**Limitation**: F.A.Q. categories are sorted alphabetically: "app", "bookmarks", "editing", "map", "tts". | ||
strump marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
**Limitation**: Each F.A.Q. sub-page has only a name. No description, no icon. Only name 'Android', or 'iOS', or 'Routing', etc. | ||
**Limitation**: Each F.A.Q. category has only a name. No description, no icon. Only name 'App', or 'Bookmarks and Tracks', or 'Map Editing', etc. | ||
|
||
## Contribution | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Häufige Fragen und Antworten | ||
description: In dieser FAQ findest du Antworten auf viele Fragen zur Organic Maps App, zu unseren Mitarbeitern und zu unserem Projekt | ||
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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Foire aux questions | ||
description: Cette FAQ répond à de nombreuses questions sur l'application Organic Maps, nos contributeurs et notre projet. | ||
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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Pytania i odpowiedzi | ||
description: Ten FAQ zawiera odpowiedzi na wiele pytań dotyczących aplikacji Organic Maps, naszych współpracowników i naszego projektu | ||
extra: | ||
menu_title: Pomoc | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Perguntas frequentes | ||
description: Este FAQ contém respostas para muitas perguntas sobre o aplicativo Organic Maps, nossos colaboradores e nosso projeto | ||
extra: | ||
menu_title: Perguntas frequentes | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Perguntas frequentes | ||
description: Esta FAQ contém respostas a muitas perguntas sobre a aplicação Organic Maps, os nossos colaboradores e o nosso projeto | ||
extra: | ||
menu_title: Perguntas frequentes | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Sıkça Sorulan Sorular | ||
description: Bu SSS, Organic Maps uygulaması, katkıda bulunanlarımız ve projemiz hakkında birçok sorunun yanıtını içermektedir | ||
extra: | ||
menu_title: SSS | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: Довідка та часті питання | ||
description: Відповіді на поширені запитання стосовно застосунка Organic Maps | ||
extra: | ||
menu_title: Довідка | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: 问题和解答 | ||
description: 本常见问题回答了有关有机地图应用程序、我们的贡献者和我们项目的许多问题 | ||
extra: | ||
menu_title: 问题和解答 | ||
--- | ||
|
||
### 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. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Was kann ich tun, wenn die App sich aufhängt oder wenn sie abstürzt? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["App"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
Es ist wahrscheinlich unser Fehler und wir werden ihn gerne im nächsten Update beheben. | ||
|
||
Android: Wenn Sie Ihre Karten auf einer SD-Karte speichern, ist die wahrscheinlichste Ursache eine fehlerhafte SD-Karte. Sie können Ihre SD-Karte formatieren oder besser durch eine neue ersetzen. Wenn Sie die App selbst auf die SD-Karte verschoben haben, verschieben Sie sie bitte zurück in den internen (Geräte-) Speicher. | ||
|
||
Wenn das Problem weiterhin besteht, [kontaktieren Sie uns bitte](mailto:[email protected]) und geben Sie uns: | ||
|
||
* kurze Beschreibung des Problems | ||
* Organic Maps Version | ||
* Gerätemodell und Betriebssystemversion (Android oder iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Qué hago si la aplicación se detiene o se bloquea? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Aplicación"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
Probablemente sea nuestro error y estaremos encantados de solucionarlo en la próxima actualización. | ||
|
||
Android: Si almacenas los mapas en una tarjeta SD, lo más probable es que el error se deba a un fallo de la tarjeta. Puedes formatear la tarjeta SD o, mejor aún, cambiarla por otra nueva. Si has movido la app a la tarjeta SD, muévela al almacenamiento interno (de tu dispositivo). | ||
|
||
Si el problema persiste [ponte en contacto con nosotros](mailto:[email protected]) y especifica por favor: | ||
|
||
* la descripción corta del problema | ||
* la version de Organic Maps | ||
* el modelo de dispositivo y la versión de OS (Android o iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Pourquoi l'application s'arrête ou crash? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Application"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
C'est probablement notre bug, et nous serons heureux de le corriger dans la prochaine mise à jour. | ||
|
||
Android: Si vous stockez les cartes sur carte SD, vous pouvez la formater, c'est la cause la plus courante. Le formatage ou le remplacement résouds le plus souvent le problème. | ||
|
||
Si le problème subsiste, merci de nous [contacter](mailto:[email protected]) et envoyer nous: | ||
|
||
* un rapport d'erreur et une description du problème | ||
* la version de Organic Maps | ||
* Le modèle de l'appareil et la version du système d'exploitation (Android ou iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
--- | ||
title: What can I do if the app has stopped/crashed? | ||
description: What actions to take if the application crashes. How to report critical bugs to developers | ||
updated: "2024-06-20" | ||
|
||
taxonomies: | ||
faq: ["App"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
On Android, if you store your maps on an SD card, the most likely cause is a faulty SD card. You can: | ||
1. Delete all downloaded maps and re-download them again to the SD card (may not work again). | ||
2. Delete all downloaded maps, select Internal device storage, and re-download maps. | ||
3. Format SD card and re-download maps. | ||
4. Buy a new SD card (recommended) | ||
|
||
If the app still crashes, please check [our GitHub](https://github.com/organicmaps/organicmaps/issues/) for similar issues, and [contact us](mailto:[email protected]) and provide the following: | ||
|
||
* A detailed description of the issue and steps to reproduce it | ||
* Organic Maps version | ||
* Device model and OS version (Android or iOS) |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Co mogę zrobić, jeśli aplikacja nie odpowiada/uległa awarii? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Aplikacja"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
Bu muhtemelen bizim hatamız ve bir sonraki güncellemede bunu düzeltmekten mutluluk duyacağız. | ||
|
||
Android'de, haritalarınızı bir SD kartta saklarsanız, bunun en olası nedeni hatalı bir SD karttır. SD kartınızı biçimlendirebilir veya daha iyisi yenisiyle değiştirebilirsiniz. Uygulamayı SD karta taşıdıysanız, lütfen tekrar dahili (cihaz) depolama alanına taşıyın. | ||
|
||
Sorun devam ederse, lütfen [bizimle iletişime geçin](mailto:[email protected]) ve şunları ekleyin: | ||
|
||
* sorunun kısa açıklaması | ||
* Organic Maps sürümü | ||
* cihaz modeli ve İşletim Sistemi sürümü (Android veya iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: O que posso fazer se o aplicativo parar (travar)? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Aplicativa"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
É provavelmente o nosso bug e ficaremos felizes em corrigi-lo na próxima atualização. | ||
|
||
Android: se você armazenar seus mapas em um cartão SD, a causa mais provável é um cartão SD defeituoso. Você pode formatar seu cartão SD ou, melhor ainda, substituí-lo por um novo. Se você moveu o aplicativo para o cartão SD, mova-o de volta para o armazenamento interno (dispositivo). | ||
|
||
Se o problema persistir, entre em [contato](mailto:[email protected]) conosco e forneça as seguintes informações: | ||
|
||
* descrição do problema e etapas para recriá-lo | ||
* Versão do Organic Maps | ||
* modelo de dispositivo e versão do sistema operacional (Android ou iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: O que fazer se a aplicação parar de funcionar (bloquear)? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Aplicativa"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
É provavelmente um erro inesperado e ficaremos contentes em corrigi-lo na próxima atualização. | ||
|
||
Android: se armazena os mapas num cartão SD, a causa mais provável é ser um cartão SD defeituoso. Pode tentar formatar o cartão SD ou melhor ainda, substituí-lo por um novo. Se moveu a aplicação para o cartão SD, mova-o novamente no sentido inverso para o armazenamento interno (dispositivo). | ||
|
||
Se mesmo assim o problema persistir, por favor [contacte-nos](mailto:[email protected]) e forneça as seguintes informações: | ||
|
||
* descrição do problema e etapas para o recriar | ||
* Versão do Organic Maps | ||
* modelo do dispositivo e versão do sistema operativo (Android ou iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Что делать, если приложение перестало работать (остановлено)? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Общие"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
Это, скорее всего, баг в нашем коде, и мы будем рады исправить его в следующем обновлении. | ||
|
||
На Android чаще всего эта проблема связана с плохой SD-картой. Если вы храните загруженные карты стран на SD-карте, попробуйте отформатировать ее, а лучше замените на новую. Если вы переместили само приложение на SD карту, пожалуйста, верните его назад в память устройства. | ||
|
||
Если ошибка осталась, пожалуйста, [сообщите нам](mailto:[email protected]) о проблеме и уточните следующую информацию: | ||
|
||
* краткое описание проблемы | ||
* версия Organic Maps | ||
* модель устройства и версия ОС (Android или iOS). |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
--- | ||
title: Uygulama durdurulursa/çökerse ne yapabilirim? | ||
description: "" | ||
updated: "2024-06-12" | ||
|
||
taxonomies: | ||
faq: ["Başvuru"] | ||
|
||
extra: | ||
order: 30 | ||
--- | ||
|
||
Bu muhtemelen bizim hatamız ve bir sonraki güncellemede bunu düzeltmekten mutluluk duyacağız. | ||
|
||
Android'de, haritalarınızı bir SD kartta saklarsanız, bunun en olası nedeni hatalı bir SD karttır. SD kartınızı biçimlendirebilir veya daha iyisi yenisiyle değiştirebilirsiniz. Uygulamayı SD karta taşıdıysanız, lütfen tekrar dahili (cihaz) depolama alanına taşıyın. | ||
|
||
Sorun devam ederse, lütfen [bizimle iletişime geçin](mailto:[email protected]) ve şunları ekleyin: | ||
|
||
* sorunun kısa açıklaması | ||
* Organic Maps sürümü | ||
* cihaz modeli ve İşletim Sistemi sürümü (Android veya iOS). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should it be capitalized? e.g. Map, App?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Renamed
faq/map/can-find-position
tofaq/map/can-not-find-position
Updated "Taxonomy value" column