nerd-fonts/bin/scripts/standardize-and-complete-readmes.sh

#!/usr/bin/env bash
# Nerd Fonts Version: 3.0.0
# Script Version: 1.1.0
# Iterates over all patched fonts directories
# converts all non markdown readmes to markdown (e.g., txt, rst) using pandoc
# adds information on additional-variations and complete font variations

infofilename="README.md"
unpatched_parent_dir="src/unpatched-fonts"
patched_parent_dir="patched-fonts"
LINE_PREFIX="# [Nerd Fonts] "
fonts_info="../../bin/scripts/lib/fonts.json"

cd ../../src/unpatched-fonts/ || {
  echo >&2 "$LINE_PREFIX Could not find source fonts directory"
  exit 1
}


function appendRfnInfo {
  local config_rfn=$1; shift
  local config_rfn_substitue=$1; shift
  local working_dir=$1; shift
  local to=$1; shift
  if [ "$config_rfn" ] && [ "$config_rfn_substitue" ]
  then
    # add to the file
    {
      printf "\\n## Why \`%s\` and not \`%s\`?\\n" "$config_rfn_substitue" "$config_rfn"
      cat "$working_dir/../../src/readme-rfn-addendum.md"
    } >> "$to"
  fi
}

function clearDestination {
  local to_dir=$1; shift
  local to=$1; shift
  [[ -d "$to_dir" ]] || mkdir -p "$to_dir"
  # clear output file (needed for multiple runs or updates):
  true > "$to" 2> /dev/null
}

if [ $# -ge 1 ]; then
  like_pattern="./$1"
  # allows one to limit to specific font.
  # e.g. with ProFont, DejaVuSansMon, Hasklig, Hack, Gohu, FiraCode, Hermit, etc.
  echo "$LINE_PREFIX Parameter given, limiting find command of directories to pattern '$like_pattern' given"
else
  like_pattern="."
  echo "$LINE_PREFIX No parameter pattern given, generating standardized readmes for all fonts in all font directories"
fi
if [ $# -ge 2 ]; then
  patched_parent_dir=$2
  echo "$LINE_PREFIX Using destination '${patched_parent_dir}'"
fi

find "$like_pattern" -type d |
while read -r filename
do

  if [[ "$filename" == "." ]];
  then
    echo "$LINE_PREFIX Skipping directory '.'"
    continue
  fi

  base_directory=$(echo "$filename" | cut -d "/" -f2)
  searchdir=$base_directory

  # limit looking for the readme files in the parent dir not the child dirs:
  if [ "$dirname" != "." -a -n "$dirname" ];
  then
    searchdir=$dirname
  else
    # reset the variables
    unset config_rfn
    unset config_rfn_substitue
    fontdata=$(cat ${fonts_info} | jq ".fonts[] | select(.folderName == \"${base_directory}\")")
    if [ "$(echo $fontdata | jq .RFN)" = "true" ]
    then
      config_rfn=$(echo $fontdata | jq -r .unpatchedName)
      config_rfn_substitue=$(echo $fontdata | jq -r .patchedName)
      if [ "${config_rfn}" = "${config_rfn_substitue}" ]
      then
        # Only the case with Mononoki which is RFN but we do not rename (we got the permission to keep the name)
        unset config_rfn
        unset config_rfn_substitue
      fi
    fi
  fi

  mapfile -t RST < <(find "$searchdir" -type f -iname 'readme.rst')
  mapfile -t TXT < <(find "$searchdir" -type f -iname 'readme.txt')
  mapfile -t MD < <(find "$searchdir" -type f -iname 'readme.md')
  outputdir=$PWD/../../${patched_parent_dir}/$filename/

  echo "$LINE_PREFIX Generating readme for: $filename"

  [[ -d "$outputdir" ]] || mkdir -p "$outputdir"


  if [ "${RST[0]}" ];
  then
    for i in "${RST[@]}"
    do
      echo "$LINE_PREFIX Found RST"

      from="$PWD/$i"
      to_dir="${PWD/$unpatched_parent_dir/$patched_parent_dir}/$filename"
      to="${to_dir}/$infofilename"

      clearDestination "$to_dir" "$to"

      pandoc "$from" --from=rst --to=markdown --output="$to"

      appendRfnInfo "$config_rfn" "$config_rfn_substitue" "$PWD" "$to"
      cat "$PWD/../../src/readme-per-directory-addendum.md" >> "$to"
    done
  elif [ "${TXT[0]}" ];
  then
    for i in "${TXT[@]}"
    do
      echo "$LINE_PREFIX Found TXT"

      from="$PWD/$i"
      to_dir="${PWD/$unpatched_parent_dir/$patched_parent_dir}/$filename"
      to="${to_dir}/$infofilename"

      clearDestination "$to_dir" "$to"

      cp "$from" "$to"

      appendRfnInfo "$config_rfn" "$config_rfn_substitue" "$PWD" "$to"
      cat "$PWD/../../src/readme-per-directory-addendum.md" >> "$to"
    done
  elif [ "${MD[0]}" ];
  then
    for i in "${MD[@]}"
    do
      echo "$LINE_PREFIX Found MD"

      from="$PWD/$i"
      to_dir="${PWD/$unpatched_parent_dir/$patched_parent_dir}/$filename"
      to="${to_dir}/$infofilename"

      clearDestination "$to_dir" "$to"

      cp "$from" "$to"

      appendRfnInfo "$config_rfn" "$config_rfn_substitue" "$PWD" "$to"
      cat "$PWD/../../src/readme-per-directory-addendum.md" >> "$to"
    done
  else
    echo "$LINE_PREFIX Did not find any readme files (RST,TXT,MD) generating just title of Font"

    to_dir="${PWD/$unpatched_parent_dir/$patched_parent_dir}/$filename"
    to="${to_dir}/$infofilename"

    clearDestination "$to_dir" "$to"

    {
      printf "# %s\\n\\n" "$base_directory"
    } >> "$to"

    appendRfnInfo "$config_rfn" "$config_rfn_substitue" "$PWD" "$to"
    cat "$PWD/../../src/readme-per-directory-addendum.md" >> "$to"
  fi

done