texlive[56919] Master: first-packages (12nov20)
commits+karl at tug.org
commits+karl at tug.org
Thu Nov 12 22:44:41 CET 2020
Revision: 56919
http://tug.org/svn/texlive?view=revision&revision=56919
Author: karl
Date: 2020-11-12 22:44:40 +0100 (Thu, 12 Nov 2020)
Log Message:
-----------
first-packages (12nov20)
Modified Paths:
--------------
trunk/Master/tlpkg/bin/tlpkg-ctan-check
trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/first-packages/
trunk/Master/texmf-dist/doc/latex/first-packages/LICENSE
trunk/Master/texmf-dist/doc/latex/first-packages/README
trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.css
trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.html
trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf
trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.tex
trunk/Master/tlpkg/tlpsrc/first-packages.tlpsrc
Added: trunk/Master/texmf-dist/doc/latex/first-packages/LICENSE
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/LICENSE (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/LICENSE 2020-11-12 21:44:40 UTC (rev 56919)
@@ -0,0 +1,5 @@
+This material is public domain, CC0.
+
+To the extent possible under law, Jim Hefferon has waived all
+copyright and related or neighboring rights to A First Set of LaTeX
+Packages. This work is published from: United States.
\ No newline at end of file
Added: trunk/Master/texmf-dist/doc/latex/first-packages/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/README (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/README 2020-11-12 21:44:40 UTC (rev 56919)
@@ -0,0 +1,22 @@
+README for A First Set of LaTeX Packages
+
+A short list of go-to LaTeX packages, aimed at a beginner.
+
+INSTALL
+
+The .html file is generated from the .tex file by running this.
+
+ $ make4ht first-packages.tex
+
+I modified it by replacing the missing ligatures, omitting some of the
+shrunken acronymns, fixing XeLaTeX, and omitting the paragraph indents.
+
+
+VIDEO
+
+A video presentation of this document is at https://youtu.be/9dmyqS3DWBc.
+
+
+HISTORY
+2020-Jul-11 Written Jim Hefferon http://hefferon.net
+2020-Nov-11 Version 1.0, upload to CTAN
\ No newline at end of file
Property changes on: trunk/Master/texmf-dist/doc/latex/first-packages/README
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.css
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.css (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.css 2020-11-12 21:44:40 UTC (rev 56919)
@@ -0,0 +1,138 @@
+
+/* start css.sty */
+.mdugmr8t-x-x-109{font-size:89%;}
+.mdugmm8t-x-x-144{font-size:117%;}
+.mdugmr8t-x-x-120{}
+.ectt-1095x-x-97{ font-family: monospace;}
+.ectt-1095x-x-97{ font-family: monospace;}
+.mdugmr8t-{font-size:81%;}
+.ectt-1000x-x-97{font-size:88%; font-family: monospace;}
+.ectt-1000x-x-97{ font-family: monospace;}
+.mdugmri8t-x-x-109{font-size:89%;}
+.logo-10x-x-109{}
+.mdugmrfc8t-x-x-109{font-size:89%;}
+p.noindent { text-indent: 0em }
+td p.noindent { text-indent: 0em; margin-top:0em; }
+p.nopar { text-indent: 0em; }
+p.indent{ text-indent: 1.5em }
+ at media print {div.crosslinks {visibility:hidden;}}
+a img { border-top: 0; border-left: 0; border-right: 0; }
+center { margin-top:1em; margin-bottom:1em; }
+td center { margin-top:0em; margin-bottom:0em; }
+.Canvas { position:relative; }
+img.math{vertical-align:middle;}
+li p.indent { text-indent: 0em }
+li p:first-child{ margin-top:0em; }
+li p:last-child, li div:last-child { margin-bottom:0.5em; }
+li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; }
+.enumerate1 {list-style-type:decimal;}
+.enumerate2 {list-style-type:lower-alpha;}
+.enumerate3 {list-style-type:lower-roman;}
+.enumerate4 {list-style-type:upper-alpha;}
+div.newtheorem { margin-bottom: 2em; margin-top: 2em;}
+.obeylines-h,.obeylines-v {white-space: nowrap; }
+div.obeylines-v p { margin-top:0; margin-bottom:0; }
+.overline{ text-decoration:overline; }
+.overline img{ border-top: 1px solid black; }
+td.displaylines {text-align:center; white-space:nowrap;}
+.centerline {text-align:center;}
+.rightline {text-align:right;}
+div.verbatim {font-family: monospace; white-space: nowrap; text-align:left; clear:both; }
+.fbox {padding-left:3.58331pt; padding-right:3.58331pt; text-indent:0pt; border:solid black 0.5119pt; }
+div.fbox {display:table}
+div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
+div.minipage{width:100%;}
+div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;}
+div.center div {text-align: left;}
+div.flushright, div.flushright div.flushright {text-align: right;}
+div.flushright div {text-align: left;}
+div.flushleft {text-align: left;}
+.underline{ text-decoration:underline; }
+.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; }
+.framebox-c, .framebox-l, .framebox-r { padding-left:3.58331pt; padding-right:3.58331pt; text-indent:0pt; border:solid black 0.5119pt; }
+.framebox-c {text-align:center;}
+.framebox-l {text-align:left;}
+.framebox-r {text-align:right;}
+span.thank-mark{ vertical-align: super }
+span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; }
+div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; }
+table.tabular td p{margin-top:0em;}
+table.tabular {margin-left: auto; margin-right: auto;}
+td p:first-child{ margin-top:0em; }
+td p:last-child{ margin-bottom:0em; }
+div.td00{ margin-left:0pt; margin-right:0pt; }
+div.td01{ margin-left:0pt; margin-right:5pt; }
+div.td10{ margin-left:5pt; margin-right:0pt; }
+div.td11{ margin-left:5pt; margin-right:5pt; }
+table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; }
+td.td00{ padding-left:0pt; padding-right:0pt; }
+td.td01{ padding-left:0pt; padding-right:5pt; }
+td.td10{ padding-left:5pt; padding-right:0pt; }
+td.td11{ padding-left:5pt; padding-right:5pt; }
+table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; }
+.hline hr, .cline hr{ height : 1px; margin:0px; }
+.tabbing-right {text-align:right;}
+span.TEX {letter-spacing: -0.125em; }
+span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;}
+a span.TEX span.E {text-decoration: none; }
+span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;}
+span.LATEX span.TEX{ position:relative; left: -0.4em; }
+div.float, div.figure {margin-left: auto; margin-right: auto;}
+div.float img {text-align:center;}
+div.figure img {text-align:center;}
+.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;}
+.marginpar p{margin-top:0.4em; margin-bottom:0.4em;}
+table.equation {width:100%;}
+.equation td{text-align:center; }
+td.equation { margin-top:1em; margin-bottom:1em; }
+td.equation-label { width:5%; text-align:center; }
+td.eqnarray4 { width:5%; white-space: normal; }
+td.eqnarray2 { width:5%; }
+table.eqnarray-star, table.eqnarray {width:100%;}
+div.eqnarray{text-align:center;}
+div.array {text-align:center;}
+div.pmatrix {text-align:center;}
+table.pmatrix {width:100%;}
+span.pmatrix img{vertical-align:middle;}
+div.pmatrix {text-align:center;}
+table.pmatrix {width:100%;}
+span.bar-css {text-decoration:overline;}
+table.tabular{border-collapse: collapse; border-spacing: 0;}
+img.cdots{vertical-align:middle;}
+.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;}
+.index-item, .index-subitem, .index-subsubitem {display:block}
+div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;}
+div.caption span.id{font-weight: bold; white-space: nowrap; }
+h1.partHead{text-align: center}
+p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
+p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
+.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;}
+.subparagraphHead, .likesubparagraphHead { font-weight: bold;}
+.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;}
+.verse{white-space:nowrap; margin-left:2em}
+div.maketitle {text-align:center;}
+h2.titleHead{text-align:center;}
+div.maketitle{ margin-bottom: 2em; }
+div.author, div.date {text-align:center;}
+div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; }
+div.author{white-space: nowrap;}
+.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; }
+.abstract p {margin-left:5%; margin-right:5%;}
+div.abstract {width:100%;}
+.figure img.graphics {margin-left:10%;}
+.lstlisting .label{margin-right:0.5em; }
+div.lstlisting{font-family: monospace; white-space: nowrap; margin-top:0.5em; margin-bottom:0.5em; }
+div.lstinputlisting{ font-family: monospace; white-space: nowrap; }
+.lstinputlisting .label{margin-right:0.5em;}
+.columns-2 p:first-child { margin-top: 0em; }
+.columns-2{-moz-column-count:2; -webkit-column-count:2; column-count:2; -moz-column-gap: 21.9pt; -webkit-column-gap: 21.9pt; column-gap: 21.9pt; -moz-column-rule-width: 0.0pt; -webkit-column-rule-width: 0.0pt; column-rule-rule-width: 0.0pt; -moz-column-rule-color: #555;; -webkit-column-rule-color: #555;; column-rule-color: #555;; -moz-column-rule-style: outset; -webkit-column-rule-style: outset; column-rule-style: outset; -moz-column-fill: balance; -webkit-column-fill: balance; column-fill: balance; }
+/* end css.sty */
+
+/* added JH */
+p.indent{ text-indent: 0em }
+span.flip_H{ display: inline-block; margin:0em;
+ transform: scale(-1, 1) }
+span.flip_V{ display: inline-block; margin:0em;
+ transform: scale(1, -1) }
+.sectionHead { margin-top:2em; font-weight: bold;}
+h2 { margin-top:2em; font-weight: bold; font-size:117%;}
Property changes on: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.css
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.html
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.html (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.html 2020-11-12 21:44:40 UTC (rev 56919)
@@ -0,0 +1,350 @@
+<!DOCTYPE html>
+<html lang="en-US" xml:lang="en-US" >
+<head><title></title>
+<meta charset="utf-8" />
+<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)" />
+<meta name="viewport" content="width=device-width,initial-scale=1" />
+<link rel="stylesheet" type="text/css" href="first-packages.css" />
+<meta name="src" content="first-packages.tex" />
+</head><body
+>
+<div class="center"
+>
+<!--l. 129--><p class="noindent" >
+</p><!--l. 130-->
+<h3><p class="noindent" ><span
+class="mdugmm8t-x-x-144">A First Set of </span><span class="LATEX"><span
+class="mdugmm8t-x-x-144">L</span><span class="A"><span
+class="mdugmm8t-x-x-144">A</span></span><span class="TEX"><span
+class="mdugmm8t-x-x-144">T</span><span
+class="E"><span
+class="mdugmm8t-x-x-144">E</span></span><span
+class="mdugmm8t-x-x-144">X</span></span></span><span
+class="mdugmm8t-x-x-144"> Packages</span><br /><br />
+<span
+class="mdugmr8t-x-x-120">Jim Hefferon</span></p></div></h3>
+ <!-- <div class="columns-2"> -->
+<!--l. 136--><p class="indent" > If you are a <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> beginner and ask, “How do I … ?” then often you will be told that there is a package
+for that. You may well next ask, “How would I know that? And if there is more than one package then
+which should I use?”
+</p><!--l. 143--><p class="indent" > This list covers most of what beginners want to do. Its goal is to cite one package in each area that is
+capable and reliable, and that is in Mac<span class="TEX">T<span
+class="E">E</span>X</span>, MiK<span class="TEX">T<span
+class="E">E</span>X</span>, and <span class="TEX">T<span
+class="E">E</span>X</span> Live. (There are some extra comments in
+parentheses that often come up along with the recommendations.)
+<a
+ id="x1-2r1"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-10001"></a>Introduction</h3>
+<!--l. 158--><p class="noindent" >For <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> users, the canonical archive is the Comprehensive <span class="TEX">T<span
+class="E">E</span>X</span> Archive Network, <a
+href="https://ctan.org" ><span>CTAN</span></a>.
+ <!-- class="mdugmr8t-">CTAN</span></a>. -->
+It has the
+latest official versions of the packages in the distributions, with documentation. And, <a
+href="https://ctan.org/topics/cloud/" >searching by topic</a> is
+very handy.
+</p><!--l. 167--><p class="indent" > You can also see the package documentation installed on your computer by typing
+<span class="obeylines-h"><span class="verb"><span
+class="ectt-1095x-x-97">texdoc</span><span
+class="ectt-1095x-x-97"> <packagename></span></span></span> in a terminal window.
+</p><!--l. 172--><p class="indent" > Before the list, one more note. If you are writing for a journal or institution that has its own package
+then of course you should use that. Look on their web page and on <span>CTAN</span>.
+<!-- class="mdugmr8t-">CTAN</span>. -->
+<a
+ id="x1-1001r1"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-20002"></a>Every document</h3>
+<!--l. 182--><p class="noindent" >To change page size, margins, and orientation, use <a
+href="https://ctan.org/pkg/geometry" ><span
+class="ectt-1095x-x-97">geometry</span></a>. Get multiple columns with <a
+href="https://ctan.org/pkg/multicol" ><span
+class="ectt-1095x-x-97">multicol</span></a>.
+</p><!--l. 186--><p class="indent" > Any document containing signi cant amounts of mathematics should use the American Mathematical
+Society's packages <a
+href="https://ctan.org/pkg/amsmath" ><span
+class="ectt-1095x-x-97">amsmath</span></a> and <a
+href="https://ctan.org/pkg/amssymb" ><span
+class="ectt-1095x-x-97">amssymb</span></a>. I also use <a
+href="https://ctan.org/pkg/amsthm" ><span
+class="ectt-1095x-x-97">amsthm</span></a> for producing theorem environments. Notes:
+(1) <a
+href="https://ctan.org/pkg/amssymb" ><span
+class="ectt-1095x-x-97">amssymb</span></a> inputs <a
+href="https://ctan.org/pkg/amsfonts" ><span
+class="ectt-1095x-x-97">amsfonts</span></a> so you don't need to load the latter, (2) many authors also use
+the caligraphic characters in <a
+href="https://ctan.org/pkg/rfsf" ><span
+class="ectt-1095x-x-97">rfsf</span></a>, (3) get bold math symbols with <a
+href="https://ctan.org/pkg/bm" ><span
+class="ectt-1095x-x-97">bm</span></a>, (4) load <span
+class="ectt-1095x-x-97">amsthm </span>after
+<span
+class="ectt-1095x-x-97">amsmath</span>, and (5) don't load <span
+class="ectt-1095x-x-97">amsmath </span>directly, instead get it by loading <a
+href="https://ctan.org/pkg/mathtools" ><span
+class="ectt-1095x-x-97">mathtools</span></a> for some useful
+improvements.
+</p><!--l. 201--><p class="indent" > You can toss in <a
+href="https://ctan.org/pkg/microtype" ><span
+class="ectt-1095x-x-97">microtype</span></a>. My eye can't spot the improvements but I appreciate that it means there are
+fewer awkward lines.
+<a
+ id="x1-2001r2"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-30003"></a>Inside a document</h3>
+<!--l. 209--><p class="noindent" >To tweak lists, use <a
+href="https://ctan.org/pkg/enumitem" ><span
+class="ectt-1095x-x-97">enumitem</span></a>.
+
+
+</p><!--l. 211--><p class="indent" > Enhance captions with <a
+href="https://ctan.org/pkg/caption" ><span
+class="ectt-1095x-x-97">caption</span></a> and control floating environments with <a
+href="https://ctan.org/pkg/float" ><span
+class="ectt-1095x-x-97">float</span></a>. (In particular, this
+package provides the option ‘<span
+class="ectt-1095x-x-97">H</span>’ to override automatic float placement and put something exactly where
+you ask.)
+</p><!--l. 219--><p class="indent" > Get hyperlinks and turn references into links with <a
+href="https://ctan.org/pkg/hyperref" ><span
+class="ectt-1095x-x-97">hyperref</span></a> (this should be the last or next to last
+package that you load). Make cross-references say ‘Theorem 1.2’ instead of just ‘1.2’ with the
+one-r-ed <a
+href="https://ctan.org/pkg/cleveref" ><span
+class="ectt-1095x-x-97">cleveref</span></a> (load it after <span
+class="ectt-1095x-x-97">hyperref</span>). Have <span>URL</span>'s
+ <!-- class="mdugmr8t-">URL</span>'s -->
+and file paths that can linebreak with
+<a
+href="https://ctan.org/pkg/url" ><span
+class="ectt-1095x-x-97">url</span></a>. (If you use <span
+class="ectt-1095x-x-97">hyperref </span>then note that it has its own commands for the <span
+class="ectt-1095x-x-97">cleveref </span>and <span
+class="ectt-1095x-x-97">url</span>
+functions.)
+</p><!--l. 231--><p class="indent" > I do code listings with <a
+href="https://ctan.org/pkg/listings" ><span
+class="ectt-1095x-x-97">listings</span></a>, although <a
+href="https://ctan.org/pkg/minted" ><span
+class="ectt-1095x-x-97">minted</span></a> is also great. Make single quotes inside verbatim
+text come out correctly with <a
+href="https://ctan.org/pkg/upquote" ><span
+class="ectt-1095x-x-97">upquote</span></a>.
+</p><!--l. 237--><p class="indent" > (A tangent: copy and paste for computer code listings would be especially convenient. This is a start
+for the <span
+class="ectt-1095x-x-97">listings </span>package. </p><!--l. 240-->
+ <div class="lstlisting" id="listing-1"><span class="label"><a
+ id="x1-3001r1"></a></span><span
+class="ectt-1000x-x-97">\</span><span
+class="ectt-1000x-x-97">lstset</span><span
+class="ectt-1000x-x-97">{</span><span
+class="ectt-1000x-x-97">basicstyle</span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97">=</span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97">\</span><span
+class="ectt-1000x-x-97">ttfamily</span><span
+class="ectt-1000x-x-97">,</span><span
+class="ectt-1000x-x-97"> </span><br /><span class="label"><a
+ id="x1-3002r2"></a></span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97">keepspaces</span><span
+class="ectt-1000x-x-97">=</span><span
+class="ectt-1000x-x-97">true</span><span
+class="ectt-1000x-x-97">,</span><span
+class="ectt-1000x-x-97"> </span><br /><span class="label"><a
+ id="x1-3003r3"></a></span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97"> </span><span
+class="ectt-1000x-x-97">columns</span><span
+class="ectt-1000x-x-97">=</span><span
+class="ectt-1000x-x-97">fullflexible</span><span
+class="ectt-1000x-x-97">}</span>
+
+ </div>
+ <!--l. 245--><p class="indent" > But it is not a full solution.
+The results depend on the
+<span>PDF </span>
+<!-- <span class="mdugmr8t-">PDF </span> -->
+viewer and worse, if your code line begins
+with blank spaces then after copy and paste those spaces are gone.)
+</p><!--l. 250--><p class="indent" > If you use Python, <a
+href="https://ctan.org/pkg/pythontex" ><span
+class="ectt-1095x-x-97">pythontex</span></a> will show code listings, but it also allows you to execute Python and put
+the results in your output. Do the same for the <span
+class="mdugmri8t-x-x-109">Sage </span>mathematics software with <a
+href="https://ctan.org/pkg/sagetex" ><span
+class="ectt-1095x-x-97">sagetex</span></a>, and similar
+systems exist for R, Haskell, and Scheme.
+</p><!--l. 258--><p class="indent" > There are many package that add table capabilities such as multirow entries and breaking across pages. I
+most often use <a
+href="https://ctan.org/pkg/array" ><span
+class="ectt-1095x-x-97">array</span></a>, which lets you define your own column types. To handle units, use <a
+href="https://ctan.org/pkg/siunitx" ><span
+class="ectt-1095x-x-97">siunitx</span></a> (which
+also has a table column type for aligning on a decimal point).
+</p><!--l. 266--><p class="indent" > Make boxes that are colored or framed, such as boxes for theorems, with <a
+href="https://ctan.org/pkg/tcolorbox" ><span
+class="ectt-1095x-x-97">tcolorbox</span></a>.
+<a
+ id="x1-3004r3"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-40004"></a>Graphics and color</h3>
+<!--l. 277--><p class="noindent" >To include graphics and do simple manipulations such as resizing, use <a
+href="https://ctan.org/pkg/graphicx" ><span
+ class="ectt-1095x-x-97">graphicx</span></a>.
+Use the
+<span>JPG </span>
+<!-- <span class="mdugmr8t-">JPG </span> -->
+ format for
+photos, <span
+ >PNG </span>
+ <!-- class="mdugmr8t-">PNG </span> -->
+ for other kinds of raster graphics, and
+ <span
+ >PDF </span>
+ <!-- class="mdugmr8t-">PDF </span> -->
+for vector graphics. If your graphic is in another
+format then convert it to one of these three. (Usually you give the file name without the extension, as with
+<span class="obeylines-h"><span class="verb"><span
+class="ectt-1095x-x-97">\includegraphics{graph}</span></span></span>.) Include parts of a <span
+class="mdugmr8t-">PDF </span>document with <a
+href="https://ctan.org/pkg/pdfpages" ><span
+class="ectt-1095x-x-97">pdfpages</span></a>. Include video or sound
+using <a
+href="https://ctan.org/pkg/media9" ><span
+class="ectt-1095x-x-97">media9</span></a>.
+</p><!--l. 290--><p class="indent" > For colors, use <a
+href="https://ctan.org/pkg/xcolor" ><span
+class="ectt-1095x-x-97">xcolor</span></a> (although the documentation can be hard to make out).
+</p><!--l. 294--><p class="indent" > To make plots and graphics, I use <a
+href="https://asymptote.sourceforge.io/" ><i>Asymptote</i></a>, a development of <span
+class="logo-10x-x-109">METAPOST </span>with three
+dimensional constructs. However, many people instead draw graphics inside the document with
+<a
+href="https://ctan.org/pkg/pgf" >Ti<i>k</i>Z</a>.
+<a
+ id="x1-4001r4"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-50005"></a>Front and back matter, headers, footers</h3>
+<!--l. 304--><p class="noindent" >To style chapter and section titles, use <a
+href="https://ctan.org/pkg/titlesec" ><span
+class="ectt-1095x-x-97">titlesec</span></a>. For page headers and footers, reach for <a
+href="https://ctan.org/pkg/fancyhdr" ><span
+class="ectt-1095x-x-97">fancyhdr</span></a>. You
+can tweak the format of tables of contents, lists of figures, etc., with <a
+href="https://ctan.org/pkg/tocloft" ><span
+class="ectt-1095x-x-97">tocloft</span></a>.
+</p><!--l. 312--><p class="indent" > Write exercise answers to an external file so that you can read them in later with <a
+href="https://ctan.org/pkg/answers" ><span
+class="ectt-1095x-x-97">answers</span></a>. I like
+
+
+footnotes at the page bottom so I use <a
+href="https://ctan.org/pkg/footmisc" ><span
+class="ectt-1095x-x-97">footmisc</span></a> (but I had to hack to change the space between a footnote
+mark and the footnote). Make an index with <a
+href="https://ctan.org/pkg/makeindex" ><span
+class="ectt-1095x-x-97">makeindex</span></a>.
+</p><!--l. 322--><p class="indent" > Bibliographies are a thorny area. Often you have strict requirements, such as from the <a
+href="https://ctan.org/pkg/MLA" ><span>MLA</span></a>. <span>CTAN </span>is
+<!-- class="ectt-1095x-x-97">MLA</span></a>. <span
+ <!-- class="mdugmr8t-">CTAN </span>is -->
+ a
+big help here; check out the many styles for both <a
+href="https://ctan.org/topic/bibtex-sty" >B<span
+class="mdugmrfc8t-x-x-109">ib</span><span class="TEX">T<span
+class="E">E</span>X</span></a> and <a
+href="https://ctan.org/topic/biblatex" >B<span
+class="mdugmrfc8t-x-x-109">ib</span><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span></a>.
+<a
+ id="x1-5001r5"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-60006"></a>Special documents</h3>
+<!--l. 334--><p class="noindent" >Make exams and problem sets with the <a
+href="https://ctan.org/pkg/exam" ><span
+class="ectt-1095x-x-97">exam</span></a> class.
+</p><!--l. 337--><p class="indent" > There are many, many resume and CV packages. Start with <span>CTAN</span>'s
+ <!-- class="mdugmr8t-">CTAN</span>'s -->
+ <a
+href="https://ctan.org/topic/cv" ><span
+>cv</span></a> topic.
+<!-- class="mdugmri8t-x-x-109">cv</span></a> topic. -->
+</p><!--l. 341--><p class="indent" > To make presentations, use the <a
+href="https://ctan.org/pkg/beamer" ><span
+class="ectt-1095x-x-97">beamer</span></a> class. (But with this package you are entering another world,
+where many of the packages discussed here do not work. For example, section title styling happens via a
+completely different mechanism.)
+<a
+ id="x1-6001r6"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-70007"></a>Fonts and engines</h3>
+<!--l. 351--><p class="noindent" >To see options besides the default Computer Modern fonts, visit the <a
+href="https://www.tug.org/FontCatalogue/" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> Font Catalogue</a>, which
+includes copy and paste code to make each one work.
+</p><!--l. 356--><p class="indent" > Beyond that list, you can also use any font that your computer has (which usually works well only if
+your document does not have much mathematics). To convert <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> source to <span
+class="mdugmr8t-">PDF </span>there are three
+programs, called engines. Most people use pdf<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>. The X<span class="TEX"><span class="E"><span class="flip_H">E</span></span></span><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> engine and the Lua<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> engine
+can leverage the <a
+href="https://ctan.org/pkg/fontspec" ><span
+class="ectt-1095x-x-97">fontspec</span></a> package to use your system's fonts. (A word about the preprint site <span
+class="ectt-1095x-x-97">arXiv.org</span>.
+If your document was produced with X<span class="TEX"><span class="E"><span class="flip_H">E</span></span></span><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> or Lua<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> then you can only submit a <span
+>PDF</span>, not the
+<!-- class="mdugmr8t-">PDF</span>, not the -->
+document source.)
+</p><!--l. 369--><p class="indent" > <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> now defaults to UTF-8 encoded input on all three engines. Use <a
+href="https://ctan.org/pkg/babel" ><span
+class="ectt-1095x-x-97">babel</span></a> for internationalization,
+such as changing the the title of the abstract or the bibliography.
+</p><!--l. 374--><p class="noindent" >____________________________________________________________________________________
+<a
+ id="x1-7001r7"></a>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-80008"></a>Feedback?</h3>
+<!--l. 377--><p class="noindent" >Contact me via <a
+href="https://hefferon.net" ><span
+class="ectt-1095x-x-97">hefferon.net</span></a>. (This version is from 2020-Nov-11.)
+</p>
+ <!-- </div> -->
+
+</body>
+</html>
+
+
+
Property changes on: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.html
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf 2020-11-12 21:43:57 UTC (rev 56918)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf 2020-11-12 21:44:40 UTC (rev 56919)
Property changes on: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.tex 2020-11-12 21:44:40 UTC (rev 56919)
@@ -0,0 +1,384 @@
+\documentclass[11pt]{article}
+% \usepackage[utf8]{inputenc}
+\usepackage[urw-garamond]{mathdesign}
+\usepackage[T1]{fontenc}
+
+\usepackage[margin=1.2in]{geometry}
+\usepackage{multicol}
+\setlength{\columnsep}{2em}
+
+\usepackage{graphicx} % needed for \XeLaTeX command
+\usepackage{listings}
+\lstset{basicstyle = \small\ttfamily,
+ keepspaces=true,
+ columns=fullflexible,
+ xleftmargin=10pt}
+
+% Get ISO dates
+\usepackage[style=iso]{datetime2}
+
+% Color for links
+\usepackage{xcolor}
+% Color theme from Rodryggo Sylva
+% https://color.adobe.com/explore?page=2
+\definecolor{darkblue}{HTML}{023059}
+\definecolor{lightblue}{HTML}{023E73}
+% \definecolor{papyrus}{HTML}{D9D8D7}
+\definecolor{papyrus}{HTML}{E4E4E4}
+\definecolor{darkred}{HTML}{BF1E0F}
+\definecolor{lightred}{HTML}{F24141}
+\pagecolor{papyrus}
+
+\usepackage{microtype}
+\usepackage[breaklinks,hidelinks,pdfa]{hyperref}
+\hypersetup{
+ colorlinks=true,
+ linkcolor=darkred,
+ filecolor=darkred,
+ urlcolor=darkred,
+}
+
+
+% ? This worked for a while and then it didn't, so I wrapped \url{..}
+\newcommand{\pkg}[1]{\href{https://ctan.org/pkg/#1}{\texttt{#1}}}
+
+% Logos and acronyms, some of them to match TUGboat commands
+\RequirePackage{mflogo} % for MetaPost \MP
+
+\newcommand\pdfLaTeX{pdf\LaTeX}
+\newcommand\PDFLaTeX{\pdfLaTeX}
+\newcommand\LuaLaTeX{Lua\LaTeX}
+\newcommand{\Asymptote}{\textit{Asymptote}} % as per the manual
+\newcommand{\TikZ}{Ti{\em k}Z} % from TUB
+
+% Stuff from ltugboat.cls
+\makeatletter
+\def\smc{\sc}
+\def\ninepoint{\small}
+\DeclareRobustCommand{\SMC}{%
+ \ifx\@currsize\normalsize\small\else
+ \ifx\@currsize\small\footnotesize\else
+ \ifx\@currsize\footnotesize\scriptsize\else
+ \ifx\@currsize\large\normalsize\else
+ \ifx\@currsize\Large\large\else
+ \ifx\@currsize\LARGE\Large\else
+ \ifx\@currsize\scriptsize\tiny\else
+ \ifx\@currsize\tiny\tiny\else
+ \ifx\@currsize\huge\LARGE\else
+ \ifx\@currsize\Huge\huge\else
+ \small\SMC at unknown@warning
+ \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
+}
+\newcommand{\SMC at unknown@warning}{\TBWarning{\string\SMC: nonstandard
+ text font size command -- using \string\small}}
+\newcommand{\textSMC}[1]{{\SMC #1}}
+\newcommand{\acro}[1]{\textSMC{#1}\@}
+
+\def\tubreflect#1{%
+ \@ifundefined{reflectbox}{%
+ \TBerror{A graphics package must be loaded for \string\XeTeX}%
+ }{%
+ \ifdim \fontdimen1\font>0pt
+ \raise 1.75ex \hbox{\kern.1em\rotatebox{180}{#1}}\kern-.1em
+ \else
+ \reflectbox{#1}%
+ \fi
+ }%
+}
+\def\tubhideheight#1{\setbox0=\hbox{#1}\ht0=0pt \dp0=0pt \box0 }
+\def\XekernbeforeE{-.125em}
+\def\XekernafterE{-.1667em}
+\DeclareRobustCommand{\Xe}{\leavevmode
+ \tubhideheight{\hbox{X%
+ \setbox0=\hbox{\TeX}\setbox1=\hbox{E}%
+ \lower\dp0\hbox{\raise\dp1\hbox{\kern\XekernbeforeE\tubreflect{E}}}%
+ \kern\XekernafterE}}}
+\def\XeTeX{\Xe\TeX}
+\def\XeLaTeX{\Xe{\kern.11em \LaTeX}}
+\makeatother
+
+\def\Bib{%
+ \ifdim \fontdimen1\font>0pt
+ B{\SMC\SMC IB}%
+ \else
+ B\textsc{ib}%
+ \fi
+}
+\def\BibLaTeX{\Bib\kern.02em \LaTeX}
+\def\BibTeX{\Bib\kern-.08em \TeX}
+
+\newcommand{\PDF}{\acro{PDF}}
+\newcommand{\CTAN}{\acro{CTAN}}
+\newcommand{\URL}{\acro{URL}}
+
+% Style I chopped out of ltugboat.cls
+\usepackage{dash}
+
+% Section title styling
+\usepackage{titlesec}
+\titleformat{\section}[hang]{\color{darkblue}\large\bf}{}{0pt}{}
+% \titlespacing{\section}{0pt}{2ex plus 0.1ex minus 0.05ex}{0.85ex plus 0.05ex}
+\titlespacing{\section}{0pt}{*2.0}{*0.85}
+
+% Give paras just a bit of room
+\setlength{\parskip}{0.45ex}
+
+
+\pagestyle{empty}
+\begin{document}\thispagestyle{empty}
+\begin{center}
+ {\color{darkblue}\Large\bf A First Set of \LaTeX\ Packages} \\[1.5ex]
+ {\color{darkblue}\large Jim Hef{}feron}
+\end{center}
+\vspace{1.5ex}
+
+\begin{multicols*}{2}
+If you are a \LaTeX{} beginner and ask,
+``How do I \ldots{}\,?''
+then often you will be told that there is a package for that.
+You may well next ask,
+``How would I know that?
+And if there is more than one package then which should I use?''
+
+This list covers most of what
+beginners want to do.
+Its goal is to cite one
+package in each area that is capable and reliable, and
+that is in
+% \textsf{Mac}\kern-0.35pt\TeX,
+Mac\kern-0.35pt\TeX,
+MiK\TeX, and \TeX\ Live.
+(There are some extra comments in parentheses that
+often come up along with the recommendations.)
+
+
+
+% ==============================
+\section{Introduction}
+For \LaTeX{} users, the canonical archive is
+the Comprehensive \TeX{} Archive Network,
+\href{https://ctan.org}{\color{darkblue}\CTAN}.
+It has the latest official versions of
+the packages in the distributions,
+with documentation.
+And, \href{https://ctan.org/topics/cloud}{\color{darkblue}searching by topic}
+is very handy.
+
+You can also see the package documentation installed on
+your computer by typing
+\verb!texdoc <packagename>! % space too wide?
+in a terminal window.
+
+Before the list, one more note.
+If you are writing for a journal or
+institution that has its own package then of course you should
+use that.
+Look on their web page and on \CTAN.
+
+
+
+% ===================================
+\section{Every document}
+To change page size, margins, and orientation, use
+\pkg{geometry}.
+Get multiple columns with \pkg{multicol}.
+
+Any document containing significant amounts of mathematics should use
+the American Mathematical Society's packages
+\pkg{amsmath}
+and
+\pkg{amssymb}.
+I also use \pkg{amsthm}
+for producing theorem environments.
+Notes: (1)~\pkg{amssymb} inputs \pkg{amsfonts} so you don't need to load
+the latter,
+(2)~many authors also use the caligraphic characters in \pkg{rfsf},
+(3)~get bold math symbols with \pkg{bm},
+(4)~load \texttt{amsthm} after \texttt{amsmath},
+and (5)~don't load \texttt{amsmath} directly, instead get it by loading
+\pkg{mathtools} for some useful improvements.
+
+You can toss in
+\pkg{microtype}.
+My eye can't spot the improvements but I appreciate that
+it means there are fewer awkward lines.
+
+
+% ===================================
+\section{Inside a document}
+To tweak lists, use \pkg{enumitem}.
+
+Enhance captions with
+\pkg{caption}
+and control floating environments with
+\pkg{float}.
+(In particular, this package provides the option `\texttt{H}'
+to override automatic float placement and put something
+exactly where you ask.)
+
+Get hyperlinks and turn references into links with
+\pkg{hyperref}
+(this should be the last or next to last package
+that you load).
+Make cross-references say `Theorem~1.2' instead of just `1.2'
+with the one-r-ed \pkg{cleveref}
+(load it after \texttt{hyperref}).
+Have \acro{URL}'s and file paths that can linebreak with
+\pkg{url}.
+(If you use \texttt{hyperref} then note that it has its own
+commands for the \texttt{cleveref} and \texttt{url} functions.)
+
+I do code listings with
+\pkg{listings},
+although \pkg{minted} is also great.
+Make single quotes inside verbatim text come out correctly with
+\pkg{upquote}.
+
+(A tangent:~copy and paste for computer code listings would be especially
+convenient.
+This is a start for the \texttt{listings} package.
+\begin{lstlisting}
+\lstset{basicstyle = \ttfamily,
+ keepspaces=true,
+ columns=fullflexible}
+\end{lstlisting}
+But it is not a full solution.
+The results depend on the \PDF{} viewer and
+worse, if your code line begins with
+blank spaces then after copy and paste those spaces are gone.)
+
+If you use Python,
+\pkg{pythontex}
+will show code listings, but it also allows you to execute
+Python and put the results in your output.
+Do the same for
+the \textit{Sage} mathematics software with \pkg{sagetex},
+and similar systems exist for R, Haskell, and Scheme.
+
+There are many package that add table capabilities such as
+multirow entries and breaking across pages.
+I most often use \pkg{array}, which lets you define your own column
+types.
+To handle units,
+use \pkg{siunitx}
+(which also has a table column type for aligning on a decimal point).
+
+Make boxes that are colored or framed, such as boxes for theorems,
+with
+\pkg{tcolorbox}.
+
+% Finally, when developing a document I often want some filler text.
+% I use
+% \pkg{lipsum}.
+
+
+% ===================================
+\section{Graphics and color}
+To include graphics and do simple manipulations such as resizing,
+use \pkg{graphicx}.
+Use the \acro{JPG} format for photos,
+\acro{PNG} for other kinds of raster graphics,
+and \PDF{} for vector graphics.
+If your graphic is in another format then convert it to one of these three.
+(Usually you give the file name without the extension,
+as with \verb!\includegraphics{graph}!.)
+Include parts of a \PDF{} document with
+\pkg{pdfpages}.
+Include video or sound using
+\pkg{media9}.
+
+For colors, use
+\pkg{xcolor}
+(although the documentation can be hard to make out).
+
+To make plots and graphics, I use
+\href{https://asymptote.sourceforge.io/}{\Asymptote{}},
+a development of \MP{} with three dimensional
+constructs.
+However, many people instead draw graphics
+inside the document with
+\href{https://ctan.org/pkg/pgf}{\TikZ}.
+
+
+\section{Front and back matter, headers, footers}
+To style chapter and section titles, use
+\pkg{titlesec}.
+For page headers and footers, reach for
+\pkg{fancyhdr}.
+You can tweak the format of tables of contents, lists of figures, etc.,
+with
+\pkg{tocloft}.
+
+Write exercise answers to an external file so that you can read them in
+later with
+\pkg{answers}.
+I like footnotes at the page bottom so I use
+\pkg{footmisc}
+(but I had to hack to change the space between a footnote mark and
+the footnote).
+Make an index with
+\pkg{makeindex}.
+
+Bibliographies are a thorny area.
+Often you have strict requirements, such as from the
+\pkg{MLA}.
+\CTAN{} is a big help here; check out the many styles for both
+\href{https://ctan.org/topic/bibtex-sty}{\BibTeX}
+and
+\href{https://ctan.org/topic/biblatex}{\BibLaTeX}.
+
+
+
+
+\section{Special documents}
+Make exams and problem sets with the
+\pkg{exam} class.
+
+There are many, many resume and CV packages.
+Start with \acro{CTAN}'s
+\href{https://ctan.org/topic/cv}{\textit{cv}} topic.
+
+To make presentations, use the
+\pkg{beamer} class.
+(But with this package you are entering another world, where many of the
+packages discussed here do not work.
+For example, section title styling happens via a completely
+different mechanism.)
+
+
+
+\section{Fonts and engines}
+To see options besides the default Computer Modern fonts,
+visit the
+\href{https://www.tug.org/FontCatalogue/}{\LaTeX\ Font Catalogue},
+which includes copy and paste code to make each one work.
+
+Beyond that list, you can also use any font that your computer has
+(which usually works well only if your document
+does not have much mathematics).
+To convert \LaTeX{} source to \PDF{} there are
+three programs, called engines.
+Most people use \PDFLaTeX.
+The \XeLaTeX{} engine and the \LuaLaTeX{} engine can leverage
+the \pkg{fontspec}
+package to use your system's fonts.
+(A word about the preprint site \texttt{arXiv.org}.
+If your document was produced with \XeLaTeX{} or \LuaLaTeX{} then
+you can only submit a \PDF, not the document source.)
+
+\LaTeX{} now defaults to UTF-8 encoded input on all three engines.
+Use \pkg{babel} for internationalization, such as changing the
+the title of the abstract or the bibliography.
+
+\vspace*{2ex}
+\noindent{\color{lightblue}\rule{\linewidth}{0.4pt}}
+
+\section{Feedback?}
+Contact me via
+\href{https://hefferon.net}{\color{lightblue}\texttt{hefferon.net}}.
+(This version is from \today.)
+% The source is at
+% \href{https://gitlab.com/jim.hefferon/latexpackages}{\color{lightblue}my GitLab repository}.)
+\end{multicols*}
+
+\end{document}
Property changes on: trunk/Master/texmf-dist/doc/latex/first-packages/first-packages.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check 2020-11-12 21:43:57 UTC (rev 56918)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check 2020-11-12 21:44:40 UTC (rev 56919)
@@ -304,7 +304,7 @@
fibeamer fifinddo-info fifo-stack fig4latex figbas figbib figflow figsize
filecontents filecontentsdef filedate filehook fileinfo filemod
findhyph fink finstrut fira firamath firamath-otf
- first-latex-doc firstaid fitbox fithesis
+ first-latex-doc first-packages firstaid fitbox fithesis
fix2col fixcmex fixfoot fixjfm fixlatvian fixltxhyph fixme fixmetodonotes
fixpdfmag fiziko
fjodor
Modified: trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc 2020-11-12 21:43:57 UTC (rev 56918)
+++ trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc 2020-11-12 21:44:40 UTC (rev 56919)
@@ -20,6 +20,7 @@
depend docsurvey
depend dtxtut
depend first-latex-doc
+depend first-packages
depend forest-quickstart
depend gentle
depend guide-to-latex
Added: trunk/Master/tlpkg/tlpsrc/first-packages.tlpsrc
===================================================================
More information about the tex-live-commits
mailing list.