summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/knittingpattern/introduction.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/knittingpattern/introduction.tex')
-rw-r--r--Master/texmf-dist/doc/latex/knittingpattern/introduction.tex223
1 files changed, 223 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/knittingpattern/introduction.tex b/Master/texmf-dist/doc/latex/knittingpattern/introduction.tex
new file mode 100644
index 00000000000..8ea64cab15d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/knittingpattern/introduction.tex
@@ -0,0 +1,223 @@
+\documentclass{article}
+
+\usepackage{fancyhdr}
+
+%% introduction.tex, version 1
+ %% Copyright 2010 Hugh Griffiths
+ %
+ % This work may be distributed and/or modified under the conditions
+ % of the LaTeX Project Public License, either version 1.3 of this
+ % license or (at your option) any later version. The latest version
+ % of this license is in http://www.latex-project.org/lppl.txt and
+ % version 1.3 or later is part of all distributions of LaTeX version
+ % 2005/12/01 or later.
+ %
+ % This work has the LPPL maintenance status `maintained'.
+ %
+ % The Current Maintainer of this work is Hugh Griffiths.
+ %
+ % This work consists of the files knittingpattern.cls, template.tex,
+ % template.pdf, introduction.tex and introduction.pdf
+
+\title{How to use the Knitting Pattern class}
+\author{Hugh Griffiths}
+
+\begin{document}
+
+\maketitle
+
+\pagestyle{fancy}
+\fancyhead{}
+\fancyfoot{}
+\renewcommand{\footrulewidth}{.4pt}
+\renewcommand{\headrulewidth}{0pt}
+\fancyfoot[R]{\copyright 2010 Hugh Griffiths}
+\thispagestyle{fancy}
+
+Thank you for downloading the Knitting Pattern class! The purpose of this class is to provide a simple, effective method for knitters to produce high-quality, attractive patterns using \LaTeX. It does this by providing commands to handle as much of the layout of the document as possible, leaving the author free to concentrate on the pattern itself.
+
+\section*{Contents}
+In this directory you'll find:
+\begin{itemize}
+\item
+knittingpattern.cls
+\item
+template.tex
+\item
+template.pdf
+\item
+lion.png
+\item
+readme.txt
+\item
+introduction.tex
+\item
+introduction.pdf
+\end{itemize}
+
+The first is the class file, you'll need to download that and put it
+in the directory you're working in (or `somewhere where TeX will find
+it'). ``template.tex'' is a sample of how this might be used,
+although here it's just creating a basic block diagram document.
+``template.pdf'' is the compiled version, so you can see how it looks.
+The image used throughout (lion.png) is the CTAN lion, drawn by Duane
+Bibby. The last two files are, of course, this introduction.
+
+Some quick notes on how to use the Knitting Pattern class. First, the
+class requires a number of other packages: graphicx, float, fancyhdr,
+longtable, calc and xcolor. These are standard and are most likely
+included in your copy of latex. Second, a note on the
+``\textbackslash{}definecolor'' command - this comes from the xcolor
+package, and allows you to specify colours using HTML colour codes.
+If you're not familiar with these,
+\begin{verbatim}
+http://html-color-codes.com/
+\end{verbatim}
+has a nice chart. It's important to use capital letters in these
+codes.
+
+\section*{Copyright notice}
+
+The gist of this is that you can use, distribute and modify this
+package freely. In particular, you're very welcome to sell patterns
+produced using it:
+
+This work may be distributed and/or modified under the conditions of
+the LaTeX Project Public License, either version 1.3 of this license
+or (at your option) any later version. The latest version of this
+license is in
+\begin{verbatim}
+http://www.latex-project.org/lppl.txt
+\end{verbatim}
+and version 1.3 or later is part of all distributions of LaTeX version
+2005/12/01 or later.
+
+This work has the LPPL maintenance status `maintained'.
+
+The Current Maintainer of this work is Hugh Griffiths.
+
+This work consists of the files knittingpattern.cls, template.tex,
+template.pdf, introduction.tex and introduction.pdf
+
+\section*{How to use the Knitting Pattern class}
+After copying the .cls file into the appropriate directory, begin your document with:
+\begin{verbatim}
+ \documentclass{knittingpattern}
+\end{verbatim}
+You will then be able to make use of the following commands:
+\begin{itemize}
+\item
+\begin{verbatim}
+\intro{Text}{pic}
+\end{verbatim}
+Divides the page into two columns, the first containing the `Text'
+section, and the second the image `pic'. This will work best if your
+text is long enough that it ends up with a vertical length close to
+that of `pic'. By default the picture will take up a quarter of the
+page width.
+
+\item
+\begin{verbatim}
+\note{borderColour}{backgroundColour}{Title}{Text}
+\end{verbatim}
+Produces a centred box with coloured background and border, containing
+the `Title' text and `Text'. The `Title' part is underlined, in a
+larger font and appears on a separate line. The box defaults to 90\%
+of the page width.
+
+\item
+\begin{verbatim}
+\diagram{diag}
+\end{verbatim}
+Gives a centred, bordered box containing the image
+`diag'. The default width is half of the page width.
+
+\item
+\begin{verbatim}
+\important{borderColour}{backgroundColour}{Text}
+\end{verbatim}
+Produces a centred, coloured box and border containing `Text', for
+anything you feel needs to be highlighted. Like \textbackslash{}note,
+the box defaults to 90\% of the page width.
+
+\item
+\begin{verbatim}
+\cpyrght{Name}
+\end{verbatim}
+This sets up the footer. It removes the page numbering, puts a
+horizontal bar at the bottom and adds `Name' on the right-hand side.
+It's important that this command appear within the first page (but
+after the title), so it's best to put this immediately after
+\textbackslash{}maketitle (otherwise the footer on the first page is
+not set up correctly).
+
+Not to be confused with \textbackslash{}copyright, which gives a
+copyright symbol.
+
+\item
+\begin{verbatim}
+\biog{pic}{Text}
+\end{verbatim}
+Produces a biographical note. Place this on the last page of your
+pattern. As with \textbackslash{}intro, this is divided into two
+columns, with an image `pic' on the left and `Text' on the right.
+This will appear as a float at the bottom of the page. The image
+will take up a quarter of the page width by default.
+
+\item
+\begin{verbatim}
+\begin{pattern}{colour1}{colour2}
+Instructions & (st) \\
+...
+\end{pattern}
+\end{verbatim}
+Produces a table of knitting instructions. Each row has two entries,
+the first for the instructions for that row of knitting, and the
+second for the number of stitches. The rows have alternating colours
+for ease of reading.
+\end{itemize}
+
+All of these commands (except \textbackslash{}cpyrght) also accept an
+optional argument which will vary the default sizes. For
+\textbackslash{}note, \textbackslash{}diagram,
+\textbackslash{}important and \textbackslash{}begin\{pattern\} this
+changes the width of the object:
+
+For example,
+\begin{verbatim}
+\diagram[width]{diag}
+\end{verbatim}
+ will produce a diagram covering a
+proportion `width' of the page width.
+
+For the ``pattern'' environment, this optional argument will vary the
+width of the second column, adjusting the other column appropriately:
+\begin{verbatim}
+\begin{pattern}[width]{colour1}{colour2}
+...
+\end\pattern}
+\end{verbatim}
+gives a pattern table whose second column has width `width' as a
+proportion of the page. The default value for this width is 0.05.
+
+For \textbackslash{}intro and \textbackslash{}biog the optional
+argument changes the width of the image, adjusting the size of the
+other column to account for this. So
+\begin{verbatim}
+\intro[0.5]{Text}{pic}
+\end{verbatim}
+ will produce two columns half the width of the page, the first
+ containing ``Text'' and the second containing the image ``pic''.
+
+\section*{Suggestions}
+
+If you have any suggestions for improvements or extra functions you'd
+like added, or if you'd like to report any bugs, please email me at
+\begin{verbatim}
+griffiths(dot)hugh(at)gmail(dot)com.
+\end{verbatim}
+
+All of the commands are easily modifiable, and I would encourage you
+to edit them to find a style you like, or to make the commands more
+user-friendly.
+\end{document}