Added information on general formatting and title page
parent
8cb7aadc20
commit
0c890741a3
|
@ -549,12 +549,15 @@
|
|||
\let\@lvspec@terminology\relax
|
||||
\let\@lvspec@abstract\relax
|
||||
\let\@lvspec@pretitle\relax
|
||||
\let\@lvspec@titlecmd\relax
|
||||
\let\@lvspec@titlecontent\relax
|
||||
|
||||
% allows us to use the abstract command whilst still using the environment
|
||||
\let\@abstract\abstract
|
||||
\let\end@abstract\endabstract
|
||||
|
||||
\newcommand\titlecontent[1]{%
|
||||
\gdef\@lvspec@titlecontent{#1}%
|
||||
}
|
||||
\renewcommand\abstract[1]{%
|
||||
\gdef\@lvspec@abstract{#1}%
|
||||
}
|
||||
|
@ -587,7 +590,7 @@
|
|||
\@author\\LoVullo Associates\\
|
||||
\vspace{2em}%
|
||||
\vfill
|
||||
\@lvspec@titlecmd
|
||||
\@lvspec@titlecontent
|
||||
\today
|
||||
\endgroup
|
||||
\end{center}
|
||||
|
|
111
lvspec.tex
111
lvspec.tex
|
@ -7,15 +7,15 @@
|
|||
\usepackage[final]{graphicx}
|
||||
|
||||
\makeatletter
|
||||
\def\@lvspec@titlecmd{%
|
||||
\includegraphics[scale=0.5]{images/dilbert-time.png}
|
||||
\vfill
|
||||
}%
|
||||
\makeatother
|
||||
|
||||
\begin{document}
|
||||
\title{LoVullo Specification Specifications}
|
||||
\author{Mike Gerwitz}
|
||||
\titlecontent{%
|
||||
\includegraphics[scale=0.5]{images/dilbert-time.png}
|
||||
\vfill
|
||||
}%
|
||||
\abstract{%
|
||||
\setlength\columnsep{-5ex}%
|
||||
\begin{multicols}{2}
|
||||
|
@ -100,7 +100,7 @@ draft} mode will enable signature lines, as shown to the right.
|
|||
|
||||
\begin{ex}
|
||||
\begin{verbatim}
|
||||
% omit "[draft]" to disable unapproved signature lines
|
||||
% omit "[draft]" to disable signature lines
|
||||
\documentclass[draft]{lvspec}
|
||||
|
||||
% as is the case with all LaTeX documents, begin and end with document
|
||||
|
@ -126,7 +126,96 @@ environment. All examples end with `$\square$'.
|
|||
\end{ex}
|
||||
|
||||
|
||||
\section{Paragraph Numbering}
|
||||
\section{General Formatting}
|
||||
There are a number of formatting decisions that \cmd{lvspec} makes for you; you
|
||||
should \emph{not} override them manually, since the \cmd{lvspec}~class is
|
||||
intended to provide a company-wide abstraction that can be easily modified to
|
||||
apply to all specifications.
|
||||
|
||||
The \cmd{lvspec}~class is based on the \cmd{scrreprt}~class, which is in turn
|
||||
very similar to the standard \LaTeX\ \cmd{report}~class. In particular, all
|
||||
section levels starting with \verb|\chapter| are supported and margins are of
|
||||
equal length on both sides, which is suitable for collating portions of the
|
||||
document without having to worry about binding and what side a particular page
|
||||
is printed on. Margins are large to provide plenty of space for annotations and
|
||||
reader markup. The default page size is US~letter.
|
||||
|
||||
\cmd{lvspec} suppresses paragraph indentation and instead adds space between
|
||||
paragraphs, which is more natural with paragraph numbering (see~\sref{parnum}).
|
||||
|
||||
The amount of text on a page is determined by a ratio that carefully balances
|
||||
characters per line and number of lines on a page according to established
|
||||
typesetting conventions and also takes into account Hermann~Zapf's ideas for
|
||||
page ``grayness'' (where a page appears darker with more text). Since
|
||||
\cmd{lvspec} adds additional whitespace between lines, it accommodates by
|
||||
decreasing the height of the top and~bottom page margins. Furthermore, glue
|
||||
between section headings has been condensed slightly and is not as stretchable.
|
||||
|
||||
The header of each page contains the document title (short title if provided) in
|
||||
the upper-right hand corner, with the current section (as of the beginning of
|
||||
the page) on the upper-left. The typeface is in {\sc Small Caps} to distinguish
|
||||
it from the page body which is in fairly close proximity. The font size has also
|
||||
been {\small slightly decreased} to move focus away from it.
|
||||
|
||||
\p{ex:footer}
|
||||
The footer of each page contains, from left to right, the section number of the
|
||||
last section to appear on the page; the current page number; and a unique
|
||||
version identifier that is either taken from \path{verstr.tex} or---if
|
||||
unavailable---the current date.\footnote{See \path{lvspec.git/Makefile} for an
|
||||
example of how to use \path{verstr.tex}.}
|
||||
|
||||
|
||||
\subsection{Title Page and Abstract}
|
||||
The title is typeset in {\sc Small Caps} to provide stronger emphasis than a
|
||||
normal typeface (because {\bf bold is too bold}).
|
||||
|
||||
If the \cmd{draft} option is provided via \verb|\documentclass|, then the text
|
||||
``{\sc(Working Draft)}'' will be typeset below the title.
|
||||
|
||||
The \verb|\title| command is modified to support an optional ``short title'' to
|
||||
be used primarily in the header to provide additional space for section names.
|
||||
|
||||
The text ``{\sc LoVullo Associates}'' is added below any provided author(s).
|
||||
|
||||
The date of document generation is typeset flush with the bottom of the page
|
||||
body.
|
||||
|
||||
Two bold, vertical bars span the entire length of the page body in the left and
|
||||
right margins.
|
||||
|
||||
Additional content may be added to the title page below the author and above the
|
||||
date by using the \verb|\titlecontent| command.
|
||||
|
||||
An abstract may be typeset on the following page using the~\verb|\abstract|
|
||||
command. If the~\cmd{draft} option is provided, an additional paragraph will be
|
||||
added---regardless of whether an abstract was given---stating that the document
|
||||
is a draft.
|
||||
|
||||
Flush with the bottom of the abstract page body is a copyright notice, date of
|
||||
page generation (the same date that appears on the title page) and the version
|
||||
identifier that appears on the footer of every page (as mentioned
|
||||
in~\pref{ex:footer}).
|
||||
|
||||
\begin{ex}
|
||||
\begin{verbatim}
|
||||
\begin{document}
|
||||
% optionally, use \title[Short Title]{Long Title}
|
||||
\title{LoVullo Specification Specifications}
|
||||
\author{Mike Gerwitz}
|
||||
\titlecontent{%
|
||||
\includegraphics[scale=0.5]{images/dilbert-time.png}
|
||||
\vfill
|
||||
}%
|
||||
\abstract{...}
|
||||
\maketitle
|
||||
% ...
|
||||
\end{verbatim}
|
||||
\end{ex}
|
||||
|
||||
Immediately after the title and~abstract pages are typeset, paragraph numbering
|
||||
(see~\sref{parnum}) and~signature lines (see~\sref{siglines}) are enabled.
|
||||
|
||||
\section{Paragraph Numbering}\label{s:parnum}
|
||||
Paragraph numbering can be temporarily disabled using \verb|\pnumoff| and
|
||||
re-enabled using \verb|pnumon|\ldots
|
||||
|
||||
|
@ -167,7 +256,7 @@ no longer any disambiguating identifier.
|
|||
\end{ex}
|
||||
|
||||
|
||||
\section{Signature Lines}
|
||||
\section{Signature Lines}\label{s:siglines}
|
||||
The department for the entire section can be set using the
|
||||
\verb|\sectiondept| command; the command takes effect until the next section
|
||||
or chapter.
|
||||
|
@ -244,6 +333,13 @@ command \verb|\incompletei|, which also includes the name of the department.
|
|||
\end{verbatim}
|
||||
\end{ex}
|
||||
|
||||
|
||||
\section{Miscellaneous}
|
||||
% text has been carefully added to this line; margin, font, etc changes will
|
||||
% ruin it!
|
||||
Proper hyphenation is added for ``ConceptOne'', as is shown here on this line:
|
||||
ConceptOne test.
|
||||
|
||||
\enddeptgroup
|
||||
|
||||
|
||||
|
@ -273,4 +369,5 @@ $ pdftex src.tex \
|
|||
|
||||
\noindent You may decide to omit \cmd{bibtex} if you are not using a
|
||||
bibliography (but you probably should cite your information and rationale).
|
||||
|
||||
\end{document}
|
||||
|
|
Loading…
Reference in New Issue