texlive[46430] Master/texmf-dist/doc/latex/docsurvey: docsurvey
commits+karl at tug.org
commits+karl at tug.org
Wed Jan 24 22:50:11 CET 2018
Revision: 46430
http://tug.org/svn/texlive?view=revision&revision=46430
Author: karl
Date: 2018-01-24 22:50:11 +0100 (Wed, 24 Jan 2018)
Log Message:
-----------
docsurvey (24jan18)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/docsurvey/README.txt
trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
Modified: trunk/Master/texmf-dist/doc/latex/docsurvey/README.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/docsurvey/README.txt 2018-01-24 21:49:58 UTC (rev 46429)
+++ trunk/Master/texmf-dist/doc/latex/docsurvey/README.txt 2018-01-24 21:50:11 UTC (rev 46430)
@@ -4,7 +4,7 @@
Provides the document
"Programming LaTeX — A survey of documentation and packages"
-January 18, 2018
+January 21, 2018
Copyright 2017-2018 Brian Dunn — www.BDTechConcepts.com
LaTeX Project Public License, version 1.3
Modified: trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex 2018-01-24 21:49:58 UTC (rev 46429)
+++ trunk/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex 2018-01-24 21:50:11 UTC (rev 46430)
@@ -268,6 +268,7 @@
% \def\XSLFO{\acro{XSL}\raise.08ex\hbox{-}\acro{FO}}
% \def\XSLT{\acro{XSLT}}
+\newcommand{\pub}[1]{\textit{#1}}
\newcommand{\acro}[1]{\textsc{\MakeLowercase{#1}}}
@@ -367,7 +368,7 @@
Worse, though, is not even being aware that the wheel has already been
invented in the first place, which can be an embarrassing waste of time.
Such can be the case both for a new \LaTeX\ programmer who isn't aware of
-the many ways things may be done, but also for someone, the author included,
+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.
@@ -431,6 +432,22 @@
\subsection{\LaTeX}
\begin{description}
+\item[Getting something out of \LaTeX:]
+ Create your first document in \LaTeX.~\cite{hefferon:first}
+ \hfill \url{https://ctan.org/pkg/first-latex-doc}
+
+\item[The very short guide to typesetting with \LaTeX:]
+ A four-page introduction.~\cite{flynn:veryshort}
+ \hfill \url{https://ctan.org/pkg/latex-veryshortguide}
+
+\item[Formatting Information:]
+ A beginner’s introduction to typesetting with \LaTeX.~\cite{flynn:formatting}
+ \hfill \url{https://ctan.org/pkg/beginlatex}
+
+\item[Writing Scientific Documents Using \LaTeX:]
+ An introduction to typesetting scientific documents.~\cite{Bennieston:scientific} \\
+ \hspace*{\fill} \url{https://ctan.org/pkg/intro-scientific}
+
\item[The Not So Short Introduction to \LaTeXe:]
Covers introductory material, customizations,
and a simple package.~\cite{oetiker:introduction}
@@ -444,6 +461,11 @@
\item[LaTeX WikiBook:] An online book, includes information about
creating \LaTeX\ packages and classes. \\
\hspace*{\fill} \url{https://en.wikibooks.org/wiki/LaTeX}
+
+\item[Initiation à LATEX:] A French guide on \LaTeX — for beginners
+ or advanced users.~\cite{bouzigues:guide} \\
+ \hspace*{\fill} \url{https://ctan.org/pkg/guide-latex-fr}
+
\end{description}
\subsection{Lua\LaTeX}
@@ -472,8 +494,7 @@
More than 14,000 symbols and \LaTeX\ commands.~\cite{pakin:list} \\
\texdoc{symbols-letter} \\ \texdoc{symbols-a4}
-\item[Every symbol (most symbols) defined\\\hspace*{-\leftmargin}by
-unicode-math:]
+\item[Every symbol (most symbols) defined by unicode-math:]
Unicode math symbols.~\cite{robertson:mathsymbols}
\texdoc{unimath-symbols}
\end{description}
@@ -672,10 +693,10 @@
\begin{description}[style=unboxed]
\raggedright
\item[TeX\Dash \LaTeX\ Stack Exchange:]
- \url{http://tex.stackexchange.com/} \\
+ \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/} \\
+\item[\LaTeX\ Community:] \url{http://www.latex-community.org} \\
A traditional forum with quick replies
to your questions
\end{description}
@@ -683,7 +704,7 @@
\item[German forums:] \
\begin{description}[style=unboxed]
\item[TeXwelt:] \url{http://texwelt.de/wissen/}
-\item[goLaTeX:] \url{http://golatex.de/}
+\item[goLaTeX:] \url{http://golatex.de}
\end{description}
\item[Mailing lists:] \url{http://tug.org/mailman/listinfo} \\
@@ -694,8 +715,8 @@
\section{Distributions \Dash \LaTeX\ for various operating systems}
\begin{description}[style=unboxed]
-\item[TeXLive:] \url{http://tug.org/texlive/} \hfill Unix and Windows
-\item[MiKTex:] \url{https://miktex.org/} \hfill Windows and Mac
+\item[TeXLive:] \url{http://tug.org/texlive} \hfill Unix and Windows
+\item[MiKTex:] \url{https://miktex.org} \hfill Windows and Mac
\item[proTeXt:] \url{http://tug.org/protext/} \hfill Windows
\item[MacTex:] \url{http://tug.org/mactex/} \hfill Mac
\end{description}
@@ -710,6 +731,9 @@
Organization and formatting improvements.
\item[2017/10/14:] More information about accessing embedded documentation.
\item[2018/01/18:] Added \url{texdoc.net}.
+\item[2018/01/21:] Added \pkg{latex-veryshortguide}, \pkg{first-latex-doc},
+ \pkg{beginlatex},
+ \pkg{intro-scientific}, \pkg{guide-latex-fr}.
\end{description}
@@ -716,17 +740,17 @@
\begin{thebibliography}{99}
\bibitem{lamport:latex}
-\LaTeX: A Document Preparation System,
+\pub{\LaTeX: A Document Preparation System},
Leslie Lamport,
second edition, Addison Wesley, 1994, ISBN 0201529831.
\bibitem{hokpkadaly:guide}
-Guide to \LaTeX,
+\pub{Guide to \LaTeX},
Helmut Kopka and Patrick W. Daly,
fourth edition, Addison-Wesley, 2004, ISBN 0321173856.
\bibitem{gratzer:moremath}
-More Math Into \LaTeX,
+\pub{More Math Into \LaTeX},
George Gr\"{a}tzer,
5th ed., Springer, 2016,
ISBN 3319237950.
@@ -733,18 +757,18 @@
%ISBN-13: 978-3319237954.
\bibitem{kottwitz:beginner}
-\LaTeX\ Beginner's Guide,
+\pub{\LaTeX\ Beginner's Guide},
Stefan Kottwitz,
Packt Publishing, 2011, ISBN 1847199860.
%ISBN-13 1847199860.
\bibitem{kottwitz:cookbook}
-\LaTeX\ Cookbook, Stefan Kottwitz, Packt Publishing, 2015,
+\pub{\LaTeX\ Cookbook}, Stefan Kottwitz, Packt Publishing, 2015,
ISBN-13 9781784395148, \\
-\url{http://latex-cookbook.net/}
+\url{http://latex-cookbook.net}
\bibitem{mittelbachgossens:companion}
-The \LaTeX\ Companion,
+\pub{The \LaTeX\ Companion},
Frank Mittelbach, Michel Goossens, Johannes Braams,
David Carlisle and Chris Rowley,
second edition, Addison-Wesley, 2004,
@@ -751,99 +775,122 @@
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{Bennieston:scientific}
+\pub{Writing Scientific Documents Using \LaTeX},
+Andrew J. Bennieston, 2009. \\
+\url{https://ctan.org/pkg/intro-scientific}
+
\bibitem{oetiker:introduction}
-The Not So Short Introduction to \LaTeXe,
-Tobias Oetiker,
-\url{https://ctan.org/pkg/lshort}
+\pub{The Not So Short Introduction to \LaTeXe},
+Tobias Oetiker, 2015. \url{https://ctan.org/pkg/lshort}
\bibitem{greenwade:reference}
-\LaTeXe: An unofficial reference manual,
+\pub{\LaTeXe: An unofficial reference manual},
George~D. Greenwade, Stephen Gilmore,
-Torsten~Martinsen, and Karl Berry,
+Torsten~Martinsen, and Karl Berry.
\url{http://home.gna.org/latexrefman}
-\bibitem{eijkhout:topic}
-\TeX\ by Topic, A \TeX{}nician's Reference,
-Victor Eijkhout,
-Addison-Wesley UK, 1991, ISBN 0201568829,
-\url{http://eijkhout.net/texbytopic/texbytopic.html}
+\bibitem{bouzigues:guide}
+\pub{Initiation à \LaTeX}, Pour débutants ou jeunes utilisateurs,
+Adrien Bouzigues, 2017. \\
+\url{https://ctan.org/pkg/guide-latex-fr}.
\bibitem{pakin:list}
-The Comprehensive \LaTeX\ Symbol List,
-Scott Pakin,
+\pub{The Comprehensive \LaTeX\ Symbol List},
+Scott Pakin, 2017.
\url{https://ctan.org/pkg/comprehensive}
\bibitem{robertson:mathsymbols}
-Every symbol (most symbols) defined by unicode-math,
-Will Robertson, \\
+\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{UK:FAQ}
UK TUG FAQ,
UK \TeX\ Users Group,
-\url{http://www.tex.ac.uk/}
+\url{http://www.tex.ac.uk}
\bibitem{pakin:visual}
-The Visual \LaTeX\ FAQ,
+\pub{The Visual \LaTeX\ FAQ},
Scott Pakin,
\url{https://ctan.org/pkg/visualfaq}
\bibitem{texdocnet}
TeXdoc Online,
-\url{http://texdoc.net/}
+\url{http://texdoc.net}
-\bibitem{latexteam:sources}
-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}
-List of internal \LaTeXe\ Macros useful to Package Authors,
-Martin Scharrer, \\
-\url{https://ctan.org/pkg/macros2e}
-
\bibitem{ctan}
Comprehensive \TeX\ Archive Network (CTAN),
\url{https://ctan.org}
\bibitem{pakin:dtxtut}
-How to Package Your \LaTeX\ Package,
+\pub{How to Package Your \LaTeX\ Package},
Scott~Pakin,
\url{https://ctan.org/pkg/dtxtut}
\bibitem{latexteam:class}
-\LaTeXe\ for class and package writers,
+\pub{\LaTeXe\ for class and package writers},
\LaTeX3 Project,
\url{https://ctan.org/pkg/clsguide}
\bibitem{mittelbach:doc}
-The doc and shortvrb packages,
+\pub{The doc and shortvrb packages},
Frank Mittelbach,
\url{https://ctan.org/pkg/doc}
\bibitem{mittelbach:docstrip}
-The DocStrip program,
+\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}
-Rolling your own Document Class:
-Using \LaTeX\ to keep away from the Dark Side,
+\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}
-Good things come in little packages:
-An introduction to writing \texttt{.ins} and \texttt{.dtx} files,
+\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}
-How to develop your own document class\Dash our experience,
+\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}
More information about the tex-live-commits
mailing list