59 Commits

Author SHA1 Message Date
Kenneth John Odle 9a6408dff3 Updates to «College, 2008» section. 2 weeks ago
Kenneth John Odle 4dc75bacc0 Finished chapter on NAPS2 2 weeks ago
Kenneth John Odle c5dbee19d9 Expanded chapter on NAPS2 2 weeks ago
Kenneth John Odle 9c8de1f3bf Additional information about scanning and replicative failure 2 weeks ago
Kenneth John Odle 15d43c79dc Added introductory material for NAPS2 2 weeks ago
Kenneth John Odle a7897aed72 Changed page images to be on a single line 2 weeks ago
Kenneth John Odle cdefa996f9 Added chapter on NAPS2 and tikz pictures 3 weeks ago
Kenneth John Odle 2bf0147520 Modified .gitignore 3 weeks ago
Kenneth John Odle 727a07d925 Added several chemistry packages; added chemistry chapter 4 months ago
Kenneth John Odle 2720b26c90 Removed «courier»; added «nott» option to «kpfonts» 4 months ago
Kenneth John Odle e0f7f7cc6e Added «courier» package; updated «kref» macro 4 months ago
Kenneth John Odle ce623f6a46 Updated «ways» 4 months ago
Kenneth John Odle 2c7e5600e3 Updated «flavors» image and scaling 4 months ago
Kenneth John Odle 43023a9eb6 Added example of a kludge 4 months ago
Kenneth John Odle 5346f340d2 Updates to right ways/wrong ways 4 months ago
Kenneth John Odle cc6ce748b8 Updates to right ways/wrong ways 4 months ago
Kenneth John Odle eb1408fb1a Added tables to chapter 6 4 months ago
Kenneth John Odle 65c395fcbd Experimenting with image size 5 months ago
Kenneth John Odle 96ce0a2ba1 - 5 months ago
Kenneth John Odle 315e1162f9 Updated readme with etsy link to 003 5 months ago
Kenneth John Odle 8a885ee11d Added chapter «the right ways» 5 months ago
Kenneth John Odle 952bbaaf21 Added one more link to bash aliases for git 5 months ago
Kenneth John Odle 85c0350642 Added 5 months ago
Kenneth John Odle 5d63f45597 Added 5 months ago
Kenneth John Odle 7064e28572 Added chapter about bash history 5 months ago
Kenneth John Odle b5d9a3eb97 Initial commit of issue #004 5 months ago
Kenneth John Odle a4df7ee225 Updated pdf version 5 months ago
Kenneth John Odle b94f5e4778 Sixth proofreading pass 5 months ago
Kenneth John Odle b1ed2f00bc Updated example labels 5 months ago
Kenneth John Odle 75f7059e02 Fifth proofreading pass 5 months ago
Kenneth John Odle b269886cb8 Updated .gitignore file 5 months ago
Kenneth John Odle fa8e43c706 Fourth proofreading pass; ~12,000 words 5 months ago
Kenneth John Odle c341cea2d6 Added macro for more easily doing href urls 5 months ago
Kenneth John Odle 6a8d3cb0f5 Added macro to format example labels 5 months ago
Kenneth John Odle 3f892de8b2 Third proofreading pass 5 months ago
Kenneth John Odle ebdb293070 Removed section on ABC; now at 40 pages 5 months ago
Kenneth John Odle 8f4be117b7 Updated .gitignore «bak» 5 months ago
Kenneth John Odle 6fc2f3acbd Second proofreading pass; still at 41 pages 5 months ago
Kenneth John Odle 7c6f47a89e First proofreading pass; now 41 pages 5 months ago
Kenneth John Odle 26f4cfa905 Added section about garden hacks 5 months ago
Kenneth John Odle 02ef9c14b4 Added musixtex chord diagrams 5 months ago
Kenneth John Odle 9937cfd5ae Updated «Miscellaneous Things» 5 months ago
Kenneth John Odle b14101b4de Updated music section 5 months ago
Kenneth John Odle 9560f94138 Added Ubuntu 22.04 (and 24.04) 5 months ago
Kenneth John Odle d394e3f909 Added 5.1.3 «Miscellaneous Things» 5 months ago
Kenneth John Odle 61f2a42b74 Added link to Flatland project 5 months ago
Kenneth John Odle ab377f3c8c Additional work to LaTeX section 5 months ago
Kenneth John Odle 786a5ceb52 Updated readme file 5 months ago
Kenneth John Odle fc25b77fb4 Added chapter «An Introduction to LaTeX» 5 months ago
Kenneth John Odle e118528a3d Updated «What's to Like About Linux» 5 months ago
Kenneth John Odle 4e48b77257 Updated .gitignore file 5 months ago
Kenneth John Odle 1b8ac2a57e Added section about Flatland 5 months ago
Kenneth John Odle 9617c37cdd Added music and installing LaTeX packages 9 months ago
Kenneth John Odle 6b46174876 Scaled images down and reprocessed 9 months ago
Kenneth John Odle eb6249657c Updated typo in README.md 9 months ago
Kenneth John Odle 8b77e01872 Added teaching section to 003 9 months ago
Kenneth John Odle efc8484832 Updated README.md 10 months ago
Kenneth John Odle 2635e646ed Initial commit of issue #3 10 months ago
Kenneth John Odle dfcbca343b Updated readme file to include Gumroad listings 1 year ago
  1. 5
  2. BIN
  3. 4
  4. BIN
  5. BIN
  6. BIN
  7. BIN
  8. BIN
  9. 1036
  10. BIN
  11. BIN
  12. BIN
  13. BIN
  14. BIN
  15. BIN
  16. BIN
  17. 7
  18. 7
  19. 450
  20. BIN
  21. BIN
  22. BIN
  23. 24


@ -8,3 +8,8 @@ Covers



@ -218,7 +218,7 @@ I purchased this computer from the back of a K-Mart, in much the same way the me
@ -228,7 +228,7 @@ The second computer I ever owned was a Commodore 128. Whereas its predecessor on



Width: 513  |  Height: 251  |  Size: 61 KiB



Width: 654  |  Height: 384  |  Size: 257 KiB




File diff suppressed because it is too large
View File



Width: 1024  |  Height: 909  |  Size: 143 KiB



Width: 1280  |  Height: 894  |  Size: 68 KiB



Width: 510  |  Height: 264  |  Size: 28 KiB



Width: 88  |  Height: 31  |  Size: 1.6 KiB





Width: 450  |  Height: 399  |  Size: 77 KiB


@ -0,0 +1,7 @@


@ -0,0 +1,7 @@


@ -0,0 +1,450 @@
% Where are our images?
% Let's set this as a half-letter sized sheet
% heightrounded,
% Adjust the top and bottom margins
% Set the header style
\fancyhead[LE,RO]{\textit{the codex}}
\fancyhead[RE,LO]{Issue \#003}
\cfoot{Page \thepage}
% Include two- or three-column sections
% Stop resetting the footnote count after each chapter
% Let's wrap some images
% Use tab stops when we need to (especially in footnotes)
% Define 18 tab stops (at 1/4" intervals)
% Make things neater. Thanks /u/-LeopardShark-
% Make a nice border and box for the tops of our examples
% Add an \hrule with space above and below
% Make hrefs easier (must load package hyperref}
% Rotate text in tables easier
% https://tex.stackexchange.com/questions/89115/how-to-rotate-text-in-multirow-table
% Use line numbers with code samples
% \begin{Verbatim}...\end{Verbatim} <-- Note the capitalization!
% Break lines inside this environment:
% Control spacing in lists
% Don't force text to fill page
% Better control over line-spacing
% Use nice fractions
% Keep the footnotes at the bottom of the page
% Do we want to include URLs?
% Yes, but we also want to hide the big red box it puts around them in the pdf. Thanks /u/0b0101011001001011
% Adjust space between caption and figure
% https://tex.stackexchange.com/questions/45990/how-can-i-modify-vertical-space-between-figure-and-caption
% Just for issue #004 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\draw (0,0) rectangle (.8,1.4);
\node at (0.4,.7) {{\LARGE #1}};
%%%% Document Information %%%%%
\author{Kenneth John Odle}
{\Huge the codex} \\
{\footnotesize Life with Linux — A Zine \\
Typeset in \LaTeX{} \\
Issue \#004}
% Change the name of the TOC
\renewcommand*\contentsname{In This Issue…}
All contents \copyright2023 Kenneth John Odle
Although this is now in your hands, and it's also on the web, so if you really wanted to steal this, I've made it pretty darn easy. I can't imagine why anyone would want to, though. However, you don't need to, because this is licenced under a CC BY-NA-SA 4.0 Creative Commons license. More information is at
\kref{https://creativecommons.org/licenses/by-nc-sa/4.0/}{https://creativecommons.org/licenses/by-nc-sa/4.0/} \includegraphics[scale=0.30]{ncsa4-0}
FYI, this is made in \LaTeX \,using the report document class. It then gets exported to a letterhalf (5.5 in x 8.5 in) pdf, which then gets made into a booklet using PDF Booklet, which you can find at
The image of Linus Torvalds on the front cover is courtesy JericoDelayah from the WikiMedia Commons. The image is from \kref{https://commons.wikimedia.org/wiki/File:4_RETAT_04_Linus_Torvalds.jpg}{https://commons.wi\\kimedia.org/wiki/File:4\_RETAT\_04\_Linus\_Torvalds.jpg} where you can also find a link to the Creative Commons CC BY-SA 3.0 license there, as well.
I'm pushing this to my own git server as I write this. You can find it \href{https://git.kjodle.net/kjodle/the-codex}{here}: \kref{https://git.kjodle.net/kjodle/the-codex}{https://git.kjodle.net/kjodle/the-codex}. New issues will be pushed after they are complete.
You can just skip over all the diversions in here if you want. It's just how my mind works. (And yes, there will be politics in this. \textit{You have been warned.}) Also, I use a lot of em-dashes, parentheses, and footnotes because that is also how my mind works. It's just one big long stream of consciousness up in here most days.
\noindent \textbf{Errata:} To err is human, to document those errors is divine. A list of errata can be found at
\noindent \textbf{Credit where credit is due:} A lot of people have come forth (mostly from Reddit) to help me out in various ways. See the preamble to this document in the source code to see them. One aspect of our society is that nobody \textit{has} to help you. It is wonderful when it happens, and I am grateful for their help.
\chapter{The Final Salad Days}
\section{College, 2008}
Bush II decided to tank the economy for ordinary people so that rich people could get richer.\footnote{This is the second of three "once in a lifetime" recessions I have lived through. Yay, capitalism! The rich get richer and everyone else gets poorer.} I decided to go back into teaching (which, thanks to current conservative political policies\footnote{Along with the asshole behavior of parents who approve of those policies.} there will always be a demand for), which meant I needed to go back to college to renew my teaching license. But this is a whole other story for which I have run out of space (not to mention it has very little to do with Linux or even computers), so it will have to go in a different zine if I ever decide to write it down.
What I can say is that the first time around, I wanted to get a biology major and an English minor because I wanted to teach biology and English, and I thought (naively) that this was how things worked.\footnote{They don't. Who knew?} But my biology advisor, a man who was many decades if not centuries my senior, advised against that plan. He felt that it would make me unhireable because it would look like I could not make up my mind between biology and English.
I did not realize it at the time,\footnote{I may not have realized it until just \textit{now}, when I wrote this.} but he was revealing his prejudice as a Biology professor. He was wrong, ultimately (schools absolutely love it when you can teach more than one subject as it provides for a lot of flexibility in scheduling), but his argument scared me. I was going to go thousands of dollars in debt for this degree (I was not smart enough to get a full scholarship, so I had to make up the difference with grants and loans—lots and lots of loans), and if I couldn't get a job, I wouldn't be able to pay back those loans. I would be sentenced to a life of penury, which is the very thing a college degree was supposed to protect against. So I agreed with him and forgot about getting an English minor.
His second argument was that as a prospective biology teacher, I was \textit{required} to get a group science ``minor'', which is in quotation marks because it was actually 36 credit hours, which was the equivalent of a major, rather than the 20 credit hours typical of an actual minor. As a result, I would have little time or energy (or money!) for another minor.
So in 2008 I decided to go back to teaching. To do so, I needed to get eight credit hours in ``a teachable subject'' so I decided to take a couple of English classes, as that would both meet the legal requirements and also give me a chance to read and write for credit.
As they say, things happened.
At first I was taking a couple of English classes. But then I thought, that's eight credit hours. If I take three more I could actually get the full minor. Why not? So a couple of English classes became an English minor, which eventually became an English major.
Becoming a biology teacher required that I take a \textit{methods} class, which is a class about…well, basically it's a class about how to \textit{be} a biology teacher. It teaches you how to plan labs and field trips, and how to do things in a safe way so that nobody gets hurt, and covers the specifics of teaching biology that were not covered in your regular education classes.
Becoming an English teacher required that I take \textit{two} methods classes: one about teaching literature and one about teaching writing. I remember very little about either class. (And to be honest, I remember more about the graduate class I took in fairy and folk tales, because those tales evolve like living beings—which in a way they are. This was where biology and literature overlapped for me in the Venn diagram of my life.)
The one thing I remember very distinctly about the writing methods course was that our capstone project had to be \textit{online}. Oh wow, I thought—I've been creating websites for a while now. But I was worried. I had been hearing about how young people were so good with technology, so comfortable with it, that I was sure whatever I came up with would just blow my feeble old school attempts out of the water.
I could not have been more wrong.
\chapter{Math in \LaTeX{} with \texttt{align} and \texttt{array}}
\chapter{Searching your Bash History}
\chapter{Other Flavors of Linux}
I admit, I am pretty invested in Ubuntu. But I don't have to be that way. There are \textit{lots} of ways to swim in the Linux pool. Just doing a quick search for ``linux flavors'' yields a lot of options:
This also omits Edubuntu which, as a former teacher, I am very interested in.
\chapter{What's to Like About Linux}
\section{bash Aliases for \texttt{git}}
\chapter{The Right Ways vs The Wrong Ways}
A lot of grew up hearing that ``there's a right way to do things and a wrong way to do things.'' I don't disagree that there is always a \textit{wrong} way to do things, but like house maintenance, working on computers quickly teaches you that there are a lot of wrong ways to do things.
Experience has shown me that not all wrong ways are wrong in the same way or to the same degree, and that the same is true of right ways. There may be multiple right ways to get something done, but some require less work and some require more work. It is not just a black-and-white issue.
In the past few years, I've started things less in terms of a particular ``right way'' opposed to a particular ``wrong way'', and started thinking in terms of a spectrum of choices, some of which are obviously wrong (but wrong to varying degrees) and some of which are right because they work, but you have to take different roads to get there.
What I have tried to do here is to create a hierarchy of ``rightness'' and ``wrongness'' as a way to organize my thinking on this subject; I can then jump in and discuss why things fall the way they do. No doubt, other people might have more distinctions or fewer in their hierarchy, or might have things in a separate order, or might have different reasons.
And, as we shall see, sometimes it's beneficial to do something the wrong way.
\newpage % Move this list to a new page.
\item \textbf{Very Wrong}
\item It doesn't work and it breaks things in weird places.
\item It doesn't work and it breaks almost everything.
\item It doesn't work but it only breaks a few local things.
\item \textbf{Wrong}
\item It works, but it breaks things in weird places.
\item It works, but it breaks almost everything else.
\item It works, but it still manages to break a few local things.
\item \textbf{Wrong\textit{ish}}
\item It works in this specific instance, but not in all instances.
\item It works, but it's far more work than it should be.
\item \textbf{Right\textit{ish}}
\item It works, but you have no idea why.
\item It works, but it requires you to rework some other pieces.
\item It works, but it's a bit of a kludge.
\item \textbf{Right}
\item It works, and is considered a best practice.
\item \textbf{Genius}
\item It's a true hack.
\section*{Very Wrong Ways}
Very wrongs ways are very wrong because not only do they not work, they take other things down with them.
\paragraph{It doesn't work and it breaks things in weird places.} You may wonder why this is worse than ``It doesn't work and it breaks almost everything else'' but for me the answer is simple: it can be terribly difficult to find those weird places. When I say ``weird'' I mean that they may be obscure places that nobody looks, they may be distant from the current situation and apparently unconnected,\footnote{But nothing is \textit{truly} disconnected from anything else.}, or they may be things that you don't have to rely on very often, so you may not discover that they are broken until days, weeks, or even months later.
\paragraph{It doesn't work and it breaks almost everything else.} This is bad, but it is not bad as the previous example, because it has two advantages. First, because almost everything is breaking, those breaks are pretty obvious. Second, because almost everything is breaking, this provides you an opportunity to look at the overall structure of your project and examine how all the different parts are connected. There may be connections that you weren't aware of. You may realize that some things are connected that shouldn't be or that some things aren't connected that should be. Sometimes it takes a real disaster to point out the strengths and weaknesses of your system.
\paragraph{It doesn't work and it still manages to break a few local things.} No complaints here. You have to undo what you did and maybe fix a few things, but you probably don't have a whole lot more to think about here.
\section*{Wrong Ways}
Wrong ways may work, but they break other things along the way. As we shall see, this is not always a bad thing.
\paragraph{It works, but it breaks things in weird places.} Again, the main issue here is that those weird places may not be obvious at first. You might use this technique, and it looks like it's working fine, but suddenly there is a person in Germany whose toilet no longer flushes properly. Or it works fine for you now, but in ten months \textit{your} toilet no longer flushes properly. And because these two things are so separated in place (in the former case) or time (in the latter case) it can be difficult to connect the two things, and we might end up spending a lot of time going down rabbit holes when the real solution is right in front of us the entire time. We waste time and effort.
\paragraph{It works, but it breaks almost everything else.} This is almost exactly like ``It doesn't work and it breaks almost everything else'' except that your solution \textit{does} work. You just need to look at your overall system and figure out why everything else is going into meltdown mode.
\paragraph{It works, but it still manages to break a few local things.} Even though this is listed as a wrong way---you are still breaking things, after all---this is not always a bad outcome to experience. It's possible that those few things that are breaking are breaking because they are weak. If you strengthen those items and then apply this technique, it turns out that this isn't actually wrong after all, it only seemed wrong at the time. In the end, you have a much project that is much less fragile overall.
\section*{Wrong\textit{ish} Ways}
\paragraph{It works in this specific instance, but not in all instances.} It works, so why is this way still wrong? Because it's not \textit{universal} for all similar situations. If it works in \textit{this one particular instance} but not similar instances, and you don't know why, then there is something about this particular instance that you are not aware of. This is not a bad thing if you're willing to chase down that unknown thing; it's potentially disastrous if you are not.
\paragraph{It works, but it's far more work than it should be.} This is often a case of not having the right tools, or having the right tools but not knowing how to use them. If you need to dig a ditch, a shovel will work, but a backhoe works much better. All that time you spent working with a shovel is time you could have spent doing something else.
\section*{Right\textit{ish} Ways}
\paragraph{It works, but you have no idea why.} I was very tempted to put this in the wrong\textit{ish} section, and in some cases it may certainly belong there. Quite frankly, you should know why a technique works. Not knowing why can be dangerous, because you assume too much about this particular technique. That may cause you to be a bit overconfident with it, and use it in a situation that doesn't really warrant its use.
\paragraph{It works, but it requires you to rework some other parts of the project.} I admit, I was at a lost as to where to put this one. And I guess it depends if you are using a kludge or a best practice, so I'm going to assume you are using a best practice. In which case, this shows you places that you were possibly \textit{not} using something which is a best practice, and now you need to make those things better.
\paragraph{It works, but it's a bit of a kludge.} A kludge is not always a bad thing (sometimes you have to work with what you have) but they are at best, inelegant, and at worst weighty and ugly. But they work for now, they don't break things, and they will last until you learn or can afford a better way. (I created a bit of a kludge when I couldn't figure out how to indent a bibliography entry. \footnote{You can see it in action in this commit for a different project: \kref{https://git.kjodle.net/kjodle/Notes-on-Python/commit/d4f93ec00f1e1078b1cfcb3aacd3481eb82bb0cd}{https://git.kjodle.net/kjodle/Notes-on-Python/commit/d4f93ec00f1e1078b1cfcb3a\\acd3481eb82bb0cd}.} Does it work? Yes. Am I happy with it? Not entirely. I'm 75\% there is a better way to do this, but I haven't found it yet. But it works for now, and I've marked it as a kludge, so I know this is something that I can come back to later. At least I made this less weighty and hid its heft and inelegance by turning it into a macro.)
\section*{Right Ways}
\paragraph{It works, and is considered a best practice.} A best practice is one that has generally been accepted as the best way to do things not because it is perfect, but because it produces results that are better than the results achieved by other methods. This is a good thing. A best practice is a best practice because it's proven itself. It's not perfect (hence it's a ``best practice'' not a ``perfect practice''), but you can count on it to get the job done. And because it is a best practice, when things go pear-shaped, it's probably because of something you've done, but if it isn't, there will most likely be a lot of people who are \textit{very} interested in helping you.
Unfortunately, sometimes a best practice is arrived at that for no other reason than ``that's how we've always done it and nothing has exploded yet.'' That's not great, but still, have a fire extinguisher handy.
\section*{Genius Ways}
\paragraph{It's a true hack.}
As I said way back in the first issue, I define a hack as ``an appropriate application of ingenuity''\footnote{See \kref{http://www.catb.org/~esr/jargon/html/meaning-of-hack.html}{http://www.catb.org/~esr/jargon/html/meaning-of-hack.html} for more information.}. These are rare, often false (it only resembles a hack; like the wizard in \textit{The Wizard of Oz}, it's based on smoke and mirrors), and even more often small.\footnote{You can usually identify a false hack by how large it is.} If you find one, enjoy it, preserve, and help to disseminate it.
\chapter{Not Another PDF Scanner}
Way back in issue \#1 of this zine\footnote{Which is only three issues ago, but considering that I published it in 2021, it seems \textit{like} a long time ago. I really need to get my act together and get these out on a more regular basis.} I talked about a workflow for scanning documents because I am trying to be as digital as possible.
In that article ``A Scanner Darkly, but with a workflow'' I mentioned that I used one piece of commercial software (VueScan) because it did what no FOSS\footnote{Free and Open Source} software could do: work with my printer and also sort pages effectively when my scanner's ADF\footnote{Automatic Document Feeder} does not duplex (i.e., it does not flip pages over to scan the other side). And while it is great software, and I did not mind paying the \$100 for a one-year subscription to it (the software company behind it is pretty much a father and son team), I didn't like being dependent on it.
The reasoning is simple. If a company decides to stop producing a product, that's it; you're done. I used to have a great plugin on my WordPress sites that added social media sharing icons to each post. The company that made it got bought out by Oracle. You might think this is a great thing, because Oracle is a big huge company with a lot of resources. But often, when big huge companies buy small independent companies, they are only interested in one or two of their products, and let the rest go. And this is exactly what happened. Oracle suddenly decided they weren't going to support this plugin and it just stopped working. The company's webpage for the plugin redirected to an Oracle page that basically said ``fuck off'' and little more. No explanation, no recommendations of similar plugins, nothing.
At least when FOSS software projects get abandoned or the original developers get better paying jobs delivering pizza, there is always the chance that someone else will take over the project. Better yet, you—yes, \textit{you}—can donate money to the project to help support it.
I first found out about NAPS2\footnote{\kref{https://www.naps2.com/}{https://www.naps2.com/}} because I had downloaded a book from the Internet Archive\footnote{\textit{Inherit the Stars} by James P. Hogan, which you can read at \kref{https://archive.org/details/inheritstars00jame}{https://archive.org/deta\\ils/inheritstars00jame}} and the pages were very, very yellowed. (It had been scanned from a pulp paperback printed on cheap paper with a high acid content. How seldom we plan for the future!)
I was looking for a way to lighten the background of the pages so that it would be easier to read. My usual solution for this would be to open the pdf in GIMP, opening each page as a separate layer. I could then figure out the settings for one page, convert that into a script (GIMP is scriptable!), apply that script to every single layer, and export the entire thing as a pdf, remembering to tick the box that says to export layers as pages, and also to do it in reverse order.
That's not a huge amount of work, but it's still—work. Surely, there has to be a more automated way to do this, no?
I searched and I searched, and I was rewarded for that search. Someone mentioned that a program called NAPS2 had this very feature. The name didn't hurt at all—at this point in my life, I am very much in favor of naps, unlike the five year old version of me.
Even better, NAPS2 had an ``interleave'' feature, which meant that I didn't need to use \texttt{pdftk} to do that.\footnote{To be fair, this is a feature which VueScan also eventually added at some point.} So scanning longer two-sided documents suddenly became a lot easier.
The only problem was that NAPS2 offered \textit{four} versions of this command: interleave, deinterleave, alternate interleave, and alternate deinterleave. (These are very neatly contained under the ``Reorder'' icon in the main menu.) I knew one of those was what I needed; I just needed to figure out which.
I'm a scientist, so I experimented. I took five sheets of paper, wrote the odd numbers 1-9 on the front side and the corresponding even numbers 2-10 on the back side. If you flipped through them, you would see something like what you see in figure \ref{naps2-orig}
\caption{The document as originally drawn}
Because I wrote on both sides of each side of paper (in order to emulate a double-sided original), I scanned the pages, and then flipped them over and scanned the other sides. And because I am scanning these upside down, the even numbers end up in reverse order. So I ended up with a pdf that looked like figure \ref{naps2-scan}.
\caption{The document as originally scanned}
That's progress, but it's not the progress I wanted to make. I tried all the different options available under the ``Reorder'' icon, and finally figured out that ``Alternate Interleave'' would produce the final pdf that I want, which you can see in figure \ref{naps2-final}.
\caption{The document after applying ``Alternate Interleave''}
If that looks like the original document, it is definitely not an accident; it is by design. Print that out and you get something close to the original.\footnote{I say ``close'' because a scan is never the equivalent of the original. It is a reflection, an imitation. But it is not the same. Every time we copy an analog object, we lose something. Replicative failure is a thing.}
\section{Adjusting the Image Quality of a Scanned Book}
I originally downloaded NAPS2 because I wanted to clean up a scanned book I had downloaded from the Internet Archive. It was an old pulp paperback, published in 1977 on cheap paper not much better than newsprint, and it was \textit{extremely} yellowed.
The way I would normally handle this would be the GIMP method I described earlier. But that's a lot of work for a book I just want to read and be done with. (No archivist work for me here.)
The workflow for this is fairly simple. First you import your pdf using the ``Import'' button. Then you select all the pages and click the ``Image'' button. The options are pretty limited: you can adjust the brightness and contrast, adjust the hue and saturation, or you can sharpen. It also has an image called ``Document Correction'' which is great if you are scanning in a lot of hand written notes and need to add a lot of contrast. (This doesn't work so greatly in the case of a badly yellowed book, unfortunately.)
You're probably not going to get a perfect book back, because the options are pretty limited. The trade-off is that you pick your settings once, and then NAPS2 handles all the work while you go get yourself a cup of coffee—or take a nap.
\section{Adjusting Images}
Even though NAPS2 was designed to be a pdf scanner, it also has the ability to save individual scans as images. Even more importantly, because each scanned page is basically an image, you can also edit each page as an image by double clicking on it, where you get editing options like crop and rotate, in addition to the ones I mentioned earlier. This is pretty handy if you're scanning something like a manual that has different sized pages, or is printed on large sheets and folded into a box so that you have to scan it in sections,\footnote{Every piece of furniture I've ever assembled has instructions like this, but I've run into quite a few manuals that are miniature versions of this, like the earbuds I wear on my daily walk.} or a package that has care instructions.
And if you're wondering why I keep banging on about manuals, it's because I do keep them. For years, I kept them all in a large three ring binder filled with page protectors that I could slip them into. It was big and awkward, and don't dare tip it the wrong way, or you have manuals all over the floor.
At some point, I realized that most manuals are available in convenient pdf form from the manufacturer's website, so I started just downloading those, making sure the pdf was identical (or identical \textit{enough}) to the original, and then tossing the original in the recycling.
\paragraph{Summary:} In short, NAPS2 is everything I need in a document scanner. It gives me some of the editing features of GIMP, has a simple interface to use (you can create different profile for each kind of scanning you you) and it just plain works. I recommend it.
\chapter{Chemistry in \LaTeX{}}
\section{Package \texttt{hmchem}}
For typesetting chemical equations:
\ce{CO2 + C -> 2 CO}
\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}
\section{Package \texttt{chemformula}}
For typesetting chemical compounds and reactions:
\ch{KCr(SO4)2 * 12 H2O}
\ch{$2n$ Na + $n$ Cl2 -> $2n$ NaCl} \par
\ch{\{[CH2=CH-CH2]- <-> {}[CH2-CH=CH2]- \}} \par
\section{Package \texttt{chemfig}}
For drawing molecules:
\chapter{A \texttt{git} Workflow}
\chapter{More about those folders in \texttt{root}}
\section{What I Learned About \LaTeX{} While Creating This Issue}
\subsection{Page Count using \texttt{detex}}
\subsection{How to Create Macros}
\section{What I learned About \LaTeX{} While Creating Something Else}



Width: 510  |  Height: 264  |  Size: 28 KiB



Width: 1160  |  Height: 849  |  Size: 136 KiB



Width: 88  |  Height: 31  |  Size: 1.6 KiB


@ -15,13 +15,24 @@ If you have questions or suggestions, you can join the [forum for this zine](htt
## Paper Copies
**Issue 003**
You can buy this on etsy at [https://www.etsy.com/listing/1507867746/the-codex-a-zine-about-linux-issue-3](https://www.etsy.com/listing/1507867746/the-codex-a-zine-about-linux-issue-3). I don't have metric versions available for download as of yet (12 July 2023) but I am working on it.
**Issue 002**
You can buy a paper copy of issue [#002](https://www.etsy.com/listing/1262188799/the-codex-a-zine-about-linux-issue-2) in my Etsy shop. Unfortunately, I can only ship to North America at the present time.
If you are outside of North America and would like to purchase a digital download which you can then print out in booklet form and staple yourself, you can buy it [here](https://www.etsy.com/listing/1252039564/the-codex-2-metric-download).
Again, you can use the couple **GIT20** to get a 20% discount.
Again, you can use the coupon **GIT20** to get a 20% discount.
If you have issues with Etsy (and who doesn't?), you can also buy them from **Gumroad**:
* [Physical copy (North America only)](https://iswpw.gumroad.com/l/codex002)
* [Digital A4 copy (everywhere)](https://iswpw.gumroad.com/l/codex002-A4)
The **GIT20** discount code will also work on Gumroad.
**Issue 001**
@ -44,4 +55,13 @@ I used a handful of packages to make this document, which I've listed below, alo
Also reddit user -LeopardShark- recommended using the package [microtype](https://www.ctan.org/pkg/microtype) to get finer typographical control. ~~Maybe in the next issue.~~ I'm actually using this in issue 002 and you can tell the difference by comparing page 2 in both issues and looking at the placement of the Creative Commons icon.
If you like this, but don't want to buy, you can always [donate](https://www.paypal.me/kjodle) via [PayPal](https://git.kjodle.net/kjodle/the-codex/raw/commit/951d36d4ce1ee46fce6127d60d18e69c0660c29e/ppme.svg). Thanks!
### New in issue 3:
* [fancyvrb](https://ctan.org/pkg/fancyvrb) &mdash; Extending the ``verbatim`` environment.
* [fvextra](https://ctan.org/pkg/fvextra) &mdash; Extending the ``fancyvrb`` package.
* [enumitem](https://ctan.org/pkg/enumitem) &mdash; Extra control over the basic list environments.
If you like this, but don't want to buy, you can always [donate](https://www.paypal.me/kjodle) via PayPal. (No PayPal account is necessary.) It's greatly appreciated.