[WIP] Initial commit for qsgen3

2025-05-30 20:37:56 +02:00
parent 106b66753f
commit 75105821fd
138 changed files with 12471 additions and 7 deletions
--- a/docs/zsdoc/data/functions/qsgen2/_add_blog_list_to_index
+++ b/docs/zsdoc/data/functions/qsgen2/_add_blog_list_to_index
@ -0,0 +1,9 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+if (${debug}) _msg debug "${0:t}_msg_1"
+local blog_index_list=$(<${config[project_root]}/blog/index.tmp.html)
+local site_index_file=$(<${config[site_root]}/index.html)
+echo "${site_index_file}" | awk -v new_body="${blog_index_list}" '{sub(/BLOGINDEX/, new_body)} 1' > "${config[site_root]}/index.html"
--- a/docs/zsdoc/data/functions/qsgen2/_blog_cache
+++ b/docs/zsdoc/data/functions/qsgen2/_blog_cache
@ -0,0 +1,31 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+_list_blogs
+typeset -A blog_cache
+if [[ -f $blog_cache_file ]]; then
+  while IFS=':' read -r name hash; do
+    blog_cache[$name]=$hash
+  	if (${debug}) _msg debug "${0:t}_msg_1" " ${blog_cache[${name}]}"
+  done < "$blog_cache_file"
+fi
+make_blog_array=()
+for blog_file in ${blogs_file_array[@]}; do
+  current_hash=$(md5sum "$blog_file" | awk '{print $1}')
+
+  if (${debug}) _msg debug "${0:t}_msg_2" " ${blog_file}"
+  if (${debug}) _msg debug "${0:t}_msg_3" " ${current_hash}"
+  if [[ ${blog_cache[$blog_file]} != "$current_hash" ]]; then
+  	if (${debug}) _msg debug "${0:t}_msg_4" " ${blog_file}"
+  	if (${debug}) _msg debug "${0:t}_msg_5" " ${current_hash}"
+    make_blog_array+=("$blog_file")
+    blog_cache[$blog_file]=$current_hash
+  fi
+done
+: >| "$blog_cache_file"
+for name in "${(@k)blog_cache}"; do
+  echo "$name:${blog_cache[$name]}" >> "$blog_cache_file"
+done
--- a/docs/zsdoc/data/functions/qsgen2/_blog_idx_for_index
+++ b/docs/zsdoc/data/functions/qsgen2/_blog_idx_for_index
@ -0,0 +1,59 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+  
+_msg sub "${0:t}_msg_1" " ${config[project_root]}/blog/index.tmp.html"
+  
+if (${debug}) _msg debug "${0:t}_msg_2"
+  
+local blog_list_tpl=$(<${config[project_root]}/themes/${config[site_theme]}/blog_list.tpl)
+local blog_list_content=""
+: >| "${config[project_root]}/blog/index.tmp.html"
+  
+for meta_str in ${BLOG_META_STR_ARRAY[@]}
+  do
+    if (${debug}) _msg debug "${0:t}_msg_4"
+    if (${debug}) _msg debug "${0:t}_msg_5" " ${meta_str}"
+    local -a meta_array=("${(@s/||/)meta_str}")
+    local sdate btitle ingress url
+    if (${debug}) _msg debug "${0:t}_msg_6"
+    for component in "${meta_array[@]}"
+      do
+        case "${component}" in
+          SDATE:*) sdate=${component#SDATE: } ;;
+          BTITLE:*) btitle=${component#BTITLE: } ;;
+          INGRESS:*) ingress=${component#INGRESS: } ;;
+          URL:*) url=${component#URL: } ;;
+        esac
+
+    done
+    
+        local adate=( $( echo ${sdate} ) )
+        local caladay="${adate[1]}"
+        local calyear="${adate[2]}"
+        local calmonth="${adate[3]}"
+        local calnday="${adate[4]}"
+          
+        local bdate="${adate[1]} - ${adate[4]}/${adate[3]}/${adate[2]}"
+        blog_list_content+=$(
+          echo "${blog_list_tpl}" | \
+          perl -pe "\
+          s|BLOGURL|${config[site_url]}${url}|g; \
+          s|BLOGTITLE|${btitle}|g; \
+          s|INGRESS|${ingress}|g; \
+          s|BLOGDATE|${bdate}|g; \
+          s|CALADAY|${caladay}|g; \
+          s|CALNDAY|${calnday}|g; \
+          s|CALMONTH|${calmonth}|g; \
+          s|CALYEAR|${calyear}|g \
+          ")
+      
+    unset sdate btitle ingress url adate caladay calyear calmonth calnday
+
+done
+if (${debug}) _msg debug "${0:t}_msg_7" " ${engine} " "${0:t}_msg_7.1"
+blog_list_content=$( _run_engine ${blog_list_content} )
+if (${debug}) _msg debug "${0:t}_msg_8" " ${config[project_root]}/blog/index.tmp.html"
+echo ${blog_list_content} > ${config[project_root]}/blog/index.tmp.html
--- a/docs/zsdoc/data/functions/qsgen2/_blog_index
+++ b/docs/zsdoc/data/functions/qsgen2/_blog_index
@ -0,0 +1,30 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+if ([[ ${config[site_blog]} == "false" ]] && [[ ${new_updated_blogs} = "true" ]]); then
+
+  if (${debug}) _msg debug "${0:t}_msg_1" "${config[site_blog]}"
+  if (${debug}) _msg debug "${0:t}_msg_2" "${new_updated_blogs}"
+  if (${debug}) _msg debug "${0:t}_msg_3"
+  if (${debug}) _msg debug "${0:t}_msg_4" " ${config[site_blog]}"
+
+  _msg std "${0:t}_msg_5" " ${config[site_root]}/blog/index.html"
+
+  local blog_index_tpl=$(<${config[project_root]}/themes/${config[site_theme]}/blog_index.tpl)
+  local blog_index_list=$(<${config[project_root]}/blog/index.tmp.html)
+
+  if (${debug}) _msg debug "${0:t}_msg_6"
+  local blog_index_content=$(echo "${blog_index_tpl}" | perl -pe "s|#sitename|${config[site_name]}|gs; s|#tagline|${config[site_tagline]}|gs")
+  if (${debug}) _msg debug "${0:t}_msg_7" " ${config[project_root]}/blog/index.tmp.html"
+  blog_index_content=$( awk -v new_body="$blog_index_list" '{sub(/BODY/, new_body)} 1' <(echo "${blog_index_content}") )
+
+  if (${debug}); then
+    _msg debug "${0:t}_msg_8" " ${config[site_root]}/blog/index.html"
+    _msg debug "${0:t}_msg_9" " ${#blog_index_content}"
+  fi
+  echo "$blog_index_content" > ${config[site_root]}/blog/index.html
+  _f_last_updated ${config[site_root]}/blog/index.html
+
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_blogs
+++ b/docs/zsdoc/data/functions/qsgen2/_blogs
@ -0,0 +1,155 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+_msg main "${0:t}_msg_3"
+if (${debug}) _msg debug "${0:t}_msg_1"
+_list_blogs
+  
+if [[ ${no_blogs_found} == "true" ]]; then
+  _msg sub "${0:t}_msg_2"
+  return
+fi
+if (${debug}) _msg debug "${0:t}_msg_4"
+_blog_cache
+
+if (( ${#make_blog_array[@]} > 0 )); then
+  BLOG_META_STR_ARRAY=()
+              
+  if [[ -f ${config[project_root]}/themes/${config[site_theme]}/blogs.tpl ]]; then
+    local blog_tpl=$(<"${config[project_root]}/themes/${config[site_theme]}/blogs.tpl")
+  else
+    _msg info "${0:t}_msg_5"
+    exit
+  fi
+
+  for blog in "${make_blog_array[@]}"; do
+    if (${debug}) _msg info "*************************************************************************"
+    if (${debug}) _msg info "**************************FOR LOOP START*********************************"
+    if (${debug}) _msg info "*************************************************************************"
+    if (${debug}) _msg debug "${0:t}_msg_6" " ${blog}"
+              
+    local content="$(<"${blog}")"
+    local sdate btitle ingress body blog_index blog_dir blog_url
+    local date_found=false
+    local title_found=false
+    while IFS= read -r line
+      do
+      if [[ "${line}" == "DATE "* ]]; then
+        if (${debug}) _msg debug "${0:t}_msg_7"
+        date_found=true
+      fi
+      if [[ "${line}" == "BLOG_TITLE "* ]]; then
+        if (${debug}) _msg debug "${0:t}_msg_8"
+        title_found=true
+      fi
+      if [[ "${date_found}" == true && "${title_found}" == true ]]; then
+        break
+      fi
+    done <<< "${content}"
+    if [[ "${date_found}" == false ]]; then
+      if (${debug}) _msg debug "${0:t}_msg_9" " ${blog}."
+      continue
+    fi
+    if [[ "${title_found}" == false ]]; then
+      if (${debug}) _msg debug "${0:t}_msg_10" " ${blog}."
+      continue
+    fi
+    sdate=( $( echo ${content} | grep DATE | sed "s|DATE\ ||" | sed "s|\-|\ |g" ) )
+    if [[ ${config[project_generator]} == "native" ]]; then
+    if (${debug}) _msg debug "* qstags: Fetching BLOG_TITLE"
+      while IFS= read -r line; do
+        if [[ "$line" == "BLOG_TITLE "* ]]; then
+          btitle="${line#BLOG_TITLE }"
+          break
+        fi
+      done <<< "$content"
+    elif [[ ${config[project_generator]} == "markdown" ]]; then
+    if (${debug}) _msg debug "* markdown: Fetching BLOG_TITLE"
+      while IFS= read -r line; do
+        if [[ "$line" == \#* ]]; then
+          btitle="${line#\#}"
+          btitle="${btitle#\#}"
+          btitle="${btitle#"${btitle%%[![:space:]]*}"}"
+          break
+        fi
+      done <<< "$content"
+    fi
+    if (${debug}) _msg debug "* Fetching INGRESS"
+    ingress=$( echo ${content} | sed "s/'/\\\'/g" | xargs | grep -Po "#INGRESS_START\K(.*?)#INGRESS_STOP" | sed "s|\ \#INGRESS_STOP||" | sed "s|^\ ||" )
+    if (${debug}) _msg debug "* Fetching BODY"
+    body=$( echo ${content} | sed "s/'/\\\'/g" | xargs | grep -Po "#BODY_START\K(.*?)#BODY_STOP" | sed "s|\ \#BODY_STOP||" | sed "s|^\ ||" )
+
+    blog_index=$(echo "${btitle:l}" | sed 's/ /_/g; s/,//g; s/\.//g; s/://g; s/[()]//g')
+
+    blog_dir="/blog/${sdate[2]}/${sdate[3]:l}/${sdate[4]}"
+    blog_url="${blog_dir}/${blog_index}.html"
+                  
+    if (${debug}) _msg debug "${0:t}_msg_11" " ${blog} " "${0:t}_msg_11.1"
+      local metadata_str="SDATE: ${sdate[@]}||BTITLE: ${btitle}||INGRESS: ${ingress}||URL: ${blog_url}"
+      BLOG_META_STR_ARRAY+=("${metadata_str}")
+                  
+      if (${debug}) _msg debug "${0:t}_msg_12" " ${blog}"
+                     
+        _msg std "  - ${btitle}"
+        if (${debug}) _msg debug "${0:t}_msg_14" " ${blog}"
+        local blog_content=$(
+          echo "${blog_tpl}" | \
+          perl -pe "\
+          s|BLOGTITLE|${btitle}|g; \
+          s|BLOGURL|${blog_url}|g; \
+          s|\QINGRESS\E|${ingress}|g; \
+          s|\QBODY\E|${body}|g \
+          ")
+          blog_content="${blog_content//CALNDAY/${sdate[4]}}"
+          blog_content="${blog_content//CALYEAR/${sdate[2]}}"
+          blog_content="${blog_content//CALMONTH/${sdate[3]}}"
+          blog_content="${blog_content//CALADAY/${sdate[1]}}"
+
+          if (${debug}) _msg debug "${0:t}_msg_15" " ${engine} " "${0:t}_msg_15_1" " ${blog}"
+            blog_content=$( _run_engine "${blog_content}" )
+            if (${debug}) _msg debug "${0:t}_msg_16"
+            if [[ $( echo ${blog_content} | grep \#link ) ]]; then
+              if (${debug}) _msg debug "${0:t}_msg_17"
+              blog_content=$(_link "${blog_content}")
+            fi
+            if [[ $( echo ${blog_content} | grep \#showimg ) ]]; then
+              if (${debug}) _msg debug "${0:t}_msg_18"
+              blog_content=$(_image "${blog_content}")
+            fi
+            if [[ $( echo ${blog_content} | grep \#ytvideo ) ]]; then
+              if (${debug}) _msg debug "${0:t}_msg_19"
+              blog_content=$(_youtube "${blog_content}")
+            fi
+          if (${debug}) _msg debug "${0:t}_msg_20"
+          blog_content=$( echo ${blog_content} | perl -pe "s|#tagline|${config[site_tagline]}|gs; s|#sitename|${config[site_name]}|gs; s|#pagetitle|${page_title}|gs" )
+      
+          if (${debug}) _msg debug "* Running _last_updated"
+          blog_content=$(_last_updated "${blog_content}")
+          if (${debug}) _msg debug "* Running _cleanup"
+          blog_content=$(_cleanup "${blog_content}")
+          if (${debug}) _msg debug "${0:t}_msg_21" " ${config[site_root]}${blog_dir}"
+          [[ ! -d "${config[site_root]}/${blog_dir}" ]] && mkdir -p "${config[site_root]}/${blog_dir}"
+          if (${debug}) _msg debug "${0:t}_msg_22" " ${config[site_root]}${blog_url}"
+          echo "${blog_content}" > "${config[site_root]}${blog_url}"
+                 
+          unset sdate btitle ingress body blog_index blog_dir blog_url
+
+  done
+  export BLOG_META_STR_ARRAY
+  if (${debug}) _msg debug "${0:t}_msg_23"
+  export new_updated_blogs=true
+
+else
+  _msg sub "${0:t}_msg_24"
+  export new_updated_blogs=false
+fi
+
+if [[ ${new_updated_blogs} == "true" ]]; then
+  if (${debug}) _msg sub "${0:t}_msg_25"
+  _blog_idx_for_index
+  if (${debug}) _msg sub "${0:t}_msg_26"
+  _blog_index
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_cleanup
+++ b/docs/zsdoc/data/functions/qsgen2/_cleanup
@ -0,0 +1,16 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+
+if (${debug}) _msg debug "${0:t}_msg_1"
+local cleaned_content=$(echo "${content}" | sed \
+  -e "s|¤||g" \
+  -e "s|#showimg\ ||g" \
+  -e "s|#ytvideo\ ||g" \
+  -e "s|#link\ ||g" \
+  )
+echo "${cleaned_content}"
--- a/docs/zsdoc/data/functions/qsgen2/_f_last_updated
+++ b/docs/zsdoc/data/functions/qsgen2/_f_last_updated
@ -0,0 +1,19 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+local upd_msg="Last updated ${today} by <a href=\"https://blog.kekepower.com/qsgen2.html\">${QSGEN} ${VERSION}</a>"
+
+if ${debug}; then
+  _msg debug "${0:t}_msg_1" " ${1}"
+  _msg debug "${0:t}_msg_2" " ${upd_msg}"
+fi
+local content="$(<${1})"
+content="${content//#updated/${upd_msg}}"
+
+if [[ -f "${1}" ]]; then
+  sed -i -e "s|#updated|${upd_msg}|" "${1}"
+else
+  _msg debug "${0:t}_msg_3" " '${1}' " "${0:t}_msg_3.1"
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_file_to_lower
+++ b/docs/zsdoc/data/functions/qsgen2/_file_to_lower
@ -0,0 +1,5 @@
+local filename="${1}"
+filename="${filename// /-}"
+filename=$(echo "${filename}" | sed -e 's/^[^a-zA-Z0-9_.]+//g' -e 's/[^a-zA-Z0-9_-]+/-/g')
+
+echo ${filename}
--- a/docs/zsdoc/data/functions/qsgen2/_help
+++ b/docs/zsdoc/data/functions/qsgen2/_help
@ -0,0 +1,2 @@
+ echo "This is where I'll write the Help documentation."
+exit
--- a/docs/zsdoc/data/functions/qsgen2/_image
+++ b/docs/zsdoc/data/functions/qsgen2/_image
@ -0,0 +1,28 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+local modified_content=""
+echo "${content}" | while IFS= read -r line; do
+  if [[ ${line} == *"#showimg"* ]]; then
+    if (${debug}) _msg debug "${0:t}_msg_1" " ${line}"
+    local img_link=$(echo "${line}" | awk -F'#showimg ' '{print $2}')
+    local image=$(echo "${img_link}" | awk -F'¤' '{print $1}')
+    local img_alt=$(echo "${img_link}" | awk -F'¤' '{print $2}')
+    local real_image=""
+    if [[ ${image} =~ ^https?:// ]]; then
+      real_image=${image}
+    elif [[ ${image} =~ ^\/ ]]; then
+      real_image=${image}
+    else
+      real_image="/images/${image}"
+    fi
+    local img_tag="<img src=\"${real_image}\" alt=\"${img_alt}\" width=\"500\" />"
+    line=${line//"#showimg ${img_link}"/${img_tag}}
+  fi
+    modified_content+="${line}\n"
+done
+echo -e "${modified_content}"
--- a/docs/zsdoc/data/functions/qsgen2/_last_updated
+++ b/docs/zsdoc/data/functions/qsgen2/_last_updated
@ -0,0 +1,15 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local upd_msg="Last updated ${today} by <a href=\"https://blog.kekepower.com/qsgen2.html\">${QSGEN} ${VERSION}</a>"
+
+if (${debug}); then _msg debug "${0:t}_msg_1"; fi
+if (${debug}); then _msg debug "${0:t}_msg_2" " ${upd_msg}"; fi
+  
+local content="${1}"
+local updated_content=$(echo "${content}" | sed \
+  -e "s|#updated|${upd_msg}|")
+echo "${updated_content}"
--- a/docs/zsdoc/data/functions/qsgen2/_link
+++ b/docs/zsdoc/data/functions/qsgen2/_link
@ -0,0 +1,27 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+local modified_content=""
+echo "${content}" | while IFS= read -r line; do
+  if [[ ${line} == *"#link"* ]]; then
+    if (${debug}) _msg debug "${0:t}_msg_1" " ${line}"
+    local url_full=$(echo "${line}" | awk -F'#link ' '{print $2}' | awk -F'¤' '{print $1 "¤" $2}')
+    local url_dest=$(echo "${url_full}" | awk -F'¤' '{print $1}')
+    local url_txt=$(echo "${url_full}" | awk -F'¤' '{print $2}')
+
+    if (${debug}) _msg debug "${0:t}_msg_2" " ${url_dest}"
+    if (${debug}) _msg debug "${0:t}_msg_3" " ${url_txt}"
+    local modified_link="<a href=\"${url_dest}\">${url_txt}"
+    if [[ ${url_dest} =~ ^https?:// ]]; then
+      modified_link+="<img class=\"exticon\" alt=\"External site icon\" src=\"/images/ext-black-top.svg\" width=\"12\" />"
+    fi
+    modified_link+="</a>"
+    line=${line//"#link ${url_full}"/${modified_link}}
+  fi
+    modified_content+="${line}\n"
+done
+echo -e "${modified_content}"
--- a/docs/zsdoc/data/functions/qsgen2/_list_blogs
+++ b/docs/zsdoc/data/functions/qsgen2/_list_blogs
@ -0,0 +1,22 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+blogs_file_array=()
+
+export no_blogs_found=false
+setopt local_options null_glob
+local -a blog_files=(blog/*.blog(On))
+
+if (( ${#blog_files[@]} == 0 )); then
+  if ${debug}; then _msg debug "${0:t}_msg_1"; fi
+  export no_blogs_found=true
+  return
+else
+  for file in "${blog_files[@]}"
+    do
+      if ${debug}; then _msg debug "${0:t}_msg_2" " $file"; fi
+        blogs_file_array+=("$file")
+  done
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_list_pages
+++ b/docs/zsdoc/data/functions/qsgen2/_list_pages
@ -0,0 +1,21 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+pages_file_array=()
+
+export no_pages_found=false
+setopt local_options null_glob
+local -a pages_files=(*.${file_ext})
+
+if (( ${#pages_files} == 0 )); then
+  if ${debug}; then _msg debug "${0:t}_msg_1" " ${file_ext}."; fi
+  export no_pages_found=true
+  return
+else
+  for file in "${pages_files[@]}"; do
+    if ${debug}; then _msg debug "${0:t}_msg_2" " ${file}"; fi
+    pages_file_array+=("$file")
+  done
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_msg
+++ b/docs/zsdoc/data/functions/qsgen2/_msg
@ -0,0 +1,21 @@
+local type=$1
+shift
+
+local full_msg=""
+for arg in "$@"; do
+    if [[ -n "${qsgenlang[$arg]}" ]]; then
+        full_msg+="${qsgenlang[$arg]}"
+    else
+        full_msg+="$arg"
+    fi
+done
+local color="${end}"
+case $type in
+    std) color="${green}" ;;
+    info) color="${yellow}" ;;
+    debug) color="${red}" ;;
+    other) color="${bold_yellow}" ;;
+    sub) color="${magenta}" ;;
+    main) color="${white}${green_bg}" ;;
+esac
+printf "${color}%b${end}\n" "${full_msg}"
--- a/docs/zsdoc/data/functions/qsgen2/_p_qstags
+++ b/docs/zsdoc/data/functions/qsgen2/_p_qstags
@ -0,0 +1,55 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+
+if ${debug}; then
+  _msg debug "${0:t}_msg_1"
+fi
+perl -0777 -pe '
+  BEGIN {
+    @qstags = (
+      "#BR", "<br/>\n",
+      "#BD", "<b>", "#EBD", "</b>",
+      "#I", "<i>", "#EI", "</i>\n",
+      "#P", "<p>", "#EP", "</p>\n",
+      "#Q", "<blockquote>", "#EQ", "</blockquote>\n",
+      "#C", "<code>", "#EC", "</code>\n",
+      "#H1", "<h1>", "#EH1", "</h1>\n",
+      "#H2", "<h2>", "#EH2", "</h2>\n",
+      "#H3", "<h3>", "#EH3", "</h3>\n",
+      "#H4", "<h4>", "#EH4", "</h4>\n",
+      "#H5", "<h5>", "#EH5", "</h5>\n",
+      "#H6", "<h6>", "#EH6", "</h6>\n",
+      "#STRONG", "<strong>", "#ESTRONG", "</strong>\n",
+      "#EM", "<em>", "#SEM", "</em>\n",
+      "#DV", "<div>", "#EDV", "</div>\n",
+      "#SPN", "<span>", "#ESPN", "</span>\n",
+      "#UL", "<ul>", "#EUL", "</ul>\n",
+      "#OL", "<ol>", "#EOL", "</ol>\n",
+      "#LI", "<li>", "#ELI", "</li>\n",
+      "#UD", "<u>", "#EUD", "</u>\n",
+      "#TBL", "<table>", "#ETBL", "</table>\n",
+      "#TR", "<tr>", "#ETR", "</tr>\n",
+      "#TD", "<td>", "#ETD", "</td>\n",
+      "#TH", "<th>", "#ETH", "</th>\n",
+      "#ART", "<article>", "#EART", "</article>\n",
+      "#SEC", "<section>", "#ESEC", "</section>\n",
+      "#ASIDE", "<aside>", "#EASIDE", "</aside>\n",
+      "#NAV", "<nav>", "#ENAV", "</nav>\n",
+      "#BTN", "<button>", "#EBTN", "</button>\n",
+      "#SEL", "<select>", "#ESEL", "</select>\n",
+      "#OPT", "<option>", "#EOPT", "</option>\n",
+      "#LT", "&lt;", "#GT", "&gt;", "#NUM", "&num;"
+    );
+  }
+
+  for (my $i = 0; $i < $#qstags; $i += 2) {
+      my $qstag = $qstags[$i];
+      my $html = $qstags[$i + 1];
+      s/\Q$qstag\E/$html/g;
+  }
+  ' <<< "$content"
--- a/docs/zsdoc/data/functions/qsgen2/_pages
+++ b/docs/zsdoc/data/functions/qsgen2/_pages
@ -0,0 +1,108 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+_msg main "${0:t}_msg_3"
+if (${debug}) _msg debug "${0:t}_msg_1"
+_pages_cache
+  
+if [[ ${no_pages_found} == "true" ]]; then
+  _msg sub "${0:t}_msg_1"
+  return
+fi
+  
+if (( ${#pages_array[@]} > 0 )); then
+  if (${debug}) _msg debug "${0:t}_msg_4"
+  
+  for pages_in_array in ${pages_array[@]}
+    do
+      if (${debug}) _msg debug "${0:t}_msg_5"
+      local pages=${config[project_root]}/themes/${config[site_theme]}/pages.tpl
+      if [[ ! -f ${pages} ]]; then
+        _msg info "${0:t}_msg_6" " ${pages}"
+        exit
+      else
+        if (${debug}) _msg debug "${0:t}_msg_7"
+        local pages_tpl="$(<${pages})"
+      fi
+      if (${debug}) _msg debug "${0:t}_msg_9" " ${pages_in_array}"
+      local page_content="$(<${pages_in_array})"
+      if (${debug}) _msg debug "${0:t}_msg_10"
+      if [[ ${config[project_generator]} == "native" ]]; then
+        while read -r line
+          do
+          if [[ "$line" =~ ^#title=(.*) ]]; then
+            local page_title=${match[1]}
+            break
+          fi
+        done <<< "$page_content"
+      elif [[ ${config[project_generator]} == "markdown" ]]; then
+        while IFS= read -r line
+          do
+          if [[ "$line" == \#* ]]; then
+            local page_title="${line#\#}"
+            page_title="${page_title#\#}"
+            page_title="${page_title#"${page_title%%[![:space:]]*}"}"
+            break
+          fi
+        done <<< ${page_content}
+      fi
+      _msg std "  - ${page_title}"
+      if (${debug}) _msg debug "${0:t}_msg_11" " ${page_title}"
+      if (${debug}) _msg debug "${0:t}_msg_12"
+      page_content=$( echo ${page_content} | grep -v \#title )
+      if (${debug}) _msg debug "${0:t}_msg_13" " ${pages_in_array}"
+        page_content=$( _run_engine "$page_content" )
+        if (${debug}) _msg debug "${0:t}_msg_14"
+        if [[ $( echo ${page_content} | grep \#link ) ]]; then
+          if (${debug}) _msg debug "${0:t}_msg_15"
+          page_content=$( _link "${page_content}" )
+          fi
+        if [[ $( echo ${page_content} | grep \#showimg ) ]]; then
+          if (${debug}) _msg debug "${0:t}_msg_16"
+          page_content=$( _image "${page_content}" )
+        fi
+        if [[ $( echo ${page_content} | grep \#ytvideo ) ]]; then
+          if (${debug}) _msg debug "${0:t}_msg_17"
+          page_content=$( _youtube "${page_content}" )
+        fi
+      if (${debug}) _msg debug "${0:t}_msg_18"
+      pages_tpl=$(echo "${pages_tpl}" | perl -pe "s|#pagetitle|${page_title}|gs; s|#tagline|${config[site_tagline]}|gs; s|#sitename|${config[site_name]}|gs")
+      
+      if (${debug}) _msg debug "${0:t}_msg_19"
+      pages_tpl=$( awk -v new_body="$page_content" '{sub(/BODY/, new_body)} 1' <(echo "${pages_tpl}") )
+      if (${debug}) _msg debug "${0:t}_msg_20"
+      pages_tpl=$( _last_updated ${pages_tpl} )
+      if (${debug}) _msg debug "${0:t}_msg_21"
+      pages_title_lower=$( _file_to_lower "${pages_in_array}" )
+      if (${debug}) _msg debug "${0:t}_msg_22"
+      pages_tpl=$( _cleanup "${pages_tpl}" )
+      echo "${pages_tpl}" > ${config[site_root]}/${pages_title_lower%.*}.html
+      if [[ ${pages_in_array} == "index.${file_ext}" &&  ${config[site_blog]} == "true" && -s "${config[project_root]}/blog/index.tmp.html" ]]; then
+        if (${debug}) _msg sub "${0:t}_msg_23" " ${pages_in_array}"
+        if (${debug}) _msg sub "${0:t}_msg_24" " ${config[site_blog]}"
+        if (${debug}) _msg sub "${0:t}_msg_25"
+        if (${debug}) ls -l ${config[project_root]}/blog/index.tmp.html
+        _add_blog_list_to_index
+      fi
+      
+    done
+    
+    export new_updated_pages=true
+    
+  else
+    if [[ ${config[site_blog]} == "true" && -s "${config[project_root]}/blog/index.tmp.html" ]]; then
+      _msg std "${0:t}_msg_26"
+      if (${debug}) _msg sub "${0:t}_msg_27" " ${pages_in_array}"
+      if (${debug}) _msg sub "${0:t}_msg_28" " ${config[site_blog]}"
+      if (${debug}) _msg sub "${0:t}_msg_25"
+      if (${debug}) ls -l ${config[project_root]}/blog/index.tmp.html
+      _add_blog_list_to_index
+    fi
+      
+    _msg sub "${0:t}_msg_29"
+    export new_updated_pages=false
+
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_pages_cache
+++ b/docs/zsdoc/data/functions/qsgen2/_pages_cache
@ -0,0 +1,31 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+typeset -A pages_cache
+  
+_list_pages
+if [[ -f $pages_cache_file ]]; then
+  while IFS=':' read -r name hash; do
+    pages_cache[$name]=$hash
+  	if (${debug}) _msg debug "${0:t}_msg_1" " ${pages_cache[${name}]}"
+  done < "$pages_cache_file"
+fi
+pages_array=()
+for file in ${pages_file_array[@]}; do
+  current_hash=$(md5sum "$file" | awk '{print $1}')
+      
+  if (${debug}) _msg debug "${0:t}_msg_2" " ${pages_cache[$file]}"
+  if (${debug}) _msg debug "${0:t}_msg_3" " current_cache: ${current_hash}"
+  if [[ ${pages_cache[$file]} != "$current_hash" ]]; then
+  	if (${debug}) _msg debug "${0:t}_msg_4" " ${pages_cache[$file]}"
+  	if (${debug}) _msg debug "${0:t}_msg_5" " current_cache: ${current_hash}"
+    pages_array+=("$file")
+    pages_cache[$file]=$current_hash
+  fi
+done
+: >| "$pages_cache_file"
+for name in "${(@k)pages_cache}"; do
+  echo "$name:${pages_cache[$name]}" >> "$pages_cache_file"
+done
--- a/docs/zsdoc/data/functions/qsgen2/_qstags
+++ b/docs/zsdoc/data/functions/qsgen2/_qstags
@ -0,0 +1,50 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+
+if ${debug}; then
+  _msg debug "${0:t}_msg_1"
+fi
+typeset -A qstags=(
+  "#BR" "<br/>\n"
+  "#BD" "<b>" "#EBD" "</b>"
+  "#I" "<i>" "#EI" "</i>\n"
+  "#P" "<p>" "#EP" "</p>\n"
+  "#Q" "<blockquote>" "#EQ" "</blockquote>\n"
+  "#C" "<code>" "#EC" "</code>\n"
+  "#H1" "<h1>" "#EH1" "</h1>\n"
+  "#H2" "<h2>" "#EH2" "</h2>\n"
+  "#H3" "<h3>" "#EH3" "</h3>\n"
+  "#H4" "<h4>" "#EH4" "</h4>\n"
+  "#H5" "<h5>" "#EH5" "</h5>\n"
+  "#H6" "<h6>" "#EH6" "</h6>\n"
+  "#STRONG" "<strong>" "#ESTRONG" "</strong>\n"
+  "#EM" "<em>" "#SEM" "</em>\n"
+  "#DV" "<div>" "#EDV" "</div>\n"
+  "#SPN" "<span>" "#ESPN" "</span>\n"
+  "#UL" "<ul>" "#EUL" "</ul>\n"
+  "#OL" "<ol>" "#EOL" "</ol>\n"
+  "#LI" "<li class=\"libody\">" "#ELI" "</li>\n"
+  "#UD" "<u>" "#EUD" "</u>\n"
+  "#TBL" "<table>" "#ETBL" "</table>\n"
+  "#TR" "<tr>" "#ETR" "</tr>\n"
+  "#TD" "<td>" "#ETD" "</td>\n"
+  "#TH" "<th>" "#ETH" "</th>\n"
+  "#ART" "<article>" "#EART" "</article>\n"
+  "#SEC" "<section>" "#ESEC" "</section>\n"
+  "#ASIDE" "<aside>" "#EASIDE" "</aside>\n"
+  "#NAV" "<nav>" "#ENAV" "</nav>\n"
+  "#BTN" "<button>" "#EBTN" "</button>\n"
+  "#SEL" "<select>" "#ESEL" "</select>\n"
+  "#OPT" "<option>" "#EOPT" "</option>\n"
+  "#LT" "&lt;" "#GT" "&gt;" "#NUM" "&num;"
+  )
+  for qstag html (${(kv)qstags}); do
+    content=${content//${qstag}/${html}}
+  done
+
+  echo "${content}"
--- a/docs/zsdoc/data/functions/qsgen2/_run_engine
+++ b/docs/zsdoc/data/functions/qsgen2/_run_engine
@ -0,0 +1,11 @@
+local debug=false
+
+if [[ ${config[project_generator]} == "native" ]]; then
+  ${engine} ${1}
+elif [[ ${config[project_generator]} == "markdown" ]]; then
+  echo "${1} | ${engine} ${engine_opts}"
+else
+  _msg debug "ERROR running engine: ${engine}!"
+  _msg info "Usage: _run_engine <input>"
+  exit
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_sitemap
+++ b/docs/zsdoc/data/functions/qsgen2/_sitemap
@ -0,0 +1,92 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+if ([[ ${config[site_sitemap]} == "true" ]] && ( [[ ${new_updated_blogs} == "true" ]] || [[ ${new_updated_pages} == "true" ]] )) || [[ ${sitemap_force} == "true" ]]; then
+
+  setopt extendedglob
+  
+  _msg main "${0:t}_msg_1"
+
+  local sm_file="sitemap.xml"
+  local b_file="sitemap-blogs.xml"
+  local p_file="sitemap-pages.xml"
+  local sitemap_file="${config[site_root]}/${sm_file}"
+  local sitemap_blog="${config[site_root]}/${b_file}"
+  local sitemap_page="${config[site_root]}/${p_file}"
+  builtin cd ${config[site_root]}
+  local -a html_files=(**/[a-z]*.html(.))
+  local -a blog_files=()
+  local -a page_files=()
+  for file in "${html_files[@]}"; do
+    if [[ $file == *blog* ]]; then
+      blog_files+=("$file")
+    else
+      page_files+=("$file")
+    fi
+  done
+  echo '<?xml version="1.0" encoding="UTF-8"?>' > ${sitemap_blog}
+  echo "<!-- Sitemap generated by ${QSGEN} ${VERSION} - https://github.com/kekePower/qsgen2 -->" >> ${sitemap_blog}
+  echo "<?xml-stylesheet type=\"text/xsl\" href=\"${config[site_url]}/css/default-sitemap.xsl?sitemap=page\"?>" >> ${sitemap_blog}
+  echo '<urlset' >> ${sitemap_blog}
+  echo '  xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"' >> ${sitemap_blog}
+  echo '  xmlns:xhtml="http://www.w3.org/1999/xhtml"' >> ${sitemap_blog}
+  echo '  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"' >> ${sitemap_blog}
+  echo '>' >> ${sitemap_blog}
+  for file in "${blog_files[@]}"
+    do
+      local url="${config[site_url]}/${file}"
+      local lastmod=$(stat -c %y "${file}" 2>/dev/null | cut -d' ' -f1,2 | sed 's/ /T/' | sed 's/\..*$//')
+
+      echo "  <url>" >> ${sitemap_blog}
+      echo "    <loc>${url}</loc>" >> ${sitemap_blog}
+      echo "    <lastmod><![CDATA[${lastmod}+01:00]]></lastmod>" >> ${sitemap_blog}
+      echo "    <changefreq><![CDATA[always]]></changefreq>" >> ${sitemap_blog}
+      echo "    <priority><![CDATA[1]]></priority>" >> ${sitemap_blog}
+      echo "  </url>" >> ${sitemap_blog}
+  done
+  echo '</urlset>' >> "${sitemap_blog}"
+  _msg std "  - ${b_file}"
+  echo '<?xml version="1.0" encoding="UTF-8"?>' > ${sitemap_page}
+  echo "<!-- Sitemap generated by ${QSGEN} ${VERSION} - https://github.com/kekePower/qsgen2 -->" >> ${sitemap_page}
+  echo "<?xml-stylesheet type=\"text/xsl\" href=\"${config[site_url]}/css/default-sitemap.xsl?sitemap=page\"?>" >> ${sitemap_page}
+  echo '<urlset' >> ${sitemap_page}
+  echo '  xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"' >> ${sitemap_page}
+  echo '  xmlns:xhtml="http://www.w3.org/1999/xhtml"' >> ${sitemap_page}
+  echo '  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"' >> ${sitemap_page}
+  echo '>' >> ${sitemap_page}
+  for file in "${page_files[@]}"
+    do
+      local url="${config[site_url]}/${file}"
+      local lastmod=$(stat -c %y "${file}" 2>/dev/null | cut -d' ' -f1,2 | sed 's/ /T/' | sed 's/\..*$//')
+
+      echo "  <url>" >> ${sitemap_page}
+      echo "    <loc>${url}</loc>" >> ${sitemap_page}
+      echo "    <lastmod><![CDATA[${lastmod}+01:00]]></lastmod>" >> ${sitemap_page}
+      echo "    <changefreq><![CDATA[always]]></changefreq>" >> ${sitemap_page}
+      echo "    <priority><![CDATA[1]]></priority>" >> ${sitemap_page}
+      echo "  </url>" >> ${sitemap_page}
+  done
+  echo '</urlset>' >> "${sitemap_page}"
+  _msg std "  - ${p_file}"
+
+  if (${debug}); then _msg debug "${0:t}_msg_2" " ${sitemap_file}"; fi
+  echo '<?xml version="1.0" encoding="UTF-8"?>' > "${sitemap_file}"
+  echo "<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">" >> "${sitemap_file}"
+  echo "  <sitemap>" >> "${sitemap_file}"
+  echo "    <loc>${config[site_url]}/${b_file}</loc>" >> "${sitemap_file}"
+  local lastmod_b=$(stat -c %y "${b_file}" 2>/dev/null | cut -d' ' -f1,2 | sed 's/ /T/' | sed 's/\..*$//')
+  echo "    <lastmod>${lastmod_b}</lastmod>" >> "${sitemap_file}"
+  echo "  </sitemap>" >> "${sitemap_file}"
+  echo "  <sitemap>" >> "${sitemap_file}"
+  echo "    <loc>${config[site_url]}/${p_file}</loc>" >> "${sitemap_file}"
+  local lastmod_p=$(stat -c %y "${p_file}" 2>/dev/null | cut -d' ' -f1,2 | sed 's/ /T/' | sed 's/\..*$//')
+  echo "    <lastmod>${lastmod_p}</lastmod>" >> "${sitemap_file}"
+  echo "  </sitemap>" >> "${sitemap_file}"
+  echo "</sitemapindex>" >> "${sitemap_file}"
+  _msg std "  - ${sm_file}"
+
+  builtin cd ${config[project_root]}
+
+fi
--- a/docs/zsdoc/data/functions/qsgen2/_version
+++ b/docs/zsdoc/data/functions/qsgen2/_version
@ -0,0 +1,4 @@
+_msg info "_qsgen2_msg_7" "-$(strftime "%Y")"
+echo "${yellow}- https://github.com/kekePower/qsgen2/${end}"
+_msg info "_qsgen2_msg_8" " '${1} help' " "_qsgen2_msg_8.1"
+exit
--- a/docs/zsdoc/data/functions/qsgen2/_youtube
+++ b/docs/zsdoc/data/functions/qsgen2/_youtube
@ -0,0 +1,18 @@
+if [[ ${globaldebug} == "true" ]]; then
+  local debug=true
+else
+  local debug=false
+fi
+
+local content="${1}"
+local modified_content=""
+echo "${content}" | while IFS= read -r line; do
+  if [[ ${line} == *"#ytvideo"* ]]; then
+    if (${debug}) _msg debug "${0:t}_msg_1" " ${line}"
+    local yt_id=$(echo "${line}" | awk -F'#ytvideo ' '{print $2}')
+    local yt_iframe="<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/${yt_id}\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen></iframe>"
+    line=${line//"#ytvideo ${yt_id}"/${yt_iframe}}
+  fi
+  modified_content+="${line}\n"
+done
+echo -e "${modified_content}"