mirror of
https://github.com/flynx/photobook.git
synced 2025-10-29 10:20:08 +00:00
71 lines
2.1 KiB
Bash
Executable File
71 lines
2.1 KiB
Bash
Executable File
#!/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 :
|