The tools and techniques I use are available in WYSIWYG document software but you'll find them discussed in the last chapter of the manual with a title something like "Things less than 1% of you might use (but only if you are in professional publishing)". They are available but, they're far from the dominant paradigm. If they try to use it at all, most people end up jury-rigging this kind of functionality instead of using what the software offers and then end up with a nightmare. LaTeX gives you simple hooks to build your document off of and they're one of the first things you learn about.
When I write something I pretty much always follow these steps (and this goes equally for papers, articles, posters and Beamer presentations.):
- Document setup: write preamble text, \usepackage for packages I know will be necessary (math, graphics, etc), and \begin{document} \end{document}
- Now lay out the high level logical structure by putting in \section{} tags. This might be as simple as
\section{Introduction}
I'll often also include commands or comments to note where titlepage, table of content, bibliography, etc. commands will go.
\section{Background}
\section{.....}
\section{Conclusions} - Now lay out more refined levels of logical structure with \subsection{} and \subsubsection{} (Leslie Lamport wrote LaTeX to only go to subsubsection level for good layout reasons. You can define lower levels but it's often not worth it. When I need another level I use \subsubsection*{} to get an unnumbered subsubsection). This gets you to a a deeper structure like
\section{Cloud Droplet Retrieval}
%Break down relevant instruments that do retrievals
\subsection{MODIS}
\subsubsection{Technique}
%Radiance retrieval a la Nakajima-King
\subsubsection{Assumptions}
\subsection{POLDER}
\subsubsection{Technique}
%Fits to Mie simulation
...etc - Note that in building this structure I haven't written any of the document. I'll include notes about the final level of structure but I try to avoid actually writing any of it. The notes can be done as in-line comments like above, as live text or within a comment environment. Each method can have its place.
I don't write much here because I find that once I have something written as a sentence or as paragraphs, I become very reluctant to alter it significantly. Maybe I'm too attached to supposed cleverness but, I tend to move sentences around and then morph grammar rather than do the right thing; delete them and move on. Better to not have them there in the first place. - Once this logical structure has settled (or is mostly settled), I start to flesh out the body of the text. You can do this by simply expanding on the comments you've left behind but often I will do this by writing each section in a separate document and using \input{} lines to bring them into the main document. This keeps the logical structure of the document clean, easy to read and easy to edit around my actual text. Doing it this way can lead to headaches when you try to do labels and references for figures, tables, though, so experiment and see what works best for you. LaTeX can handle the separate files well but it can be a pain to the carbon wetware moving around in multiple files trying figure out what goes where.
- Clean up anything in the actual typesetting that LaTeX doesn't do quite the way you want (LaTeX is built to be smart about typesetting but sometimes I feel a need to do things my way)
It's all about process. A good, consistent process will do wonders and LaTeX makes it easy to build a good process.
No comments:
Post a Comment