;;; Collected wisdom of past APOcEds.  Last edited Dec 10 1994.
;;; "I" will refer to the APOcEd; don't try and figure out which one. =)

;;; ---------- Create the body of the APOc ----------

Create a file called body.tex.  It should contain all the articles, in
LaTeX format, but it doesn't need any of the initial or final declarations,
like \documentstyle..., \begin{document}, or \end{document}.  That's all
taken care of in another file (along with the margins and other formatting
parameters.)

I've defined some macros:

\article{Title of the Article}
This makes an article title (without the default LaTeX numbering) and makes
a corresponding entry in the table of contents.

\subarticle{Title of Subarticle}
Similar to \article, but formats the title and table-of-contents entry in a
manner suitable for subarticles.

LaTeX will try and mangle some symbols, so replace "$" with "\$", "%" with
"\%", "&" with "\&", "<" with "$<$", ">" with "$>$", etc.  It's also nice
to typeset smileys [the =) things] in \tt or \sf font.

;;; --------- Check the Layout ----------

latex skel

This runs the file skel.tex through LaTeX.  skel is a "skeleton" file, i.e.
it's the "middle" of the APOc, without the covers.  This exists because the
covers have lots of fancy PostScript stuff which slows down the xdvi
previewer an awful lot.  (Actually, it's only the front cover now.  I
converted the entire back cover into pure LaTeX.)

Anyway, you should look for formatting problems here.  Some common
situations:

Overfull hbox errors: LaTeX will complain about these as it runs.
Basically, it means that LaTeX couldn't find a good way to break a line,
and it's too wide.  Sometimes, it'll just be a few points over (a point is
about 1/72 of an inch.)  You don't really have to worry about it unless it
gets really bad (i.e. You can actually *see* it.), although it's nice to
fix them anyway (I usually do.)

Usually, the problem stems from some really long word or phrase.  LaTeX
can't find a good place to break it.  Try editing the text to move the word
away from the edge of the page.  You can also try to get it to hyphenate.

Try getting the pages to break nicely, without leaving too much blank
space.  Three hints for doing this: you can force a page break by adding a
"\newpage" command.  If you need to shrink a verical space
(e.g. before/after an environment) to stop the last couple of lines from
spilling over, you can use \vspace* with a negative argument.  Finally,
juggling the order of articles helps.  A lot.

It's important to get the text to be around 4n+2 pages, so that when you
add the cover pages you get a number divisible by 4.  4n+1 is fine (you can
leave the inside back cover blank by adding "\newpage\ \newpage" there).
4n is so-so (you need to add 2 pages.)  4n+3 is downright bad.

;;; -------------- Make the final copy --------------

latex apoc
This makes the full APOc, with the covers on.

latex apoc
You need to do it twice to get the table of contents.  This is because the
table of contents can't be created until all the other pages are set.  (You
may run into trouble if the table of contents ever gets bigger than 2
pages.  Just keep running LaTeX until it settles down.  Alternately, try to
keep the table of contents short.)

add apo
dvidvi "4:-1(0in,-0.7in),2(5.5in,-0.7in)" apoc side1
dvidvi "4:-3(0in,-0.7in),0(5.5in,-0.7in)" apoc side2

This little bit of magic is what puts the APOc into the booklet form.
dvidvi is a special program (which I've installed in the APO locker) which
takes the dvi file produced by LaTeX and shuffles it around.  These
particular commands take two pages at a time and lay them out side-by-side.

;;; --------------- Preview the final copy ------------

This step is optional, but it helps for checking whether weird stuff
(e.g. space for pasting in pledge articles) works like you think it does.

xdvi -paper usr side1 &
xdvi -paper usr side2 &

;;; --------------- Print it out ------------

And now, you can print them out.  Remember to use landscape mode-- the text
is *supposed* to be sideways.  Ta-dah!

dvips -Pprintername -t landscape side1
dvips -Pprintername -t landscape side2

;;; --------------- Send out the E-mail copy ------------

There should be a script in the APOc directory called "mail-apoc" (if not,
there is a copy in /mit/bert/apoc).  It can be used to generate the version
of the APOc without LaTeX formatting.  Type

add sipb

./mail-apoc >! MAIL

to store the "electronic" APOc into file called MAIL, then use your
favourite mail handler to write a short header, include MAIL and send it
out.  (If there are problems, pester bert-- he wrote it.)

;;; --------------- Archiving ------------

A paper copy goes into the Historian's files.

A copy of all the files you changed (typically body.tex and cover-defs.tex;
possibly *-cover.tex as well) goes into the directory
	/mit/apo/Archives/APOcrypha/Volume(volume#)/Issue(issue#)

You should compress the files using the "gzip" program from the SIPB locker
to save space.