WillAdams
3 hours ago
First, anyone who is interested in this should buy the books:
https://www.informit.com/store/latex-companion-parts-i-ii-3r...
I was certainly glad to, since the binding was breaking on my 2nd edition due to constant usage, and I was glad to have the option of buying hardcovers.
Second, work through a good tutorial, there are many, but I like: https://tug.ctan.org/info/lshort/english/lshort.pdf
Third, learn your way around CTAN, and https://tex.stackexchange.com/ --- for pretty much any problem you have, there should be a package or code snippet which addresses it, if not ask on SE or https://old.reddit.com/r/LaTeX/ after searching (and let folks know what terminology you used in your search), and consider using one of the nice well-documented documentstyles suited to your project --- Koma is good for Europeans, I like Memoir and not just because the first author was kind enough to consider my suggestions for the manual or implement some simplistic code I sent in (has anyone heard from Peter Wilson lately?)
Lastly, when working with macros and packages and so forth, conceptually divide them between semantic markup (this bit of code describes how this text/number should be represented and thought of) and appearance (this bit of code is necessary to get the text on the page at this pagination state in the best possible way) --- all of the latter macros should be defined twice, once as null ops in one package file, a second time redefined to actually do what is desired in a second package --- that way, the page can be set without them just by commenting out the second package. It's even better if all such macros are named in such a way that they can be easily commented out w/ a find-replace.
mbarr
2 hours ago
Looks like there's an update to the tutorial:
dmlorenzetti
3 hours ago
Regarding the idea to have some macros that expand to null when unwanted -- I have some "developer" macros that, in day-to-day use, do things like showing TODO items.
The most useful one typesets the labels of equations, sections, figures, and so forth, so I can copy-paste right from the document as I'm editing. That makes it so much easier to insert cross-references while writing, without breaking the flow to search out the definition.
Rather than commenting out packages, I have two top-level input files, which `\input{}` the actual content. Those files differ only where they read the developer-oriented definitions:
\input{latex_input/defn/dev_defns_for_devs.tex}
versus \input{latex_input/defn/dev_defns_for_release.tex}
falcor84
3 hours ago
> First, anyone who is interested in this should buy the books:
> https://www.informit.com/store/latex-companion-parts-i-ii-3r...
I'm getting "Sorry, this book is no longer in print."
mbarr
2 hours ago
Here's the link to the in-print version:
https://www.informit.com/store/latex-companion-parts-i-ii-97...
WillAdams
an hour ago
My apologies, didn't notice that the hardcover was out-of-print and that the paperback is what is available:
https://www.informit.com/store/latex-companion-part-i-978013...