Updated Hidden Figures (markdown)

Hidden-Figures.md

@@ -1,94 +1,94 @@
 There are a series of advanced configuration options that you may need to change to better adapt Gravity Sync to your environment. They are referenced at the end of the `gravity-sync.conf` file. It is suggested that you make any necessary variable changes to this file, as they will supersede the ones located in the core script. If you want to revert back to the Gravity Sync default for any of these settings, just apply a `#` to the beginning of the line to comment it out.
 
-## `PH_IN_TYPE` and `RH_IN_TYPE`
+### `PH_IN_TYPE` and `RH_IN_TYPE`
 
 These variables allow you to configure either a default/standard Pi-hole installation on both the local and remote hosts. Available options are either `default` or `docker` exactly has written.
 
 - Default setting in Gravity Sync is `default`.
 - These variables can be set via `./gravity-sync.sh config` function.
 
-## `PIHOLE_DIR` and `RIHOLE_DIR`
+### `PIHOLE_DIR` and `RIHOLE_DIR`
 
 These variables allow you to change the location of the Pi-hole settings folder on both the local and remote hosts. This is required for Docker installations of Pi-hole. This directory location should be from the root of the file system and be configured **without** a trailing slash.
 
 - Default setting in Gravity Sync is `/etc/pihole`.
 - These variables can be set via `./gravity-sync.sh config` function and required if a Docker install is selected.
 
-## `PIHOLE_BIN` and `RIHOLE_BIN`
+### `PIHOLE_BIN` and `RIHOLE_BIN`
 
 These variables allow you to change the location of the Pi-hole binary folder on both the local and remote hosts. Unless you've done a custom Pi-hole installation, this setting is unlikely to require changes. This directory location should be from the root of the file system and be configured **without** a trailing slash.
 
 - Default setting in Gravity Sync is `/usr/local/bin/pihole`.
 
-## `DOCKER_BIN` and `ROCKER_BIN`
+### `DOCKER_BIN` and `ROCKER_BIN`
 
 These variables allow you to change the location of the Docker binary folder on both the local and remote hosts. This may be necessary on some systems, if you've done a custom installation of Docker. This directory location should be from the root of the file system and be configured **without** a trailing slash.
 
 - Default setting in Gravity Sync is `/usr/bin/docker`.
 
-## `FILE_OWNER` and `RILE_OWNER`
+### `FILE_OWNER` and `RILE_OWNER`
 
 These variables allow you to change the file owner of the Pi-hole gravity database on both the local and remote hosts. This is required for Docker installations of Pi-hole, but is likely unnecessary on standard installs.
 
 - Default setting in Gravity Sync is `pihole:pihole`.
 - These variables are set via `./gravity-sync.sh config` function to `named:docker` automatically if a Docker install is selected.
 
-## `DOCKER_CON` and `ROCKER_CON`
+### `DOCKER_CON` and `ROCKER_CON`
 
 These variables allow you to change the location of the name of the Docker container on both the local and remote hosts.
 
 - Default setting in Gravity Sync is `pihole`.
 - These variables can be set via `./gravity-sync.sh config` function.
 
-## `GRAVITY_FI` and `CUSTOM_DNS`
+### `GRAVITY_FI` and `CUSTOM_DNS`
 
 These variables are for the `gravity.db` and `custom.list` files that are the two components replicated by Gravity Sync. You should not change them unless Pi-hole changes their naming convention for these files, in which case the core Gravity Sync files will be changed to adapt.
 
-## `VERIFY_PASS`
+### `VERIFY_PASS`
 
 Gravity Sync will prompt to verify user interactivity during push, restore, or config operations (that overwrite an existing configuration) with the intention that it prevents someone from accidentally automating in the wrong direction or overwriting data intentionally. If you'd like to automate a push function, or just don't like to be asked twice to do something destructive, then you can opt-out.
 
 - Default setting in Gravity Sync is `0`, change to `1` to bypass this check.
 
-## `SKIP_CUSTOM`
+### `SKIP_CUSTOM`
 
 Starting in v1.7.0, Gravity Sync manages the `custom.list` file that contains the "Local DNS Records" function within the Pi-hole interface. If you do not want to sync this setting, perhaps if you're doing a multi-site deployment with differing local DNS settings, then you can opt-out of this sync.
 
 - Default setting in Gravity Sync is `0`, change to `1` to exempt `custom.list` from replication.
 - This variable can be set via `./gravity-sync.sh config` function.
 
-## `DATE_OUTPUT`
+### `DATE_OUTPUT`
 
 _This feature has not been implemented, but the intent is to provide the ability to add timestamped output to each status indicator in the script output (ex: [2020-05-28 19:46:54] [EXEC] \$MESSAGE)._
 
-## `PING_AVOID`
+### `PING_AVOID`
 
 The `./gravity-sync.sh config` function will attempt to ping the remote host to validate it has a valid network connection. If there is a firewall between your hosts preventing ICMP replies, or you otherwise wish to skip this step, it can be bypassed here.
 
 - Default setting in Gravity Sync is `0`, change to `1` to skip this network test.
 - This variable can be set via `./gravity-sync.sh config` function.
 
-## `ROOT_CHECK_AVOID`
+### `ROOT_CHECK_AVOID`
 
 In versions of Gravity Sync prior to 3.1, at execution, Gravity Sync would check that it's deployed with its own user (not running as root), but for some deployments this was a hindrance.
 
 - This variable is no longer parsed by Gravity Sync.
 
-## `BACKUP_RETAIN`
+### `BACKUP_RETAIN`
 
 The `./gravity-sync.sh backup` function will retain a defined number of days worth of `gravity.db` and `custom.list` backups.
 
 - Default setting in Gravity Sync is `7`, adjust as desired.
 - This variable can be set via `./gravity-sync.sh config` function.
 
-## `SSH_PORT`
+### `SSH_PORT`
 
 Gravity Sync is configured by default to use the standard SSH port (22) but if you need to change this, such as if you're traversing a NAT/firewall for a multi-site deployment, to use a non-standard port.
 
 - Default setting in Gravity Sync is 22.
 - This variable can be set via `./gravity-sync.sh config` function.
 
-## `SSH_PKIF`
+### `SSH_PKIF`
 
 Gravity Sync is configured by default to use the `.ssh/id_rsa` key-file that is generated using the `ssh-keygen` command. If you have an existing key-file stored somewhere else that you'd like to use, you can configure that here. The key-file will still need to be in the users `$HOME` directory.
 
@@ -97,19 +97,19 @@ At this time Gravity Sync does not support using a passphrase in RSA key-files.
 - Default setting in Gravity Sync is `.ssh/id_rsa`.
 - This variable can be set via `./gravity-sync.sh config` function.
 
-## `LOG_PATH`
+### `LOG_PATH`
 
 Gravity Sync will place logs in the same folder as the script (identified as .cron and .log) but if you'd like to place these in a another location, you can do that by identifying the full path to the directory (ex: `/full/path/to/logs`) without a trailing slash.
 
 - Default setting in Gravity Sync is a variable called `${LOCAL_FOLDR}`.
 
-## `SYNCING_LOG=''`
+### `SYNCING_LOG`
 
 Gravity Sync will write a timestamp for any completed sync, pull, push or restore job to this file. If you want to change the name of this file, you will also need to adjust the LOG_PATH variable above, otherwise your file will be remove during an `update` operations.
 
 - Default setting in Gravity Sync is `gravity-sync.log`
 
-## `CRONJOB_LOG=''`
+### `CRONJOB_LOG`
 
 Gravity Sync will log the execution history of the previous automation task via Cron to this file. If you want to change the name of this file, you will also need to adjust the LOG_PATH variable above, otherwise your file will be remove during an `update` operations.
 
@@ -117,12 +117,12 @@ This will have an impact to both the `./gravity-sync.sh automate` function and t
 
 - Default setting in Gravity Sync is `gravity-sync.cron`
 
-## `HISTORY_MD5=''`
+### `HISTORY_MD5`
 
 Gravity Sync will log the file hashes of the previous `smart` task to this file. If you want to change the name of this file, you will also need to adjust the LOG_PATH variable above, otherwise your file will be removed during an `update` operations.
 
 - Default setting in Gravity Sync is `gravity-sync.md5`
 
-## `BASH_PATH=''`
+### `BASH_PATH`
 
 If you need to adjust the path to bash that is identified for automated execution via Crontab, you can do that here. This will only have an impact if changed before generating the crontab via the `./gravity-sync.sh automate` function. If you need to change this after the fact, either modify your crontab manually or delete the entry and re-run the automate function.