Site Navigation:
 
 

LaTeX Standards for FHSST

Who can edit what?

The "state" of a file is given in a comment field near the top of each file. It can be one of:
Not maintained
If a file is not maintained, you can request to become the maintainer by emailing the FHSST-Authors mailing list. You can assume temporary maintainer-ship for 7 days (if you have CVS write access). If there are no objections after this time, you are the maintainer. It is very likely that any content submitted to an unmaintained file will be accepted. You can just submit the changes via CVS (if you have write access) or email the FHSST-Authors mailing list.
Editable by all
It is unlikely that content to a file with this state will be rejected, so you may contribute to CVS (if you have write access) or email the maintainer. It is generally considered polite to inform the maintainer before editing their file.
Currently in edit
It is very unlikely that content will be accepted to a currently in edit file. If you really feel like you have something to contribute to such a file, you must email both the editor and the maintainer in order to avoid wasting time working on a file which may currently be undergoing a serious overhaul on somebody else's machine.
Stable
Any changes made to a stable file must be agreed upon by all the FHSST authors, and such changes must also be compatible with the legalities placed upon a published school textbook. This pretty much means that only typos and incorrect solutions to problems will be accepted.

The first 3 states are obvious, however the change to stable is very strict. A file only becomes stable when it is ready for printing and use in a school. For it to reach this stage it should have proved its worth in several real world tests and must have been read by several authors. When a maintainer finally decides that a file is worthy and submits it for stable status, they must email the FHSST-Authors mailing list with the request.

All problems and objections (by any author) must be worked out, and the maintainer has to re-apply for stable status when all the problems are worked out. This way everyone agrees to every file that is stable. All core members must email the list agreeing that the file is "stable". Also, there must be no objections filed against a candidate for 7 days.

If you want to add a chapter please notify the admin team via fhsst-admin-priv AT nongnu DOT org and wait for a response before adding it. We try to keep things relaxed but some moderation is definitely required.

Labels

Every section, subsection, subsubsection, equation and figure must have a label tag. Equations must begin {eq:} and figures {fig:}. The next part of the label must be consistent throughout the file and is the chapter's label appended with a colon. e.g. "physics/collisions.tex" uses the label "pc" throughout (p for physics, c for collisions), so equations are all labelled {eq:pc:description}. The description part is up to the author to decide upon, but try to keep it short and descriptive.

References

In true LaTeX fashion, try not to ever refer to "the figure below", but instead use a \ref tag with the equation or figure's label. In very exceptional circumstances (very small figures) it may be best to put the figure inline with the text. In that case you may use

some text
\begin{figure}[H]
pstricks jig
\end{figure}
\noindent
some more text

to achieve inline figures.

PSPictures

Although it is possible to have a pspicture without a figure environment, it is best that all pspictures be inside a \figure{} environment.

Notation

We must stick to the SA syllabus very strictly with regards to notation. In order to use a consistent notation throughout the book, you should use the following macros for certain symbols:

\ms = meters per second
\momen = momentum
\kener = kinetic energy
(need more)

check out the defines.tex file to see more. (Please add more using other/notation.tex as a guide)

Homemade Environments

We have developed many environments to make writing easier. Here are a few:

\nts{}
Use this to leave "Notes to Self""

\pwex{} (physics) \mwex{} (maths) \cwex{} (chemistry)
Use these for worked example environments. Use \westep{} for each new step of the solution.

check out the defines.tex file to see more.