From c0b46180d7fb80e02ede355e25b1335df8a39347 Mon Sep 17 00:00:00 2001 From: Syndamia Date: Thu, 29 Sep 2022 15:07:07 +0300 Subject: [hooks] Updated and reformatted documentation for everything in hooks, including README --- generate-hooks/create-file-lists.awk | 122 +++++++++++++++++++++++------------ 1 file changed, 80 insertions(+), 42 deletions(-) (limited to 'generate-hooks/create-file-lists.awk') diff --git a/generate-hooks/create-file-lists.awk b/generate-hooks/create-file-lists.awk index 113bca6..7d18bdd 100644 --- a/generate-hooks/create-file-lists.awk +++ b/generate-hooks/create-file-lists.awk @@ -1,55 +1,93 @@ -# This is a really rudementary way to make making file lists less HTML-y -# I made it so: -# 1) You don't have to write quite as much HTML -# 2) The Data columns for each file get to be formatted as Markdown ( is not recognized as a block-level element, so the stuff inside get formatted https://kristaps.bsd.lv/lowdown/lowdown.5.html#HTML_Blocks) - -# Very roughly, each file list has either this: -#
Folder Info File Data
-# or this: -# File Data
-# structure, the difference being that in the first, all of the files are in a folder. +# +# == About == +# +# Each file list is a "details" element, that contains a table, each row being a different file +# or alternatively, just the table on it's own. +# +# -- Result HTML -- +# +#
+# Folder Info +# +# File Data +#
+#
+# or +# +# File Data +#
-# In Markdown you type in something like (without the "# " in front): -# -# &&fos -# Description -# &&file0 -# Data 1 -# Data 1.1 -# Data 1.2 +# +# == ftags == +# +# &&folder The text right afterwards is the title of the folder. All files +# are hidden inside the collapsed details tag (click to show). +# The file table is indented. You cannot have a folder inside a folder. +# It can be omitted, and the files table will be shown as-is. +# +# &&file Everything that follows this tag is the data for a file. You should +# use &&fd to specify columns of information! Depending on the context, +# it might be replaced with the start of a table, closing the summary +# and starting table, or closing and opening a table row. +# +# &&/files This tag must exist at the bottom of a file list, no matter if it was +# started with or without a &&folder. +# +# &&fd Defines a column of information for a file (row). Practically, it is +# replaced with , and is added to the end of the line. +# If you don't use it, make sure to have the leading and trailing td tags! +# +# &&ft-TYPE Depending on TYPE, it inserts an image tag that contains the file "icon" +# for the corresponding type. +# Available values for TYPE: photo, text, zip, movie, markdown +# +# -- Placement/Flow -- +# +# All ftags, except &&fd, can be placed on their own line (empty line above and below) +# or before/after another ftag. +# Folder title must be inside the same paragraph as the ftag itself. This means that, +# after +# every &&folder ftag, the text can continue directly next to it and/or on new lines, +# without there being any empty lines (you can add those with
or two spaces at +# line end). +# +# -- Example Usage -- +# +# (I like to indent a bit &&fd ftags, for readability's sake, but you don't have to) +# # &&file -# Data 2 -# Data 2.1 -# Data 2.2 -# &&fod +# &&ft-text +# &&fd Notes +# &&fd 10 KB +# &&/files # -# or +# &&folder Math +# &&file +# &&ft-text +# &&fd Homework 1 +# &&file +# &&ft-text +# &&fd Homework 2 +# &&/files +# +# &&folder Art Project
+# Status: 70% complete
+# Note: Reserach Van Gogh paintings # -# &&nos -# Data 1 -# Data 1.1 -# Data 1.2 # &&file -# Data 2 -# Data 2.1 -# Data 2.2 -# &&nod - +# &&fd Painting 1 +# &&fd 100% Complete +# +# &&file +# &&fd Painting 2 +# &&fd 40% Complete # -# And the lines starting with && (I'll call them ftags) get replaced by some HTML. The around each file Data is mandatory. -# &&file0 must only be used on before the very first file data, when files are in a folder. There must be no empty lines, lines mustn't start with spaces, there mustn't be anything around ftags and ftags have to be on their own lines. -# The commands have fairly intuitive abbreviations: -# &&nos no folder start (start file list, without making a folder) -# &&fos folder start -# &&file0 file start of first file in folder (must only be used when items are in a folder!) -# &&file file start -# &&nod no folder end (end file list, without having made a folder) -# &&fod folder end +# &&/files BEGIN { fileStarted = 0 noFolder = 1 - searchEndP = 0 + searchEndP = 0 # Used to remove trailing

in file row # Special formatting nam[1] = "folder" -- cgit v1.3.1-26-gb76a