Merge branch 'master' into develop

feat(user/bk-find-git-verify):Follow symbolic links

feat(user:bkphotorights):Check exiftool exists; Apply GPLv3+

feat(user/bkphotorights):Add script to save photo license metadata

- Note: Does so by using `exiftool`. Uses my information, my website,
  and CC BY-SA 4.0 as an example.

update(user/bkdatev):Add Helsinki, Finland

- Note: v0.3.3 -> v0.3.4

fix(user/):Make scripts executable

fix(user/bkdatev):Pass date arguments to get_tz_offset()

- Note: If arguments to `bkdatev` are not passed to the `date` call in
  the `get_tz_offset()` function, the time zone offset displayed will be
  that of the user's current time, not the historical time they might
  specify via an option like `--date="1941-12-07T07:48-10:30"`; in this
  particular example, the reported time for Hawaii would be
  `1941-12-07T07:48-10` if the command were run in the year 2023 when
  Hawaii's time zone offset is `UTC-10` instead of `UT/GMT-10:30` as it
  was in the year 1941.

feat(user/combine_pdfs.sh):Add script to combine PDFs with pdftk

feat(user/mp3s_to_mkv.sh):Add variant of 'mp3s_to_opus.sh'

- Note: AudioAnchor in the F-Droid repository fails to handle seekback
  of opus files yet handles mkv containers with a single opus audio
  stream okay. Therefore, converting directly into an mkv container is
  the way to go if AudioAnchor is to be used for combining audiobook
  mp3s into a single audio file.

doc(user/bkdatev):Add comment warning about macOS compatibility

- Note: Basically, the `bkdatev` command by itself should work with
  macOS 11.1. Additional arguments are passed along to `date` so the
  provided example (`bkdatev --date="2001-09-11T09:02:59-04"`) will fail
  due to BSD `date` not accepting ISO-8601 date strings like GNU
  Coreutils `date` does.

fix(user/bkdatev):Make compatible with Bash 3.2.57

- Note: In Bash 5.1, a negative length argument in a parameter
  substitution (i.e. the `$len` in `${myVar:$start_idx:$len}`) causes
  the last characters of the $myVar string to be truncated which is
  convenient in various applications. However, a negative length in Bash
  3.2.57 (a macOS machine I happen to have) throws an error; for
  compatibility, I've instead added an additional arithemetical
  operation to calculate the positive length that corresponds to a
  truncation by 2 of the total string length.

feat(user/bkdatev): Add macOS BSD date compatibility

- Note(user/bkdatev): v0.2.2 -> v0.3.0

feat(unitproc):Bash function to insert string into another string

chore(unitproc/bkt-checkInt):Use 'must' instead of 'try'

- note: Also put regular expression test input in quotes.

feat(user/bk-copy-rand-music):Restrict filenames of copied files

- Note: Using `tr -dc '[:graph:][:space:]'` as character filter.

feat(user/mp3s_to_opus.sh):Add script to combine mp3s into an opus

- Note: Useful for combining audiobooks split across many mp3 files.

feat(user/mw_create...):Update mediawiki journal create scripts

feat(user/mw_create_year_journal):Add mediawiki page script

feat(unitproc/python/):Add EVA-2020-02-2 humidity conversions

- Note: See:
  - https://zdv2.bktei.com/gitweb/EVA-2020-02.git
  - https://zdv2.bktei.com/gitweb/EVA-2020-02-2.git
  - https://gitlab.com/baltakatei/ninfacyzga-01

feat(user/mw_create_month_journal_range):Add mw script

- Note: Creates journal month boilerplate for year range 1582/2100.

feat(unitproc/bk_export_audio.sh):Run conversion jobs in parallel

- Note: Uses `nproc` from GNU Coreutils 8.32

update(archive/bktei_signing_key.asc):Update exp date

- Note: key fingerprint:
  3457 A265 922A 1F38 39DB 0264 A0A2 95AB DC34 69C9

feat(unitproc/bkcsvjoin):Add version number

feat(user/check_ots.sh):Handle .ots.bak, .OTS files.

- style(user/check_ots.sh):Organize into bash functions.

update(README):Add link to reboil.com wiki entry for project

feat(user/mw_create_month_journal.sh):Add mediawiki script

- Note: Useful for creating monthly journals

feat(user/ots-git-gpg-wrapper*):Add OpenTimestamps v0.7.0 wrapper scripts

- Note: See
    https://github.com/opentimestamps/opentimestamps-client/blob/cd9ca65cbf7bd70db668cce47241f0feb8ea2186/ots-git-gpg-wrapper.sh

- Note: Wrapper scripts are meant to replace the default
  `ots-git-gpg-wrapper.sh` script included in ots v0.7.0:
    https://github.com/opentimestamps/opentimestamps-client/blob/cd9ca65cbf7bd70db668cce47241f0feb8ea2186/ots-git-gpg-wrapper.sh

feat(unitproc/get_rand_line):Bash script that gets random line

fix(unitproc/bkshuf):Init Bash PRNG before consuming lines

- Note: v0.1.1 -> v0.1.2

feat(unitproc/isAudio):Add script to filter audio files from find results

update(unitproc/bkdstcountdown):Refactor

feat(user/git-bk-find-file):Show ISO 8601 time along with commit

chore(README.org):Update with bktei project code

feat(user/ping_offline.sh):Add script to ping until it succeeds once

- Note: the script is meant to mark the time when internet
  connectivity is reestablished.

- doc(user/ping_offline.sh.org):Add docs

- doc(user/template.org):Add template for future executable
  documentation.

doc(user/rmsym.org):Describe rmsym

feat(user/rmsym):Add script to delete only symlinks

feat(user/get_ytpljson.sh):Add script to get YT playlist metadata

- Note: Requests YouTube playlist metadata in JSON format from
  `https://www.googleapis.com`.

feat(user/space4):Add script to space out stdin every 4 lines

feat(user/bk-copy-rand-music): Use env vars for bkshuf params

- fix(bk-copy-rand-music):Fix upper size and duration cutoffs
- feat(unitproc/bkshuf):Detect env vars

feat(user/bk-copy-rand-music):Clump output with bkshuf

- feat(unitproc/bkshuf):Utilize environment variables if available
- doc(.../bkshuf/article.tm):update TeXmacs article

chore(doc/up/bkshuf/article.tm):Update GitLab URL in bkshuf doc

feat(doc/up/bkshuf/):Add TeXmacs documentation

- Note: Compiled PDF uploaded to:

  https://reboil.com/res/2023/txt/20230214T1327+00..bkshuf_article.pdf

feat(user/bkfeh):Use unique names for sample files

- Note: Use both file order and file b2sum 32-bit hashes

feat(unitproc/bkshuf):Add bash script like shuf

- Note: bkshuf tends to preserve neighbors in output

fix(unitproc/bkt-randFloat):Resolve shellcheck delinter warnings

feat(unitproc/bkt-randFloat):Update to use printf

chore(unitproc/bkt-randFloat):Add more sample code

feat(u/bkfeh):Accept sample dir size and file count via envvar

feat(user/bkfeh):Save up to 100MB or 100 sample images if envvar set

- Note: Environment variable is BKFEH_SAMPLE_DIR in which contents
  will be deleted and sample images saved upon every run of bkfeh.

feat(user/bkfeh):Process stdin and psargs separately

- Note: Filter out dotfiles via a grep of file list

feat(user/bkfeh):Ignore dotfile directories (e.g. `./.Photos`)

- feat(unitproc/bkt-filter_no_dots):Add bash function to filter out
  stdin lines with dotfile basenames. (Note: Quite slow).
- chore(unitproc/bkt-read_stdin_psarg):Remove debug code and fix how
  posarg is read (error found via shellcheck).

feat(user/bkfeh):Add wrapper for feh

- Note: accepts dirs via stdin or positional arguments. Uses GNU
  Parallel to speed up `find` operations.

chore(up/bkt-read_stdin_psarg):Add version number

Merge branch 'develop'

feat(up/bkt-read_stdin_psarg):add bash func to read stdin and posarg

- Note: bash function name: read_stdin_psarg()

feat(user/bkdatediff):Add script to calculate timestamp differences

- Note: Uses GNU date

Merge branch 'master' into develop

feat(user/git-bk-find-file):Add script to search old tree filenames

- Ref/Attrib: albfan "How can I search Git branches for a file or
  directory?"

  https://stackoverflow.com/a/16868704/10850071

style(unitproc/):Shorten names of template prefix (bktemp -> bkt)

feat(user/bk-gpg-ver-sigs):Add script to verify many gpg sig files

- chore(unitproc/bktemp-yellDieTry):Rename bktemp-yellDieMust per
  monking's naming convention.

feat(user/regex-backslash.sh):Add script to escape regex chars

feat(user/list_large_dirs.sh):Set version 1.0.0

feat(user/list_large_dirs.sh):Simplify check_depends()

feat(user/list_large_dirs.sh):Add script

fix(user/bkdatev):Unset LC_TIME so date can use locale-specific %c

fix(user/bkdatev):typo

feat(user/bkdatev):Add Taiwan and Pyongyang

feat(user/bkdatev):Substitute UNIX epoch for UTC locale time

feat(user/bkdatev):Script to print various verbose iso-8601 dates

feat(user/get_gpgkey_from_gitlog.sh):Add checkapp()

chore(user/get_gpgkey_from_gitlog.sh):Add version number

feat(user):Script to get gpg fingerprints from git dir

- chore(.):Move draft scripts to draft dirs

chore(user/bk_this-date...):Fix permissions

feat(user/bk_this-date): Add script to print dow for given dom

- Note: script name: bk_this-date-in-recent-years.sh

- Note: The script prints out an iso-8601 date string followed by the
  day of the week for the most recent 10 years or a specified date
  range. Useful for determining likely years a month-day combination
  occured when the day of the week is known.

fix(user/bksum):Inhibit stdout/err messages for wait timestamps

- Note: 'ots --wait s file' prints terminal text every 30 seconds for
  every calendar server. Unless inhibited, these messages obscure the
  progress dots of 'bksum'.

feat(user/bksum):Add wait option for timestamps

- Note: Equivalent to adding "--wait" to an `ots` command.
- feat(unitproc/bktemp-count_jobs):Assign version number to
    count_jobs() function.

chore(user/bksum):Bump version to note executable name change

style(user/bksum):Rename bksumsign.sh to bksum

feat(user/bksumsign.sh):Personal checksum script

- Note: Permits signing and timestamping checksum with GnuPG and
  OpenTimestamps respectively.

feat(u/bktemp-checkAppFileDir):Fix zero-length string bug

- Note: checkfile() had "bad array subscript" error when fed a
  zero-length string as input.

feat(user/mw_create_redirect_day_month): Create mediawiki script

- Note: Script generates a text file for each day of a specified year
containing redirect wikicode used to link to each day's month's
page. I made this for my personal mediawiki journal so I can wikilink
to iso-8601 dates (e.g. 2022-09-02) and get the corresponding month's
page (e.g. 2022-09) instead (jumping to the section with the iso-8601
date).

fix(user/bkots):Only use 25% of available CPUs

chore(user/convert_file_to_flac.sh):Note version number of depends

fix(user/):Fix flac converter script

- Note: Make it drop audio
- Note: Make it use compression level 12

modified:   user/convert_file_to_flac.sh

feat(user/):Add script to convert files to FLAC with ffmpeg

new file:   user/convert_file_to_flac.sh

fix(user/bk-naut-hide):Disable find -L option to avoid loop

fix(user/bk-naut-hide):Comment out debug stderr

feat(user/):Add script to check an ots file

new file:   user/check_ots.sh

fix(user/bkots):Exit code 0 if script finishes

chore(user/bkots):Comment debug line

feat(user/bkots):Optimize with GNU Parallel for executing commands

  - Assemble each command and save as string in array; then execute
    array.

  - Use bash function as wrapper to echo and group each command being
    performed along with its stdout/stderr messages.

  - Use regex search of '/.' to find and exclude dotfile paths instead
    of resolving each basename of each parent directory in each path.

  - Use double quotes to handle file names with special characters.

    - Escape out double quotes when they appear in file names.

  - Note: Incrementing major version number due to added dependency of
    GNU Parallel 20210822

feat(user/bk-find-git-verify):Add script to verify many git sigs

feat(unitproc/bktemp-count_jobs):Add count_jobs() function

- Note: GNU parallel does what the `count_jobs()` was intended to
  facilitate: control the number of jobs spawned in bash scripts.

feat(user/bkots): Don't timestamp files changed in last 1 min

- Note: The intent of a minimum age limit for files to be timestamped
  is to avoid timestamping files that are frequently changing.

chore(user/):Permissions

chore(user/bk-naut-hide):Add version number

feat(user/):Add bash script to update .hidden files for nautilus

new file:   user/bk-naut-hide

feat(user/):Remove quotation marks from ots arguments

fix(user/bkots):Handle spaces in filenames provided to 'ots' command

minor(user/bkots):fix verbose comment