summaryrefslogtreecommitdiff
path: root/info/docsurvey/docsurvey.tex
diff options
context:
space:
mode:
Diffstat (limited to 'info/docsurvey/docsurvey.tex')
-rw-r--r--info/docsurvey/docsurvey.tex929
1 files changed, 655 insertions, 274 deletions
diff --git a/info/docsurvey/docsurvey.tex b/info/docsurvey/docsurvey.tex
index 4b37f380b5..fb5a1e1995 100644
--- a/info/docsurvey/docsurvey.tex
+++ b/info/docsurvey/docsurvey.tex
@@ -1,8 +1,476 @@
+% To compile:
+% lualatex docsurvey.tex
+% lualatex docsurvey.tex
+% biber docsurvey
+% lualatex docsurvey.tex
+% lualatex docsurvey.tex
+
+\begin{filecontents}[overwrite]{docsurvey.bib}
+@book{lamport:latex,
+ title={\LaTeX: A Document Preparation System},
+ author={Leslie Lamport},
+ edition=2,
+ publisher={Addison Wesley},
+ year=1994,
+ isbn=0201529831,
+}
+
+@book{hokpkadaly:guide,
+ title={Guide to \LaTeX},
+ author={Helmut Kopka and Patrick W. Daly},
+ edition=4,
+ publisher={Addison-Wesley},
+ year=2004,
+ isbn=0321173856,
+}
+
+@book{gratzer:moremath,
+ title={More Math Into \LaTeX},
+ author={George Gr\"{a}tzer},
+ edition=5,
+ publisher={Springer},
+ year=2016,
+ isbn=9783319237954,
+}
+
+@book{kottwitz:beginner,
+ title={\LaTeX\ Beginner's Guide},
+ author={Stefan Kottwitz},
+ publisher={Packt Publishing},
+ year=2011,
+ isbn=1847199860,
+}
+
+@book{kottwitz:cookbook,
+ title={\LaTeX\ Cookbook},
+ author={Stefan Kottwitz},
+ publisher={Packt Publishing},
+ year=2015,
+ isbn=9781784395148,
+ url={http://latex-cookbook.net}
+}
+
+@book{mittelbachgossens:companion,
+ title={The \LaTeX\ Companion},
+ author={Frank Mittelbach and Michel Goossens and Johannes Braams
+ and David Carlisle and Chris Rowley},
+ edition=2,
+ publisher={Addison-Wesley},
+ year=2004,
+ isbn=0201362996,
+}
+
+@book{eijkhout:topic,
+ title={\TeX\ by Topic},
+ subtitle={A \TeX{}nician's Reference},
+ author={Victor Eijkhout},
+ publisher={Addison-Wesley UK},
+ year=1991,
+ isbn=0201568829,
+ url={http://eijkhout.net/texbytopic/texbytopic.html}
+}
+
+@manual{hefferon:first,
+ title={Getting something out of \LaTeX},
+ author={Jim Hefferon},
+ year=2009,
+ url={https://ctan.org/pkg/first-latex-doc}
+}
+
+@manual{flynn:veryshort,
+ title={The very short guide to typesetting with \LaTeX},
+ author={Peter Flynn},
+ year=2016,
+ url={https://ctan.org/pkg/latex-veryshortguide}
+}
+
+@manual{flynn:formatting,
+ title={Formatting Information, A beginner’s introduction to
+ typesetting with \LaTeX},
+ author={Peter Flynn},
+ year=2005,
+ url={https://ctan.org/pkg/beginlatex}
+}
+
+@manual{talbot:novices,
+ title={\LaTeX\ for Complete Novices},
+ author={Nicola L. C. Talbot},
+ year=2012,
+ publisher={Dickimaw Books},
+ url={http://www.dickimaw-books.com}
+}
+
+@manual{talbot:phd,
+ title={Using \LaTeX\ to Write a PhD Thesis},
+ author={Nicola L. C. Talbot},
+ year=2013,
+ publisher={Dickimaw Books},
+ url={http://www.dickimaw-books.com}
+}
+
+@manual{morris:gettingstarted,
+ title={Getting Started with \LaTeXe},
+ author={Michael P. Morris},
+ year=2020,
+ url={https://ctan.org/pkg/startlatex2e}
+}
+
+@manual{Bennieston:scientific,
+ title={Writing Scientific Documents Using \LaTeX},
+ author={Andrew J. Bennieston},
+ year=2009,
+ url={https://ctan.org/pkg/intro-scientific}
+}
+
+@manual{oetiker:introduction,
+ title={The Not So Short Introduction to \LaTeXe},
+ author={Tobias Oetiker},
+ year=2015,
+ url={https://ctan.org/pkg/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}
+}
+
+@manual{latex:authors,
+ title={\LaTeXe\ for authors},
+ author={\LaTeX3 Project Team},
+ year=2020,
+ url={https://ctan.org/pkg/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}
+}
+
+@article{voss:farbige,
+ title={Farbige Mathematik},
+ journaltitle={TeXnische Komödie},
+ author={Herbert Voß},
+ year=2004,
+ url={https://ctan.org/pkg/voss-mathcol}
+}
+
+@manual{Gonzato:musicians,
+ title={\LaTeX\ for Musicians},
+ author={Guido Gonzato},
+ year=2019,
+ url={https://ctan.org/pkg/latex4musicians}
+}
+
+@manual{pakin:list,
+ title={The Comprehensive \LaTeX\ Symbol List},
+ author={Scott Pakin},
+ year=2017,
+ url={https://ctan.org/pkg/comprehensive}
+}
+
+@manual{robertson:mathsymbols,
+ title={Every symbol (most symbols) defined by unicode-math},
+ author={Will Robertson},
+ year=2018,
+ url={https://ctan.org/pkg/unicode-math}
+}
+
+@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}
+}
+
+@manual{scharrer:listinternal,
+ title={List of internal \LaTeXe\ Macros useful to Package Authors},
+ author={Martin Scharrer},
+ url={https://ctan.org/pkg/macros2e}
+}
+
+@online{TeX:FAQ,
+ title={\TeX\ FAQ},
+ url={https://texfaq.org/}
+}
+
+@manual{pakin:visual,
+ title={The Visual \LaTeX\ FAQ},
+ author={Scott Pakin},
+ url={https://ctan.org/pkg/visualfaq}
+}
+
+@manual{bouzigues:guide,
+ title={Initiation à \LaTeX},
+ subtitle={Pour débutants ou jeunes utilisateurs},
+ author={Adrien Bouzigues},
+ year=2017,
+ url={https://ctan.org/pkg/guide-latex-fr}
+}
+
+@manual{Goulet:Redaction,
+ title={Rédaction avec \LaTeX},
+ author={Vincent Goulet},
+ year=2020,
+ url={https://ctan.org/pkg/formation-latex-ul}
+}
+
+@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}
+}
+
+@manual{massago:exemplos,
+ title={\LaTeXe\ Via Exemplos},
+ author={Sadao Massago},
+ year=2018,
+ url={https://ctan.org/pkg/latex-via-exemplos}
+}
+
+@online{latexwikibook,
+ title={Wikibooks},
+ subtitle={LaTeX},
+ url={https://en.wikibooks.org/wiki/LaTeX}
+}
+
+@online{ebookfoundation:free,
+ title={Free Programming Books},
+ author={Ebook Foundation},
+ url={https://github.com/EbookFoundation/free-programming-books}
+}
+
+@book{wilson:design,
+ title={A Few Notes on Book Design},
+ author={Peter Wilson},
+ year=2009,
+ month=8,
+ publisher={The Herries Press},
+ edition=1,
+ url={https://ctan.org/pkg/memdesign}
+}
+
+@manual{kohm:typearea,
+ title={KOMA-Script — The Guide},
+ author={Markus Kohm},
+ year=2018,
+ url={https://ctan.org/pkg/koma-script}
+}
+
+@manual{tufte:book,
+ title={A TUFTE-STYLE BOOK},
+ author={The Tufte-LaTeX Developers},
+ year=2015,
+ url={https://ctan.org/pkg/tufte-latex}
+}
+
+@article{revets:octavo,
+ title={The Octavo Package},
+ author={Stefan A. Revets},
+ journaltitle={TUGboat},
+ number={23 3/4},
+ year=2002,
+ pages={269},
+ url={https://ctan.org/pkg/octavo}
+}
+
+@manual{beccari:canoniclayout,
+ title={Package canoniclayout},
+ author={Claudio Beccari},
+ year=2011,
+ url={https://ctan.org/pkg/canoniclayout}
+}
+
+@manual{fear:booktabs,
+ title={Publication-quality tables in \LaTeX},
+ author={Simon Fear},
+ year=2016,
+ url={https://ctan.org/pkg/booktabs}
+}
+
+@manual{tantu:pgf,
+ title={The TikZ and PGF Packages},
+ author={Till Tantau},
+ year=2020,
+ url={https://ctan.org/pkg/pgf}
+}
+
+@online{texdocnet,
+ title={TeXdoc Online},
+ url={http://texdoc.net}
+}
+
+@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}
+}
+
+@manual{pakin:dtxtut,
+ title={How to Package Your \LaTeX\ Package},
+ author={Scott Pakin},
+ url={https://ctan.org/pkg/dtxtut}
+}
+
+@manual{latexteam:class,
+ title={\LaTeXe\ for class and package writers},
+ author={\LaTeX3 Project},
+ url={https://ctan.org/pkg/clsguide}
+}
+
+@manual{mittelbach:doc,
+ title={The doc and shortvrb packages},
+ author={Frank Mittelbach},
+ url={https://ctan.org/pkg/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}
+}
+
+@article{flynn:article,
+ title={Rolling your own Document Class:
+ Using \LaTeX\ to keep away from the Dark Side},
+ author={Peter Flynn},
+ journaltitle={TUGboat},
+ number={28:1},
+ year=2007,
+ pages={110--123},
+ url={http://tug.org/TUGboat/tb28-1/tb88flynn.pdf}
+}
+
+@article{pakin:goodthings,
+ title={Good things come in little packages:
+ An introduction to writing \texttt{.ins} and \texttt{.dtx} files},
+ author={Scott~Pakin},
+ journaltitle={TUGboat},
+ number={29:2},
+ year=2008,
+ pages={305--314},
+ url={http://tug.org/TUGboat/tb29-2/tb92pakin.pdf}
+}
+
+@article{mansfield:class,
+ title={How to develop your own document class\Dash our experience},
+ author={Niall Mansfield},
+ journaltitle={TUGboat},
+ number={29:3},
+ year=2008,
+ pages={356--361},
+ url={http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf}
+}
+
+@online{gutenberg:TeXniques,
+ title={TeXniques},
+ subtitle={Groupe francophone des Utilisateurs de TEX, \LaTeX\ et logiciels compagnons},
+ url={https://www.gutenberg.eu.org/TeXniques}
+}
+
+@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}
+}
+
+@book{baudoin:learnLaTeX,
+ title={Apprends \LaTeX!},
+ author={Marc Baudoin},
+ year=2012,
+ url={http://www.babafou.eu.org/Apprends_LaTeX}
+}
+
+@manual{amsmath,
+ title={User’s Guide for the amsmath Package},
+ author={{American Mathematical Society} and {\LaTeX3 project}},
+ year=2020,
+ url={https://ctan.org/pkg/amsmath}
+}
+
+@manual{amsmath-it,
+ title={Manuale utente per il pacchetto amsmath},
+ author={{American Mathematical Society} and {\LaTeX3 project}},
+ 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}
+}
+
+@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}
+}
+
+@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},
+ year=1999,
+ url={https://ctan.org/pkg/amslatexdoc-vietnamese}
+}
+
+@manual{latex2e-japanese,
+ title={\LaTeX2e for authors},
+ author={\LaTeX3 Project Team},
+ translator={Yukitoshi FUJIMURA},
+ year=2015,
+ 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}},
+ translator={Yukitoshi FUJIMURA},
+ year=2018,
+ url={https://www.latex-project.org/help/documentation/amsldoc_jpn.pdf}
+}
+
+@manual{shortmath-jp,
+ title={Short Math Guide for LaTeX},
+ author={Michael Downes and Barbara Beeton},
+ translator={Yukitoshi FUJIMURA},
+ year=2017,
+ url={https://www.latex-project.org/help/documentation/short-math-guide_jpn.pdf}
+}
+
+\end{filecontents}
+
+
+
+
\documentclass{article}
% \documentclass[twocolumn]{article}
+
+
+% \usepackage[T1]{fontenc}
+% \usepackage[utf8]{inputenc}
+\usepackage{fontspec}
+% \setmonofont{Inconsolata}
+% \setmainfont{Erewhon}
+% \setsansfont{SourceSansPro}
+
+
\usepackage{lmodern}
\usepackage{erewhon}
% \usepackage[type1,scaled=.95]{cabin} % sans serif like Gill Sans, full styles
@@ -10,15 +478,18 @@
\usepackage[varqu,varl]{inconsolata} % typewriter
% \renewcommand{\familydefault}{\sfdefault}
-\usepackage[T1]{fontenc}
-\usepackage[utf8]{inputenc}
\usepackage[bottom=1in]{geometry}
\usepackage{graphicx}
+\usepackage{metalogox}
+
\usepackage{needspace}
+\usepackage{biblatex}
+\addbibresource{docsurvey.bib}
+
\usepackage[nottoc,numbib]{tocbibind}
\setcounter{secnumdepth}{0}
@@ -302,6 +773,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\usepackage{enumitem}
\setlist[description]{style=nextline,font=\small}
+\setlist[description]{style=nextline,font=\small,before={\raggedright}}
\usepackage{multicol}
@@ -313,13 +785,12 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\newrobustcmd*{\pkg}[1]{\textsf{#1}}
\newrobustcmd*{\prog}[1]{\texttt{#1}}
-\newrobustcmd*{\LuaLaTeX}{Lua\-\LaTeX}
-\newrobustcmd*{\LuaTeX}{Lua\-\TeX}
\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})}}
\newrobustcmd*{\userentry}[1]{%
\leavevmode\par\hspace*{2em}\texttt{#1}\smallskip\\}
@@ -339,7 +810,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\author{Brian Dunn \\
\small \href{mailto:bd@BDTechConcepts.com}{bd@BDTechConcepts.com} \\
- \small Copyright 2017--2018 Brian Dunn\thanks{
+ \small Copyright 2017--2020 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.
@@ -360,7 +831,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
\begin{abstract}
\noindent
-A survey of programming-related documentation for \LaTeX.
+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,
programming-related packages, users groups and online communities,
@@ -395,6 +866,7 @@ on the screen. Printed books also provide extended discussion of
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
@@ -414,7 +886,7 @@ electronic format.
of \LaTeX\ and numerous useful packages.
Second edition: 2004.~\cite{mittelbachgossens:companion}
\item[Additional books:] Listed at the \TeX\ \acro{FAQ}.~\cite{TeX:FAQ}
- \hfurl{https://texfaq.org/}
+ \hfciteurl{TeX:FAQ}
\end{description}
@@ -428,7 +900,7 @@ program.
\subsection{\TeX}
\begin{description}
-\item[\TeX\ by Topic, A \TeX{}nician's Reference:]
+\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
@@ -441,15 +913,15 @@ program.
\begin{description}
\item[Getting something out of \LaTeX:]
Create your first document in \LaTeX.~\cite{hefferon:first}
- \hfurl{https://ctan.org/pkg/first-latex-doc}
+ \hfciteurl{hefferon:first}
\item[The very short guide to typesetting with \LaTeX:]
A four-page introduction.~\cite{flynn:veryshort}
- \hfurl{https://ctan.org/pkg/latex-veryshortguide}
+ \hfciteurl{flynn:veryshort}
\item[Formatting Information:]
A beginner’s introduction to typesetting with \LaTeX.~\cite{flynn:formatting}
- \hfurl{https://ctan.org/pkg/beginlatex}
+ \hfciteurl{flynn:formatting}
\item[\LaTeX\ for Complete Novices:]
An extensive introduction for a non-technical person.~\cite{talbot:novices}
@@ -460,24 +932,35 @@ program.
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} \\
- \hfurl{https://ctan.org/pkg/intro-scientific}
+ 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} \hfurl{https://ctan.org/pkg/lshort}
+ \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} \\
- \hfurl{https://latexref.xyz}
+ 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. \\
- \hfurl{https://en.wikibooks.org/wiki/LaTeX}
+ 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}
\subsection{Lua\LaTeX}
@@ -503,6 +986,37 @@ program.
programming environment. \texdoc{interface3}
\end{description}
+
+\subsection{Math typesetting}
+\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}
+
+
+\subsection{Music typesetting}
+
+\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}
+
+
\subsection{Symbol references}
These are lists of the \LaTeX\ commands which produce symbols.
@@ -510,7 +1024,7 @@ These are lists of the \LaTeX\ commands which produce symbols.
\begin{description}
\item[Comprehensive \LaTeX\ Symbol List:]
More than 14,000 symbols and \LaTeX\ commands.~\cite{pakin:list}
-\texdoc{symbols-letter} \\ \texdoc{symbols-a4}
+\texdoc{symbols-letter} \texdoc{symbols-a4}
\item[Every symbol (most symbols) defined by unicode-math:]
Unicode math symbols.~\cite{robertson:mathsymbols}
@@ -526,8 +1040,7 @@ The source code for \LaTeXe\ itself is also included in the distribution.
\item[The \LaTeXe\ sources:] Occasionally useful for figuring out how
something really works.~\cite{latexteam:sources}
\texdoc{source2e}
-\item[List of internal \LaTeXe\ macros
- \\\hspace*{-\leftmargin}useful to package authors:]
+\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}
@@ -540,11 +1053,10 @@ The source code for \LaTeXe\ itself is also included in the distribution.
%Frequently-Asked Questions
\begin{description}
-\item[\TeX\ FAQ:] A wide-ranging list of
-fre\-quently-asked questions.
-(formerly the UK TUG FAQ)
-~\cite{TeX:FAQ} \\
-\texdoc{letterfaq} \\
+\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
@@ -553,35 +1065,98 @@ it is programmed.~\cite{pakin:visual}
\end{description}
-\subsection{Non-English}
-
-\begin{description}
-\item[Initiation à LATEX:] A French guide on \LaTeX — for beginners
- or advanced users.~\cite{bouzigues:guide} \\
- \hfurl{https://ctan.org/pkg/guide-latex-fr}
-
-\item[\LaTeXe\ Via Exemplos:] A study course
-in Brazilian Portuguese.~\cite{massago:exemplos}
- \hfurl{https://ctan.org/pkg/latex-via-exemplos}
-
-\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} \hfurl{https://ctan.org/pkg/lshort}
+\subsection{International languages}
+\label{sec:international}
-\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} \\
- \hfurl{https://latexref.xyz}
-
-\item [Ebook Foundation — Free Programming Books:] A variety
-of \TeX-related and other programming books and documents,
-in a number of languages.~\cite{ebookfoundation:free}
-\hfurl{https://github.com/EbookFoundation/free-programming-books}
+\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:] \
+ 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:%
+ ]
+ 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 typeseting theory}
+\subsection{General typesetting theory}
Discussion about general typesetting theory,
presented by various \TeX-related authors.
@@ -630,7 +1205,7 @@ 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. \hfurl{texdoc.net}
+with popular packages sorted by category. \hfciteurl{texdocnet}
\subsection{\prog{kpsewhich}}
@@ -693,7 +1268,17 @@ topics then shows you related packages.~\cite{ctan}
\needspace{7\baselineskip}
-\section{Packages useful for programming \LaTeX}
+\section{Useful packages}
+
+\subsection{General use}
+
+\begin{description}
+\item [A First Set of \LaTeX\ Packages:]
+ A list of packages useful for beginners.~\cite{hefferon:firstset}
+ \texdoc{first-packages}
+\end{description}
+
+\subsection{Programming \LaTeX}
A number of packages are especially useful for \LaTeX\ programmers:
\texdoc{<packagename>}
@@ -766,25 +1351,29 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
\end{description}
\section{Users groups}
+\label{sec:groups}
\begin{description}[style=unboxed]
\item[\TeX\ Users Group:] \url{http://tug.org}
+\item[Dante:] German users group. \url{https://www.dante.de}
\item[List of international users groups:] \url{http://tug.org/usergroups.html}
\end{description}
\section{Online communities}
+\label{sec:online}
\begin{description}[style=unboxed]
\item[English forums:] \
\begin{description}[style=unboxed]
\raggedright
\item[TeX\Dash \LaTeX\ Stack Exchange:]
- \url{http://tex.stackexchange.com} \\
Almost any question has already
been asked, and a quick web search will find answers, ranked by vote.
-\item[\LaTeX\ Community:] \url{http://www.latex-community.org} \\
+ \url{http://tex.stackexchange.com}
+\item[\LaTeX\ Community:]
A traditional forum with quick replies
to your questions
+ \url{http://www.latex-community.org}
\end{description}
\item[German forums:] \
@@ -798,8 +1387,10 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
\item[TeXnique.fr:] \url{http://texnique.fr}
\end{description}
-\item[Mailing lists:] \url{http://tug.org/mailman/listinfo} \\
+\item[Mailing lists:]
Several dozen, spanning a wide range of \TeX-related topics.
+ \url{http://tug.org/mailman/listinfo}
+
\item[Newsgroup:] \url{comp.text.tex}
\end{description}
@@ -831,225 +1422,15 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
Updated host and name for \TeX\ \acro{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.
\end{description}
-\begin{thebibliography}{99}
-
-\bibitem{lamport:latex}
-\pub{\LaTeX: A Document Preparation System},
-Leslie Lamport,
-second edition, Addison Wesley, 1994, ISBN 0201529831.
-
-\bibitem{hokpkadaly:guide}
-\pub{Guide to \LaTeX},
-Helmut Kopka and Patrick W. Daly,
-fourth edition, Addison-Wesley, 2004, ISBN 0321173856.
-
-\bibitem{gratzer:moremath}
-\pub{More Math Into \LaTeX},
-George Gr\"{a}tzer,
-5th ed., Springer, 2016,
-ISBN 3319237950.
-%ISBN-13: 978-3319237954.
-
-\bibitem{kottwitz:beginner}
-\pub{\LaTeX\ Beginner's Guide},
-Stefan Kottwitz,
-Packt Publishing, 2011, ISBN 1847199860.
-%ISBN-13 1847199860.
-
-\bibitem{kottwitz:cookbook}
-\pub{\LaTeX\ Cookbook}, Stefan Kottwitz, Packt Publishing, 2015,
-ISBN-13 9781784395148. \\
-\url{http://latex-cookbook.net}
-
-\bibitem{mittelbachgossens:companion}
-\pub{The \LaTeX\ Companion},
-Frank Mittelbach, Michel Goossens, Johannes Braams,
-David Carlisle and Chris Rowley,
-second edition, Addison-Wesley, 2004,
-ISBN 0201362996.
-%ISBN-13 0-201-36299-6.
-
-\bibitem{eijkhout:topic}
-\pub{\TeX\ by Topic}, A \TeX{}nician's Reference,
-Victor Eijkhout,
-Addison-Wesley UK, 1991, ISBN 0201568829.
-\url{http://eijkhout.net/texbytopic/texbytopic.html}
-
-\bibitem{hefferon:first}
-\pub{Getting something out of \LaTeX},
-Jim Hefferon, 2009. \url{https://ctan.org/pkg/first-latex-doc}
-
-\bibitem{flynn:veryshort}
-\pub{The very short guide to typesetting with \LaTeX},
-Peter Flynn, 2016. \\
-\url{https://ctan.org/pkg/latex-veryshortguide}
-
-\bibitem{flynn:formatting}
-\pub{Formatting Information}, A beginner’s introduction to
-typesetting with \LaTeX, Peter Flynn, 2005. \\
-\url{https://ctan.org/pkg/beginlatex}
-
-\bibitem{talbot:novices}
-\pub{\LaTeX\ for Complete Novices},
-Nicola L. C. Talbot, 2012.
-Dickimaw Books.
-\url{http://www.dickimaw-books.com}
-
-\bibitem{talbot:phd}
-\pub{Using \LaTeX\ to Write a PhD Thesis},
-Nicola L. C. Talbot, 2013.
-Dickimaw Books.
-\url{http://www.dickimaw-books.com}
-
-\bibitem{Bennieston:scientific}
-\pub{Writing Scientific Documents Using \LaTeX},
-Andrew J. Bennieston, 2009. \\
-\url{https://ctan.org/pkg/intro-scientific}
-
-\bibitem{oetiker:introduction}
-\pub{The Not So Short Introduction to \LaTeXe},
-Tobias Oetiker, 2015. \url{https://ctan.org/pkg/lshort}
-
-\bibitem{greenwade:reference}
-\pub{\LaTeXe: An unofficial reference manual},
-George~D. Greenwade, Stephen Gilmore,
-Torsten~Martinsen, and Karl Berry.
-\url{https://latexref.xyz}
-
-\bibitem{pakin:list}
-\pub{The Comprehensive \LaTeX\ Symbol List},
-Scott Pakin, 2017.
-\url{https://ctan.org/pkg/comprehensive}
-
-\bibitem{robertson:mathsymbols}
-\pub{Every symbol (most symbols) defined by unicode-math},
-Will Robertson, 2018. \\
-\url{https://ctan.org/pkg/unicode-math}
-
-\bibitem{latexteam:sources}
-\pub{The \LaTeXe\ Sources},
-Johannes Braams, David Carlisle, Alan Jeffrey, Leslie Lamport,
-Frank Mittelbach, Chris Rowley, and Rainer Sch\"opf.
-\url{https://ctan.org/pkg/source2e}
-
-\bibitem{scharrer:listinternal}
-\pub{List of internal \LaTeXe\ Macros useful to Package Authors},
-Martin Scharrer. \\
-\url{https://ctan.org/pkg/macros2e}
-
-\bibitem{TeX:FAQ}
-\TeX\ FAQ.
-\url{https://texfaq.org/}
-
-\bibitem{pakin:visual}
-\pub{The Visual \LaTeX\ FAQ},
-Scott Pakin.
-\url{https://ctan.org/pkg/visualfaq}
-
-\bibitem{bouzigues:guide}
-\pub{Initiation à \LaTeX}, Pour débutants ou jeunes utilisateurs,
-Adrien Bouzigues, 2017. \\
-\url{https://ctan.org/pkg/guide-latex-fr}
-
-\bibitem{massago:exemplos}
-\pub{\LaTeXe\ Via Exemplos},
-Sadao Massago, 2018.
-\url{https://ctan.org/pkg/latex-via-exemplos}
-
-\bibitem{ebookfoundation:free}
-\pub{Free Programming Books},
-Ebook Foundation. \\
-\url{https://github.com/EbookFoundation/free-programming-books}
-
-\bibitem{wilson:design}
-\pub{A Few Notes on Book Design},
-Peter Wilson, 2009.
-\url{https://ctan.org/pkg/memdesign}
-
-\bibitem{kohm:typearea}
-\pub{KOMA-Script — The Guide},
-Markus Kohm, 2018.
-\url{https://ctan.org/pkg/koma-script}
-
-\bibitem{tufte:book}
-\pub{A TUFTE-STYLE BOOK},
-The Tufte-LaTeX Developers, 2015.
-\url{https://ctan.org/pkg/tufte-latex}
-
-\bibitem{revets:octavo}
-\pub{The Octavo Package},
-Stefan A. Revets,
-\pub{TUGboat} 23 3/4 (2002), p.~269.
-\url{https://ctan.org/pkg/octavo}
-
-\bibitem{beccari:canoniclayout}
-\pub{Package canoniclayout},
-Claudio Beccari, 2011.
-\url{https://ctan.org/pkg/canoniclayout}
-
-\bibitem{fear:booktabs}
-\pub{Publication-quality tables in \LaTeX},
-Simon Fear, 2016.
-\url{https://ctan.org/pkg/booktabs}
-
-\bibitem{tantu:pgf}
-\pub{Till Tantau}, 2015.
-\url{https://ctan.org/pkg/pgf}
-
-\bibitem{texdocnet}
-TeXdoc Online.
-\url{http://texdoc.net}
-
-\bibitem{ctan}
-Comprehensive \TeX\ Archive Network (CTAN).
-\url{https://ctan.org}
-
-\bibitem{pakin:dtxtut}
-\pub{How to Package Your \LaTeX\ Package},
-Scott~Pakin.
-\url{https://ctan.org/pkg/dtxtut}
-
-\bibitem{latexteam:class}
-\pub{\LaTeXe\ for class and package writers},
-\LaTeX3 Project.
-\url{https://ctan.org/pkg/clsguide}
-
-\bibitem{mittelbach:doc}
-\pub{The doc and shortvrb packages},
-Frank Mittelbach.
-\url{https://ctan.org/pkg/doc}
-
-\bibitem{mittelbach:docstrip}
-\pub{The DocStrip program},
-Frank Mittelbach, Denys Duchier, Johannes Braams,
-Marcin Woli\'nski, and Mark Wooding.
-\url{https://ctan.org/pkg/docstrip}
-
-\bibitem{flynn:article}
-\pub{Rolling your own Document Class:
-Using \LaTeX\ to keep away from the Dark Side},
-Peter~Flynn,
-\TUB\ 28:1 (2007), pp.\,110--123.
-\url{http://tug.org/TUGboat/tb28-1/tb88flynn.pdf}
-
-\bibitem{pakin:goodthings}
-\pub{Good things come in little packages:
-An introduction to writing \texttt{.ins} and \texttt{.dtx} files},
-Scott~Pakin,
-\TUB\ 29:2 (2008), pp.\,305--314.
-\url{http://tug.org/TUGboat/tb29-2/tb92pakin.pdf}
-
-\bibitem{mansfield:class}
-\pub{How to develop your own document class\Dash our experience},
-Niall Mansfield,
-\TUB\ 29:3 (2008), pp.\,356--361.
-\url{http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf}
-
-\end{thebibliography}
-% \vfilneg
+\printbibliography
+
\end{document}