From 2720b26c901278fcfcaea8fbcba436a6599adb84 Mon Sep 17 00:00:00 2001 From: Kenneth Odle Date: Sun, 6 Aug 2023 15:32:01 -0400 Subject: [PATCH] =?UTF-8?q?Removed=20=C2=ABcourier=C2=BB;=20added=20=C2=AB?= =?UTF-8?q?nott=C2=BB=20option=20to=20=C2=ABkpfonts=C2=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 004/codex-004.tex | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/004/codex-004.tex b/004/codex-004.tex index b64699b..6a278d3 100644 --- a/004/codex-004.tex +++ b/004/codex-004.tex @@ -4,12 +4,11 @@ \usepackage{amssymb} \usepackage{makeidx} \usepackage{graphicx} -\usepackage{kpfonts} +\usepackage[nott]{kpfonts} \usepackage{float} \raggedbottom \usepackage{array} \usepackage{multirow} -\usepackage{courier} % Where are our images? \graphicspath{{images/}} @@ -60,7 +59,7 @@ \newcommand\krule[2]{\vspace{#1}\hrule\vspace{#2}} % Make hrefs easier (must load package hyperref} -\newcommand\kref[2]{\href{#1}{{\texttt{\textbf{#2}}}}} +\newcommand\kref[2]{\href{#1}{{\texttt{#2}}}} % Rotate text in tables easier % https://tex.stackexchange.com/questions/89115/how-to-rotate-text-in-multirow-table @@ -93,6 +92,7 @@ % Just for issue #004 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \usepackage{pifont} +\usepackage{qrcode} %%%% Document Information %%%%% \author{Kenneth John Odle} @@ -114,9 +114,17 @@ \section*{Impressum} 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} +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 -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 (\kref{https://pdfbooklet.sourceforge.io/wordpress/}{https://pdfbooklet.sourceforge.io/\\wordpress/}). +\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} + +\medskip + +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 + +\kref{https://pdfbooklet.sourceforge.io/wordpress/}{https://pdfbooklet.sourceforge.io/wordpress/} + +\medskip 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. @@ -126,7 +134,9 @@ You can just skip over all the diversions in here if you want. It's just how my \medskip -\noindent \textbf{Errata:} To err is human, to document those errors is divine. A list of errata can be found at \kref{https://git.kjodle.net/kjodle/the-codex/wiki/Errata}{https://git.kjodle.net/kjodle/the-codex/wik\\i/Errata}. +\noindent \textbf{Errata:} To err is human, to document those errors is divine. A list of errata can be found at + +\kref{https://git.kjodle.net/kjodle/the-codex/wiki/Errata}{https://git.kjodle.net/kjodle/the-codex/wiki/Errata}. \medskip @@ -257,7 +267,7 @@ Wrong ways may work, but they break other things along the way. As we shall see, \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/d4f93ec00f1e107\\8b1cfcb3aacd3481eb82bb0cd}.} 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.) +\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} @@ -271,6 +281,8 @@ Unfortunately, sometimes a best practice is arrived at that for no other reason 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{A \texttt{git} Workflow}