Skip to content
Snippets Groups Projects
Commit 9f20ab48 authored by Edward Longman's avatar Edward Longman
Browse files

Improve the rebuilding instructions and add the references that in the section

parent d2835e58
No related branches found
No related tags found
No related merge requests found
......@@ -18,13 +18,13 @@
title = {Updated templates reference 2},
year = {2011}
}
@electronic{GNUdesc
@electronic{GNUdesc,
author = {{Free Software Foundation, Inc.}},
title = {GNU Make}
title = {GNU Make},
url = {https://www.gnu.org/software/make/}
}
@electronic{Docstrip
author = {Frank Mit­tel­bach,
title = {docstrip Remove comments from file}
@electronic{Docstrip,
author = {Frank Mit­tel­bach},
title = {docstrip – Remove comments from file},
url = {https://ctan.org/pkg/docstrip?lang=en}
}
\chapter{Rebuilding the Templates}To change the templates you should understand how the templates are made.
The templates are built using the docstrip package.
"The pack­age pre­pares a \LaTeX ker­nel or pack­age source file for ac­tual use, by re­mov­ing the doc­u­men­ta­tion and meta-data" \citep{Docstrip}
It also creates a document containing some documentation for the created files.
The docstrip utility comes as a latex package so when the main file (.dtx) is run with the command `latex ecsdocs.dtx` it creates all the class files plus the example templates.
When this tool is run it creates lots of auxiliary files.
To help with managing these auxiliary files GNU Make is used.
"GNU Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files."\citep{GNUdesc}
\chapter{Rebuilding the Templates}\label{rebuilding}
In most cases this template style and layout will be suitable. If it is not, it may only require a small change to bring the template in line with your institution's recommendations.
Quick modifications will need to be done on the \verb|ecsdocs.cls| file in the \verb|tex/latex/ecsdocs| folder. Modification of all the templates or major modifications should be made to the original \verb|source/docstrip/ecsdocs/ecsdocs.dtx|
\section{The Build Process}
To change the templates you should understand how the templates are made.
The templates are built using the docstrip package.
"The pack­age pre­pares a \LaTeX ker­nel or pack­age source file for ac­tual use, by re­mov­ing the doc­u­men­ta­tion and meta-data" \citep{Docstrip}
It also creates a document containing some documentation for the created files.
The docstrip utility comes as a latex package so when the main file (.dtx) is run with the command \verb|latex ecsdocs.dtx| it creates all the class files plus the example templates.
When this tool is run it creates lots of auxiliary files.
To help with managing these auxiliary files GNU Make is used. "GNU Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files."\citep{GNUdesc}.
The make command can be run in several different configurations. \verb|make all| creates all of the class, template, bibliography and figure files from the source files. \verb|make install| moves all of the created files into the users texmf directory ready for use.
\section{The Source File}
The source file \verb|ecsdocs.dtx| results in the several different class (\verb|.cls|) files as well as the template (\verb|.tex|) files.
It also creates the figure files and the chapter files.
Whilst this creates a mess of files all in one folder the \verb|make install| command is designed to clean them up into a folder structure described in Listing~\ref{folder_struct}.
The dtx file is designed to ensure continuity across different classes: names, font, department page styling and other formats.
It largely self documents into the folder labelled \verb|doc|.
As the work done in rebuilding this was for the purpose of improving the PhD Thesis and Progress report templates the others have not been tested.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment