From 2cf7265d16fa1f57ae4892792cf1d2e82cc0cac5 Mon Sep 17 00:00:00 2001 From: MM20 <15646950+MM2-0@users.noreply.github.com> Date: Thu, 3 Oct 2024 19:01:23 +0200 Subject: [PATCH] Add more docs --- .../user-guide/customization/themed-icons.md | 9 ++---- docs/docs/user-guide/faq.md | 30 +++++++++++++++--- docs/docs/user-guide/sidebar.ts | 4 +++ .../troubleshooting/update-not-installed.md | 31 +++++++++++++++++++ 4 files changed, 63 insertions(+), 11 deletions(-) create mode 100644 docs/docs/user-guide/troubleshooting/update-not-installed.md diff --git a/docs/docs/user-guide/customization/themed-icons.md b/docs/docs/user-guide/customization/themed-icons.md index a01a759d..862de311 100644 --- a/docs/docs/user-guide/customization/themed-icons.md +++ b/docs/docs/user-guide/customization/themed-icons.md @@ -17,15 +17,12 @@ While themed icons were originally introduced in Android 13, support has been ba Note however, that some apps (especially preinstalled system apps) may not support themed icons on older Android versions. -## Themed icon packs +## Themable icon packs Some icon packs, notably [Lawnicons](https://github.com/LawnchairLauncher/lawnicons) and [Arcticons](https://github.com/Donnnno/Arcticons), have support -for themed icons. This is indicated by a "Dynamic colors" badge in the icon pack selection dialog. -After you have selected an icon pack with support for themed icons, you can enable themed icons for -that pack using the toggle button that appears in the icon pack preference: - -![Themed icon pack](/img/themed-icon-pack.png) +for themed icons. This is indicated by a palette icon +in the icon pack selection dialog. > [!NOTE] > If you are an icon pack developer, you can indicate that your icon pack supports themed icons by diff --git a/docs/docs/user-guide/faq.md b/docs/docs/user-guide/faq.md index 15cb945b..fbab6fbc 100644 --- a/docs/docs/user-guide/faq.md +++ b/docs/docs/user-guide/faq.md @@ -8,24 +8,44 @@ sidebar_position: 2 There are two options: -1. Go to Settings > Home screen > Clock and enable "Favorites". This will display the first row of pinned items +1. Go to Settings > Home screen > Clock and enable "Favorites". This will display the first row of + pinned items as part of the clock widget. -2. Scroll down to the end of the widgets list, select "Edit widgets" > "Add widget" > "Favorites" to add +2. Scroll down to the end of the widgets list, select "Edit widgets" > "Add widget" > "Favorites" to + add the favorites widget to the home screen. ## Can I remove / customize the clock? -Yes, you can customize the clock style by going to Settings > Home screen > Clock and selecting a different +Yes, you can customize the clock style by going to Settings > Home screen > Clock and selecting a +different style. There is also an "empty style" that will remove the clock entirely. ## The toggle to grant notification access or to enable the accessibility service is disabled -Please refer to the [Restricted Settings on Android 13+](/docs/user-guide/troubleshooting/restricted-settings) page. +Please refer to +the [Restricted Settings on Android 13+](/docs/user-guide/troubleshooting/restricted-settings) page. ## The launcher keeps asking for notification access or accessibility service -Please refer to the [this page](/docs/user-guide/troubleshooting/granted-permissions). +Please refer to [this page](/docs/user-guide/troubleshooting/granted-permissions). + +## I can't update to the latest version + +Please refer to the [Launcher Cannot Be Updated](/docs/user-guide/troubleshooting/update-not-installed) page. + +## Why is wallpaper blur not supported on my device? + +Wallpaper blur is available if: + +- the device runs Android 12 or higher +- battery saver is not enabled + +Furthermore, the device has to have support for [cross window +blur](https://source.android.com/docs/core/display/window-blurs). This is a flag that has to +be enabled by the device manufacturer to indicate that their implementation of the render engine +supports blur effects and that the GPU is powerful enough to handle them. ## How can I set up the nightly version? diff --git a/docs/docs/user-guide/sidebar.ts b/docs/docs/user-guide/sidebar.ts index 091408d4..80bdcca0 100644 --- a/docs/docs/user-guide/sidebar.ts +++ b/docs/docs/user-guide/sidebar.ts @@ -117,6 +117,10 @@ export const UserGuideSidebar: DefaultTheme.SidebarItem[] = [ text: 'Restricted Settings on Android 13+', link: '/docs/user-guide/troubleshooting/restricted-settings', }, + { + text: 'Launcher Cannot Be Updated', + link: '/docs/user-guide/troubleshooting/update-not-installed', + }, ], }, ] diff --git a/docs/docs/user-guide/troubleshooting/update-not-installed.md b/docs/docs/user-guide/troubleshooting/update-not-installed.md new file mode 100644 index 00000000..91d7f866 --- /dev/null +++ b/docs/docs/user-guide/troubleshooting/update-not-installed.md @@ -0,0 +1,31 @@ +# Launcher Cannot Be Updated + +If you are trying to update the launcher, but the installation fails, you are most likely trying +to crossgrade from the F-Droid version to the Github version or vice versa. Both versions use +different signing keys, so you cannot update one with the other. + +## Kvaesitso versions + +There are two different release versions of Kvaesitso: + +- **Github version**: This is the version that is released on Github. It includes all features and + is also available on + the [MM20 F-Droid repository](https://fdroid.mm20.de/app/de.mm20.launcher2.release) and on + the [IzzyOnDroid F-Droid repository](https://apt.izzysoft.de/fdroid/index/apk/de.mm20.launcher2.release). +- **F-Droid version**: This version is built and signed, and distributed by the F-Droid maintainers. + It is available on + the [official F-Droid repository](https://f-droid.org/packages/de.mm20.launcher2.release). Some + features disabled that depend on external APIs; most notably, there are fewer + weather providers available. Furthermore, new versions are usually released with a delay (a few + days up to a week). + +## Check which version you have installed + +Go to Settings > About. If the version number is something like `x.y.z`, you have the Github version +installed. If the version number ends in `-fdroid`, you have the F-Droid version installed. + +## Switch between versions + +You cannot switch versions without uninstalling the current version first. First, backup your +data in Settings > Backup & restore. Then, uninstall the current version and install the other +version. You can then restore your data in Settings > Backup & restore > Restore. \ No newline at end of file