prepare docs/ for hugo ssg (see #176)

docs/settings.md

@@ -1,19 +1,18 @@
-# Launcher Settings
+# Settings
 
-Tweaks and customizations can be made from within the Launcher Settings page.
+Tweaks and customizations can be made from within the settings page.
+The settings can be opened by binding the Settings action to a gesture (this is especially useful when configuring μLauncher for the first time) or from the settings icon in the app drawer.[^1]
 
-These settings let you change wallpapers, change colors and fonts, enable monochrome app icons, change the app drawer layout, and much more.
-
-In the following documentation, 'app drawer' will be used to refer to the 'All Apps', 'Favorite Apps' and 'Private Space' views.
+[^1]: i.e. the 'All Apps', 'Favorite Apps' and 'Private Space' views.
 
 ## Appearance
 
-> ### Choose a wallpaper
+### Choose a wallpaper
 
 This triggers Android's mechanism to change the wallpaper using a photos app, file explorer, or native wallpaper setting app.
 µLauncher uses the system-wide wallpaper, i.e. this change also affects other launchers.
 
-> ### Font (in-app font)
+### Font (in-app font)
 
 Set the font used within the app settings. This setting does not affect the date/time home screen font.
 
@@ -21,17 +20,17 @@ Set the font used within the app settings. This setting does not affect the date
 
 **options:** `Hack`,`System default`,`Sans serif`,`Serif`,`Monospace`,`Serif monospace`
 
-> ### Text Shadow
+### Text Shadow
 
 **type:** `toggle`
 
-> ### Background (app list and setting)
+### Background (app list and setting)
 
 **type:** `dropdown`
 
 **type:** `Transparent`,`Dim`,`Blur`,`Solid`
 
-> ### Monochrome app icons
+### Monochrome app icons
 
 Remove coloring from all app icons. Can help decrease visual stimulus when enabled.
 
@@ -39,49 +38,56 @@ Remove coloring from all app icons. Can help decrease visual stimulus when enabl
 
 ## Date & Time
 
-> ### Font (home screen)
+These settings effect the clock shown on the home screen (or on widget panels).
+If the clock is removed, the settings are not used.
 
-Set the home screen font for date and time. This setting does not affect the in-app font.
+### Font (home screen)
+
+Set the home screen font for date and time. This setting does not affect the font of other components.
 
 **type:** `dropdown`
 
 **options:** `Hack`,`System default`,`Sans serif`,`Serif`,`Monospace`,`Serif monospace`
 
-> ### Color [`[bug]`](https://github.com/jrpie/launcher/issues/151)
+### Color
 
 Set the color for the home screen date and time.
 
-Accepts a HEX color code (consisting of a '#' followed by three sets of two alphanumeric (letters and numbers) characters. A fourth set of two alphanumeric characters may be added to set the transparency of the color.
+Accepts an 6 digit RGB or or 8 digit ARGB color code characters.[^2]
+Note that on Android the ARGB color format is used, i.e. the alpha component is specified first.
+This differs from the more common RGBA, which is used in web development.
 
-[Color wheel picker](https://rgbacolorpicker.com/color-wheel-picker)
 
-**type:** `HEX`,`RGBA`
+[^2]: More precisely, everything that is vaild input for [parseColor](https://developer.android.com/reference/android/graphics/Color#parseColor(java.lang.String)) can be used.
 
-> ### Use localized date format
 
-Adapt the display of dates and times to the specific conventions of a particular locale or region. Different locales use different date orders (e.g., MM/DD/YYYY in the US, DD/MM/YYYY in Europe).
+**type:** `ARGB`
+
+### Use localized date format
+
+Adapt the display of dates and times to the specific conventions of a particular locale or region as set by the system. Different locales use different date orders (e.g., MM/DD/YYYY in the US, DD/MM/YYYY in Europe).
 
 **type:** `toggle`
 
-> ### Show time
+### Show time
 
 Show the current time on the home screen.
 
 **type:** `toggle`
 
-> ### Show seconds
+### Show seconds
 
 Show the current time down to the second on the home screen.
 
 **type:** `toggle`
 
-> ### Show date
+### Show date
 
 Show the current date on the home screen.
 
 **type:** `toggle`
 
-> ### Flip date and time
+### Flip date and time
 
 Place the current time above the current date on the home screen.
 
@@ -89,7 +95,7 @@ Place the current time above the current date on the home screen.
 
 ## Functionality
 
-> ### Launch search results
+### Launch search results
 
 Launches any app that matches user keyboard input when no other apps match.
 
@@ -105,37 +111,37 @@ Press space to temporarily disable this feature and allow text entry without pre
 
 **type:** `toggle`
 
-> ### Search the web
+### Search the web
 
-Press return/enter while searching the app list to launch a web search.
+Press return while searching the app list to launch a web search.
 
 **type:** `toggle`
 
-> ### Start keyboard for search
+### Start keyboard for search
 
 Automatically open the keyboard when the app drawer is opened.
 
 **type:** `toggle`
 
-> ### Double swipe gestures
+### Double swipe gestures
 
 Enable double swipe (two finger) gestures in launcher settings. Does not erase gesture bindings if accidentally turned off.
 
 **type:** `toggle`
 
-> ### Edge swipe gestures
+### Edge swipe gestures
 
 Enable edge swipe (near edges of screen) gestures in launcher settings. Does not erase gesture bindings if accidentally turned off.
 
 **type:** `toggle`
 
-> ### Edge width
+### Edge width
 
 Change how large a margin is used for detecting edge gestures. Shows the edge margin preview when using the slider.
 
 **type:** `slider`
 
-> ### Choose method for locking the screen
+### Choose method for locking the screen
 
 There are two methods to lock the screen and unfortunately both have downsides.
 
@@ -157,11 +163,11 @@ There are two methods to lock the screen and unfortunately both have downsides.
 
 ## Apps
 
-> ### Hidden apps
+### Hidden apps
 
 Open an app drawer containing only hidden apps.
 
-> ### Don't show apps that are bound to a gesture in the app list
+### Don't show apps that are bound to a gesture in the app list
 
 Remove certain apps from the app drawer if they are already accessible via a gesture.
 
@@ -169,20 +175,21 @@ Reduces redundancy and tidies up app drawer.
 
 **type:** `toggle`
 
-> ### Hide paused apps
+### Hide paused apps
 
 Remove paused apps from the app drawer.
 For example an app belonging to the work profile is paused when the work profile is inactive.
 
 **type:** `toggle`
 
-> ### Hide private space from app list
+### Hide private space from app list
 
 Remove private space from app drawer.
+Private space apps can be accessed using a separate app drawer which can be opened with the Private Space action.
 
 **type:** `toggle`
 
-> ### Layout of app list
+### Layout of app list
 
 Changes how the apps are displayed when accessing the app drawer.
 
@@ -195,7 +202,7 @@ Changes how the apps are displayed when accessing the app drawer.
 
 **options:** `Default`,`Text`,`Grid`
 
-> ### Reverse the app list
+### Reverse the app list
 
 Enable reverse alphabetical sorting of apps in the app drawer.
 Useful for keeping apps within easier reach from the keyboard.
@@ -204,21 +211,21 @@ Useful for keeping apps within easier reach from the keyboard.
 
 ## Display
 
-> ### Rotate screen
+### Rotate screen
 
 **type:** `toggle`
 
-> ### Keep screen on
+### Keep screen on
 
 **type:** `toggle`
 
-> ### Hide status bar
+### Hide status bar
 
 Remove the top status bar from the home screen.
 
 **type:** `toggle`
 
-> ### Hide navigation bar
+### Hide navigation bar
 
 Remove the navigation bar from the home screen. Enabling this setting may make it difficult to use the device if gestures are not setup properly.
 
@@ -226,7 +233,7 @@ Remove the navigation bar from the home screen. Enabling this setting may make i
 
 ## Additional Settings
 
-> ### App Drawer Long Press on App
+### App Drawer Long Press on App
 
 Access additional per-app details and settings. To use, open the app drawer and long press on any app.