summaryrefslogtreecommitdiff
path: root/info
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-01-03 03:02:33 +0000
committerNorbert Preining <norbert@preining.info>2021-01-03 03:02:33 +0000
commit1a272a3cba66aebe829cd28965c0e8acc8c44681 (patch)
tree21670ae655514a500b2123d9fb25a3cfb8ec4c76 /info
parent0b2ae1a0d39f8b9035311e4fd7745686b73c8393 (diff)
CTAN sync 202101030302
Diffstat (limited to 'info')
-rw-r--r--info/docsurvey/README.txt6
-rw-r--r--info/docsurvey/docsurvey.pdfbin292549 -> 319425 bytes
-rw-r--r--info/docsurvey/docsurvey.tex1859
-rw-r--r--info/first-packages/LICENSE5
-rw-r--r--info/first-packages/README22
-rw-r--r--info/first-packages/first-packages.htmlbin18104 -> 0 bytes
-rw-r--r--info/first-packages/first-packages.pdfbin135046 -> 0 bytes
-rw-r--r--info/first-packages/first-packages.tex384
-rw-r--r--info/latex-doc-ptr/LICENSE5
-rw-r--r--info/latex-doc-ptr/Makefile70
-rw-r--r--info/latex-doc-ptr/README36
-rw-r--r--info/latex-doc-ptr/dash.sty11
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.css (renamed from info/first-packages/first-packages.css)54
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.css.replacement148
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.html778
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.pdfbin153456 -> 169323 bytes
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.sty263
-rw-r--r--info/latex-doc-ptr/latex-doc-ptr.tex637
-rw-r--r--info/latex-doc-ptr/massage_html.awk27
19 files changed, 3191 insertions, 1114 deletions
diff --git a/info/docsurvey/README.txt b/info/docsurvey/README.txt
index 035ee112e7..4def82149e 100644
--- a/info/docsurvey/README.txt
+++ b/info/docsurvey/README.txt
@@ -4,8 +4,8 @@ The LaTeX docsurvey package
Provides the document
"Programming LaTeX — A survey of documentation and packages"
-2020/12/14
-Copyright 2017-2020 Brian Dunn — www.BDTechConcepts.com
+2021/01/02
+Copyright 2017-2021 Brian Dunn — www.BDTechConcepts.com
LaTeX Project Public License, version 1.3
@@ -23,7 +23,7 @@ and information on creating packages and documentation.
Files:
README.txt, docsurvey.pdf, docsurvey.tex
-docsurvey.bib is generated when docsurvey.tex is compiled.
+docsurvey.bib and docsurvey.bbx are generated when docsurvey.tex is compiled.
---
diff --git a/info/docsurvey/docsurvey.pdf b/info/docsurvey/docsurvey.pdf
index 7244da15c9..1f85590e31 100644
--- a/info/docsurvey/docsurvey.pdf
+++ b/info/docsurvey/docsurvey.pdf
Binary files differ
diff --git a/info/docsurvey/docsurvey.tex b/info/docsurvey/docsurvey.tex
index fb5a1e1995..5c8f2c8088 100644
--- a/info/docsurvey/docsurvey.tex
+++ b/info/docsurvey/docsurvey.tex
@@ -6,32 +6,48 @@
% lualatex docsurvey.tex
% lualatex docsurvey.tex
+
+\documentclass{article}
+
+
+
+
\begin{filecontents}[overwrite]{docsurvey.bib}
@book{lamport:latex,
title={\LaTeX: A Document Preparation System},
author={Leslie Lamport},
edition=2,
- publisher={Addison Wesley},
+ publisher={Addison Wesley Professional},
year=1994,
- isbn=0201529831,
+ pagetotal=272,
+ isbn={0-201-52983-1},
+ url={https://www.pearson.com/us/higher-education/program/Lamport-La-Te-X-A-Document-Preparation-System-2nd-Edition/PGM159713.html},
+ annotation={The classic introduction to \LaTeX, in continuous reprint for
+ decades.},
}
@book{hokpkadaly:guide,
title={Guide to \LaTeX},
author={Helmut Kopka and Patrick W. Daly},
edition=4,
- publisher={Addison-Wesley},
+ publisher={Addison-Wesley Professional},
year=2004,
- isbn=0321173856,
+ pagetotal=597,
+ isbn={0-321-17385-6},
+ url={https://www.pearson.com/us/higher-education/program/Kopka-Guide-to-La-Te-X-4th-Edition/PGM156755.html},
+ annotation={An introduction and more advanced material, including an extensive
+ reference guide.},
}
@book{gratzer:moremath,
title={More Math Into \LaTeX},
- author={George Gr\"{a}tzer},
+ author={George Grätzer},
edition=5,
publisher={Springer},
year=2016,
- isbn=9783319237954,
+ isbn={978-3-319-23795-4},
+ url={https://www.springer.com/gp/book/9783319237954},
+ annotation={Updated edition.},
}
@book{kottwitz:beginner,
@@ -40,6 +56,8 @@
publisher={Packt Publishing},
year=2011,
isbn=1847199860,
+ url={https://www.packtpub.com/product/latex-beginner-s-guide/9781847199867},
+ annotation={An overview with numerous examples.},
}
@book{kottwitz:cookbook,
@@ -47,8 +65,9 @@
author={Stefan Kottwitz},
publisher={Packt Publishing},
year=2015,
- isbn=9781784395148,
- url={http://latex-cookbook.net}
+ isbn={978-1-784-39514-8},
+ url={http://latex-cookbook.net},
+ annotation={More examples.},
}
@book{mittelbachgossens:companion,
@@ -58,7 +77,38 @@
edition=2,
publisher={Addison-Wesley},
year=2004,
- isbn=0201362996,
+ pagetotal=1090,
+ isbn={0-201-36299-6},
+ url={http://www.informit.com/store/latex-companion-9780133387667},
+ annotation={Provides extended discussion and examples of the inner workings
+ of \LaTeX\ and numerous useful packages.},
+}
+
+@book{voss:typesettingmath,
+ title={Typesetting Mathematics with \LaTeX},
+ author={Herbert Voß},
+ publisher={UIT Cambridge},
+ year=2010,
+ url={https://www.uit.co.uk/typesetting-mathematics-with-latex},
+ isbn={978-1-906-86017-2},
+}
+
+@book{voss:typesettingtables,
+ title={Typesetting Tables with \LaTeX},
+ author={Herbert Voß},
+ publisher={UIT Cambridge},
+ year=2011,
+ url={https://www.uit.co.uk/typesetting-tables-with-latex},
+ isbn={978-1-906-86025-7},
+}
+
+@book{voss:pstricks,
+ title={PSTricks: Graphics and PostScript for \TeX\ and \LaTeX},
+ author={Herbert Voß},
+ publisher={UIT Cambridge},
+ year=2011,
+ url={https://www.uit.co.uk/pstricks},
+ isbn={978-1-906-86013-4},
}
@book{eijkhout:topic,
@@ -67,22 +117,146 @@
author={Victor Eijkhout},
publisher={Addison-Wesley UK},
year=1991,
- isbn=0201568829,
- url={http://eijkhout.net/texbytopic/texbytopic.html}
+ pagetotal=317,
+ isbn={0-201-56882-9},
+ url={http://eijkhout.net/texbytopic/texbytopic.html},
+ texdoc={texbytopic},
+ annotation={A reference for \TeX.
+ This may be useful for understanding the source code of \LaTeX\ packages,
+ many of which are quite old and written in
+ low-level \TeX.},
+}
+
+@book{abrahams:impatient,
+ title={\TeX\ for the Impatient},
+ author={Paul W. Abrahams and Kathryn A. Hargreaves and Karl Berry},
+ year=2020,
+ pagetotal=393,
+ url={https://ctan.org/pkg/impatient},
+ texdoc={impatient},
+ annotation={A tutorial and reference for \TeX, plain \TeX, and Eplain.
+ Also available in French and Chinese.\newline},
+}
+
+@book{abrahams:impatient-cn,
+ title={\TeX {\setmainfont{FandolFang} 急就帖}},
+ author={Paul W. Abrahams and Kathryn A. Hargreaves and Karl Berry},
+ year=2014,
+ pagetotal=429,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/impatient},
+ annotation={A tutorial and reference for \TeX, plain \TeX, and Eplain.},
+ texdoc={impatient-cn},
+}
+
+@book{doob:gentle,
+ title={A Gentle Introduction to \TeX},
+ subtitle={A Manual for Self-study},
+ author={Michael Doob},
+ year=2002,
+ pagetotal=97,
+ url={https://ctan.org/pkg/gentle},
+ annotation={A comprehensive tutorial on plain \TeX.},
+ texdoc={gentle},
+}
+
+@book{wilkins:started,
+ title={Getting Started with Plain \TeX},
+ author={D. R. Wilkins},
+ year=1994,
+ pagetotal=40,
+ url={http://www.ntg.nl/doc/wilkins/pllong.pdf},
+}
+
+@book{huang:notes,
+ title={\LaTeX\ Notes v 1.20},
+ author={Alpha Huang},
+ year=2008,
+ pagetotal=107,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/latex-notes-zh-cn},
+ annotation={An introduction to \TeX\ and \LaTeX, including the use
+ of Chinese fonts.},
+ texdoc={latex-notes},
+}
+
+@online{ctex-faq,
+ title={CTEXFAQ ({\setmainfont{FandolFang} 常见问题集})},
+ author={{\setmainfont{FandolFang}吴凌云}},
+ year=2007,
+ pagetotal=41,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/ctex-faq},
+ annotation={\FAQ\ from the Chinese \TeX\ Society.},
+ texdoc={ctex-faq},
+}
+
+@book{wang:install,
+ title={{\setmainfont{FandolFang}一份简短的关于} \LaTeX {\setmainfont{FandolFang}安装的介绍}},
+ author={{\setmainfont{FandolFang}王然}},
+ year=2020,
+ pagetotal=49,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/install-latex-guide-zh-cn},
+ annotation={Installing \LaTeX\ and compiling documents, using various
+ operating systems.},
+ texdoc={install-latex-guide-zh-cn},
+}
+
+@misc{asymptote-example-cn,
+ title={Asymptote {\setmainfont{FandolFang}范例教程}},
+ author={{\setmainfont{FandolFang}刘海洋}},
+ year=2009,
+ pagetotal=51,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/asymptote-by-example-zh-cn},
+ annotation={A tutorial for \pkg{asymptote} in the form of a graphical \FAQ.},
+ texdoc={asymptote-by-example-zh-cn},
+}
+
+@book{asymptote-faq-cn,
+ title={Asymptote {\setmainfont{FandolFang}中的常见问题} (FAQ)},
+ author={{\setmainfont{FandolFang}译者}},
+ year=2009,
+ pagetotal=26,
+ langid={Chinese},
+ language={Chinese},
+ url={https://ctan.org/pkg/asymptote-faq-zh-cn},
+ annotation={A translation of the Asymptote \FAQ},
+ texdoc={asymptote-faq-zh-cn},
+}
+
+@book{abrahams:impatient-fr,
+ title={TEX pour l’Impatient},
+ author={Paul W. Abrahams and Kathryn A. Hargreaves and Karl Berry},
+ year=2004,
+ pagetotal=407,
+ langid={french},
+ language={french},
+ url={https://ctan.org/pkg/impatient},
+ annotation={A tutorial and reference for \TeX, plain \TeX, and Eplain.},
+ texdoc={impatient-fr},
}
@manual{hefferon:first,
title={Getting something out of \LaTeX},
author={Jim Hefferon},
year=2009,
- url={https://ctan.org/pkg/first-latex-doc}
+ url={https://ctan.org/pkg/first-latex-doc},
+ annotation={Create your first document in \LaTeX.},
}
@manual{flynn:veryshort,
title={The very short guide to typesetting with \LaTeX},
author={Peter Flynn},
year=2016,
- url={https://ctan.org/pkg/latex-veryshortguide}
+ url={https://ctan.org/pkg/latex-veryshortguide},
+ annotation={A four-page introduction.},
}
@manual{flynn:formatting,
@@ -90,64 +264,93 @@
typesetting with \LaTeX},
author={Peter Flynn},
year=2005,
- url={https://ctan.org/pkg/beginlatex}
+ url={https://ctan.org/pkg/beginlatex},
+ annotation={A beginner’s introduction to typesetting with \LaTeX.}
}
@manual{talbot:novices,
title={\LaTeX\ for Complete Novices},
author={Nicola L. C. Talbot},
year=2012,
+ pagetotal=279,
publisher={Dickimaw Books},
- url={http://www.dickimaw-books.com}
+ url={http://www.dickimaw-books.com},
+ texdoc={dickimaw-novices},
+ annotation={An extensive introduction for a non-technical person.},
}
@manual{talbot:phd,
title={Using \LaTeX\ to Write a PhD Thesis},
author={Nicola L. C. Talbot},
year=2013,
+ pagetotal=146,
publisher={Dickimaw Books},
- url={http://www.dickimaw-books.com}
+ url={http://www.dickimaw-books.com},
+ texdoc={dickimaw-thesis},
+ annotation={A followup to \pub{\LaTeX\ for Complete Novices}, including extensive
+ discussion about bibliographies, indexes, and glossaries.},
}
@manual{morris:gettingstarted,
title={Getting Started with \LaTeXe},
author={Michael P. Morris},
year=2020,
- url={https://ctan.org/pkg/startlatex2e}
+ pagetotal=33,
+ url={https://ctan.org/pkg/startlatex2e},
+ annotation={A beginner's bare-bones overview.},
+ texdoc={startlatex2e},
}
@manual{Bennieston:scientific,
title={Writing Scientific Documents Using \LaTeX},
author={Andrew J. Bennieston},
year=2009,
- url={https://ctan.org/pkg/intro-scientific}
+ url={https://ctan.org/pkg/intro-scientific},
+ annotation={An introduction to typesetting scientific documents.},
}
@manual{oetiker:introduction,
title={The Not So Short Introduction to \LaTeXe},
author={Tobias Oetiker},
year=2015,
- url={https://ctan.org/pkg/lshort}
+ pagetotal=153,
+ language={Numerous languages},
+ url={https://ctan.org/pkg/lshort},
+ annotation={Covers introductory material, customizations,
+ and a simple package.},
+ texdoc={-l lshort},
}
@manual{greenwade:reference,
title={\LaTeXe: An unofficial reference manual},
author={George~D. Greenwade and Stephen Gilmore and Torsten~Martinsen and Karl Berry},
- url={https://latexref.xyz}
+ url={https://latexref.xyz},
+ pagetotal=246,
+ language={English, French, Spanish},
+ annotation={A thorough but concise reference manual for \LaTeXe,
+ available in several languages.\\\nopunct},
+ texdoc={-l latex2e-help},
}
@manual{latex:authors,
title={\LaTeXe\ for authors},
- author={\LaTeX3 Project Team},
+ author={{\LaTeX3 Project Team}},
year=2020,
- url={https://ctan.org/pkg/usrguide}
+ pagetotal=31,
+ url={https://ctan.org/pkg/usrguide},
+ annotation={An overview of the new features of \LaTeXe\ compared to \LaTeX 2.09.},
+ texdoc={usrguide},
}
@manual{downes:shortmath,
title={Short Math Guide for \LaTeX},
author={Michael Downes and Barbara Beeton},
year=2017,
- url={https://ctan.org/pkg/short-math-guide}
+ pagetotal=21,
+ url={https://ctan.org/pkg/short-math-guide},
+ annotation={A summary of features in \LaTeX\ and packages for writing
+ math formulas.},
+ texdoc={short-math-guide},
}
@article{voss:farbige,
@@ -155,93 +358,304 @@
journaltitle={TeXnische Komödie},
author={Herbert Voß},
year=2004,
- url={https://ctan.org/pkg/voss-mathcol}
+ pagetotal=7,
+ langid={german},
+ language={german},
+ url={https://ctan.org/pkg/voss-mathcol},
+ annotation={Math in color. In German, but with easy-to-use examples.},
+ texdoc={voss-mathcol},
+}
+
+@online{weissenburger:anleitung,
+ title={Anleitung},
+ author={Jens Weissenburger and Damir Rakityansky},
+ year=2003,
+ langid={german},
+ language={german},
+ url={https://ctan.org/pkg/anleitung},
+ annotation={Using \LaTeX, Mik\TeX, and TrueType fonts.},
}
@manual{Gonzato:musicians,
title={\LaTeX\ for Musicians},
author={Guido Gonzato},
year=2019,
- url={https://ctan.org/pkg/latex4musicians}
+ pagetotal=66,
+ url={https://ctan.org/pkg/latex4musicians},
+ annotation={Packages and programs for music symbols, lyrics, chord sheets,
+ sheet music, and guitar tablature.},
+ texdoc={latex4musicians},
}
@manual{pakin:list,
title={The Comprehensive \LaTeX\ Symbol List},
author={Scott Pakin},
year=2017,
- url={https://ctan.org/pkg/comprehensive}
+ pagetotal=348,
+ url={https://ctan.org/pkg/comprehensive},
+ annotation={More than 14,000 symbols and \LaTeX\ commands.},
+ texdoc={{symbols-letter \\ texdoc symbols-a4}},
+
}
@manual{robertson:mathsymbols,
title={Every symbol (most symbols) defined by unicode-math},
author={Will Robertson},
year=2018,
- url={https://ctan.org/pkg/unicode-math}
+ pagetotal=119,
+ url={https://ctan.org/pkg/unicode-math},
+ annotation={Unicode math symbols.},
+ texdoc={unimath-symbols},
+}
+
+@online{detexify,
+ title={Detexify},
+ url={http://detexify.kirelabs.org/classify.html},
+ annotation={Draw a symbol, and the website tells you which macros might
+ make that symbol.}
+}
+
+@online{shapecatcher,
+ title={shapecatcher},
+ url={http://shapecatcher.com/},
+ annotation={Draw a symbol, and the website tells you which Unicode
+ symbols it might be.}
}
@manual{latexteam:sources,
title={The \LaTeXe\ Sources},
author={Johannes Braams and David Carlisle and Alan Jeffrey and Leslie Lamport and
Frank Mittelbach and Chris Rowley and Rainer Sch\"opf},
- url={https://ctan.org/pkg/source2e}
+ url={https://ctan.org/pkg/source2e},
+ pagetotal=955,
+ annotation={Occasionally useful for figuring out how something really works.},
+ texdoc={source2e},
}
@manual{scharrer:listinternal,
title={List of internal \LaTeXe\ Macros useful to Package Authors},
author={Martin Scharrer},
- url={https://ctan.org/pkg/macros2e}
+ url={https://ctan.org/pkg/macros2e},
+ pagetotal=14,
+ annotation={A list of the core \LaTeX\ macros, each of which is linked to the
+ source code.},
+ texdoc={macros2e},
}
@online{TeX:FAQ,
title={\TeX\ FAQ},
- url={https://texfaq.org/}
+ url={https://texfaq.org/},
+ annotation={An online resource, which includes a detailed list of printed books.}
}
@manual{pakin:visual,
title={The Visual \LaTeX\ FAQ},
author={Scott Pakin},
- url={https://ctan.org/pkg/visualfaq}
+ pagetotal=33,
+ url={https://ctan.org/pkg/visualfaq},
+ annotation={Click on a visual element to learn how it is programmed.},
+ texdoc={visualFAQ},
+}
+
+@manual{casteleyn:pstricks,
+ title={Visual PSTricks},
+ author={Jean Pierre Casteleyn},
+ year=2016,
+ pagetotal=261,
+ language={English, French},
+ url={https://ctan.org/pkg/visualpstricks},
+ annotation={A visual \FAQ\ consisting of a small example for each effect.},
+ texdoc={-l visualpstricks},
+}
+
+@manual{casteleyn:tikz,
+ title={Visual TikZ},
+ author={Jean Pierre Casteleyn},
+ year=2018,
+ pagetotal=221,
+ language={English, French},
+ url={https://ctan.org/pkg/visualtikz},
+ annotation={A visual \FAQ\ consisting of a small example for each effect.},
+ texdoc={-l visualtikz},
+}
+
+
+@manual{lammarsch:cheat,
+ title={\LaTeX\ Cheat Sheet},
+ author={Marion Lammarsch},
+ year=2017,
+ pagetotal=4,
+ url={https://ctan.org/pkg/latex-refsheet},
+ annotation={A reference for \LaTeX\ with KOMA-Script.},
+ texdoc={latex-refsheet},
+}
+
+@manual{schlomer:cheat,
+ title={\TeX\ font errors: Cheatsheet},
+ author={Nico Schlömer},
+ year=2010,
+ pagetotal=3,
+ url={https://ctan.org/pkg/tex-font-errors-cheatsheet},
+ annotation={How \TeX\ integrates fonts, and related error messages.},
+ texdoc={tex-font-errors-cheatsheet},
+}
+
+@manual{chang:cheat,
+ title={\LaTeXe\ Cheat Sheet},
+ author={Winston Chang},
+ year=2006,
+ pagetotal=2,
+ url={https://ctan.org/pkg/latexcheat},
+ annotation={A quick-reference guide for \LaTeX\ and Bib\TeX.
+ Also in Brazilian Portuguese, German, Japanese, and Spanish.},
+ texdoc={latexcheat},
+}
+
+@manual{chang:cheat-de,
+ title={\LaTeXe Befehlsübersicht},
+ author={Winston Chang},
+ year=2006,
+ pagetotal=2,
+ langid={german},
+ language={german},
+ translator={Tammo Schwindt},
+ url={https://ctan.org/pkg/latexcheat-de},
+ annotation={A quick-reference guide for \LaTeX\ and Bib\TeX.},
+ texdoc={latexcheat-de},
+}
+
+@online{faq-de,
+ title={The DANTE \TeX\ Users Group Frequently Asked Questions},
+ langid={german},
+ language={german},
+ url={https://ctan.org/pkg/faq-de},
+}
+
+@manual{chang:cheat-esmx,
+ title={Acordeón para \LaTeXe},
+ author={Winston Chang},
+ year=2006,
+ pagetotal=2,
+ langid={spanish},
+ language={spanish},
+ translator={J. Luis Rivera},
+ url={https://ctan.org/pkg/latexcheat-esmx},
+ annotation={A quick-reference guide for \LaTeX\ and Bib\TeX.},
+ texdoc={latexcheat-esmx},
+}
+
+@manual{faq-es,
+ title={CervanTeX (Spanish TeX Group) FAQ},
+ langid={spanish},
+ language={spanish},
+ url={https://ctan.org/pkg/faq-es},
+ texdoc={es-tex-faq},
+}
+
+@manual{chang:cheat-ptbr,
+ title={Guia Rápido \LaTeXe},
+ author={Winston Chang},
+ year=2006,
+ pagetotal=2,
+ langid={brazilian},
+ language={brazilian},
+ translator={Silvio C. G. Granja},
+ url={https://ctan.org/pkg/latexcheat-ptbr},
+ annotation={A quick-reference guide for \LaTeX\ and Bib\TeX.},
+ texdoc={latexcheat-ptbr},
+}
+
+@manual{chang:platexcheat,
+ title={p\LaTeXe\ {\setmainfont{Harano Aji Mincho}チートシート}},
+ author={Winston Chang},
+ year=2006,
+ pagetotal=2,
+ langid={japanese},
+ language={japanese},
+ translator={Takuto Asakura},
+ url={https://ctan.org/pkg/platexcheat},
+ annotation={A quick-reference guide for \LaTeX\ and Bib\TeX.},
+ texdoc={platexcheat},
}
@manual{bouzigues:guide,
title={Initiation à \LaTeX},
subtitle={Pour débutants ou jeunes utilisateurs},
author={Adrien Bouzigues},
+ langid={french},
+ language={french},
year=2017,
- url={https://ctan.org/pkg/guide-latex-fr}
+ pagetotal=273,
+ url={https://ctan.org/pkg/guide-latex-fr},
+ annotation={A guide on \LaTeX\ — for beginners or advanced users.},
+}
+
+@book{rouquette:sciences,
+ title={\XeLaTeX — Appliqué Aux Sciences Humaines},
+ author={Maïeul Rouquette},
+ langid={french},
+ language={french},
+ year=2012,
+ pagetotal=268,
+ url={https://ctan.org/pkg/latex-sciences-humaines},
}
@manual{Goulet:Redaction,
title={Rédaction avec \LaTeX},
author={Vincent Goulet},
year=2020,
- url={https://ctan.org/pkg/formation-latex-ul}
+ pagetotal=196,
+ langid={french},
+ language={french},
+ url={https://ctan.org/pkg/formation-latex-ul},
+ annotation={An introductory course prepared for
+ Université Laval, Québec, Canada. \\\nopunct},
+ texdoc={{formation-latex-ul, texdoc formation-latex-ul-diapos}},
}
@manual{Holkar:polyglossia,
title={A practical guide to \LaTeX\ and polyglossia for Indian Languages},
author={Rohit Dilip Holkar},
year=2017,
- url={https://ctan.org/pkg/latex-mr}
+ pagetotal=37,
+ langid={marathi},
+ language={Marathi},
+ url={https://ctan.org/pkg/latex-mr},
+ texdoc={latex-mr},
}
@manual{massago:exemplos,
title={\LaTeXe\ Via Exemplos},
author={Sadao Massago},
year=2018,
- url={https://ctan.org/pkg/latex-via-exemplos}
+ pagetotal=264,
+ langid={brazilian},
+ language={brazilian},
+ url={https://ctan.org/pkg/latex-via-exemplos},
+ annotation={A study course.},
+}
+
+@online{texwikibook,
+ title={Wikibooks},
+ subtitle={TeX},
+ url={https://en.wikibooks.org/wiki/TeX},
+ annotation={An online book about low-level \TeX.},
}
@online{latexwikibook,
title={Wikibooks},
subtitle={LaTeX},
- url={https://en.wikibooks.org/wiki/LaTeX}
+ url={https://en.wikibooks.org/wiki/LaTeX},
+ annotation={An online book, includes information about
+ creating \LaTeX\ packages and classes.},
}
@online{ebookfoundation:free,
title={Free Programming Books},
author={Ebook Foundation},
- url={https://github.com/EbookFoundation/free-programming-books}
+ url={https://github.com/EbookFoundation/free-programming-books},
+ annotation={A variety of \TeX-related and other programming books
+ and documents.},
}
@book{wilson:design,
@@ -251,21 +665,32 @@
month=8,
publisher={The Herries Press},
edition=1,
- url={https://ctan.org/pkg/memdesign}
+ pagetotal=139,
+ url={https://ctan.org/pkg/memdesign},
+ annotation={More than 100 pages of discussion about book design and typography.},
+ texdoc={memdesign},
}
@manual{kohm:typearea,
title={KOMA-Script — The Guide},
author={Markus Kohm},
year=2018,
- url={https://ctan.org/pkg/koma-script}
+ pagetotal=565,
+ url={https://ctan.org/pkg/koma-script},
+ annotation={Documentation for the KOMA-Script package.
+ Also includes discussion about the page layout of a book.},
+ texdoc={typearea},
}
@manual{tufte:book,
title={A TUFTE-STYLE BOOK},
- author={The Tufte-LaTeX Developers},
+ author={{The Tufte-LaTeX Developers}},
year=2015,
- url={https://ctan.org/pkg/tufte-latex}
+ pagetotal=42,
+ url={https://ctan.org/pkg/tufte-latex},
+ annotation={Documentation for the Tufte-\LaTeX\ document classes.
+ Also includes layout ideas from the books of Edward R. Tufte.},
+ texdoc={tufte-latex},
}
@article{revets:octavo,
@@ -275,71 +700,106 @@
number={23 3/4},
year=2002,
pages={269},
- url={https://ctan.org/pkg/octavo}
+ url={https://ctan.org/pkg/octavo},
+ annotation={Design principles and guidelines emulating books
+ from the Renaissance.},
+ texdoc={octavo}
}
@manual{beccari:canoniclayout,
title={Package canoniclayout},
author={Claudio Beccari},
year=2011,
- url={https://ctan.org/pkg/canoniclayout}
+ pagetotal=8,
+ url={https://ctan.org/pkg/canoniclayout},
+ annotation={Documentation for the \pkg{canoniclayout} package.
+ Also includes ideas regarding text-block proportions.},
+ texdoc={canoniclayout},
}
@manual{fear:booktabs,
title={Publication-quality tables in \LaTeX},
author={Simon Fear},
year=2016,
- url={https://ctan.org/pkg/booktabs}
+ pagetotal=18,
+ url={https://ctan.org/pkg/booktabs},
+ annotation={Documents the \pkg{booktabs} package, and also includes
+ thoughts on the design of tabular layouts in general.},
+ texdoc={booktabs},
}
@manual{tantu:pgf,
title={The TikZ and PGF Packages},
author={Till Tantau},
year=2020,
- url={https://ctan.org/pkg/pgf}
+ pagetotal=1321,
+ url={https://ctan.org/pkg/pgf},
+ annotation={As well as documenting the packages, this manual also includes
+ ``General guidelines and principles concerning the creation of graphics
+ for scientific presentations, papers, and books''.},
+ texdoc={pgfmanual},
}
@online{texdocnet,
title={TeXdoc Online},
- url={http://texdoc.net}
+ url={http://texdoc.net},
+ annotation={An online version of \prog{texdoc},
+ with popular packages sorted by category.},
}
@online{ctan,
title={Comprehensive \TeX\ Archive Network},
shorttitle={CTAN},
- url={https://ctan.org}
-}
-
-@manual{hefferon:firstset,
- title={A First Set of \LaTeX\ Packages},
- author={Jim Hefferon},
- year=2020,
- url={https://ctan.org/pkg/first-packages}
+ url={https://ctan.org},
+ annotation={
+ The Comprehensive \TeX\ Archive Network (\CTAN) provides a master collection of
+ packages. A search function is available, which is useful when you know the
+ name of a package or its author, and a list of topics is also provided.
+ There are so many topics, however, that finding the right topic can be a
+ problem in itself. One useful method to find what you are looking for is
+ to search for a related package you may already know about, then look at
+ its description on \CTAN\ to see what topics are shown for it. Selecting these
+ topics then shows you related packages.
+ },
}
@manual{pakin:dtxtut,
title={How to Package Your \LaTeX\ Package},
author={Scott Pakin},
- url={https://ctan.org/pkg/dtxtut}
+ pagetotal=36,
+ url={https://ctan.org/pkg/dtxtut},
+ annotation={A tutorial.},
+ texdoc={dtxtut},
}
@manual{latexteam:class,
title={\LaTeXe\ for class and package writers},
- author={\LaTeX3 Project},
- url={https://ctan.org/pkg/clsguide}
+ author={{\LaTeX3 Project Team}},
+ pagetotal=33,
+ url={https://ctan.org/pkg/clsguide},
+ annotation={Programming a package or class.},
+ texdoc={clsguide},
}
@manual{mittelbach:doc,
title={The doc and shortvrb packages},
author={Frank Mittelbach},
- url={https://ctan.org/pkg/doc}
+ pagetotal=64,
+ url={https://ctan.org/pkg/doc},
+ annotation={Packages for documenting packages.},
+ texdoc={doc},
}
@manual{mittelbach:docstrip,
title={The DocStrip program},
author={Frank Mittelbach and Denys Duchier and Johannes Braams and
Marcin Woli\'nski and Mark Wooding},
- url={https://ctan.org/pkg/docstrip}
+ pagetotal=61,
+ url={https://ctan.org/pkg/docstrip},
+ annotation={The program which processes \filenm{.dtx}
+ and \filenm{.ins} files to generate documentation and \filenm{.sty}
+ files.\\\nopunct},
+ texdoc={docstrip},
}
@article{flynn:article,
@@ -350,18 +810,20 @@
number={28:1},
year=2007,
pages={110--123},
- url={http://tug.org/TUGboat/tb28-1/tb88flynn.pdf}
+ url={http://tug.org/TUGboat/tb28-1/tb88flynn.pdf},
+ annotation={An overview of the \pkg{article} class.},
}
@article{pakin:goodthings,
title={Good things come in little packages:
An introduction to writing \texttt{.ins} and \texttt{.dtx} files},
- author={Scott~Pakin},
+ author={Scott Pakin},
journaltitle={TUGboat},
number={29:2},
year=2008,
pages={305--314},
- url={http://tug.org/TUGboat/tb29-2/tb92pakin.pdf}
+ url={http://tug.org/TUGboat/tb29-2/tb92pakin.pdf},
+ annotation={How and why to create your own \filenm{.dtx} and \filenm{.ins} files.},
}
@article{mansfield:class,
@@ -371,96 +833,459 @@
number={29:3},
year=2008,
pages={356--361},
- url={http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf}
+ url={http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf},
+ annotation={A comparison of developing class vs.\ package files.},
}
@online{gutenberg:TeXniques,
title={TeXniques},
subtitle={Groupe francophone des Utilisateurs de TEX, \LaTeX\ et logiciels compagnons},
- url={https://www.gutenberg.eu.org/TeXniques}
+ langid={french},
+ language={french},
+ url={https://www.gutenberg.eu.org/TeXniques},
+ annotation={A collection of resources.},
+}
+
+@online{faq-fr,
+ title={French FAQ of the Gutenberg \TeX\ user group},
+ langid={french},
+ language={french},
+ translator={Marie-Paule Kluth},
+ url={https://ctan.org/pkg/faq-fr},
}
@book{lozano:everythingLaTeX,
title={Tout Ce Que Vous Avez Toujours Voulu Savoir Sur \LaTeX\ Sans Jamais Oser Le Demander},
author={Vincent Lozano},
year=2011,
- url={http://lozzone.free.fr/index.php?vlunch=latex}
+ pagetotal=271,
+ langid={french},
+ language={french},
+ url={http://lozzone.free.fr/index.php?vlunch=latex},
+ annotation={A book for beginners.},
}
@book{baudoin:learnLaTeX,
title={Apprends \LaTeX!},
author={Marc Baudoin},
year=2012,
- url={http://www.babafou.eu.org/Apprends_LaTeX}
+ pagetotal=222,
+ langid={french},
+ language={french},
+ url={http://www.babafou.eu.org/Apprends_LaTeX},
+ annotation={A full textbook written for
+ École Nationale Supérieure de Techniques Avancées.},
+}
+
+@book{tellechea:apprendre,
+ title={Apprendre à programmer en \TeX},
+ author={Christian Tellechea},
+ year=2014,
+ pagetotal=580,
+ langid={french},
+ language={french},
+ url={https://ctan.org/pkg/apprendre-a-programmer-en-tex},
+ annotation={Basic programming of \TeX, with examples.},
+ texdoc={apprendre},
+}
+
+@book{reckdahl:freps,
+ title={Utilisation de Graphiques Importés dans \LaTeX2},
+ author={Keith Reckdahl},
+ year=2001,
+ pagetotal=148,
+ langid={french},
+ language={french},
+ url={https://ctan.org/pkg/fepslatex},
+ annotation={How to import graphics in \LaTeXe.},
+ texdoc={fepslatex},
+}
+
+@book{reckdahl:eps,
+ title={Using Imported Graphics in \LaTeX\ and pdf\LaTeX},
+ author={Keith Reckdahl},
+ year=2006,
+ pagetotal=124,
+ url={https://ctan.org/pkg/epslatex},
}
@manual{amsmath,
title={User’s Guide for the amsmath Package},
- author={{American Mathematical Society} and {\LaTeX3 project}},
+ author={{American Mathematical Society} and {\LaTeX3 Project Team}},
year=2020,
- url={https://ctan.org/pkg/amsmath}
+ pagetotal=44,
+ url={https://ctan.org/pkg/amsmath},
+ annotation={How to use \pkg{amsmath}.
+ Also see \nameref{sec:international} for the Italian, Japanese,
+ and Vietnamese translations.},
+ texdoc={amsmath},
}
@manual{amsmath-it,
title={Manuale utente per il pacchetto amsmath},
- author={{American Mathematical Society} and {\LaTeX3 project}},
+ author={{American Mathematical Society} and {\LaTeX3 Project Team}},
+ year=1999,
+ pagetotal=39,
+ langid={italian},
+ language={italian},
translator={
Giulio Agostini and Giuseppe Bilotta and Flavio Casadei Della Chiesa and Onofrio
de Bari and Giacomo Delre and Luca Ferrante and Tommaso Pecorella and
Mileto Rigido and Roberto Zanasi
},
- year=1999,
- url={http://tug.ctan.org/tex-archive/info/italian/amsldoc/itamsldoc.pdf}
+ url={http://tug.ctan.org/tex-archive/info/italian/amsldoc/itamsldoc.pdf},
+ annotation={Manual for \pkg{amsmath}.},
+ texdoc={amsldoc-it},
}
@manual{campani:tutorial,
title={Introdução ao Uso do Preparador de Documentos \LaTeX},
author={Carlos A. P. Campani},
year=2011,
- url={https://ctan.org/pkg/cursolatex}
+ pagetotal=188,
+ langid={portuguese},
+ language={portuguese},
+ url={https://ctan.org/pkg/cursolatex},
+ annotation={A tutorial as \acro{PDF} slides.},
+ texdoc={cursolatex},
}
@manual{amsmath-vn,
title={{\setmainfont{Latin Modern Roman} \textit{Hướng dẫn sử dụng gói amsmath}}},
- author={{American Mathematical Society} and {\LaTeX3 project}},
- translator={Ky Anh},
+ author={{American Mathematical Society} and {\LaTeX3 Project Team}},
year=1999,
- url={https://ctan.org/pkg/amslatexdoc-vietnamese}
+ pagetotal=36,
+ langid={vietnamese},
+ language={Vietnamese},
+ translator={Ky Anh},
+ url={https://ctan.org/pkg/amslatexdoc-vietnamese},
+ annotation={Manual for \pkg{amsmath}.},
+ texdoc={amsldoc-vn},
}
@manual{latex2e-japanese,
title={\LaTeX2e for authors},
- author={\LaTeX3 Project Team},
+ author={{\LaTeX3 Project Team}},
+ langid={japanese},
+ language={japanese},
translator={Yukitoshi FUJIMURA},
year=2015,
- url={https://www.latex-project.org/help/documentation/usrguide_jpn.pdf}
+ pagetotal=34,
+ annotation={An overview of the new features of \LaTeXe\ compared to \LaTeX 2.09.},
+ url={https://www.latex-project.org/help/documentation/usrguide_jpn.pdf},
}
@manual{amsmath-jp,
title={User’s Guide for the amsmath Package},
- author={{American Mathematical Society} and {\LaTeX3 project}},
+ author={{American Mathematical Society} and {\LaTeX3 Project Team}},
translator={Yukitoshi FUJIMURA},
+ langid={japanese},
+ language={japanese},
year=2018,
- url={https://www.latex-project.org/help/documentation/amsldoc_jpn.pdf}
+ pagetotal=45,
+ url={https://www.latex-project.org/help/documentation/amsldoc_jpn.pdf},
+ annotation={Manual for \pkg{amsmath}.},
}
@manual{shortmath-jp,
- title={Short Math Guide for LaTeX},
+ title={Short Math Guide for \LaTeX},
author={Michael Downes and Barbara Beeton},
translator={Yukitoshi FUJIMURA},
+ langid={japanese},
+ language={japanese},
+ year=2017,
+ pagetotal=21,
+ url={https://www.latex-project.org/help/documentation/short-math-guide_jpn.pdf},
+}
+
+@online{LaTeXfontcatalog,
+ title={The \LaTeX\ Font Catalogue},
+ author={Palle Jørgensen},
+ url={https://www.tug.org/FontCatalogue/},
+ annotation={A detailed list of fonts for \LaTeX, each with
+ samples and setup information.}
+}
+
+@online{rakityansky:truetype,
+ title={Using TrueType fonts with \TeX\ (\LaTeX) and pdf\TeX (pdf\LaTeX)},
+ author={Damir Rakityansky},
+ url={http://www.radamir.com/tex/ttf-tex.htm},
+}
+
+@manual{markey:tame,
+ title={Tame the BeaST},
+ subtitle={The B to X of Bib\TeX},
+ author={Nicolas Markey},
+ year=2009,
+ pagetotal=48,
+ url={https://ctan.org/pkg/tamethebeast/},
+ annotation={About bibliographies and Bib\TeX.},
+ texdoc={tamethebeast},
+}
+
+@manual{rees:biblatex,
+ title={Biblatex Cheat Sheet},
+ author={Clea F. Rees},
year=2017,
- url={https://www.latex-project.org/help/documentation/short-math-guide_jpn.pdf}
+ pagetotal=2,
+ url={https://ctan.org/pkg/biblatex-cheatsheet},
+ texdoc={biblatex-cheatsheet},
}
\end{filecontents}
+\begin{filecontents}[overwrite]{docsurvey.bbx}
+% Based on reading.bbx from the biblatex package.
+\ProvidesFile{docsurvey.bbx}
+[\abx@bbxid]
+
+\RequireBibliographyStyle{standard}
+
+\DeclareBibliographyDriver{manual}{%
+ \usebibmacro{bibindex}%
+ \usebibmacro{begentry}%
+% \usebibmacro{author/editor}% docsurvey modification
+ \usebibmacro{author/editor+others/translator+others}% docsurvey modification
+ \setunit{\printdelim{nametitledelim}}\newblock
+ \usebibmacro{title}%
+ \newunit
+ \printlist{language}%
+ \newunit\newblock
+ \usebibmacro{byauthor}%
+ \newunit\newblock
+ \usebibmacro{byeditor+others}% docsurvey modification
+ \newunit\newblock% docsurvey modification
+ \usebibmacro{byeditor}%
+ \newunit\newblock
+ \printfield{edition}%
+ \newunit\newblock
+ \usebibmacro{series+number}%
+ \newunit\newblock
+ \printfield{type}%
+ \newunit
+ \printfield{version}%
+ \newunit
+ \printfield{note}%
+ \newunit\newblock
+ \printlist{organization}%
+ \newunit
+ \usebibmacro{publisher+location+date}%
+ \newunit\newblock
+ \usebibmacro{chapter+pages}%
+ \newunit
+ \printfield{pagetotal}%
+ \newunit\newblock
+ \iftoggle{bbx:isbn}
+ {\printfield{isbn}}
+ {}%
+ \newunit\newblock
+ \usebibmacro{doi+eprint+url}%
+ \newunit\newblock
+ \usebibmacro{addendum+pubstate}%
+ \setunit{\bibpagerefpunct}\newblock
+ \usebibmacro{pageref}%
+ \newunit\newblock
+ \iftoggle{bbx:related}
+ {\usebibmacro{related:init}%
+ \usebibmacro{related}}
+ {}%
+ \usebibmacro{finentry}}
+
+
+\DeclareNameAlias{author}{default}
+\DeclareNameAlias{editor}{default}
+
+\DeclareFieldFormat{entrykey}{\mbox{\bfseries#1}}
+\DeclareFieldFormat{annotation}{%
+% \bibstring{annotation}\addcolon\space %
+ #1%
+}
+\DeclareFieldFormat{abstract}{\bibstring{abstract}\addcolon\space #1}
+\DeclareFieldFormat{library}{\bibstring{library}\addcolon\space #1}
+\DeclareFieldFormat{file}{\bibstring{file}\addcolon\space \url{#1}}
+\DeclareFieldFormat{shorthandwidth}{#1}
+
+\InitializeBibliographyStyle{%
+ \global\undef\bbx@lasthash}
+
+\setlength{\bibitemsep}{0.5\baselineskip}
+\setlength{\bibparsep}{0pt}
+
+\defbibenvironment{bibliography}
+ {\list
+ {}
+ {\setlength{\leftmargin}{0pt}%
+ \setlength{\itemindent}{0pt}%
+ \setlength{\itemsep}{\bibitemsep}%
+ \setlength{\parsep}{\bibparsep}}}
+ {\endlist}
+ {\bbx@item}
+
+\defbibenvironment{shorthand}
+ {\list
+ {\printfield[shorthandwidth]{shorthand}}
+ {\setlength{\labelwidth}{\shorthandwidth}%
+ \setlength{\leftmargin}{\labelwidth}%
+ \setlength{\labelsep}{\biblabelsep}%
+ \addtolength{\leftmargin}{\labelsep}%
+ \setlength{\itemsep}{\bibitemsep}%
+ \setlength{\parsep}{\bibparsep}%
+ \renewcommand*{\makelabel}[1]{##1\hss}}}
+ {\endlist}
+ {\item}
+
+\def\bbx@item@false{%
+ \itemsep2\bibitemsep
+ \item\relax
+ \itemsep\bibitemsep}
+
+\def\bbx@item@true{%
+ \bbx@item@full}
+
+\def\bbx@item@full{%
+ \itemsep2\bibitemsep
+ \@itempenalty\z@
+ \item\relax
+ \begingroup
+ \samepage\bfseries
+ \def\finentrypunct{\strut}%
+ \usebibmacro{entryhead:full}%
+ \ifbool{bbx:entrykey}
+ {\def\newblockpunct{%
+ \nobreak\hskip\z@skip\strut
+ \hfill\penalty100\hskip1em\relax
+ \hbox{}\nobreak\hfill\strut}%
+ \def\finentrypunct{%
+ \parfillskip\z@\finalhyphendemerits\z@
+ \par\nobreak}%
+ \newblock
+ \printfield{entrykey}}
+ {}%
+ \finentry
+ \endgroup
+ \nopagebreak% docsurvey modification
+ \\[-.7ex]% docsurvey modification
+ \textcolor{lightgray}{\rule[\smallskipamount]{\linewidth}{1.2pt}}% docsurvey modification
+ \vspace*{-\medskipamount}% docsurvey modification
+ \itemsep\bibitemsep
+ \@itempenalty\@M
+ \item\strut
+ \@itempenalty\z@}
+
+\def\bbx@item@name{%
+ \iffieldequals{fullhash}{\bbx@lasthash}
+ {\bbx@item@false}
+ {\itemsep2\bibitemsep
+ \@itempenalty\z@
+ \item\relax
+ \begingroup
+ \samepage\bfseries
+ \def\finentrypunct{\strut}%
+ \usebibmacro{entryhead:name}%
+ \finentry
+ \endgroup
+ \nopagebreak% docsurvey modification
+ \\[-.7ex]% docsurvey modification
+ \textcolor{lightgray}{\rule[\smallskipamount]{\linewidth}{1.2pt}}% docsurvey modification
+ \vspace*{-\medskipamount}% docsurvey modification
+ \itemsep\bibitemsep
+ \@itempenalty\@M
+ \item\strut
+ \@itempenalty\z@}}
+
+\newbool{bbx:entrykey}
+\newbool{bbx:annotation}
+\newbool{bbx:abstract}
+\newbool{bbx:library}
+\newbool{bbx:file}
+
+\DeclareBiblatexOption{global,type,entry}[boolean]{entryhead}[true]{%
+ \ifcsdef{bbx@item@#1}
+ {\letcs\bbx@item{bbx@item@#1}}
+ {\PackageError{biblatex}
+ {Invalid option 'header=#1'}
+ {Valid values: header=true, false, full, name.}}}
+\DeclareBiblatexOption{global,type,entry}[boolean]{entrykey}[true]{%
+ \setbool{bbx:entrykey}{#1}}
+\DeclareBiblatexOption{global,type,entry}[boolean]{annotation}[true]{%
+ \setbool{bbx:annotation}{#1}}
+\DeclareBiblatexOption{global,type,entry}[boolean]{abstract}[true]{%
+ \setbool{bbx:abstract}{#1}}
+\DeclareBiblatexOption{global,type,entry}[boolean]{library}[true]{%
+ \setbool{bbx:library}{#1}}
+\DeclareBiblatexOption{global,type,entry}[boolean]{file}[true]{%
+ \setbool{bbx:file}{#1}}
+
+\ExecuteBibliographyOptions{loadfiles,entryhead,%
+% entrykey,% docsurvey modification
+annotation,abstract,library,file}
+
+\newbibmacro*{entryhead:full}{%
+% \printnames[labelname][-1]{labelname}%
+% \setunit*{\addcolon\space}%
+ \printfield{labeltitle}%
+ \hspace*{\fill}% docsurvey modification
+ \printnames[labelname][-1]{labelname}% docsurvey modification
+}
+\newbibmacro*{entryhead:name}{%
+ \ifnameundef{labelname}
+ {\printfield{labeltitle}}
+ {\printnames[labelname]{labelname}}%
+ \savefield{fullhash}{\bbx@lasthash}}
+
+\newbibmacro*{entrytail}{%
+ \newunit\newblock
+ \begingroup
+ \def\newblockpunct{\item}%
+ \ifbool{bbx:annotation}
+ {\usebibmacro{annotation}%
+ \newunit\newblock}
+ {}%
+ \ifbool{bbx:abstract}
+ {\usebibmacro{abstract}%
+ \newunit\newblock}
+ {}%
+ \ifbool{bbx:file}
+ {\printfield{file}%
+ \newunit\newblock}
+ {}%
+ \ifbool{bbx:library}
+ {\printfield{library}%
+ \newunit\newblock}
+ {}%
+ \endgroup}
+
+\renewbibmacro*{finentry}{%
+ \ifbibliography
+ {\usebibmacro{entrytail}}
+ {}%
+ \finentry}
+
+\DeclareBibliographyDriver{set}{%
+ \renewbibmacro*{finentry}{\finentry}%
+ \entryset{}{}%
+ \newunit\newblock
+ \usebibmacro{setpageref}%
+ \ifbibliography
+ {\usebibmacro{entrytail}}
+ {}%
+ \finentry}
+
+\endinput
+\end{filecontents}
-\documentclass{article}
+\begin{filecontents}[overwrite]{docsurvey.cbx}
+% Based on reading.cbx from the biblatex package.
+\ProvidesFile{docsurvey.cbx}
+[\abx@cbxid]
+
+\RequireCitationStyle{authortitle}
+\endinput
+\end{filecontents}
-% \documentclass[twocolumn]{article}
% \usepackage[T1]{fontenc}
@@ -487,12 +1312,133 @@
\usepackage{needspace}
-\usepackage{biblatex}
+
+\usepackage[bibstyle=docsurvey, citestyle=draft, block=space]{biblatex}
\addbibresource{docsurvey.bib}
+\DeclareSourcemap{
+ \maps[datatype=bibtex]{
+ \map{
+ \step[fieldsource=texdoc]
+ \step[fieldset=usera,origfieldval]
+ }
+ }
+}
+
+\DeclareFieldFormat{usera}{\hspace*{\fill}\mbox{\texttt{(texdoc #1)}}\smallskip}
+
+\AtEveryBibitem{%
+ \csappto{blx@bbx@\thefield{entrytype}}{% put at end of entry
+ \iffieldundef{usera}%
+ {}%
+ {\space\printfield{usera}}%
+ }%
+}
+
+% *category
+
+\DeclareBibliographyCategory{printedbooks}
+\addtocategory{printedbooks}{lamport:latex, hokpkadaly:guide, gratzer:moremath,
+ voss:typesettingmath, voss:typesettingtables, voss:pstricks,
+ kottwitz:beginner, kottwitz:cookbook,
+ mittelbachgossens:companion, TeX:FAQ}
+
+\DeclareBibliographyCategory{TeX}
+\addtocategory{TeX}{eijkhout:topic, abrahams:impatient, texwikibook, doob:gentle,
+ wilkins:started}
+
+\DeclareBibliographyCategory{LaTeX}
+\addtocategory{LaTeX}{hefferon:first, flynn:veryshort, flynn:formatting,
+ talbot:novices, talbot:phd, morris:gettingstarted, Bennieston:scientific,
+ oetiker:introduction, greenwade:reference, latexwikibook, latex:authors,
+ lamport:latex, hokpkadaly:guide, kottwitz:beginner, kottwitz:cookbook,
+ mittelbachgossens:companion
+}
+
+\DeclareBibliographyCategory{bibliography}
+\addtocategory{bibliography}{markey:tame, rees:biblatex}
+
+\DeclareBibliographyCategory{math}
+\addtocategory{math}{amsmath, downes:shortmath, voss:farbige, voss:typesettingmath,
+ gratzer:moremath}
+
+\DeclareBibliographyCategory{tables}
+\addtocategory{tables}{fear:booktabs, voss:typesettingtables}
+
+\DeclareBibliographyCategory{graphics}
+\addtocategory{graphics}{reckdahl:eps, tantu:pgf, casteleyn:pstricks, casteleyn:tikz,
+ voss:pstricks}
+
+\DeclareBibliographyCategory{music}
+\addtocategory{music}{Gonzato:musicians}
+
+\DeclareBibliographyCategory{font}
+\addtocategory{font}{LaTeXfontcatalog, rakityansky:truetype}
+
+\DeclareBibliographyCategory{source}
+\addtocategory{source}{latexteam:sources, scharrer:listinternal}
+
+\DeclareBibliographyCategory{FAQ}
+\addtocategory{FAQ}{TeX:FAQ, pakin:visual, pakin:list, robertson:mathsymbols,
+ chang:cheat, lammarsch:cheat, schlomer:cheat, casteleyn:pstricks, casteleyn:tikz,
+ rees:biblatex, detexify, shapecatcher}
+
+\DeclareBibliographyCategory{langmultiple}
+\addtocategory{langmultiple}{oetiker:introduction, greenwade:reference,
+ ebookfoundation:free}
+
+\DeclareBibliographyCategory{brazilian}
+\addtocategory{brazilian}{massago:exemplos, chang:cheat-ptbr}
+
+\DeclareBibliographyCategory{chinese}
+\addtocategory{chinese}{abrahams:impatient-cn, huang:notes, ctex-faq, wang:install,
+ asymptote-example-cn, asymptote-faq-cn}
+
+\DeclareBibliographyCategory{french}
+\addtocategory{french}{gutenberg:TeXniques, lozano:everythingLaTeX, baudoin:learnLaTeX,
+ bouzigues:guide, Goulet:Redaction, tellechea:apprendre, faq-fr, reckdahl:freps,
+ casteleyn:pstricks, casteleyn:tikz, greenwade:reference, oetiker:introduction,
+ abrahams:impatient-fr, rouquette:sciences}
+
+\DeclareBibliographyCategory{german}
+\addtocategory{german}{chang:cheat-de, faq-de, oetiker:introduction, voss:farbige,
+ weissenburger:anleitung}
+
+\DeclareBibliographyCategory{indian}
+\addtocategory{indian}{Holkar:polyglossia}
+
+\DeclareBibliographyCategory{italian}
+\addtocategory{italian}{amsmath-it, oetiker:introduction}
+
+\DeclareBibliographyCategory{japanese}
+\addtocategory{japanese}{latex2e-japanese, amsmath-jp, shortmath-jp, chang:platexcheat,
+ oetiker:introduction}
+
+\DeclareBibliographyCategory{portuguese}
+\addtocategory{portuguese}{campani:tutorial, oetiker:introduction}
+
+\DeclareBibliographyCategory{spanish}
+\addtocategory{spanish}{chang:cheat-esmx, faq-es, greenwade:reference,
+ oetiker:introduction}
+
+\DeclareBibliographyCategory{vietnamese}
+\addtocategory{vietnamese}{amsmath-vn, oetiker:introduction}
+
+\DeclareBibliographyCategory{typesetting}
+\addtocategory{typesetting}{wilson:design, kohm:typearea, tufte:book,
+revets:octavo, beccari:canoniclayout, fear:booktabs, tantu:pgf}
+
+\DeclareBibliographyCategory{creating}
+\addtocategory{creating}{pakin:dtxtut, latexteam:class, mittelbach:doc,
+mittelbach:docstrip, flynn:article, pakin:goodthings, mansfield:class}
+
+
+\nocite{*}
+
+
+
\usepackage[nottoc,numbib]{tocbibind}
-\setcounter{secnumdepth}{0}
% colored section headers:
\usepackage[x11names]{xcolor}
@@ -504,17 +1450,17 @@
\definecolor{plumcolor}{HTML}{8E4585}
-\titleformat{\section}
- {\normalfont\sffamily\large\bfseries\color{sectioncolor}}{\thesection}{1em}{}%[\hrule]
-\titlespacing*{\section}{0pt}{*2}{*.5}
+\titleformat{\section}[block]
+ {\normalfont\sffamily\Large\bfseries\color{sectioncolor}}{\thesection}{1em}{}%[\hrule]
+\titlespacing*{\section}{0pt}{*4}{*.5}
-\titleformat{\subsection}
- {\normalfont\sffamily\normalsize\bfseries\color{sectioncolor}}{\thesubsection}{1em}{}
-\titlespacing*{\subsection}{0pt}{*1}{*.5}
+\titleformat{\subsection}[display]
+ {\normalfont\sffamily\large\bfseries\color{sectioncolor}}{\thesubsection}{1em}{}
+\titlespacing*{\subsection}{0pt}{*3}{*.5}
\titleformat{\subsubsection}
- {\normalfont\sffamily\normalsize\itshape\color{sectioncolor}}{\thesubsubsection}{1em}{}
-\titlespacing*{\subsubsection}{0pt}{*1}{*.5}
+ {\normalfont\sffamily\bfseries\normalsize\itshape\color{sectioncolor}}{\thesubsubsection}{1em}{}
+\titlespacing*{\subsubsection}{0pt}{*2}{*.5}
@@ -560,6 +1506,7 @@
\renewcommand{\slash}{/\penalty\exhyphenpenalty\hspace{0pt}}
\newcommand{\spslash}{\unskip\kern.085em/\hspace{.085em}\penalty\exhyphenpenalty\hspace{0pt}}
+\DeclareRobustCommand{\filenm}[1]{\texttt{#1}}
\let\texttub\textsl % redefined in other situations
% \DeclareRobustCommand{\AllTeX}{(\La\kern-.075em)\kern-.075em\TeX}
@@ -602,13 +1549,15 @@
% \DeclareRobustCommand{\eTeX}{\ensuremath{\varepsilon}-\kern-.125em\TeX}
% \DeclareRobustCommand{\ExTeX}{%
% \ensuremath{\textstyle\varepsilon_{\kern-0.15em\cal{X}}}\kern-.2em\TeX}
-% \def\FAQ{\acro{FAQ}}
+\def\FAQ{\acro{FAQ}}
% \def\FTP{\acro{FTP}}
% \def\Ghostscript{Ghost\-script}
% \def\GNU{\acro{GNU}}
% \def\GUI{\acro{GUI}}
% \def\Hawaii{Hawai`i}
-% \def\HTML{\acro{HTML}}
+\def\HTML{\acro{HTML}}
+\def\EPUB{\acro{EPUB}}
+\def\ODT{\acro{ODT}}
% \def\HTTP{\acro{HTTP}}
% \def\IDE{\acro{IDE}}
% \def\IEEE{\acro{IEEE}}
@@ -770,6 +1719,54 @@ Subject={LaTeX programming documentation},%
Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
}}
+\pdfstringdefDisableCommands{%
+ \def\quad{ }%
+ \def\\{ }%
+ \def\pkg#1{#1}%
+ \def\ctr#1{#1}%
+ \def\bool#1{#1}%
+ \def\optn#1{#1}%
+ \def\env#1{#1}%
+ \def\cs#1{\textbackslash#1}%
+ \def\,{ }%
+ \def\LuaLaTeX{LuaLaTeX}%
+ \def\XeLaTeX{XeLaTeX}%
+ \def\TeX{TeX}%
+ \def\LaTeX{LaTeX}%
+ \def\LaTeXe{LaTeX2e}%
+ \def\LuaTeX{LuaTeX}%
+ \def\LuaLaTeX{LuaLaTeX}%
+ \def\XeTeX{XeTeX}%
+ \def\AmS{AMS}%
+ \def\Dash{ --- }%
+ \def\dash{ -- }%
+ \def\Slash{/}%
+ \def\prog#1{\detokenize{#1}}%
+ \def\progcode#1{#1}%
+ \def\filenm#1{\detokenize{#1}}%
+ \def\brand#1{#1}%
+ \def\acro#1{#1}%
+ \def\HTML{HTML}%
+ \def\ODT{ODT}%
+ \def\SVG{SVG}%
+ \def\PNG{PNG}%
+ \def\GIF{GIF}%
+ \def\JPG{JPG}%
+ \def\EPS{EPS}%
+ \def\PDF{PDF}%
+ \def\DVI{DVI}%
+ \def\UTF{UTF}%
+ \def\URL{URL}%
+ \def\element#1{#1}%
+ \def\attribute#1{#1}%
+ \def\HTMLfive{HTML5}%
+ \def\CSS{CSS}%
+ \def\CSSthree{CSS3}%
+ \def\EPUB{EPUB}%
+ \def\TOC{TOC}%
+ \def\LOF{LOF}%
+ \def\LOT{LOT}%
+}
\usepackage{enumitem}
\setlist[description]{style=nextline,font=\small}
@@ -787,7 +1784,6 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\newrobustcmd*{\prog}[1]{\texttt{#1}}
\newrobustcmd*{\tag}[1]{\texttt{<#1>}}
\newrobustcmd*{\prop}[1]{\textsl{\texttt{#1}}}
-\newrobustcmd*{\epub}{\acro{EPUB}}
\newrobustcmd*{\texdoc}[1]{\hspace*{\fill}\mbox{(\texttt{texdoc #1})}}
\newrobustcmd*{\hfurl}[1]{\hspace*{\fill}\mbox{(\url{#1})}}
\newrobustcmd*{\hfciteurl}[1]{\hspace*{\fill}\mbox{(\citeurl{#1})}}
@@ -810,7 +1806,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\author{Brian Dunn \\
\small \href{mailto:bd@BDTechConcepts.com}{bd@BDTechConcepts.com} \\
- \small Copyright 2017--2020 Brian Dunn\thanks{
+ \small Copyright 2017--2021 Brian Dunn\thanks{
This work may be distributed and/or modified under the
conditions of the \LaTeX\ Project Public License, either version 1.3
of this license or (at your option) any later version.
@@ -822,24 +1818,29 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
}
+\setcounter{secnumdepth}{0}
+
\begin{document}
\maketitle
+
\thispagestyle{empty}
\begin{abstract}
\noindent
A survey of documentation for \LaTeX.
Included are references to printed and electronic books and manuals,
-symbol lists, \acro{FAQ}s, the \LaTeX\ source code, CTAN and distributions,
+symbol lists, \FAQ{}s, the \LaTeX\ source code, CTAN and distributions,
programming-related packages, users groups and online communities,
and information on creating packages and documentation.
\end{abstract}
+
\tableofcontents
+
\section{Introduction}
Reinventing the wheel may be useful if you think that you can do it better.
@@ -850,13 +1851,19 @@ the many ways things may be done, but also for someone, this author included,
who learned \LaTeX\ many years ago but may have missed some of the recent
advancements in package code and documentation.
-A wealth of information is available, not
-only in print and online, but also directly embedded in the typical \LaTeX\
-distribution.
+A wealth of information is available, not only in print and online,
+but also directly embedded in the typical \LaTeX\ distribution.
The following is meant to be a broad overview of some of today's resources
for \LaTeX\ programmers.
-(The latest version of this document is available in the \pkg{docsurvey} package.)
+In some cases the same document may be listed in several categories.
+For example, a graphics \FAQ\ also available in French may be listed under
+graphics, \FAQ{}s, and also French documents.
+
+Many older documents are not included.
+
+(The latest version of this document is available as the \LaTeX\ \pkg{docsurvey} package.)
+
\section{Printed books}
@@ -867,30 +1874,13 @@ useful topics, have extensive human-edited indexes which are more useful
than a simple document-wide search function, and some are also available in
electronic format.
-\begin{description}
-\item[\LaTeX:\ A Document Preparation System:]
- The classic introduction to \LaTeX, in continuous reprint for
- decades.~\cite{lamport:latex}
-\item[Guide to \LaTeX:]
- An introduction and more advanced material, including an extensive
- reference guide.
- Fourth edition: 2004.~\cite{hokpkadaly:guide}
-\item[More Math into \LaTeX:]
- Updated to a fifth edition in 2016.~\cite{gratzer:moremath}
-\item[\LaTeX\ Beginner's Guide:]
- An overview with numerous examples.~\cite{kottwitz:beginner}
-\item[\LaTeX\ Cookbook:]
- More examples.~\cite{kottwitz:cookbook}
-\item[The \LaTeX\ Companion:]
- Provides extended discussion and examples of the inner workings
- of \LaTeX\ and numerous useful packages.
- Second edition: 2004.~\cite{mittelbachgossens:companion}
-\item[Additional books:] Listed at the \TeX\ \acro{FAQ}.~\cite{TeX:FAQ}
- \hfciteurl{TeX:FAQ}
-\end{description}
+\printbibliography[
+ heading=none,
+ category=printedbooks,
+]
-\section{Electronic books and documentation}
+\section{Books and documentation by category}
Most of these are provided with the \TeX\ distribution, and may be updated
with each release.
@@ -899,69 +1889,21 @@ program.
\subsection{\TeX}
-\begin{description}
-\item[\TeX\ by Topic, A \TeX nician's Reference:]
- A reference for \TeX.
- This may be useful for understanding the source code of \LaTeX\ packages,
- many of which are quite old and written in
- low-level \TeX.~\cite{eijkhout:topic}
- \texdoc{texbytopic}
-\end{description}
+For a list of older books, see \url{https://www.texfaq.org/FAQ-tex-books}.
+
+\printbibliography[
+ heading=none,
+ category=TeX,
+]
+
\subsection{\LaTeX}
-\begin{description}
-\item[Getting something out of \LaTeX:]
- Create your first document in \LaTeX.~\cite{hefferon:first}
- \hfciteurl{hefferon:first}
-
-\item[The very short guide to typesetting with \LaTeX:]
- A four-page introduction.~\cite{flynn:veryshort}
- \hfciteurl{flynn:veryshort}
-
-\item[Formatting Information:]
- A beginner’s introduction to typesetting with \LaTeX.~\cite{flynn:formatting}
- \hfciteurl{flynn:formatting}
-
-\item[\LaTeX\ for Complete Novices:]
- An extensive introduction for a non-technical person.~\cite{talbot:novices}
- \texdoc{dickimaw-novices}
-
-\item[Using \LaTeX\ to Write a PhD Thesis:]
- A followup to \pub{\LaTeX\ for Complete Novices}, including extensive
- discussion about bibliographies, indexes, and glossaries.~\cite{talbot:phd}
- \texdoc{dickimaw-thesis}
-
-\item[Getting Started with \LaTeXe:]
- A beginner's bare-bones overview.~\cite{morris:gettingstarted}
- \texdoc{startlatex2e}
-
-\item[Writing Scientific Documents Using \LaTeX:]
- An introduction to typesetting scientific documents.~\cite{Bennieston:scientific}
- \newline
- \hfciteurl{Bennieston:scientific}
-
-\item[The Not So Short Introduction to \LaTeXe:]
- Covers introductory material, customizations,
- and a simple package. Available in many languages~\cite{oetiker:introduction}
- \texdoc{-l lshort}
- \hfciteurl{oetiker:introduction}
-
-\item[\LaTeXe: An unofficial reference manual:]
- A thorough but concise reference manual for \LaTeXe,
- available in several languages.~\cite{greenwade:reference}
- \texdoc{-l latex2e-help}
- \hfciteurl{greenwade:reference}
-
-\item[LaTeX WikiBook:] An online book, includes information about
- creating \LaTeX\ packages and classes.~\cite{latexwikibook}
- \hfciteurl{latexwikibook}
-
-\item[\LaTeXe\ for authors:]
- An overview of the new features of \LaTeXe\ compared to \LaTeX 2.09.
- ~\cite{latex:authors}
- \texdoc{usrguide}
-\end{description}
+\printbibliography[
+ heading=none,
+ category=LaTeX,
+]
+
\subsection{Lua\LaTeX}
@@ -970,6 +1912,7 @@ program.
\item [Lua\TeX\ Reference:] The full manual. \texdoc{luatex.pdf}
\end{description}
+
\subsection{\XeLaTeX}
\begin{description}
@@ -979,6 +1922,7 @@ program.
\texdoc{font-change-xetex}
\end{description}
+
\subsection{\LaTeX3 and \pkg{expl3}}
\begin{description}
@@ -987,225 +1931,185 @@ program.
\end{description}
-\subsection{Math typesetting}
+\subsection{Bibliography}
+
+\printbibliography[
+ heading=none,
+ category=bibliography,
+]
+
+
+\subsection{Math}
\label{sec:math}
-\begin{description}
-\item [User’s Guide for the amsmath Package:]
- How to use \pkg{amsmath}.~\cite{amsmath} \texdoc{amsmath} \\
- Also see \nameref{sec:international} for the Italian, Japanese,
- and Vietnamese translations.
-
-\item[Short Math Guide for \LaTeX:]
- A summary of features in \LaTeX\ and packages for writing
- math formulas.~\cite{downes:shortmath}
- \texdoc{short-math-guide}
-
-\item[Farbige Mathematik:]
- Math in color. In German, but with easy-to-use examples.~\cite{voss:farbige}
- \texdoc{voss-mathcol}
-\end{description}
+\printbibliography[
+ heading=none,
+ category=math,
+]
-\subsection{Music typesetting}
+\subsection{Tables}
-\begin{description}
-\item [\LaTeX\ for Musicians:]
- Packages and programs for music symbols, lyrics, chord sheets, sheet music,
- and guitar tablature.~\cite{Gonzato:musicians}
- \texdoc{latex4musicians}
-\end{description}
+Also see the \TeX\ FAQ\ Floats section: \url{https://www.texfaq.org/#floats}
+\printbibliography[
+ heading=none,
+ category=tables,
+]
-\subsection{Symbol references}
-These are lists of the \LaTeX\ commands which produce symbols.
+\subsection{Graphics}
-\begin{description}
-\item[Comprehensive \LaTeX\ Symbol List:]
-More than 14,000 symbols and \LaTeX\ commands.~\cite{pakin:list}
-\texdoc{symbols-letter} \texdoc{symbols-a4}
+Also see the \TeX\ FAQ\ Graphics section: \url{https://www.texfaq.org/#graphics}
-\item[Every symbol (most symbols) defined by unicode-math:]
-Unicode math symbols.~\cite{robertson:mathsymbols}
-\texdoc{unimath-symbols}
-\end{description}
+\printbibliography[
+ heading=none,
+ category=graphics,
+]
-\subsection{Source code}
+\subsection{Music}
-The source code for \LaTeXe\ itself is also included in the distribution.
-\begin{description}
-\item[The \LaTeXe\ sources:] Occasionally useful for figuring out how
- something really works.~\cite{latexteam:sources}
- \texdoc{source2e}
-\item[List of internal \LaTeXe\ macros useful to package authors:]
- A list of the core \LaTeX\ macros, each of which is linked to the
- source code.~\cite{scharrer:listinternal}
- \texdoc{macros2e}
-\end{description}
+\printbibliography[
+ heading=none,
+ category=music,
+]
+\subsection{Fonts}
-\subsection{FAQs}
+Also see the \TeX\ FAQ\ Fonts section: \url{https://www.texfaq.org/#fonts}
-%Frequently-Asked Questions
+\printbibliography[
+ heading=none,
+ category=font,
+]
-\begin{description}
-\item[\TeX\ FAQ:] A wide-ranging list of fre\-quently-asked questions.
-(Formerly the UK TUG FAQ.)
-~\cite{TeX:FAQ}
-\texdoc{letterfaq}
-\texdoc{newfaq}
-
-\item[Visual \LaTeX\ FAQ:] Click on a visual element to learn how
-it is programmed.~\cite{pakin:visual}
-\texdoc{visualFAQ}
-\end{description}
+
+\subsection{\FAQ{}s, symbol references, cheat sheets}
+
+\printbibliography[
+ heading=none,
+ category=FAQ,
+]
+
+
+\subsection{Source code}
+
+The source code for \LaTeXe\ itself is also included in the distribution.
+
+\printbibliography[
+ heading=none,
+ category=source,
+]
\subsection{International languages}
\label{sec:international}
-\begin{description}[style=standard]
- \item [Multiple languages:] The following are available in several languages.
- \begin{description}
- \item[The Not So Short Introduction to \LaTeXe:]
- Covers introductory material, customizations,
- and a simple package.~\cite{oetiker:introduction}
- \texdoc{-l lshort}
- \hfciteurl{oetiker:introduction}
-
- \item[\LaTeXe: An unofficial reference manual:]
- A thorough but concise reference manual
- for \LaTeXe.~\cite{greenwade:reference}
- \texdoc{-l latex2e-help}
- \hfciteurl{greenwade:reference}
-
- \item [Ebook Foundation — Free Programming Books:] A variety
- of \TeX-related and other programming books
- and documents.~\cite{ebookfoundation:free}
- \hfciteurl{ebookfoundation:free}
- \end{description}
- \item[Brazilian Portuguese:] \
- \begin{description}
- \item[\LaTeXe\ Via Exemplos:] A study course.~\cite{massago:exemplos}
- \hfciteurl{massago:exemplos}
- \end{description}
- \item[French:] \
+\subsubsection{Multiple languages}
+
+ The following are available in several languages.
+ Also see CTAN's topic for each language for additional translations of
+ package and other documentation.
+ \printbibliography[
+ heading=none,
+ category=langmultiple,
+ ]
+
+\subsubsection{Brazilian Portuguese}
+ \printbibliography[
+ heading=none,
+ category=brazilian,
+ ]
+
+\subsubsection{Chinese}
+ \printbibliography[
+ heading=none,
+ category=chinese,
+ ]
+
+\subsubsection{French}
Also see \nameref{sec:online}.
- \begin{description}
- \item[TeXniques:]
- A collection of resources.~\cite{gutenberg:TeXniques}
- \hfciteurl{gutenberg:TeXniques}
- \item[%
- Tout Ce Que Vous Avez Toujours Voulu Savoir
- Sur \LaTeX\ Sans Jamais Os Er Le Demander:%
+ \printbibliography[
+ heading=none,
+ category=french,
]
- A book for beginners.~\cite{lozano:everythingLaTeX}
- \hfciteurl{lozano:everythingLaTeX}
- \item[Apprends \LaTeX!:] A full textbook written for
- École Nationale Supérieure de Techniques Avancées.~\cite{baudoin:learnLaTeX}
- \hfciteurl{baudoin:learnLaTeX}
- \item[Initiation à LATEX:] A guide on \LaTeX\ — for beginners
- or advanced users.~\cite{bouzigues:guide}
- \hfciteurl{bouzigues:guide}
- \item[Rédaction avec \LaTeX:]
- An introductory course prepared for
- Université Laval, Québec, Canada.~\cite{Goulet:Redaction}
- \texdoc{formation-latex-ul}
- \texdoc{formation-latex-ul-diapos}
- \end{description}
- \item[German:] \
- See \nameref{sec:math}, \nameref{sec:groups}, and \nameref{sec:online}.
- \item[Indian:] \
- \begin{description}
- \item [A practical guide to \LaTeX\ and polyglossia for Indian Languages:]
- \LaTeX\ and \pkg{polyglossia} for Indian languages.~\cite{Holkar:polyglossia}
- \texdoc{latex-mr}
- \end{description}
- \item[Italian:] \
- \begin{description}
- \item [Manuale utente per il pacchetto amsmath:] Manual for \pkg{amsmath}.
- \cite{amsmath-it}
- \texdoc{amsldoc-it}
- \end{description}
- \item[Japanese:] \
- \begin{description}
- \item [\LaTeX2e for authors:] \cite{latex2e-japanese}
- \hfciteurl{latex2e-japanese}
- \item [User’s Guide for the amsmath Package:] \cite{amsmath-jp}
- \hfciteurl{amsmath-jp}
- \item [Short Math Guide for LaTeX:] \cite{shortmath-jp}
- \hfciteurl{shortmath-jp}
- \end{description}
- \item[Portuguese:] \
- \begin{description}
- \item [Introdução ao Uso do Preparador de Documentos \LaTeX:]
- A tutorial as \acro{PDF} slides.~\cite{campani:tutorial}
- \texdoc{cursolatex}
- \end{description}
- \item[Vietnamese:] \
- \begin{description}
- \item [%
- {\setmainfont{Latin Modern Roman} \textbf{Hướng dẫn sử dụng gói}}
- amsmath:%
- ] Manual for \pkg{amsmath}.~\cite{amsmath-vn}
- \texdoc{amsldoc-vn}
- \end{description}
-\end{description}
-\subsection{General typesetting theory}
+\subsubsection{German}
-Discussion about general typesetting theory,
-presented by various \TeX-related authors.
+ Also see \nameref{sec:groups}, and \nameref{sec:online}.
+ \printbibliography[
+ heading=none,
+ category=german,
+ ]
-\begin{description}
-\item[A Few Notes on Book Design:]
- Discussion about book design and typography.
- 100+ pages.~\cite{wilson:design}
- \texdoc{memdesign}
+\subsubsection{Indian}
+ \printbibliography[
+ heading=none,
+ category=indian,
+ ]
-\item[KOMA-Script — The Guide --- Calculating the Page Layout with typearea:]
- Discussion about the page layout of a book.~\cite{kohm:typearea}
- \texdoc{typearea}
+\subsubsection{Italian}
+ \printbibliography[
+ heading=none,
+ category=italian,
+ ]
-\item[A TUFTE-STYLE BOOK --- The Design of Tufte's Books:]
- Emulating ideas from the books of Edward R. Tufte.~\cite{tufte:book}
- \texdoc{tufte-latex}
+\subsubsection{Japanese}
+ \printbibliography[
+ heading=none,
+ category=japanese,
+ ]
-\item[The Octavo Package:]
- Design principles and guidelines emulating books
- from the Renaissance.~\cite{revets:octavo}
- \texdoc{octavo}
+\subsubsection{Portuguese}
+ \printbibliography[
+ heading=none,
+ category=portuguese,
+ ]
+
+\subsubsection{Spanish}
+ \printbibliography[
+ heading=none,
+ category=spanish,
+ ]
-\item[Package canoniclayout:]
- Ideas regarding text-block proportions.~\cite{beccari:canoniclayout}
- \texdoc{canoniclayout}
+\subsubsection{Vietnamese}
+ \printbibliography[
+ heading=none,
+ category=vietnamese,
+ ]
-\item[Publication-quality tables in \LaTeX:]
- Improved design of tabular layouts.~\cite{fear:booktabs}
- \texdoc{booktabs}
-\item[The Ti\textit{k}Z and PGF Packages --- Guidelines on Graphics:]
- ``General guidelines and principles concerning the creation of graphics
- for scientific presentations, papers, and books''.~\cite{tantu:pgf}
- \texdoc{pgfmanual}
+\subsection{General typesetting theory}
+
+Discussion about general typesetting theory,
+presented by various \TeX-related authors.
+
+For a list of non-\LaTeX-specific books, see \url{https://www.texfaq.org/FAQ-type-books}.
+
+\printbibliography[
+ heading=none,
+ category=typesetting,
+]
-\end{description}
\section{Accessing embedded information}
-\subsection{\pkg{texdoc}}
+\subsection{\prog{texdoc} and \prog{mthelp}}
A large amount of documentation is included in a \TeX\ distribution.
-Most can be accessed with the \prog{texdoc} program.
+For TeXLive distributions, package documentation
+can be accessed with the \prog{texdoc} program.
Enter ``\prog{texdoc -l <name>}'' to search for
matching package, file, or program names. In some cases the same document
is available in both letter or A4 paper sizes, or in several languages.
-\prog{texdoc} is also available online~\cite{texdocnet},
-with popular packages sorted by category. \hfciteurl{texdocnet}
+\prog{texdoc} is also available online,
+with popular packages sorted by category. \hfurl{http://www.texdoc.net/}
+
+For MikTeX, the \prog{mthelp} program accesses package documentation.
+Enter ``\prog{mthelp <name>}''.
\subsection{\prog{kpsewhich}}
@@ -1264,20 +2168,191 @@ There are so many topics, however, that finding the right topic can be a
problem in itself. One useful method to find what you are looking for is
to search for a related package you may already know about, then look at
its description on \CTAN\ to see what topics are shown for it. Selecting these
-topics then shows you related packages.~\cite{ctan}
+topics then shows you related packages.\hfurl{https://ctan.org/}
\needspace{7\baselineskip}
-\section{Useful packages}
-\subsection{General use}
+\section{Useful classes, packages, and programs}
+
+Use \prog{texdoc} or \prog{mthelp} to access information about each of the following.
+
+\subsection{General-use packages and classes}
+
+\begin{multicols}{2}
+
+\begin{description}
+
+\item[Classes:] \pkg{memoir}, \pkg{koma-script}
+
+\item[Page layout:] \pkg{fancyhdr}, \pkg{geometry}, \pkg{microtype}, \pkg{nowidow}
+
+\item[Fonts:] \pkg{fontspec}, \pkg{mathspec}, \pkg{unicode-math}
+
+\item[Sectioning:] \pkg{titlesec}
+
+\item[Table of contents:] \pkg{etoc}, \pkg{minitoc}, \pkg{multitoc}, \pkg{shorttoc},
+ \pkg{titletoc}, \pkg{tocbibind}, \pkg{tocdata}, \pkg{tocloft}, \pkg{tocvsec2}
+
+\item[Title page:] \pkg{authblk}, \pkg{titling}
+
+\item[Front and back matter:] \pkg{abstract}, \pkg{appendix}
+
+\item[Indexing:] \prog{makeindex}, \prog{xindy}, \prog{xindex}, \pkg{gindex},
+ \pkg{hvindex}, \pkg{idxlayout}, \pkg{imakeidx}, \pkg{index}, \pkg{makeidx},
+ \pkg{splitidx}, \pkg{varindex}, \pkg{xindex}
+
+\item[Glossary:] \pkg{glossaries}, \pkg{nomencl}
+
+\item[Bibliography:] \prog{bibtex}, \pkg{biblatex}
+
+\item[Cross-referencing:] \pkg{cleveref}, \pkg{hyperref}, \pkg{url}, \pkg{xr-hyper},
+ \pkg{xurl}, \pkg{zref}
+
+\item[Foot notes, margin notes, page notes:]
+ \pkg{bigfoot}, \pkg{endheads}, \pkg{endnotes}, \pkg{footmisc},
+ \pkg{manyfoot}, \pkg{marginfit}, \pkg{marginfix}, \pkg{marginnote},
+ \pkg{pagenote}, \pkg{parnotes}, \pkg{sidenotes}
+
+\item[Math:] \pkg{amsmath}, \pkg{amssymb}, \pkg{breqn}, \pkg{mathtools},
+ \pkg{resizegather}, \pkg{nicematrix}, \pkg{scalerel}, \pkg{stackrel}
+
+\item[Theorems:]
+ \pkg{amsthm}, \pkg{apxproof}, \pkg{ntheorem}, \pkg{shadethm},
+ \pkg{theorem}, \pkg{thmbox}, \pkg{thmtools}
+
+\item[Units and fractions:] \pkg{nicefrac}, \pkg{siunitx}, \pkg{xfrac}
+
+\item[Floats:] \pkg{caption}, \pkg{dblfloatfix}, \pkg{endfloat}, \pkg{fewerfloatpages},
+ \pkg{float}, \pkg{floatrow}, \pkg{hypcap}, \pkg{keyfloat}, \pkg{newfloat},
+ \pkg{placeins}, \pkg{rotfloat}, \pkg{stfloats}, \pkg{subcaption}, \pkg{subfig},
+ \pkg{subfloat}, \pkg{wrapfig}
+
+\item[Tabular:] \pkg{array}, \pkg{booktabs}, \pkg{colortbl}, \pkg{longtable},
+ \pkg{ltxtable}, \pkg{multirow},
+ \pkg{supertabular}, \pkg{tabularx}, \pkg{tabulary},
+ \pkg{threeparttable}, \pkg{threeparttablex},
+ \pkg{widetable}, \pkg{xltabular}, \pkg{xtab}
+
+\item[Graphics:] \pkg{asymptote}, \pkg{curves}, \pkg{fitbox}, \pkg{graphicx},
+ \pkg{pict2e}, \pkg{pstricks}, \pkg{tikz}, \pkg{xy}
+
+\item[Color:] \pkg{normalcolor}, \pkg{xcolor}
+
+\item[Lists:] \pkg{enumerate}, \pkg{enumitem}, \pkg{paralist}
+
+\item[Minipages:] \pkg{eqparbox}, \pkg{minibox}, \pkg{pbox}, \pkg{shapepar}
+
+\item[Quotations:] \pkg{csquotes}, \pkg{epigraph}, \pkg{quoting}, \pkg{verse}
+
+\item[Verbatim:] \pkg{fancyvrb}, \pkg{fvextra}, \pkg{moreverb}, \pkg{shortvrb},
+ \pkg{upquote}, \pkg{verbatim}
+
+\item[Frames:] \pkg{boxedminipage2e}, \pkg{fancybox}, \pkg{fbox}, \pkg{framed},
+ \pkg{mdframed}, \pkg{shadow}, \pkg{tcolorbox}
+
+\item[Multi-columns:] \pkg{adjmulticol}, \pkg{multicol}, \pkg{multicolrule}, \pkg{vwcol}
+
+\item[Margins:] \pkg{fullwidth}, \pkg{hanging}, \pkg{midpage}
+
+\item[Line numbering:] \pkg{lineno}
+
+\item[Algorithms and Listings:] \pkg{algorithm2e}, \pkg{algorithmicx},
+ \pkg{listings}, \pkg{listingsutf8}, \pkg{minted}
+
+\item[Acronyms:] \pkg{acro}, \pkg{acronym}
+
+\item[Ordinals:] \pkg{engord}, \pkg{fmtcount}, \pkg{nth}
+
+\item[Direct formatting:]
+ \pkg{cancel}, \pkg{ellipsis}, \pkg{embrac}, \pkg{enparen},
+ \pkg{hyphenat}, \pkg{lettrine}, \pkg{lips},
+ \pkg{lua-check-hyphen}, \pkg{luacolor},
+ \pkg{pdfcol}, \pkg{pdfcolmk},
+ \pkg{pdfrender}, \pkg{realscripts}, \pkg{relsize},
+ \pkg{seqsplit}, \pkg{soul}, \pkg{soulpos},
+ \pkg{soulutf8}, \pkg{stackengine},
+ \pkg{textfit}, \pkg{thinsp}, \pkg{trimclip}, \pkg{truncate},
+ \pkg{ulem}, \pkg{umoline}, \pkg{underscore}, \pkg{uspace},
+ \pkg{xellipsis}
+
+\item[Symbols:] \pkg{academicons}, \pkg{amssymb}, \pkg{bbding},
+ \pkg{chemgreek}, \pkg{dingbat}, \pkg{euro}, \pkg{eurosym},
+ \pkg{fontawesome}, \pkg{fontawesome5}, \pkg{gensymb}, \pkg{latexsym},
+ \pkg{marvosym}, \pkg{metalogo}, \pkg{metalogox},
+ \pkg{pifont}, \pkg{textalpha}, \pkg{textcomp}, \pkg{textgreek},
+ \pkg{typicons}, \pkg{xunicode}
+
+\item[Files:]
+ \pkg{attachfile}, \pkg{attachfile2}, \pkg{hyperxmp},
+ \pkg{intopdf}, \pkg{pdfpages}, \pkg{pdfx}, \pkg{xmpincl}
+
+\item[Admonitions:] \pkg{awesomebox}, \pkg{notes}
+
+\item[Editorial:] \pkg{changebar}, \pkg{changelog}, \pkg{changes},
+ \pkg{easy-todo}, \pkg{easyReview}, \pkg{ed}, \pkg{errata}, \pkg{fixme},
+ \pkg{fixmetodonotes},
+ \pkg{pdfcomment}, \pkg{pdfmarginpar},
+ \pkg{todo}, \pkg{todonotes}, \pkg{tram}, \pkg{xechangebar}
+
+\item[Accessibility:] \pkg{accessibility}, \pkg{accsupp},
+ \pkg{axessibility},
+ \pkg{pdfcomment}, \pkg{repltext}, \pkg{tagpdf}
+
+\item[Multi-langauge:] \pkg{babel}, \pkg{bidi}, \pkg{polyglossia}
+
+\item[Debug:] \pkg{chkfloat}, \pkg{cmdtrack}, \pkg{dprogress}, \pkg{inputtrc},
+ \pkg{lua-visual-debug}, \pkg{refcheck}
+
+\end{description}
+
+\end{multicols}
+
+\subsection{Automatic compiling}
+
+The programs \prog{arara} and \prog{latexmk} automatically recompile as necessary to
+resolve all dependencies.
+
+
+\subsection{Converting to \HTML\ and other document formats}
\begin{description}
-\item [A First Set of \LaTeX\ Packages:]
- A list of packages useful for beginners.~\cite{hefferon:firstset}
- \texdoc{first-packages}
+ \item[Using \TeX\ to generate the \HTML:]
+ The \pkg{lwarp} package and the \prog{tex4ht} program
+ each use native \LaTeX\ to interpret the document and generate \HTML.
+ More of \LaTeX\ is supported compared to the translators listed below.
+ \begin{description}
+ \item [\pkg{lwarp} package:] Supports hundreds of packages. Generates \HTML,
+ and provides indirect assistance for \EPUB\ conversion and
+ copy/paste into a word-processor.
+ \url{https://ctan.org/pkg/lwarp}
+ \item [\prog{tex4ht} program:] Generates \HTML, \EPUB, \ODT, and Docbook.
+ \url{http://tug.org/tex4ht/}
+ \end{description}
+
+ \item[Translators:]
+ These systems use external programs to translate a subset of \LaTeX\ syntax
+ into \HTML. Search for each on \CTAN\ (\url{http:\\ctan.org}).
+ \begin{description}
+ \item [H\textsuperscript{E}v\textsuperscript{E}a:] \url{http://hevea.inria.fr/}
+ \item [T\textsubscript{T}H:] \url{http://hutchinson.belmont.ma.us/tth/}
+ \item [GELLMU:] \url{http://www.albany.edu/~hammond/gellmu/}
+ \item [\LaTeX{}ML:] \url{http://dlmf.nist.gov/LaTeXML/}
+ \item [PlasTeX:] \url{https://github.com/tiarno/plastex}
+ \item [\LaTeX2HTML:] \url{http://www.latex2html.org/}
+ and \url{http://ctan.org/pkg/latex2html}
+ \item [\TeX2page:] \url{http://ds26gte.github.io/tex2page/index.html}
+ \end{description}
+ \item[\LaTeX\ math to \HTML:]
+ \prog{Glad\TeX} takes a \LaTeX\ math expression and generates
+ the corresponding \HTML.
+ \begin{description}
+ \item[\prog{Glad\TeX}:] \url{http://humenda.github.io/GladTeX/}
+ \end{description}
\end{description}
+
+
\subsection{Programming \LaTeX}
A number of packages are especially useful for \LaTeX\ programmers:
@@ -1315,40 +2390,13 @@ A number of packages are especially useful for \LaTeX\ programmers:
\section{Creating and documenting new packages}
-\subsection{How-to}
-
Documentation for those interested in creating their own package or class:
-\begin{description}
-\item[How to package your \LaTeX\ package:] A tutorial.~\cite{pakin:dtxtut}
- \texdoc{dtxtut}
-\item[\LaTeXe\ for class and package writers:] Programming a package
- or class.~\cite{latexteam:class}
- \texdoc{clsguide}
-\item[The doc and shortvrb packages:] Packages for documenting
- packages.~\cite{mittelbach:doc}
- \texdoc{doc}
-\item[The DocStrip program:] The program which processes \verb+.dtx+
- and \verb+.ins+ files to generate documentation and \verb+.sty+
- files.~\cite{mittelbach:docstrip}
- \texdoc{docstrip}
-\end{description}
-
-\subsection{Published articles about creating \LaTeX\ packages}
-Related articles from \TUB:
-
-\begin{description}
-\item[Rolling your own Document Class:
-Using \LaTeX\ to keep away from the Dark Side:] An overview of the
- \pkg{article} class.~\cite{flynn:article}
-\item[Good things come in little packages: An
- introduction to writing \texttt{.ins} and \texttt{.dtx} files:] How and why
- to create your own \verb+.dtx+ and \verb+.ins+ files.~\cite{pakin:goodthings}
-\item[How to develop your own document class\Dash our experience:]
- A comparison of developing class vs.\ package
- files.~\cite{mansfield:class}
+\printbibliography[
+ heading=none,
+ category=creating,
+]
-\end{description}
\section{Users groups}
\label{sec:groups}
@@ -1395,6 +2443,14 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
\end{description}
+\section{Online editing and collaboration}
+
+\begin{description}[style=unboxed]
+\item[Overleaf:] Collaborative editing of \LaTeX\ documents online.
+ \url{https://www.overleaf.com/}
+\end{description}
+
+
\section{Distributions \Dash \LaTeX\ for various operating systems}
\begin{description}[style=unboxed]
\item[TeXLive:] \url{http://tug.org/texlive} \hfill Unix and Windows
@@ -1404,6 +2460,7 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
\end{description}
+
\section{Change log}
\begin{description}[style=standard]
@@ -1419,18 +2476,18 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
\item[2018/03/24:] Added \pkg{interface3}, \pkg{dickimaw-novices}, \pkg{dickimaw-thesis}.
\item[2018/04/01:] Added TeXnique.fr.
\item[2018/06/28:] Added sections for non-English documents and general typesetting theory.
- Updated host and name for \TeX\ \acro{FAQ}. Added \pkg{latex-via-exemplos} and
+ Updated host and name for \TeX\ FAQ. Added \pkg{latex-via-exemplos} and
Ebook Foundation free programming books.
\item[2018/10/18:] Updated \acro{URL} for \pub{\LaTeXe: An unofficial reference manual}.
\item[2020/12/14:] Improved bibliography.
Added categories for math and music; \pkg{startlatex2e};
items written in French, German, Indian, Italian, Japanese, Portuguese, Vietnamese;
Dante users group.
+\item[2021/01/02:] Now uses \pkg{biblatex}.
+ Added \prog{mthelp}, many international documents,
+ and categories for \FAQ{}s and cheat sheets, graphics, tables, and fonts.
+ Added lists of packages by category. Added Overleaf.
\end{description}
-\printbibliography
-
-
-
\end{document}
diff --git a/info/first-packages/LICENSE b/info/first-packages/LICENSE
deleted file mode 100644
index 24862b6eeb..0000000000
--- a/info/first-packages/LICENSE
+++ /dev/null
@@ -1,5 +0,0 @@
-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
diff --git a/info/first-packages/README b/info/first-packages/README
deleted file mode 100644
index d39fa69113..0000000000
--- a/info/first-packages/README
+++ /dev/null
@@ -1,22 +0,0 @@
-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
diff --git a/info/first-packages/first-packages.html b/info/first-packages/first-packages.html
deleted file mode 100644
index f09cb1bc5d..0000000000
--- a/info/first-packages/first-packages.html
+++ /dev/null
Binary files differ
diff --git a/info/first-packages/first-packages.pdf b/info/first-packages/first-packages.pdf
deleted file mode 100644
index fe7200a836..0000000000
--- a/info/first-packages/first-packages.pdf
+++ /dev/null
Binary files differ
diff --git a/info/first-packages/first-packages.tex b/info/first-packages/first-packages.tex
deleted file mode 100644
index 47ce64ab1a..0000000000
--- a/info/first-packages/first-packages.tex
+++ /dev/null
@@ -1,384 +0,0 @@
-\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@unknown@warning
- \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
-}
-\newcommand{\SMC@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}
diff --git a/info/latex-doc-ptr/LICENSE b/info/latex-doc-ptr/LICENSE
new file mode 100644
index 0000000000..060b41738e
--- /dev/null
+++ b/info/latex-doc-ptr/LICENSE
@@ -0,0 +1,5 @@
+LICENSE
+
+This material, called latex-doc-ptr, is Public Domain.
+
+2020-Dec-31 Jim Hefferon, Karl Berry \ No newline at end of file
diff --git a/info/latex-doc-ptr/Makefile b/info/latex-doc-ptr/Makefile
index 3c72b22cce..61a11929cb 100644
--- a/info/latex-doc-ptr/Makefile
+++ b/info/latex-doc-ptr/Makefile
@@ -1,2 +1,70 @@
-latex-doc-ptr.pdf: latex-doc-ptr.tex latex-doc-ptr.sty
+# Makefile
+# For latex-doc-ptr.
+# 2020-Dec-31 Jim Hefferon
+
+latex-doc-ptr.pdf: latex-doc-ptr.tex latex-doc-ptr.sty dash.sty
pdflatex --file-line-error --interaction=nonstopmode $<
+
+latex-doc-ptr.html: latex-doc-ptr.tex latex-doc-ptr.sty dash.sty
+ make4ht latex-doc-ptr.tex
+ cp latex-doc-ptr.css.replacement latex-doc-ptr.css
+ # Get subsections headers
+ awk -f massage_html.awk <latex-doc-ptr.html > latex-doc-ptr-massaged.html
+ # Correct lost ligatures (all very fragile, but I can't grok tex4ht)
+ sed -e 's/>\Wname\W</>name</' \
+ -e 's/also available o\W*ine/also available offline/' \
+ -e 's/\W*nd them by/find them by/' \
+ -e 's/uno\W*cial reference/unofficial reference/' \
+ -e 's/Many web pages o\W*er quick help with/Many web pages offer quick help with/' \
+ -e 's/You are likely to \W*nd an answer/You are likely to find an answer/' \
+ -e 's/has the latest o\W*cial versions/has the latest official versions/' \
+ -e 's/If you have trouble \W*nding something/\n<p>If you have trouble finding something/' \
+ -e 's/any document containing signi\W*cant amounts of mathematics/any document containing significant amounts of mathematics/' \
+ -e 's/control \W*oating environments/control floating environments/' \
+ -e 's/override automatic \W*oat placement/override automatic float placement/' \
+ -e 's/cause issues \W what if/cause issues\&nbsp;\&mdash; what if/' \
+ -e 's/left? \W but it/left?\&nbsp;\&mdash; but it/' \
+ -e 's/and \W*le paths that can break/and file paths that can break/' \
+ -e 's/The \W*rst/The first/' \
+ -e 's/which lets you de\W*ne your own/which lets you define your own/' \
+ -e 's/scienti\W*c units,/scientific units,/' \
+ -e 's/often want to generate \W*ller text./often want to generate filler text./' \
+ -e 's/give the \W*le name without/give the file name without/' \
+ -e 's/lists of \W*gures/lists of figures/' \
+ -e 's/to an external \W*le/to an external file/' \
+ -e 's/via a completely di\W*erent/via a completely different/' \
+ -e 's/as \W*la-tech\W* or \W*lay-tech,\W*/as \&apos;la-tech\&apos; or \&apos;lay-tech\&apos;, /' \
+ -e 's/as as \Wla-tech\W or \Wlay-tech,\W apos;la-techas \Wla-tech\W or \Wlay-tech,\W apos; or as \Wla-tech\W or \Wlay-tech,\W apos;lay-techas \Wla-tech\W or \Wlay-tech,\W apos;,/as \&apos;la-tech&apos; or \&apos;lay-tech\&apos;, /' \
+ -e 's/We prefer the \Wrst,/We prefer the first,/' \
+ -e 's/the \Wrst syllable./the first syllable./' \
+ < latex-doc-ptr-massaged.html > latex-doc-ptr-massaged-ligs.html
+ # Correct lost paragraphs inside subsections
+ sed -e 's/Many people use/<p>&/' \
+ -e 's/If you have trouble/<p>&/' \
+ -e 's/As referred to above,/<p>&/' \
+ -e 's/Also, include/<p>&/' \
+ -e 's/Enhance captions/<p>&/' \
+ -e 's/Get hyperlinks/<p>&/' \
+ -e 's/Inside verbatim/<p>&/' \
+ -e 's/If you use Python,/<p>&/' \
+ -e 's/Make boxes that/<p>&/' \
+ -e 's/Use <a/<p>&/' \
+ -e 's/Finally, when/<p>&/' \
+ -e 's/To include/<p>&/' \
+ -e 's/In your plots/<p>&/' \
+ -e 's/For footnotes,/<p>&/' \
+ -e 's/Bibliographies are/<p>&/' \
+ -e 's/There are many/<p>&/' \
+ -e 's/To make presentations,/<p>&/' < latex-doc-ptr-massaged-ligs.html > latex-doc-ptr-massaged-pars.html
+ # Correct misc
+ sed -e 's/X E </Xe</' \
+ -e 's/Books <\/span><p>/Books <\/span>/' \
+ -e 's/filler text. <p>/filler text. /' \
+ < latex-doc-ptr-massaged-pars.html > latex-doc-ptr-massaged-misc.html
+ # Bring it back to latex-doc-ptr.html
+ cp latex-doc-ptr-massaged-misc.html latex-doc-ptr.html
+ rm latex-doc-ptr-massaged-ligs.html \
+ latex-doc-ptr-massaged-pars.html \
+ latex-doc-ptr-massaged-misc.html
+
+all: latex-doc-ptr.pdf latex-doc-ptr.html
diff --git a/info/latex-doc-ptr/README b/info/latex-doc-ptr/README
index 37b1735074..dfb20a8bc6 100644
--- a/info/latex-doc-ptr/README
+++ b/info/latex-doc-ptr/README
@@ -1,20 +1,44 @@
latex-doc-ptr
-This is intended as the document that comes up when a person runs
+ This is intended as the document that comes up when a person runs
'texdoc latex'. The idea is that an exhaustive reference for LaTeX
is not what the overwhelming majority of users would find useful at
-that point. So instead, in addition to naming such a reference,
-it points to a selection of docs that may be of value to a variety
-of users.
+that point. Instead, it gives a selection of resources, for a
+variety of users.
+
+ See also http://mirror.ctan.org/info/first-latex-doc .
-See also http://www.ctan.org/tex-archive/info/first-latex-doc .
License:
public domain
+
+Install:
+ If you have a recent TeX distribution,
+ pdflatex latex-doc-ptr
+should do nicely.
+
+ My version of TeX is old, so I have some trouble with tex4ht. If you
+are in my situation then try the Makefile, which does a lot of hacking.
+
+
+Notes:
+
+1) My version of make4ht requires that I change
+ \def\IfFileExists#1#2#3{%
+to
+ \long\def\IfFileExists#1#2#3{%
+in a local copy of tex4ht.sty. See https://tex.stackexchange.com/a/423729/339
+
+2) Repo is here.
+ https://gitlab.com/jim.hefferon/latex-doc-ptr
+
+
Comments to:
- Jim Hefferon email ftpmaint at tug.ctan.org
+ Jim Hefferon email jhefferon@smcvt.edu
+
History:
+ 2021-Jan-02 JH, KB Merged with another doc, first-packages.
2009-Mar-24 Jim Hefferon, Manuel Pégourié-Gonnard, Karl Berry
diff --git a/info/latex-doc-ptr/dash.sty b/info/latex-doc-ptr/dash.sty
new file mode 100644
index 0000000000..3654dd2d69
--- /dev/null
+++ b/info/latex-doc-ptr/dash.sty
@@ -0,0 +1,11 @@
+% Dash code stolen from tugboat.dtx
+\def\thinskip{\hskip 0.16667em\relax}
+\def\endash{--}
+\def\emdash{\endash-}
+\def\d@sh#1#2{\unskip#1\thinskip#2\thinskip\ignorespaces}
+\def\dash{\d@sh\nobreak\endash}
+\def\Dash{\d@sh\nobreak\emdash}
+\def\ldash{\d@sh\empty{\hbox{\endash}\nobreak}}
+\def\rdash{\d@sh\nobreak\endash}
+\def\Ldash{\d@sh\empty{\hbox{\emdash}\nobreak}}
+\def\Rdash{\d@sh\nobreak\emdash}
diff --git a/info/first-packages/first-packages.css b/info/latex-doc-ptr/latex-doc-ptr.css
index 137a7b50cb..d3af60f188 100644
--- a/info/first-packages/first-packages.css
+++ b/info/latex-doc-ptr/latex-doc-ptr.css
@@ -1,16 +1,23 @@
/* 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%;}
+.Spectral-Light-osf-t-1x-x-109{}
+.Spectral-Bold-osf-t-1x-x-172{font-size:156%;}
+.ectt-1095{ font-family: monospace;}
+.ectt-1095{ font-family: monospace;}
+.ectt-1095{ font-family: monospace;}
+.Spectral-Bold-osf-t-1x-x-109{}
+.cmr-8{font-size:72%;}
+.cmr-6{font-size:54%;}
+.cmmi-10x-x-109{font-style: italic;}
+.Spectral-Light-osf-t-1{font-size:90%;}
+.ectt-1000{font-size:90%; font-family: monospace;}
+.ectt-1000{ font-family: monospace;}
+.ectt-1000{ font-family: monospace;}
+.Spectral-LightItalic-osf-t-1x-x-109{}
+.Spectral-Light-osf-sc-t-1x-x-109{}
+.ectt-0900{font-size:81%; font-family: monospace;}
+.ectt-0900{ font-family: monospace;}
+.ectt-0900{ font-family: monospace;}
p.noindent { text-indent: 0em }
td p.noindent { text-indent: 0em; margin-top:0em; }
p.nopar { text-indent: 0em; }
@@ -38,7 +45,7 @@ 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; }
+.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
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%;}
@@ -49,7 +56,7 @@ 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, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
.framebox-c {text-align:center;}
.framebox-l {text-align:left;}
.framebox-r {text-align:right;}
@@ -97,7 +104,6 @@ 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}
@@ -125,14 +131,18 @@ div.lstlisting{font-family: monospace; white-space: nowrap; margin-top:0.5em; ma
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; }
+/* .columns-2{-moz-column-count:2; -webkit-column-count:2; column-count:2; -moz-column-gap: 27.2197pt; -webkit-column-gap: 27.2197pt; column-gap: 27.2197pt; -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%;}
+/* Adjust the generated defs */
+.Spectral-Bold-lf-t-1x-x-172 {font-size:156%;
+ font-weight: bold;} /* doc title in bold */
+.Spectral-Bold-lf-t-1x-x-109 {margin-top:2em;
+ font-weight: bold;
+ margin-right: 0.25em} /* run-in subsection name */
+p.indent{ text-indent: 0em } /* make all paragraphs un-indented */
+a { text-decoration: none; } /* remove underlines, since below LaTeX is ugly*/
+
+.Spectral-LightItalic-lf-t-1x-x-109 { font-style: italic;
+ } /* make "name" in `texdoc name' */
diff --git a/info/latex-doc-ptr/latex-doc-ptr.css.replacement b/info/latex-doc-ptr/latex-doc-ptr.css.replacement
new file mode 100644
index 0000000000..db1fcd494c
--- /dev/null
+++ b/info/latex-doc-ptr/latex-doc-ptr.css.replacement
@@ -0,0 +1,148 @@
+
+/* start css.sty */
+.Spectral-Light-osf-t-1x-x-109{}
+.Spectral-Bold-osf-t-1x-x-172{font-size:156%;}
+.ectt-1095{ font-family: monospace;}
+.ectt-1095{ font-family: monospace;}
+.ectt-1095{ font-family: monospace;}
+.Spectral-Bold-osf-t-1x-x-109{}
+.cmr-8{font-size:72%;}
+.cmr-6{font-size:54%;}
+.cmmi-10x-x-109{font-style: italic;}
+.Spectral-Light-osf-t-1{font-size:90%;}
+.ectt-1000{font-size:90%; font-family: monospace;}
+.ectt-1000{ font-family: monospace;}
+.ectt-1000{ font-family: monospace;}
+.Spectral-LightItalic-osf-t-1x-x-109{}
+.Spectral-Light-osf-sc-t-1x-x-109{}
+.ectt-0900{font-size:81%; font-family: monospace;}
+.ectt-0900{ font-family: monospace;}
+.ectt-0900{ font-family: monospace;}
+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 }
+@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.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
+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.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
+.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;}
+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: 27.2197pt; -webkit-column-gap: 27.2197pt; column-gap: 27.2197pt; -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 */
+/* Adjust the generated defs */
+.Spectral-Bold-lf-t-1x-x-172 {font-size:156%;
+ font-weight: bold;} /* doc title in bold */
+.Spectral-Bold-lf-t-1x-x-109 {margin-top:2em;
+ font-weight: bold;
+ margin-right: 0.25em} /* run-in subsection name */
+p.indent{ text-indent: 0em } /* make all paragraphs un-indented */
+a { text-decoration: none; } /* remove underlines, since below LaTeX is ugly*/
+
+.Spectral-LightItalic-osf-t-1x-x-109 { font-style: italic;
+ } /* make "name" in `texdoc name' */
diff --git a/info/latex-doc-ptr/latex-doc-ptr.html b/info/latex-doc-ptr/latex-doc-ptr.html
new file mode 100644
index 0000000000..674de5fabb
--- /dev/null
+++ b/info/latex-doc-ptr/latex-doc-ptr.html
@@ -0,0 +1,778 @@
+
+<?xml version="1.0" encoding="iso-8859-1" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
+<html xmlns="http://www.w3.org/1999/xhtml"
+>
+<head><title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)" />
+<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)" />
+<!-- xhtml,html -->
+<meta name="src" content="latex-doc-ptr.tex" />
+<link rel="stylesheet" type="text/css" href="latex-doc-ptr.css" />
+</head><body
+>
+<div class="center"
+>
+<!--l. 6--><p class="noindent" >
+</p><!--l. 7--><p class="noindent" ><span
+class="Spectral-Bold-lf-t-1x-x-172">A First Set of </span><span class="LATEX"><span
+class="Spectral-Bold-lf-t-1x-x-172">L</span><span class="A"><span
+class="Spectral-Bold-lf-t-1x-x-172">A</span></span><span class="TEX"><span
+class="Spectral-Bold-lf-t-1x-x-172">T</span><span
+class="E"><span
+class="Spectral-Bold-lf-t-1x-x-172">E</span></span><span
+class="Spectral-Bold-lf-t-1x-x-172">X</span></span></span> <span
+class="Spectral-Bold-lf-t-1x-x-172">Resources</span></p></div>
+ <div class="columns-2">
+<!--l. 17--><p class="indent" > This page suggests documentation, add-on components, and other resources for a beginning <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>
+user.
+</p><!--l. 20--><p class="indent" > The links here are to freely available materials, so you can click to see the documentation online. Where
+the documentation is also available offline in a typical <span class="TEX">T<span
+class="E">E</span>X</span> installation, we provide its name as an end note.
+View it by running `<span
+class="ectt-1095">texdoc </span><span
+class="Spectral-LightItalic-lf-t-1x-x-109">name</span>' in a terminal.
+</p>
+<h3 class="sectionHead"><a
+ id="x1-1000"></a>Starting</h3>
+<!--l. 32--><p class="noindent" >To run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>, you must use an online service or install a distribution. Online services are commercial;
+find them by entering `online latex' in a search engine. For distributions, your choices are <a
+href="https://tug.org/texlive/" ><span class="TEX">T<span
+class="E">E</span>X</span>&#x00A0;Live</a> on a
+Unix system, including GNU/Linux, or on Windows, or the related <a
+href="https://tug.org/mactex/" >Mac<span class="TEX">T<span
+class="E">E</span>X</span></a> on Macintosh, or <a
+href="https://miktex.org/" >MiK<span class="TEX">T<span
+class="E">E</span>X</span></a> on
+Windows or a Unix system.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Tutorials </span>The site <a
+href="https://www.learnlatex.org/" ><span
+class="ectt-1095">learnlatex.org</span></a> teaches you the basics in a sound way, and also lets you play with the
+commands to see the results. For a more traditional document, the most widely recommended one is <a
+href="https://ctan.org/pkg/lshort-english" >The
+Not-So Short Guide to <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>2<span
+class="cmmi-10x-x-109">&#x03B5;</span></a>, available in many languages.<sup><a
+href="#ennote-1" id="enmark-1"><span
+class="cmr-8">1</span></a></sup>
+ <p>Many people use <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> to write mathematical text and for this the premier choice is from the
+American Mathematical Society. See their <a
+href="http://mirror.ctan.org/info/amslatex/primer/amshelp.pdf" >Getting up and running with AMS-<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span></a>,<sup><a
+href="#ennote-2" id="enmark-2"><span
+class="cmr-8">2</span></a></sup> and more detail is
+in <a
+href="http://mirror.ctan.org/macros/latex/required/amsmath/amsldoc.pdf" >Users Guide for the <span
+class="ectt-1095">amsmath </span>package</a>.<sup><a
+href="#ennote-3" id="enmark-3"><span
+class="cmr-8">3</span></a></sup>
+</p>
+<h3 class="sectionHead"><a
+ id="x1-2000"></a>Documentation</h3>
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">References </span>The nearest thing to a general reference for <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> is <a
+href="http://mirror.ctan.org/info/latex2e-help-texinfo/latex2e.html" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>2<span
+class="cmmi-10x-x-109">&#x03B5;</span> unofficial reference manual</a>.<sup><a
+href="#ennote-4" id="enmark-4"><span
+class="cmr-8">4</span></a></sup>
+Look for symbols in the <a
+href="http://mirror.ctan.org/info/symbols/comprehensive/symbols-letter.pdf" >Comprehensive List of Symbols</a>.<sup><a
+href="#ennote-5" id="enmark-5"><span
+class="cmr-8">5</span></a></sup> And, <a
+href="https://tug.org/TUGboat/" >TUGboat</a>, the journal of the <a
+href="https://tug.org" ><span class="TEX">T<span
+class="E">E</span>X</span> Users
+Group</a>, has published many articles, at levels from beginner to expert, almost since the inception of
+<span class="TEX">T<span
+class="E">E</span>X</span>.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">FAQs </span>Many web pages offer quick help with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>, although they can be out of date. Particularly useful
+and reliable are the <a
+href="https://texfaq.org/" ><span class="TEX">T<span
+class="E">E</span>X</span> FAQ</a>,<sup><a
+href="#ennote-6" id="enmark-6"><span
+class="cmr-8">6</span></a></sup> as well as <a
+href="https://tug.org/interest.html" ><span class="TEX">T<span
+class="E">E</span>X</span> Resources on the Web</a>. You can also get a handy
+general <a
+href="http://mirror.ctan.org/info/latexcheat/latexcheat/latexsheet.pdf" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> Cheat Sheet</a>,<sup><a
+href="#ennote-7" id="enmark-7"><span
+class="cmr-8">7</span></a></sup> as well as the <a
+href="http://mirrors.ctan.org/info/undergradmath/undergradmath.pdf" >Math for Undergraduates Cheat Sheet</a>.<sup><a
+href="#ennote-8" id="enmark-8"><span
+class="cmr-8">8</span></a></sup> Also,
+<a
+href="http://mirror.ctan.org/info/l2tabu/english/l2tabuen.pdf" >An essential guide to <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>2<span
+class="cmmi-10x-x-109">&#x03B5;</span> usage</a><sup><a
+href="#ennote-9" id="enmark-9"><span
+class="cmr-8">9</span></a></sup> helps you develop sound habits, by saying what not to
+do.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Questions </span>If you are stuck on an issue, the <a
+href="https://tex.stackexchange.com/" ><span class="TEX">T<span
+class="E">E</span>X</span>-<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> Stack Exchange</a> site and the mailing list
+<a
+href="https://lists.tug.org/texhax" >texhax@tug.org</a> are where knowledgeable people hang out. You are likely to find an answer in their past
+discussions, which cover decades, and if not then you can post a question yourself.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Books </span>There are many excellent books about <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>. Visit the <a
+href="https://tug.org/books/" ><span class="TEX">T<span
+class="E">E</span>X</span> Users Group's book list</a> for a
+selection, and for discounts.
+<h3 class="sectionHead"><a
+ id="x1-3000"></a>Packages</h3>
+<!--l. 131--><p class="noindent" >One of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>'s strengths is the tremendous number of available add-on packages. This list covers most of
+what beginners want to do. (There are some comments in parentheses that often come up in conjunction
+
+
+with these recommendations.)
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Our archive </span>The Comprehensive <span class="TEX">T<span
+class="E">E</span>X</span> Archive Network, <a
+href="https://ctan.org" ><span
+class="Spectral-Light-lf-t-1">CTAN</span></a>, has the latest official versions of the
+packages that are in the distributions, along with documentation. <a
+href="https://ctan.org/topics/cloud" >Browsing by topic</a> can be very
+handy.
+
+<p><p>If you have trouble finding something, it may be the house package of a journal or institution. Look on
+their web page as well as on <span
+class="Spectral-Light-lf-t-1">CTAN</span>.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Every document </span>To change page size, margins, and orientation, use <a
+href="https://ctan.org/pkg/geometry" ><span
+class="ectt-1095">geometry</span></a>.<sup><a
+href="#ennote-10" id="enmark-10"><span
+class="cmr-8">10</span></a></sup> Get multiple columns
+with <a
+href="https://ctan.org/pkg/multicol" ><span
+class="ectt-1095">multicol</span></a>.<sup><a
+href="#ennote-11" id="enmark-11"><span
+class="cmr-8">11</span></a></sup>
+ <p>As referred to above, any document containing significant amounts of mathematics should use the
+American Mathematical Society's packages <a
+href="https://ctan.org/pkg/amsmath" ><span
+class="ectt-1095">amsmath</span></a><sup><a
+href="#ennote-12" id="enmark-12"><span
+class="cmr-8">12</span></a></sup> and <a
+href="https://ctan.org/pkg/amsfonts" ><span
+class="ectt-1095">amsfonts</span></a>.<sup><a
+href="#ennote-13" id="enmark-13"><span
+class="cmr-8">13</span></a></sup> Also use their <a
+href="https://ctan.org/pkg/amsthm" ><span
+class="ectt-1095">amsthm</span></a><sup><a
+href="#ennote-14" id="enmark-14"><span
+class="cmr-8">14</span></a></sup> for
+producing theorem environments. Notes: (1)&#x00A0;<a
+href="https://ctan.org/pkg/amsfonts" ><span
+class="ectt-1095">amssymb</span></a> inputs <a
+href="https://ctan.org/pkg/amsfonts" ><span
+class="ectt-1095">amsfonts</span></a> so load the former instead of the
+latter, (2)&#x00A0;many authors also use the calligraphic characters in <a
+href="https://ctan.org/pkg/rsfs" ><span
+class="ectt-1095">rsfs</span></a>,<sup><a
+href="#ennote-15" id="enmark-15"><span
+class="cmr-8">15</span></a></sup> (3)&#x00A0;get bold math symbols with <a
+href="https://ctan.org/pkg/bm" ><span
+class="ectt-1095">bm</span></a>,<sup><a
+href="#ennote-16" id="enmark-16"><span
+class="cmr-8">16</span></a></sup>
+(4)&#x00A0;don't load <a
+href="https://ctan.org/pkg/amsmath" ><span
+class="ectt-1095">amsmath</span></a> directly, instead get it by loading <a
+href="https://ctan.org/pkg/mathtools" ><span
+class="ectt-1095">mathtools</span></a><sup><a
+href="#ennote-17" id="enmark-17"><span
+class="cmr-8">17</span></a></sup> for some useful improvements, and
+(4)&#x00A0;load <a
+href="https://ctan.org/pkg/amsthm" ><span
+class="ectt-1095">amsthm</span></a> after <a
+href="https://ctan.org/pkg/mathtools" ><span
+class="ectt-1095">mathtools</span></a>.
+ <p>Also, include <a
+href="https://ctan.org/pkg/microtype" ><span
+class="ectt-1095">microtype</span></a>.<sup><a
+href="#ennote-18" id="enmark-18"><span
+class="cmr-8">18</span></a></sup> It will make your document have fewer awkward lines.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Inside a document </span>Tweak the layout of lists with <a
+href="https://ctan.org/pkg/enumitem" ><span
+class="ectt-1095">enumitem</span></a>.<sup><a
+href="#ennote-19" id="enmark-19"><span
+class="cmr-8">19</span></a></sup>
+ <p>Enhance captions with <a
+href="https://ctan.org/pkg/caption" ><span
+class="ectt-1095">caption</span></a><sup><a
+href="#ennote-20" id="enmark-20"><span
+class="cmr-8">20</span></a></sup> and control floating environments with <a
+href="https://ctan.org/pkg/float" ><span
+class="ectt-1095">float</span></a>.<sup><a
+href="#ennote-21" id="enmark-21"><span
+class="cmr-8">21</span></a></sup> (In particular, this
+package provides the `<span
+class="ectt-1095">H</span>' option to override automatic float placement and put something exactly where you
+ask. This may cause issues&nbsp;&mdash; what if you want to include a two inch tall graphic on a page that has only an
+inch left?&nbsp;&mdash; but it sometimes is what you want.)
+ <p>Get hyperlinks and turn references into links with <a
+href="https://ctan.org/pkg/hyperref" ><span
+class="ectt-1095">hyperref</span></a><sup><a
+href="#ennote-22" id="enmark-22"><span
+class="cmr-8">22</span></a></sup> (make sure to set it up, as with
+<span class="lstinline"></span><span
+class="ectt-1000">\</span><span
+class="ectt-1000">hypersetup</span><span
+class="ectt-1000">{</span><span
+class="ectt-1000">colorlinks</span><span
+class="ectt-1000">=</span><span
+class="ectt-1000">true</span><span
+class="ectt-1000">}</span>). Have cross-references that say `Theorem&#x00A0;1.2' instead of just `1.2' with
+<a
+href="https://ctan.org/pkg/cleveref" ><span
+class="ectt-1095">cleveref</span></a>.<sup><a
+href="#ennote-23" id="enmark-23"><span
+class="cmr-8">23</span></a></sup> For <span
+class="Spectral-Light-lf-t-1">URL</span>'s and file paths that can break across lines, use <a
+href="https://ctan.org/pkg/url" ><span
+class="ectt-1095">url</span></a>.<sup><a
+href="#ennote-24" id="enmark-24"><span
+class="cmr-8">24</span></a></sup> (If you use <a
+href="https://ctan.org/pkg/hyperref" ><span
+class="ectt-1095">hyperref</span></a> then note
+that it has its own commands for the <a
+href="https://ctan.org/pkg/cleveref" ><span
+class="ectt-1095">cleveref</span></a> and <a
+href="https://ctan.org/pkg/url" ><span
+class="ectt-1095">url</span></a> functions.)
+ <p>Inside verbatim text, make single quotes come out correctly with <a
+href="https://ctan.org/pkg/upquote" ><span
+class="ectt-1095">upquote</span></a>.<sup><a
+href="#ennote-25" id="enmark-25"><span
+class="cmr-8">25</span></a></sup> For including computer
+code, the <a
+href="https://ctan.org/pkg/listings" ><span
+class="ectt-1095">listings</span></a><sup><a
+href="#ennote-26" id="enmark-26"><span
+class="cmr-8">26</span></a></sup> package is very popular. (Copy and paste for computer code is especially convenient.
+This is a start for the <a
+href="https://ctan.org/pkg/listings" ><span
+class="ectt-1095">listings</span></a> package. </p><!--l. 219-->
+ <div class="lstlisting" id="listing-1"><span class="label"><a
+ id="x1-3001r1"></a></span><span
+class="ectt-1000">\</span><span
+class="ectt-1000">lstset</span><span
+class="ectt-1000">{</span><span
+class="ectt-1000">basicstyle</span><span
+class="ectt-1000">=\</span><span
+class="ectt-1000">ttfamily</span><span
+class="ectt-1000">,</span><span
+class="ectt-1000">&#x00A0;</span><br /><span class="label"><a
+ id="x1-3002r2"></a></span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">keepspaces</span><span
+class="ectt-1000">=</span><span
+class="ectt-1000">true</span><span
+class="ectt-1000">,</span><span
+class="ectt-1000">&#x00A0;</span><br /><span class="label"><a
+ id="x1-3003r3"></a></span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">&#x00A0;</span><span
+class="ectt-1000">columns</span><span
+class="ectt-1000">=</span><span
+class="ectt-1000">fullflexible</span><span
+class="ectt-1000">}</span>
+
+ </div>
+ But it is not a full solution. The results depend on the <span
+class="Spectral-Light-lf-t-1">PDF </span>viewer and worse, if your code line begins
+with blank spaces then after copy and paste those spaces are gone.)
+ <p>If you use Python, <a
+href="https://ctan.org/pkg/pythontex" ><span
+class="ectt-1095">pythontex</span></a><sup><a
+href="#ennote-27" id="enmark-27"><span
+class="cmr-8">27</span></a></sup> 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="Spectral-LightItalic-lf-t-1x-x-109">Sage </span>mathematics software with <a
+href="https://ctan.org/pkg/sagetex" ><span
+class="ectt-1095">sagetex</span></a>, and similar
+support exists for other languages.
+ <p>There are many packages that add table capabilities, such as multirow entries and breaking across
+pages. The first package to try is <a
+href="https://ctan.org/pkg/array" ><span
+class="ectt-1095">array</span></a>,<sup><a
+href="#ennote-28" id="enmark-28"><span
+class="cmr-8">28</span></a></sup> which lets you define your own column types. To handle
+scientific units, use <a
+href="https://ctan.org/pkg/siunitx" ><span
+class="ectt-1095">siunitx</span></a><sup><a
+href="#ennote-29" id="enmark-29"><span
+class="cmr-8">29</span></a></sup> (which also has a table column type for aligning on a decimal
+point).
+ <p>Make boxes that are colored or framed, such as boxes for theorems, with <a
+href="https://ctan.org/pkg/tcolorbox" ><span
+class="ectt-1095">tcolorbox</span></a>.<sup><a
+href="#ennote-30" id="enmark-30"><span
+class="cmr-8">30</span></a></sup>
+ <p>Use <a
+href="https://ctan.org/pkg/babel" ><span
+class="ectt-1095">babel</span></a><sup><a
+href="#ennote-31" id="enmark-31"><span
+class="cmr-8">31</span></a></sup> for internationalization, including changing the title of the abstract or the bibliography.
+(Note that <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.)
+ <p>Finally, when developing a document, you often want to generate filler text. Use <a
+href="https://ctan.org/pkg/lipsum" ><span
+class="ectt-1095">lipsum</span></a>.<sup><a
+href="#ennote-32" id="enmark-32"><span
+class="cmr-8">32</span></a></sup>
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Color and graphics </span>For colors, use <a
+href="https://ctan.org/pkg/xcolor" ><span
+class="ectt-1095">xcolor</span></a>.<sup><a
+href="#ennote-33" id="enmark-33"><span
+class="cmr-8">33</span></a></sup>
+ <p>To include graphics and do simple manipulations such as resizing, use <a
+href="https://ctan.org/pkg/graphicx" ><span
+class="ectt-1095">graphicx</span></a>.<sup><a
+href="#ennote-34" id="enmark-34"><span
+class="cmr-8">34</span></a></sup> Use the <span
+class="Spectral-Light-lf-t-1">JPG </span>format
+for photos, <span
+class="Spectral-Light-lf-t-1">PNG </span>for other kinds of raster graphics, and <span
+class="Spectral-Light-lf-t-1">PDF </span>for vector graphics. If your graphic is in another
+
+
+format then convert it to one of these three. (Usually in your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> source, you give the file name without
+the extension, as with <span class="lstinline"></span><span
+class="ectt-1000">\</span><span
+class="ectt-1000">includegraphics</span><span
+class="ectt-1000">{</span><span
+class="ectt-1000">myplot</span><span
+class="ectt-1000">}</span>.) Include parts of an outside <span
+class="Spectral-Light-lf-t-1">PDF </span>document with
+<a
+href="https://ctan.org/pkg/pdfpages" ><span
+class="ectt-1095">pdfpages</span></a>.<sup><a
+href="#ennote-35" id="enmark-35"><span
+class="cmr-8">35</span></a></sup> Include video or sound using <a
+href="https://ctan.org/pkg/media9" ><span
+class="ectt-1095">media9</span></a>.<sup><a
+href="#ennote-36" id="enmark-36"><span
+class="cmr-8">36</span></a></sup>
+ <p>In your plots and graphics, you want that the fonts and notations match your document. You have a few
+choices. Draw inside your document with <a
+href="https://ctan.org/pkg/pgf" >Ti<span
+class="Spectral-LightItalic-lf-t-1x-x-109">k</span>Z</a>.<sup><a
+href="#ennote-37" id="enmark-37"><span
+class="cmr-8">37</span></a></sup> You can instead draw using an external command
+language such as <a
+href="https://asymptote.sourceforge.io/" >Asymptote</a>,<sup><a
+href="#ennote-38" id="enmark-38"><span
+class="cmr-8">38</span></a></sup> and bring the results in as graphics. And there are other options, such as
+that the <a
+href="http://www.gnuplot.info/" >Gnuplot</a> plotting software will output Ti<span
+class="Spectral-LightItalic-lf-t-1x-x-109">k</span>Z commands, and the <a
+href="https://inkscape.org/" >Inkscape</a> vector graphics editor
+allows you to embed <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>-generated equations.
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Front and back matter, headers, footers </span>To style chapter and section titles, use <a
+href="https://ctan.org/pkg/titlesec" ><span
+class="ectt-1095">titlesec</span></a>.<sup><a
+href="#ennote-39" id="enmark-39"><span
+class="cmr-8">39</span></a></sup> For page
+headers and footers, reach for <a
+href="https://ctan.org/pkg/fancyhdr" ><span
+class="ectt-1095">fancyhdr</span></a>.<sup><a
+href="#ennote-40" id="enmark-40"><span
+class="cmr-8">40</span></a></sup> You can tweak the format of tables of contents, lists of figures,
+etc., with <a
+href="https://ctan.org/pkg/tocloft" ><span
+class="ectt-1095">tocloft</span></a>.<sup><a
+href="#ennote-41" id="enmark-41"><span
+class="cmr-8">41</span></a></sup>
+ <p>For footnotes, use <a
+href="https://ctan.org/pkg/footmisc" ><span
+class="ectt-1095">footmisc</span></a>.<sup><a
+href="#ennote-42" id="enmark-42"><span
+class="cmr-8">42</span></a></sup> Make an index with <a
+href="https://ctan.org/pkg/makeindex" ><span
+class="ectt-1095">makeindex</span></a>.<sup><a
+href="#ennote-43" id="enmark-43"><span
+class="cmr-8">43</span></a></sup> With <a
+href="https://ctan.org/pkg/answers" ><span
+class="ectt-1095">answers</span></a><sup><a
+href="#ennote-44" id="enmark-44"><span
+class="cmr-8">44</span></a></sup> you can send exercise
+answers to an external file, where you can make them a separate document or include them at the end of the
+current one.
+ <p>Bibliographies are a thorny area. Often you have strict requirements, such as from the <a
+href="https://ctan.org/pkg/MLA" ><span
+class="ectt-1095">MLA</span></a>.<sup><a
+href="#ennote-45" id="enmark-45"><span
+class="cmr-8">45</span></a></sup> <span
+class="Spectral-Light-lf-t-1">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="Spectral-Light-lf-sc-t-1x-x-109">ib</span><span class="TEX">T<span
+class="E">E</span>X</span></a><sup><a
+href="#ennote-46" id="enmark-46"><span
+class="cmr-8">46</span></a></sup> and <a
+href="https://ctan.org/topic/biblatex" >B<span
+class="Spectral-Light-lf-sc-t-1x-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>.<sup><a
+href="#ennote-47" id="enmark-47"><span
+class="cmr-8">47</span></a></sup>
+<p class="subsection"><span
+class="Spectral-Bold-lf-t-1x-x-109">Special documents </span>Make exams and problem sets with the <a
+href="https://ctan.org/pkg/exam" ><span
+class="ectt-1095">exam</span></a><sup><a
+href="#ennote-48" id="enmark-48"><span
+class="cmr-8">48</span></a></sup> class.
+ <p>There are many, many resume and CV packages. Start with <span
+class="Spectral-Light-lf-t-1">CTAN</span>'s <a
+href="https://ctan.org/topic/cv" >cv topic</a>.
+ <p>To make presentations, use the <a
+href="https://ctan.org/pkg/beamer" ><span
+class="ectt-1095">beamer</span></a><sup><a
+href="#ennote-49" id="enmark-49"><span
+class="cmr-8">49</span></a></sup> class. (However, 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.)
+<h3 class="sectionHead"><a
+ id="x1-4000"></a>Fonts and engines</h3>
+<!--l. 344--><p class="noindent" >The documentation for font use commands from the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> developers is <a
+href="http://mirror.ctan.org/macros/latex/base/fntguide.pdf" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>2<span
+class="cmmi-10x-x-109">&#x03B5;</span> font selection</a>.<sup><a
+href="#ennote-50" id="enmark-50"><span
+class="cmr-8">50</span></a></sup>
+</p><!--l. 348--><p class="indent" > To move beyond the default fonts, visit the <a
+href="https://tug.org/FontCatalogue/" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span>&#x00A0;Font Catalogue</a>, which includes copy and paste code
+to make each one work.
+</p><!--l. 353--><p class="indent" > Beyond that list, you can also use your computer system's fonts (beware this makes your source
+harder to share with friends, though). The background is:&#x00A0;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="Spectral-Light-lf-t-1">PDF</span>
+output there are three varieties of the <span class="TEX">T<span
+class="E">E</span>X</span> engine. Currently the most common is <a
+href="https://tug.org/applications/pdftex/" >pdf<span class="TEX">T<span
+class="E">E</span>X</span></a>.<sup><a
+href="#ennote-51" id="enmark-51"><span
+class="cmr-8">51</span></a></sup>
+For instance, this document was generated with <span class="obeylines-h"><span class="verb"><span
+class="ectt-1095">pdflatex</span><span
+class="ectt-1095">&#x00A0;latex-doc-ptr.tex</span></span></span>. Two further
+developments, <a
+href="https://tug.org/xetex/" >Xe<span class="TEX">T<span
+class="E">E</span>X</span></a>,<sup><a
+href="#ennote-52" id="enmark-52"><span
+class="cmr-8">52</span></a></sup> and <a
+href="http://www.luatex.org/" >Lua<span class="TEX">T<span
+class="E">E</span>X</span></a>,<sup><a
+href="#ennote-53" id="enmark-53"><span
+class="cmr-8">53</span></a></sup> can leverage the <a
+href="https://ctan.org/pkg/fontspec" ><span
+class="ectt-1095">fontspec</span></a><sup><a
+href="#ennote-54" id="enmark-54"><span
+class="cmr-8">54</span></a></sup> package to use your system's fonts,
+such as OpenType and TrueType fonts, in addition to the ones from your <span class="TEX">T<span
+class="E">E</span>X</span> distribution.
+(Mathematics requires much special tuning, though, so most of the time you cannot use system fonts for
+math.)
+</p><!--l. 376--><p class="indent" > More is on the <a
+href="https://tug.org/fonts/" ><span class="TEX">T<span
+class="E">E</span>X</span> Users Group's font page</a>.
+</p>
+<h3 class="sectionHead"><a
+ id="x1-5000"></a>Writing <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span></h3>
+<!--l. 386--><p class="noindent" ><p>There are many ways to make writing <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> source easier. Most people use a source code editor, such as
+<a
+href="https://www.texstudio.org/" ><span class="TEX">T<span
+class="E">E</span>X</span>studio</a>, or Emacs with the add-on mode <a
+href="https://www.gnu.org/software/auctex/" >AUC-<span class="TEX">T<span
+class="E">E</span>X</span></a>, or <a
+href="https://pages.uoregon.edu/koch/texshop/" ><span class="TEX">T<span
+class="E">E</span>X</span>Shop</a> on a Mac.
+</p>
+<h3 class="sectionHead"><a
+ id="x1-6000"></a>Pronunciation</h3>
+<!--l. 401--><p class="noindent" >Pronounce <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+class="E">E</span>X</span></span> as &apos;la-tech&apos; or &apos;lay-tech&apos;, with emphasis on either syllable. We prefer the first, with
+emphasis on the first syllable.
+</p>
+<h3 class="sectionHead"><a
+ id="x1-7000"></a>Welcome to the community!</h3>
+<!--l. 409--><p class="noindent" >One reason that all of these resources are available is the work of the many <a
+href="https://tug.org/usergroups.html" >user groups</a>, including the <a
+href="https://tug.org/" ><span class="TEX">T<span
+class="E">E</span>X</span>
+
+
+Users Group</a>. Please consider joining.
+</p><!--l. 421--><p class="noindent" >_________________________________________________________________________________________
+</p>
+<h3 class="sectionHead"><a
+ id="x1-8000"></a>Package names, for texdoc</h3>
+<!--l. 424--><p class="noindent" ></p><!--l. 4--><p class="indent" > <a
+href="#enmark-1" id="ennote-1"><sup><span
+class="cmr-6">1</span></sup></a><a
+href="https://ctan.org/pkg/lshort" ><span
+class="ectt-0900">lshort</span></a> <a
+href="#enmark-2" id="ennote-2"><sup><span
+class="cmr-6">2</span></sup></a><a
+href="https://ctan.org/pkg/amshelp" ><span
+class="ectt-0900">amshelp</span></a> <a
+href="#enmark-3" id="ennote-3"><sup><span
+class="cmr-6">3</span></sup></a><a
+href="https://ctan.org/pkg/amsmath" ><span
+class="ectt-0900">amsmath</span></a> <a
+href="#enmark-4" id="ennote-4"><sup><span
+class="cmr-6">4</span></sup></a><a
+href="https://ctan.org/pkg/latex2e" ><span
+class="ectt-0900">latex2e</span></a> <a
+href="#enmark-5" id="ennote-5"><sup><span
+class="cmr-6">5</span></sup></a><a
+href="https://ctan.org/pkg/comprehensive" ><span
+class="ectt-0900">comprehensive</span></a> <a
+href="#enmark-6" id="ennote-6"><sup><span
+class="cmr-6">6</span></sup></a><a
+href="https://ctan.org/pkg/faq" ><span
+class="ectt-0900">faq</span></a> <a
+href="#enmark-7" id="ennote-7"><sup><span
+class="cmr-6">7</span></sup></a><a
+href="https://ctan.org/pkg/latexcheat" ><span
+class="ectt-0900">latexcheat</span></a> <a
+href="#enmark-8" id="ennote-8"><sup><span
+class="cmr-6">8</span></sup></a><a
+href="https://ctan.org/pkg/undergradmath" ><span
+class="ectt-0900">undergradmath</span></a> <a
+href="#enmark-9" id="ennote-9"><sup><span
+class="cmr-6">9</span></sup></a><a
+href="https://ctan.org/pkg/l2tabuen" ><span
+class="ectt-0900">l2tabuen</span></a> <a
+href="#enmark-10" id="ennote-10"><sup><span
+class="cmr-6">10</span></sup></a><a
+href="https://ctan.org/pkg/geometry" ><span
+class="ectt-0900">geometry</span></a>
+<a
+href="#enmark-11" id="ennote-11"><sup><span
+class="cmr-6">11</span></sup></a><a
+href="https://ctan.org/pkg/multicol" ><span
+class="ectt-0900">multicol</span></a> <a
+href="#enmark-12" id="ennote-12"><sup><span
+class="cmr-6">12</span></sup></a><a
+href="https://ctan.org/pkg/amsmath" ><span
+class="ectt-0900">amsmath</span></a> <a
+href="#enmark-13" id="ennote-13"><sup><span
+class="cmr-6">13</span></sup></a><a
+href="https://ctan.org/pkg/amssymb" ><span
+class="ectt-0900">amssymb</span></a> <a
+href="#enmark-14" id="ennote-14"><sup><span
+class="cmr-6">14</span></sup></a><a
+href="https://ctan.org/pkg/amsthm" ><span
+class="ectt-0900">amsthm</span></a> <a
+href="#enmark-15" id="ennote-15"><sup><span
+class="cmr-6">15</span></sup></a><a
+href="https://ctan.org/pkg/rsfs" ><span
+class="ectt-0900">rsfs</span></a> <a
+href="#enmark-16" id="ennote-16"><sup><span
+class="cmr-6">16</span></sup></a><a
+href="https://ctan.org/pkg/bm" ><span
+class="ectt-0900">bm</span></a> <a
+href="#enmark-17" id="ennote-17"><sup><span
+class="cmr-6">17</span></sup></a><a
+href="https://ctan.org/pkg/mathtools" ><span
+class="ectt-0900">mathtools</span></a> <a
+href="#enmark-18" id="ennote-18"><sup><span
+class="cmr-6">18</span></sup></a><a
+href="https://ctan.org/pkg/microtype" ><span
+class="ectt-0900">microtype</span></a> <a
+href="#enmark-19" id="ennote-19"><sup><span
+class="cmr-6">19</span></sup></a><a
+href="https://ctan.org/pkg/enumitem" ><span
+class="ectt-0900">enumitem</span></a> <a
+href="#enmark-20" id="ennote-20"><sup><span
+class="cmr-6">20</span></sup></a><a
+href="https://ctan.org/pkg/caption" ><span
+class="ectt-0900">caption</span></a> <a
+href="#enmark-21" id="ennote-21"><sup><span
+class="cmr-6">21</span></sup></a><a
+href="https://ctan.org/pkg/float" ><span
+class="ectt-0900">float</span></a>
+<a
+href="#enmark-22" id="ennote-22"><sup><span
+class="cmr-6">22</span></sup></a><a
+href="https://ctan.org/pkg/hyperref" ><span
+class="ectt-0900">hyperref</span></a> <a
+href="#enmark-23" id="ennote-23"><sup><span
+class="cmr-6">23</span></sup></a><a
+href="https://ctan.org/pkg/cleveref" ><span
+class="ectt-0900">cleveref</span></a> <a
+href="#enmark-24" id="ennote-24"><sup><span
+class="cmr-6">24</span></sup></a><a
+href="https://ctan.org/pkg/url" ><span
+class="ectt-0900">url</span></a> <a
+href="#enmark-25" id="ennote-25"><sup><span
+class="cmr-6">25</span></sup></a><a
+href="https://ctan.org/pkg/upquote" ><span
+class="ectt-0900">upquote</span></a> <a
+href="#enmark-26" id="ennote-26"><sup><span
+class="cmr-6">26</span></sup></a><a
+href="https://ctan.org/pkg/listings" ><span
+class="ectt-0900">listings</span></a> <a
+href="#enmark-27" id="ennote-27"><sup><span
+class="cmr-6">27</span></sup></a><a
+href="https://ctan.org/pkg/pythontex" ><span
+class="ectt-0900">pythontex</span></a> <a
+href="#enmark-28" id="ennote-28"><sup><span
+class="cmr-6">28</span></sup></a><a
+href="https://ctan.org/pkg/array" ><span
+class="ectt-0900">array</span></a> <a
+href="#enmark-29" id="ennote-29"><sup><span
+class="cmr-6">29</span></sup></a><a
+href="https://ctan.org/pkg/siunitx" ><span
+class="ectt-0900">siunitx</span></a> <a
+href="#enmark-30" id="ennote-30"><sup><span
+class="cmr-6">30</span></sup></a><a
+href="https://ctan.org/pkg/tcolorbox" ><span
+class="ectt-0900">tcolorbox</span></a> <a
+href="#enmark-31" id="ennote-31"><sup><span
+class="cmr-6">31</span></sup></a><a
+href="https://ctan.org/pkg/babel" ><span
+class="ectt-0900">babel</span></a> <a
+href="#enmark-32" id="ennote-32"><sup><span
+class="cmr-6">32</span></sup></a><a
+href="https://ctan.org/pkg/lipsum" ><span
+class="ectt-0900">lipsum</span></a>
+<a
+href="#enmark-33" id="ennote-33"><sup><span
+class="cmr-6">33</span></sup></a><a
+href="https://ctan.org/pkg/xcolor" ><span
+class="ectt-0900">xcolor</span></a> <a
+href="#enmark-34" id="ennote-34"><sup><span
+class="cmr-6">34</span></sup></a><a
+href="https://ctan.org/pkg/graphics" ><span
+class="ectt-0900">graphics</span></a> <a
+href="#enmark-35" id="ennote-35"><sup><span
+class="cmr-6">35</span></sup></a><a
+href="https://ctan.org/pkg/pdfpages" ><span
+class="ectt-0900">pdfpages</span></a> <a
+href="#enmark-36" id="ennote-36"><sup><span
+class="cmr-6">36</span></sup></a><a
+href="https://ctan.org/pkg/media9" ><span
+class="ectt-0900">media9</span></a> <a
+href="#enmark-37" id="ennote-37"><sup><span
+class="cmr-6">37</span></sup></a><a
+href="https://ctan.org/pkg/tikz" ><span
+class="ectt-0900">tikz</span></a> <a
+href="#enmark-38" id="ennote-38"><sup><span
+class="cmr-6">38</span></sup></a><a
+href="https://ctan.org/pkg/asymptote" ><span
+class="ectt-0900">asymptote</span></a> <a
+href="#enmark-39" id="ennote-39"><sup><span
+class="cmr-6">39</span></sup></a><a
+href="https://ctan.org/pkg/titlesec" ><span
+class="ectt-0900">titlesec</span></a> <a
+href="#enmark-40" id="ennote-40"><sup><span
+class="cmr-6">40</span></sup></a><a
+href="https://ctan.org/pkg/fancyhdr" ><span
+class="ectt-0900">fancyhdr</span></a> <a
+href="#enmark-41" id="ennote-41"><sup><span
+class="cmr-6">41</span></sup></a><a
+href="https://ctan.org/pkg/tocloft" ><span
+class="ectt-0900">tocloft</span></a> <a
+href="#enmark-42" id="ennote-42"><sup><span
+class="cmr-6">42</span></sup></a><a
+href="https://ctan.org/pkg/footmisc" ><span
+class="ectt-0900">footmisc</span></a>
+<a
+href="#enmark-43" id="ennote-43"><sup><span
+class="cmr-6">43</span></sup></a><a
+href="https://ctan.org/pkg/makeindex" ><span
+class="ectt-0900">makeindex</span></a> <a
+href="#enmark-44" id="ennote-44"><sup><span
+class="cmr-6">44</span></sup></a><a
+href="https://ctan.org/pkg/answers" ><span
+class="ectt-0900">answers</span></a> <a
+href="#enmark-45" id="ennote-45"><sup><span
+class="cmr-6">45</span></sup></a><a
+href="https://ctan.org/pkg/mla" ><span
+class="ectt-0900">mla</span></a> <a
+href="#enmark-46" id="ennote-46"><sup><span
+class="cmr-6">46</span></sup></a><a
+href="https://ctan.org/pkg/bibtex" ><span
+class="ectt-0900">bibtex</span></a> <a
+href="#enmark-47" id="ennote-47"><sup><span
+class="cmr-6">47</span></sup></a><a
+href="https://ctan.org/pkg/biblatex" ><span
+class="ectt-0900">biblatex</span></a> <a
+href="#enmark-48" id="ennote-48"><sup><span
+class="cmr-6">48</span></sup></a><a
+href="https://ctan.org/pkg/exam" ><span
+class="ectt-0900">exam</span></a> <a
+href="#enmark-49" id="ennote-49"><sup><span
+class="cmr-6">49</span></sup></a><a
+href="https://ctan.org/pkg/beamer" ><span
+class="ectt-0900">beamer</span></a> <a
+href="#enmark-50" id="ennote-50"><sup><span
+class="cmr-6">50</span></sup></a><a
+href="https://ctan.org/pkg/fntguide" ><span
+class="ectt-0900">fntguide</span></a> <a
+href="#enmark-51" id="ennote-51"><sup><span
+class="cmr-6">51</span></sup></a><a
+href="https://ctan.org/pkg/pdftex" ><span
+class="ectt-0900">pdftex</span></a> <a
+href="#enmark-52" id="ennote-52"><sup><span
+class="cmr-6">52</span></sup></a><a
+href="https://ctan.org/pkg/xetex" ><span
+class="ectt-0900">xetex</span></a> <a
+href="#enmark-53" id="ennote-53"><sup><span
+class="cmr-6">53</span></sup></a><a
+href="https://ctan.org/pkg/luatex" ><span
+class="ectt-0900">luatex</span></a>
+<a
+href="#enmark-54" id="ennote-54"><sup><span
+class="cmr-6">54</span></sup></a><a
+href="https://ctan.org/pkg/fontspec" ><span
+class="ectt-0900">fontspec</span></a>
+</p>
+ </div>
+
+</body></html>
+
+
+
+
diff --git a/info/latex-doc-ptr/latex-doc-ptr.pdf b/info/latex-doc-ptr/latex-doc-ptr.pdf
index 8ae9e94e7b..82a55bfefa 100644
--- a/info/latex-doc-ptr/latex-doc-ptr.pdf
+++ b/info/latex-doc-ptr/latex-doc-ptr.pdf
Binary files differ
diff --git a/info/latex-doc-ptr/latex-doc-ptr.sty b/info/latex-doc-ptr/latex-doc-ptr.sty
index 097cfce602..c9982ad369 100644
--- a/info/latex-doc-ptr/latex-doc-ptr.sty
+++ b/info/latex-doc-ptr/latex-doc-ptr.sty
@@ -1,31 +1,132 @@
% latex-doc-ptr.sty style for LaTeX doc pointer document
-% Jim Hefferon public domain
-\usepackage[margin=1in]{geometry}
+% 2021-Jan-02 Jim Hefferon, Karl Berry public domain
+
+
+% include graphics
+\usepackage{graphicx} % needed for \XeLaTeX command
+
+% Color, for links and titles
+\usepackage{xcolor}
+% Color theme from Rodryggo Sylva
+% https://color.adobe.com/explore?page=2
+\definecolor{darkblue}{HTML}{274375} % {023059}
+\definecolor{lightblue}{HTML}{094085} %{023E73}
+% \definecolor{papyrus}{HTML}{D9D8D7}
+\definecolor{papyrus}{HTML}{E4E4E4}
+\definecolor{darkred}{HTML}{BF1E0F}
+\definecolor{lightred}{HTML}{F24141}
+% \pagecolor{papyrus}
-\usepackage{color,graphicx}
%\usepackage{dash}
-\usepackage{url}
+% \usepackage{url}
\usepackage{hyperref}
\hypersetup{colorlinks,breaklinks,
- linkcolor=black,citecolor=blue,
- filecolor=blue,urlcolor=blue,
+ linkcolor=black,citecolor=lightblue,
+ filecolor=blue,urlcolor=lightblue,
pdfpagemode=UseNone}
-\usepackage{tgbonum}
-
-\usepackage[para]{footmisc}
-% Change horiz room between fn mark and fn hskip from .5em
-% Suggested to RF making this settable
-\long\def\@makefntext#1{\leavevmode
-\@makefnmark\nobreak
-\hskip.05em\relax#1%
+
+% fonts
+% \usepackage{cochineal}
+\usepackage[light,lining]{spectral}
+\usepackage[T1]{fontenc}
+
+\usepackage{microtype}
+
+
+% ====== Page design =========
+% margins, multicolumn
+\usepackage[margin=1in]{geometry}
+\usepackage{multicol}
+\setlength{\columnsep}{2.5em}
+
+% space between paragraphs
+\setlength{\parskip}{.15ex plus .02ex minus .01ex}
+
+% Page headers and footers
+\pagestyle{empty}
+
+% Section titles
+\usepackage{titlesec}
+\titleformat{\section}[hang]{\color{black}\large\bf}{}{0pt}{}
+% \titlespacing{\section}{0pt}{2ex plus 0.1ex minus 0.05ex}{0.85ex plus 0.05ex}
+\titlespacing{\section}{0pt}{*2}{*0.66}
+
+\titleformat{\subsection}[runin]{\color{black}\normalsize\bf}{}{0.65em}{}
+% \titlespacing{\subsection}{0pt}{0.5ex plus 0.1ex minus 0.05ex}{0.15ex plus 0.05ex}
+\titlespacing{\subsection}{0pt}{*0.5}{*1}
+
+\setcounter{secnumdepth}{0} % Number the sections only if level -1 or less
+
+
+% footnotes and package macro\patchcmd{\@makefntext}{.5em}{0em}{}{}
+\usepackage{ragged2e}
+\usepackage{etoolbox} % for patchcmd
+\usepackage{endnotes}
+\usepackage[para, norule, hang]{footmisc} % from https://tex.stackexchange.com/a/60949
+\patchcmd{\@makefntext}{.5em}{0em}{}{}
+\def\theendnotes{\immediate\closeout\@enotes \global\@enotesopenfalse
+ \begingroup
+ \makeatletter
+ \edef\@tempa{`\string >}%
+ \ifnum\catcode\@tempa=12%
+ \let\@ResetGT\relax
+ \else
+ \edef\@ResetGT{\noexpand\catcode\@tempa=\the\catcode\@tempa}%
+ \@makeother\>%
+ \fi
+ \def\@doanenote##1##2>{\def\@theenmark{##1}\begingroup
+ \@ResetGT
+ \edef\@currentlabel{\csname p@endnote\endcsname\@theenmark}%
+ \enoteformat}
+ \def\@endanenote{\hspace{0.65em plus 0.1em}\endgroup}%
+ \enoteheading
+ \enotesize % worth a look: \RaggedRight
+ \input{\jobname.ent}%
+ \endgroup}
+% ENDNOTE INDENT
+% \patchcmd{\enoteformat}{1.8em}{0em}{}{}
+% \def\makeenmark{\hbox{XX$^\theenmark$}}
+\def\enoteformat{\rightskip\z@ \leftskip\z@ \parindent=0em
+ \leavevmode\hbox{\makeenmark}}
+
+\renewcommand\enoteheading{% from https://tex.stackexchange.com/a/62425
+ \setcounter{secnumdepth}{-2}
+ \section{\notesname}
+ % \mbox{}\par\vskip-\baselineskip
+ \mbox{}\par\vspace{-1.08\baselineskip}% \vskip-0.9\baselineskip
+ \let\@afterindentfalse\@afterindenttrue
}
+\renewcommand{\notesname}{Package names, for texdoc}
+% \long\def\@makefntext#1{\leavevmode
+% \@makefnmark\nobreak
+% \hskip.04em\relax#1%
+% }
+
+% computer code
+\usepackage{listings}
+\lstset{basicstyle = \small\ttfamily,
+ keepspaces=true,
+ columns=fullflexible,
+ xleftmargin=10pt}
+\usepackage{upquote}
+
+% Get ISO dates
+\usepackage[style=iso]{datetime2}
+
+% Definitions for this doc
+
+% Refer to texdoc
+\newcommand{\texdoc}[1]{\footnote{\protect\pkg{#1}}}
+\let\footnote=\endnote
-\newcommand{\texdoc}[1]{\/\footnote{\protect\texttt{#1}}}
+% Name package by CTAN and texdoc name
+\newcommand{\pkglink}[2]{\href{https://ctan.org/pkg/#1}{\texttt{#2}}}
+% \newcommand{\pkg}[1]{\href{https://ctan.org/pkg/#1}{\texttt{#1}}}
+\newcommand{\pkg}[1]{\pkglink{#1}{#1}}
-\setlength{\parskip}{-.25ex plus -.05ex minus -.05ex}
% \@startsection {NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}
% optional * [ALTHEADING]{HEADING}
% Generic command to start a section.
@@ -46,20 +147,16 @@
% is normally defined to \@startsection + its first six arguments.
% \makeatletter
-\def\section{\@startsection {section}{1}{\z@}{-3ex plus -.45ex minus
- -.20ex}{4.75ex plus .45ex minus .20ex}{\centering\Large\bf}}
-\def\subsection{\@startsection {subsection}{2}{\z@}{-2.5ex plus -.15ex minus
- -.10ex}{.80ex plus .1ex}{\centering\large\bf}}
-\def\subsubsection{\@startsection{subsubsection}{3}{\z@}{-.85ex plus -.15ex minus
- -.05ex}{-.75em}{\normalsize\sc}}
+% \def\section{\@startsection {section}{1}{\z@}{-3ex plus -.45ex minus
+% -.20ex}{4.75ex plus .45ex minus .20ex}{\centering\Large\bf}}
+% \def\subsection{\@startsection {subsection}{2}{\z@}{-2.5ex plus -.15ex minus
+% -.10ex}{.80ex plus .1ex}{\centering\large\bf}}
+% \def\subsubsection{\@startsection{subsubsection}{3}{\z@}{-.85ex plus -.15ex minus
+% -.05ex}{-.75em}{\normalsize\sc}}
% \makeatother
-\setcounter{secnumdepth}{0} % Number the sections only if level -1 or less
-\setlength{\parskip}{.85ex plus .15ex minus .05ex}
-
-\pagestyle{empty}
-\newcommand{\program}[1]{\texttt{#1}}
-\newcommand{\package}[1]{\textit{#1}}
+% \newcommand{\program}[1]{\texttt{#1}}
+% \newcommand{\package}[1]{\textit{#1}}
% Used for backslash
\newcommand\SLASH{\char`\\}
% Last thing before the document: define the \XeTeX logo (stolen from
@@ -70,24 +167,110 @@
% least a chance to look ok.
%
% \begin{macrocode}
+% \def\tubreflect#1{%
+% \ifx\reflectbox\relax
+% \errmessage{A graphics package must be loaded for \string\XeTeX}%
+% \else
+% \ifdim \fontdimen1\font>0pt
+% \raise 1.35ex \hbox{\kern.1em\rotatebox{180}{#1}}\kern-.1em
+% \else
+% \reflectbox{#1}%
+% \fi
+% \fi
+% }
+% \def\tubhideheight#1{\setbox0=\hbox{#1}\ht0=0pt \dp0=0pt \box0 }
+% \DeclareRobustCommand\Xe[1]{\leavevmode
+% \tubhideheight{\hbox{X%
+% \setbox0=\hbox{\TeX}\setbox1=\hbox{E}%
+% \lower\dp0\hbox{\raise\dp1\hbox{\kern-.125em\tubreflect{E}}}%
+% \kern-.1667em #1}}}
+% \newcommand{\xetex}{\Xe\TeX}
+% \newcommand{\pdftex}{pdf\TeX}
+% \newcommand{\luatex}{Lua\TeX}
+% \newcommand{\texworks}{\TeX{}works}
+
+
+
+% 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}
+
+% Stuff from ltugboat.cls
+\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@unknown@warning
+ \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
+}
+\newcommand{\SMC@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{%
- \ifx\reflectbox\relax
- \errmessage{A graphics package must be loaded for \string\XeTeX}%
- \else
+ \@ifundefined{reflectbox}{%
+ \TBerror{A graphics package must be loaded for \string\XeTeX}%
+ }{%
\ifdim \fontdimen1\font>0pt
- \raise 1.35ex \hbox{\kern.1em\rotatebox{180}{#1}}\kern-.1em
+ \raise 1.75ex \hbox{\kern.1em\rotatebox{180}{#1}}\kern-.1em
\else
\reflectbox{#1}%
\fi
- \fi
+ }%
}
\def\tubhideheight#1{\setbox0=\hbox{#1}\ht0=0pt \dp0=0pt \box0 }
-\DeclareRobustCommand\Xe[1]{\leavevmode
+\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-.125em\tubreflect{E}}}%
- \kern-.1667em #1}}}
-\newcommand{\xetex}{\Xe\TeX}
-\newcommand{\pdftex}{pdf\TeX}
-\newcommand{\luatex}{Lua\TeX}
-\newcommand{\texworks}{\TeX{}works}
+ \lower\dp0\hbox{\raise\dp1\hbox{\kern\XekernbeforeE\tubreflect{E}}}%
+ \kern\XekernafterE}}}
+\def\XeTeX{\Xe\TeX}
+\def\XeLaTeX{\Xe{\kern.11em \LaTeX}}
+\def\LuaTeX{Lua\TeX}
+\def\pdfTeX{pdf\TeX}
+
+\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}}
+\newcommand{\TikZ}{Ti{\textit k}Z} % from TUB
+\newcommand{\Asymptote}{Asymptote} % the manual uses typewriter
+\newcommand{\gnuplot}{Gnuplot} % the FAQ says lower case first letter
+
+% Style I chopped out of ltugboat.cls
+\usepackage{dash}
+
+
+\newcommand{\program}[1]{\texttt{#1}}
+\newcommand{\package}[1]{#1}
+% stubs
+% \newcommand{\texdoc}[1]{\relax}
+
+% Give paras just a bit of room
+% \setlength{\parskip}{0.45ex}
+
+\pagestyle{empty}
diff --git a/info/latex-doc-ptr/latex-doc-ptr.tex b/info/latex-doc-ptr/latex-doc-ptr.tex
index 8cf2c86fb1..590bebb76b 100644
--- a/info/latex-doc-ptr/latex-doc-ptr.tex
+++ b/info/latex-doc-ptr/latex-doc-ptr.tex
@@ -1,257 +1,434 @@
-\documentclass[10pt]{article}
+\documentclass[11pt]{article}
\usepackage{latex-doc-ptr}
-
-% This document is intended as the result of a "texdoc latex" in TeX Live.
-% The license is Public Domain. See README file for more.
+\usepackage{endnotes}
\begin{document}\thispagestyle{empty}
-\section{\LaTeX}
-
-\LaTeX{} is the most popular macro package for \TeX{}.
-(A macro package is a set of commands that an author typically uses
-to write documents.)
-
-This page does not try to answer all questions about \LaTeX;
-rather
-we suggest some documentation, add-on components, and resources
-that a \LaTeX{} user can start with.
-We limit our recommendations to freely-available materials,
-and you can click on the text to see the documentation on the Internet.
-(In case the Internet is not convenient, when the documentation is also
-available
-in a typical \TeX{} installation we provide its name in a footnote;
-to view it locally using
-\href{http://tug.org/texdoc}{\package{texdoc}},\texdoc{texdoc}
-run ``\texttt{texdoc \textit{name}}'' at a command prompt.)
-
-
-
-
-\subsection{Starting out}
-
-The article
-\href{http://mirror.ctan.org/info/first-latex-doc/first-latex-doc.pdf}{Getting something out of \LaTeX}
-walks a beginner through writing a sample document.
-In particular, to use \LaTeX{}, users must install a \TeX{} distribution,
-such as
-\href{http://miktex.org/}{MiK\TeX{}} on Windows, or
-\href{http://www.tug.org/texlive/}{\TeX{}~Live} on
-a Unix system such as GNU/Linux or on Windows,
+\begin{center}
+ {\color{black}\LARGE\bf A First Set of \LaTeX{} Resources}
+\end{center}
+\vspace{1.5ex}
+
+\begin{multicols*}{2}
+% \section{\LaTeX}
+
+% \LaTeX{} is a collection of commands for
+% writing documents with the \TeX{} typesetting system.
+% It is by far the most popular way to use that system.
+This page suggests documentation, add-on components, and other resources
+for a beginning \LaTeX{} user.
+
+The links here are to freely available materials,
+so you can click to see the documentation online.
+Where the documentation is also available
+offline in a typical \TeX{} installation, we provide its name as an end note.
+View it
+by running `\texttt{texdoc {\it name}}' in a terminal.
+
+
+
+% ========================================================
+\section{Starting}
+
+To run \LaTeX{}, you must use an online service or
+install a distribution.
+Online services are commercial; find them by entering `online latex' in
+a search engine.
+For distributions, your choices are
+\href{https://tug.org/texlive/}{\TeX{}~Live} on
+a Unix system, including GNU/Linux, or on Windows,
+or the related
+\href{https://tug.org/mactex/}{Mac\TeX{}} on Macintosh,
or
-\href{http://www.tug.org/mactex/}{Mac\TeX{}} on Macintosh OS~X.
-
-
+\href{https://miktex.org/}{MiK\TeX{}} on Windows or a Unix system.
+
+\subsection{Tutorials}
+The site \href{https://www.learnlatex.org/}{\texttt{learnlatex.org}}
+teaches you the basics in a sound way, and also
+lets you play with the commands to see the results.
+For a more traditional document,
+the most widely recommended one is
+\href{https://ctan.org/pkg/lshort-english}
+ {\package{The Not-So Short Guide to \LaTeXe}}, available in many
+ languages.\texdoc{lshort}
+% and another good one is from the
+% \href{https://tug.org/tutorials/tugindia/}{\package{Indian \TeX{} User Group}}.
+% The article
+% \href{http://mirror.ctan.org/info/first-latex-doc/first-latex-doc.pdf}{\package{Getting something out of \LaTeX}}
+% walks a beginner through writing a sample document.
+
+Many people use \LaTeX{} to write mathematical text and
+for this the premier choice is from the American Mathematical Society.
+See their
+\href{http://mirror.ctan.org/info/amslatex/primer/amshelp.pdf}
+ {\package{Getting up and running with AMS-\LaTeX}},\texdoc{amshelp}
+and more detail is in
+\href{http://mirror.ctan.org/macros/latex/required/amsmath/amsldoc.pdf}
+ {\package{Users Guide for the {\tt amsmath} package}}.\texdoc{amsmath}
-\subsection{Documentation}
-\subsubsection{Essentials}
-The most widely-recommended introduction is
-\href{http://mirror.ctan.org/info/lshort/}
- {\package{The Not-So Short Guide to \LaTeXe}}.\texdoc{lshort}
-Another good one is from the
-\href{http://tug.org/tutorials/tugindia/}{\package{TUGIndia user group}}.
-For typesetting mathematics, use the
-the American Mathematical Society's
-AMS-\LaTeX{} package,
-introduced in the primer,
-\href{http://mirror.ctan.org/info/amslatex/primer/amshelp.pdf}
- {\package{Getting up and running with AMS-\LaTeX}}.\texdoc{amshelp}
+% ========================================================
+\section{Documentation}
-\subsubsection{References}
-The official \LaTeX{} documentation from the development team
-is
-\href{http://mirror.ctan.org/macros/latex/doc/usrguide.pdf}
- {\package{\LaTeXe{} for Authors}};\texdoc{usrguide} this focuses on
-changes made in recent versions of \LaTeX{}.
-The nearest thing to a general reference manual for \LaTeX{} is the unofficial
+\subsection{References}
+The nearest thing to a general reference for \LaTeX{} is
\href{http://mirror.ctan.org/info/latex2e-help-texinfo/latex2e.html}
- {\package{\LaTeX: Structured documents for \TeX}}.\texdoc{latex2e}
+ {\package{\LaTeXe{} unofficial reference manual}}.\texdoc{latex2e}
Look for symbols in the
\href{http://mirror.ctan.org/info/symbols/comprehensive/symbols-letter.pdf}
{\package{Comprehensive List of Symbols}}.\texdoc{comprehensive}
-A two-page
-\href{http://mirror.ctan.org/info/latexcheat/latexsheet.pdf}
- {\package{\LaTeX{} Cheat Sheet}}\texdoc{latexcheat} is available.
-The document
-\href{http://mirror.ctan.org/info/l2tabu/}
- {\textit{l2tabu}}\texdoc{l2tabuen}
-can help you to acquire sound habits by
-suggesting what you should consider taboo.
-
-
-\subsubsection{FAQ's}
-Many web pages offer help with \TeX{} and \LaTeX{}.
-Particularly useful is the
-\href{http://www.tex.ac.uk/faq}{\package{English FAQ}}\texdoc{faq}
-and the
-\href{http://tug.org/interest.html}{\package{TUG web resources page}}.
-The \href{http://tug.org/pracjourn/}{\package{Prac\TeX{} Journal}}
-is an online magazine aimed at beginning and intermediate users, and
-\href{http://tug.org/TUGboat/}{\package{TUGboat}}
-has published many articles at all levels nearly since the inception of
-\TeX{}.
-
-\subsubsection{Books}
-There are many books about \LaTeX{};
+And, \href{https://tug.org/TUGboat/}{\package{TUGboat}},
+the journal of the
+\href{https://tug.org}{\TeX{} Users Group},
+has published many articles, at levels from beginner to expert,
+almost since the inception of \TeX{}.
+
+
+
+\subsection{FAQs}
+Many web pages offer quick help with \LaTeX{},
+although they can be out of date.
+Particularly useful and reliable are the
+\href{https://texfaq.org/}{\package{\TeX{} FAQ}},\texdoc{faq}
+as well as
+\href{https://tug.org/interest.html}{\package{\TeX{} Resources on the Web}}.
+You can also get a handy general
+\href{http://mirror.ctan.org/info/latexcheat/latexcheat/latexsheet.pdf}
+ {\package{\LaTeX{} Cheat Sheet}},\texdoc{latexcheat}
+as well as the
+\href{http://mirrors.ctan.org/info/undergradmath/undergradmath.pdf}
+ {\package{Math for Undergraduates Cheat Sheet}}.\texdoc{undergradmath}
+Also,
+\href{http://mirror.ctan.org/info/l2tabu/english/l2tabuen.pdf}
+ {An essential guide to \LaTeXe{} usage}\texdoc{l2tabuen}
+helps you develop sound habits, by
+saying what not to do.
+
+\subsection{Questions}
+If you are stuck on an issue, the
+\href{https://tex.stackexchange.com/}{\TeX{}-\LaTeX{} Stack Exchange} site
+and the mailing list
+\href{https://lists.tug.org/texhax}{texhax@tug.org}
+are where knowledgeable people hang out.
+You are likely to find an answer in their past discussions, which cover
+decades, and if not then you can post a question yourself.
+
+
+\subsection{Books}
+There are many excellent books about \LaTeX{}.
+Visit the
+\href{https://tug.org/books/}
+ {\package{\TeX{} Users Group's book list}} for a selection, and for discounts.
+
+
+
+
+% =========================================================
+\section{Packages}
+
+One of \LaTeX's strengths is the tremendous number of available add-on
+packages.
+This list covers most of what
+beginners want to do.
+(There are some comments in parentheses that
+often come up in conjunction with these recommendations.)
+
+
+\subsection{Our archive}
+The Comprehensive \TeX{} Archive Network,
+\href{https://ctan.org}{\color{darkblue}\CTAN},
+has the latest official versions of
+the packages that are in the distributions,
+along with documentation.
+\href{https://ctan.org/topics/cloud}{\color{darkblue}Browsing by topic}
+can be very handy.
+
+% If you develop a package, please upload it to \CTAN.
+If you have trouble finding something, it may be
+the house package of a journal or institution.
+Look on their web page as well as on \CTAN.
+
+
+
+\subsection{Every document}
+To change page size, margins, and orientation, use
+\pkg{geometry}.\texdoc{geometry}
+Get multiple columns with \pkg{multicol}.\texdoc{multicol}
+
+As referred to above, any document containing significant amounts of
+mathematics should use
+the American Mathematical Society's packages
+\pkg{amsmath}\texdoc{amsmath}
+and
+\pkg{amsfonts}.\texdoc{amssymb}
+Also use their \pkg{amsthm}\texdoc{amsthm}
+for producing theorem environments.
+Notes: (1)~\pkglink{amsfonts}{amssymb} inputs \pkg{amsfonts} so load the former
+instead of the latter,
+(2)~many authors also use the calligraphic characters in
+\pkg{rsfs},\texdoc{rsfs}
+(3)~get bold math symbols with \pkg{bm},\texdoc{bm}
+(4)~don't load \pkg{amsmath} directly, instead get it by loading
+\pkg{mathtools}\texdoc{mathtools} for some useful improvements,
+and
+(4)~load \pkg{amsthm} after \pkg{mathtools}.
+
+Also, include
+\pkg{microtype}.\texdoc{microtype}
+It will make
+your document have fewer awkward lines.
+
+
+
+\subsection{Inside a document}
+Tweak the layout of lists with \pkg{enumitem}.\texdoc{enumitem}
+
+Enhance captions with
+\pkg{caption}\texdoc{caption}
+and control floating environments with
+\pkg{float}.\texdoc{float}
+(In particular, this package provides the `\texttt{H}' option
+to override automatic float placement and put something
+exactly where you ask.
+This may cause issues\Dash what if you want to include a two inch tall
+graphic on a page that has only an inch left?\Dash but it sometimes
+is what you want.)
+
+Get hyperlinks and turn references into links with
+\pkg{hyperref}\texdoc{hyperref}
+(make sure to set it up,
+as with \lstinline!\hypersetup{colorlinks=true}!).
+Have cross-references that say `Theorem~1.2' instead of just `1.2'
+with \pkg{cleveref}.\texdoc{cleveref}
+For \acro{URL}'s and file paths that can break across lines, use
+\pkg{url}.\texdoc{url}
+(If you use \pkg{hyperref} then note that it has its own
+commands for the \pkg{cleveref} and \pkg{url} functions.)
+
+Inside verbatim text, make single quotes come out correctly with
+\pkg{upquote}.\texdoc{upquote}
+For including computer code, the
+\pkg{listings}\texdoc{listings} package is very popular.
+% although \pkg{minted}\texdoc{minted}
+% has many things to recommend it.
+(Copy and paste for computer code is especially
+convenient.
+This is a start for the \pkg{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}\texdoc{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}, % \texdoc{sagetex}? not in TL
+and similar support exists for other languages.
+
+There are many packages that add table capabilities, such as
+multirow entries and breaking across pages.
+The first package to try is \pkg{array},\texdoc{array}
+which lets you define your own column
+types.
+To handle scientific units,
+use \pkg{siunitx}\texdoc{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}.\texdoc{tcolorbox}
+
+Use \pkg{babel}\texdoc{babel}
+for internationalization, including changing the
+title of the abstract or the bibliography.
+(Note that \LaTeX{} now defaults to UTF-8 encoded input.)
+
+Finally, when developing a document, you often want to
+generate filler text.
+Use
+\pkg{lipsum}.\texdoc{lipsum}
+
+
+
+\subsection{Color and graphics}
+For colors, use
+\pkg{xcolor}.\texdoc{xcolor}
+
+To include graphics and do simple manipulations such as resizing,
+use \pkg{graphicx}.\texdoc{graphics}
+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 in your \LaTeX{} source, you give the file name without the extension,
+as with \lstinline!\includegraphics{myplot}!.)
+Include parts of an outside \PDF{} document with
+\pkg{pdfpages}.\texdoc{pdfpages}
+Include video or sound using
+\pkg{media9}.\texdoc{media9}
+
+In your plots and graphics, you want that
+the fonts and notations match your document.
+You have a few choices.
+Draw inside your document with
+\href{https://ctan.org/pkg/pgf}{\TikZ}.\texdoc{tikz}
+You can instead draw using an external command language such as
+\href{https://asymptote.sourceforge.io/}{\Asymptote{}},\texdoc{asymptote}
+and bring the results in as graphics.
+And there are other options, such as that the
+\href{http://www.gnuplot.info/}{\gnuplot{}} plotting software
+will output \TikZ{} commands,
+and the
+\href{https://inkscape.org/}{Inkscape} vector graphics editor allows
+you to embed \LaTeX{}-generated equations.
+
+
+\subsection{Front and back matter, headers, footers}
+To style chapter and section titles, use
+\pkg{titlesec}.\texdoc{titlesec}
+For page headers and footers, reach for
+\pkg{fancyhdr}.\texdoc{fancyhdr}
+You can tweak the format of tables of contents, lists of figures, etc.,
+with
+\pkg{tocloft}.\texdoc{tocloft}
+
+For footnotes, use
+\pkg{footmisc}.\texdoc{footmisc}
+Make an index with
+\pkg{makeindex}.\texdoc{makeindex}
+With \pkg{answers}\texdoc{answers}
+you can send exercise answers to an external file, where you can make them
+a separate document or include them at the end of the current one.
+
+Bibliographies are a thorny area.
+Often you have strict requirements, such as from the
+\pkg{MLA}.\texdoc{mla}
+\CTAN{} is a big help here; check out the many styles for both
+\href{https://ctan.org/topic/bibtex-sty}{\BibTeX}\texdoc{bibtex}
+and
+\href{https://ctan.org/topic/biblatex}{\BibLaTeX}.\texdoc{biblatex}
+
+
+
+
+\subsection{Special documents}
+Make exams and problem sets with the
+\pkg{exam}\texdoc{exam}
+class.
+
+There are many, many resume and CV packages.
+Start with \acro{CTAN}'s
+\href{https://ctan.org/topic/cv}{cv topic}.
+
+To make presentations, use the
+\pkg{beamer}\texdoc{beamer}
+class.
+(However, 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}
+The documentation for font use commands from the \LaTeX{} developers is
+\href{http://mirror.ctan.org/macros/latex/base/fntguide.pdf}
+ {\package{\LaTeXe{} font selection}}.\texdoc{fntguide}
+
+To move beyond the default fonts,
visit the
-\href{http://tug.org/books/}
- {\package{\TeX{} Users Group Bookstore}} for discounts.
-
-
-
-\subsection{Selected \LaTeX{} packages}
-
-\subsubsection{Page size and shape}
-Adjust the page dimensions
-and orientation with
-\href{http://mirror.ctan.org/macros/latex/contrib/geometry/geometry.pdf}
- {\package{geometry}}.\texdoc{geometry}
-Control headers and footers with
-\href{http://mirror.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf}
- {\package{fancyhdr}}.\texdoc{fancyhdr}
-
-\subsubsection{Graphics}
-Import graphics into a \LaTeX{} document with the \LaTeX{} team's
-\href{http://mirror.ctan.org/macros/latex/required/graphics/}
- {\package{graphicx}} package, and the related \textit{graphics}.
-The official documentation is
-\href{http://mirror.ctan.org/macros/latex/required/graphics/grfguide.pdf}
- {\package{Packages in the `graphics' bundle}}.\texdoc{grfguide}
-Another package in the same bundle is \package{color}.\texdoc{color}
-For even more color capability use
-\href{http://mirror.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf}
- {\package{xcolor}}.\texdoc{xcolor}
-An excellent introduction to using these is the article
-\href{http://tug.org/pracjourn/2005-3/hoeppner/hoeppner.pdf}
- {\package{Strategies for including graphics in \LaTeX{} documents}}.
-% not free:
-% \href{http://www.ctan.org/tex-archive/info/epslatex/}{\textit{Using Imported Graphics in \LaTeX{} and pdf\LaTeX{}}}.
-
-
-\subsubsection{Index and bibliography}
-Make an index with \href{http://mirror.ctan.org/macros/latex/base/makeindx.dtx}
- {\package{makeidx}}.\texdoc{makeindex}
-For bibliographies, people use
-\href{http://en.wikipedia.org/wiki/BibTeX}{\package{B{\footnotesize IB}\TeX{}}}.\texdoc{bibtex}
-Two powerful tools based on it are: produce your bibliography
-in a natural science styles with
-\href{http://mirror.ctan.org/macros/latex/contrib/natbib/natbib.pdf}
- {\package{natbib}},\texdoc{natbib}
-and generate your own style by answering a sequence of questions with
-\href{http://mirror.ctan.org/macros/latex/contrib/custom-bib/makebst.pdf}
- {\package{custom-bib}}.\texdoc{custom-bib}
-
-\subsubsection{Computer code and commenting out}
-For computer code, look at
-\href{http://mirror.ctan.org/macros/latex/contrib/listings/listings.pdf}
- {\package{listings}}.\texdoc{listings}
-The
-\href{http://mirror.ctan.org/macros/latex/required/tools/verbatim.pdf}
- {\package{verbatim}}\texdoc{verbatim}
-package is also useful for computer code, and
-includes a \texttt{comment} environment to suppress parts of the document.
-
-\subsubsection{Hypertext}
-The
-\href{http://mirror.ctan.org/macros/latex/contrib/hyperref/hyperref.pdf}
- {\package{hyperref}}\texdoc{hyperref}
-package gives you
-hyper-document features, such as making table of contents
-entries link to the corresponding document part.
-If you don't need active links, typeset web addresses with
-\href{http://mirror.ctan.org/macros/latex/contrib/misc/url.sty}
- {\package{url}},\texdoc{url}
-which also does computer file names.
-
-\subsubsection{Presentations}
-You can get presentation slides by
-adjusting the page geometry and writing a regular document.
-For more sophisticated effects use
-\href
- {http://mirror.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf}
- {\package{beamer}}.\texdoc{beamer}
-The article
-\href{http://tug.org/pracjourn/2005-4/mertz/mertz.pdf}
- {\package{Beamer by example}} will get you started.
-
-
-
-\subsection{Output and fonts}
-
-\subsubsection{Output}
-The
-\href{http://tug.org/applications/pdftex/}{\package{pdf\TeX}}\texdoc{pdftex}
-program extends \TeX{}:
-it can directly produce web-friendly PDF files, as well as the
-traditional DVI format.
-For instance, this document was generated under \TeX{}~Live with
-\verb!pdflatex latex_doc_ptr.tex!.
-A further extension to that,
-\href{http://en.wikipedia.org/wiki/XeTeX}{\package{\xetex}},\texdoc{xetex}
-can use fonts from your underlying computer platform,
-in addition to the fonts from your \TeX{} distribution.
+\href{https://tug.org/FontCatalogue/}{\LaTeX\ Font Catalogue},
+which includes copy and paste code to make each one work.
+
+Beyond that list, you can also use your computer system's fonts
+(beware this makes your source file harder to share with friends, though).
+The background is:~to convert \LaTeX{} source to \PDF{} output
+there are three varieties of the \TeX{} engine.
+Currently the most common is
+\href{https://tug.org/applications/pdftex/}{\package{\pdfTeX}}.\texdoc{pdftex}
+For instance, this document was generated with
+\verb!pdflatex latex-doc-ptr.tex!.
+Two further developments,
+\href{https://tug.org/xetex/}{\package{\XeTeX}},\texdoc{xetex}
+and
+\href{http://www.luatex.org/}{\package{\LuaTeX}},\texdoc{luatex}
+can leverage
+the \pkg{fontspec}\texdoc{fontspec}
+package to use your system's fonts,
+such as OpenType and TrueType fonts,
+in addition to the ones from your \TeX{} distribution.
(Mathematics requires much special tuning, though, so most
-system fonts cannot be used for math.)
-
+of the time you cannot use system fonts for math.)
+% (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.)
-\subsubsection{Fonts}
-The font system documentation from the \LaTeX{} developers is
-\href{http://mirror.ctan.org/macros/latex/doc/fntguide.pdf}
- {\package{\LaTeXe{} font selection}}.\texdoc{fntguide}
-To move beyond \TeX's default fonts, these two
-documents describe some reasonable and free alternatives:
-\href{http://mirror.ctan.org/info/Free_Math_Font_Survey/en/survey.html}
- {\package{A Survey of Free Math Fonts for \TeX{} and \LaTeX{}}}
-and
-\href{http://www.tug.dk/FontCatalogue/}{\package{The \LaTeX{} Font Catalogue}}.
More is on the
-\href{http://tug.org/fonts/}{\TeX{} Users Group's font page}.
+\href{https://tug.org/fonts/}{\TeX{} Users Group's font page}.
-\subsection{Tools for composing \LaTeX{}}
-
-There are many environments to make writing \LaTeX{} source easier.
-For instance, many people use a text editor of some sort, such as
-Emacs with the add-on mode
-\href{http://www.gnu.org/software/auctex/}{\package{AUC-\TeX{}}}.
-A new environment that is free, runs on all major
-computer platforms, and combines the best ideas
-from available environments while retaining simplicity, is
-\href{http://tug.org/texworks/}{\texworks}.
-
-
-\subsection{Community}
-
-There are many
-\href{http://tug.org/usergroups.html}{user groups}
-for \TeX{}.
-The
-\href{http://www.ctan.org/}{Comprehensive \TeX{} Archive Network}
-contains many more packages than any distribution.
-In addition, if you are stuck on an issue, the Usenet group
-\href{http://groups.google.com/group/comp.text.tex}{\texttt{comp.text.tex}}
-and
-\href{http://lists.tug.org/texhax}{\texttt{texhax@tug.org}}
-are the most popular mailing lists.
-You can search more than a decade of
-\LaTeX{} discussions, or post a question yourself.
-\subsection{Miscellaneous}
+% =========================================================
+\section{Writing \LaTeX{}}
-\subsubsection{History}
-\LaTeX{} was first written in 1985 by Leslie Lamport, building on
-Donald Knuth's \TeX{}.
-It is now maintained and developed by the
-\href{http://www.latex-project.org}{\LaTeX{}3 Project}\texdoc{latex3} group.
-
-\subsubsection{Pronunciation}
-\LaTeX{} can be pronounced as
+There are many ways to make writing \LaTeX{} source easier.
+Most people use a source code editor, such as
+\href{https://www.texstudio.org/}{\TeX{}studio}, or
+Emacs with the add-on mode
+\href{https://www.gnu.org/software/auctex/}{\package{AUC-\TeX{}}},
+or \href{https://pages.uoregon.edu/koch/texshop/}{\TeX{}Shop} on
+a Mac.
+% A new environment that is free, runs on all major
+% computer platforms, and combines the best ideas
+% from available environments while retaining simplicity, is
+% \href{https://tug.org/texworks/}{\texworks}.
+
+
+% ====================================================
+\section{Pronunciation}
+Pronounce \LaTeX{} as
``la-tech'' or ``lay-tech,'' with emphasis on either syllable.
-(We prefer the first, with emphasis on the first syllable.)
+We prefer the first, with emphasis on the first syllable.
+
+
+% ====================================================
+\section{Welcome to the community!}
+
+One reason that all of these resources are available is
+the work of the many
+\href{https://tug.org/usergroups.html}{user groups},
+including the \href{https://tug.org/}{\TeX{} Users Group}.
+Please consider joining.
+% The
+% \href{https://www.ctan.org/}{Comprehensive \TeX{} Archive Network}
+% contains more packages than any distribution.
+
+% \vfill\null
+% \columnbreak
+\vspace*{2ex}
+\noindent{\color{lightblue}\rule{\linewidth}{0.4pt}}
+
+\hbadness=10000 % we know
+\theendnotes
+
+% \subsection{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}
diff --git a/info/latex-doc-ptr/massage_html.awk b/info/latex-doc-ptr/massage_html.awk
new file mode 100644
index 0000000000..64f988417b
--- /dev/null
+++ b/info/latex-doc-ptr/massage_html.awk
@@ -0,0 +1,27 @@
+# massage_html.awk
+# Part of latex-doc-ptr
+# make4ht loses the subsection run-in headers. It puts the resulting material
+# on two lines. So this small state machine passes through the .html file
+# and creates subsection classes from paragraphs.
+#
+# 2020-Dec-31 Jim Hefferon
+
+BEGIN { lastLine = ""}
+
+# Look for second line of two-line patterns for subsections
+/^class="Spectral-Bold-lf-t-1x-x-109">/ {
+ if(lastLine == "<span ") {
+ printf("<p class=\"subsection\">%s\n", lastLine)
+ } else {
+ print lastLine
+ }
+}
+
+!/^class="Spectral-Bold-lf-t-1x-x-109">/ {
+ print lastLine
+}
+
+{ lastLine = $0 }
+
+END {print lastLine}
+