photobook/scripts/cls2tex.sh

#!/usr/bin/env bash

printhelp(){
	echo "Generate docs from latex package/class"
	echo
	echo "Usage: $(basename $0) [-h|--help] INPUT OUTPUT [PREFIX]"
	echo
	echo "This will:"
	echo "  - keep lines starting with \\def\\<module-name>@[A-Z]\\+"
	echo "  - keep lines starting with '%%'"
	echo "  - %%%%% Text -> \\subsection(Text)"
	echo "  - %%%% Text -> \\section(Text)"
	echo "  - %% >> code -> \\begin{verbatim}code\\end{verbatim}"
	echo
	echo "PREFIX can replace the second \"%\" in the above patterns to make it"
	echo "possible to integrate multiple layers of documentation in one file"
	echo "and to integrate them in various ways, for example, in the photobook"
	echo "document class documentation \"M\" prefix is used to indicate"
	echo "meta-command docs, this enables us to document them in the relevant"
	echo "location (i.e. at the implementation) in source but move the docs to"
	echo "a unified location in docs, effectively decoupling the source and doc"
	echo "structure when needed."
	echo
	echo "NOTE: the idea of keeping latex docs in a latex file is far simpler"
	echo "      than all the stuff crammed into .dtx, at least for my needs:"
	echo "          - keep the code readable"
	echo "          - keep the docs readable"
	echo "      in both the repo and in installed form, so .dtx is not used."
}

# args/defaults...
while true ; do
	case $1 in
		-h|--help)
			printhelp
			exit
			;;

		*)
			break
			;;
	esac
done

INPUT=$1

OUTPUT=$2

PREFIX=$3
if [ -z $PREFIX ] ; then
	PREFIX=%
fi

# generate the module name...
MODULE=$(basename "$INPUT")
MODULE=${MODULE/.*/}

# do the work...
cat "$INPUT" \
	| egrep '(^%'$PREFIX'|^\\edef\\'$MODULE'@[A-Z][A-Z]+)' \
	| sed 's/^\(\\edef\\\)'$MODULE'@/%'$PREFIX'\1/' \
	| sed 's/%'$PREFIX'%%%% \(.*\)/%'$PREFIX'\\subsubsection{\1}\\label{subsubsec:\1}/' \
	| sed 's/%'$PREFIX'%%% \(.*\)/%'$PREFIX'\\subsection{\1}\\label{subsec:\1}/' \
	| sed 's/%'$PREFIX'%% \(.*\)/%'$PREFIX'\\section{\1}\\label{sec:\1}/' \
	| sed 's/%'$PREFIX'\s\+>>\s\+\(.*\)/%'$PREFIX'\\begin{verbatim} \1 \\end{verbatim}/' \
	| cut -c 3- - \
	> "$OUTPUT"


# vim:set ts=4 sw=4 nowrap :