diff options
Diffstat (limited to 'info')
| -rw-r--r-- | info/docsurvey/README.txt | 19 | ||||
| -rw-r--r-- | info/docsurvey/docsurvey.pdf | bin | 348900 -> 292549 bytes | |||
| -rw-r--r-- | info/docsurvey/docsurvey.tex | 929 |
3 files changed, 671 insertions, 277 deletions
diff --git a/info/docsurvey/README.txt b/info/docsurvey/README.txt index 085730577f..035ee112e7 100644 --- a/info/docsurvey/README.txt +++ b/info/docsurvey/README.txt @@ -4,14 +4,15 @@ The LaTeX docsurvey package Provides the document "Programming LaTeX — A survey of documentation and packages" -2018/10/18 -Copyright 2017-2018 Brian Dunn — www.BDTechConcepts.com +2020/12/14 +Copyright 2017-2020 Brian Dunn — www.BDTechConcepts.com LaTeX Project Public License, version 1.3 --- -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, FAQs, the LaTeX source code, CTAN and distributions, programming-related packages, users groups and online communities, @@ -21,3 +22,15 @@ and information on creating packages and documentation. Files: README.txt, docsurvey.pdf, docsurvey.tex + +docsurvey.bib is generated when docsurvey.tex is compiled. + +--- + +To compile the document: + +lualatex docsurvey.tex +lualatex docsurvey.tex +biber docsurvey +lualatex docsurvey.tex +lualatex docsurvey.tex diff --git a/info/docsurvey/docsurvey.pdf b/info/docsurvey/docsurvey.pdf Binary files differindex 97b146e8c1..7244da15c9 100644 --- a/info/docsurvey/docsurvey.pdf +++ b/info/docsurvey/docsurvey.pdf 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} |