summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-05-17 20:25:25 +0000
committerKarl Berry <karl@freefriends.org>2018-05-17 20:25:25 +0000
commit7e9227dfbf310d133bca2331f978d17b65320433 (patch)
tree2a0ab91ce5f4386cf392abe441daee7606face4f /Master/texmf-dist/doc/latex
parent0ecf5cacb77a8ffb9204f7532bf5d93b44fe5e29 (diff)
knowledge (17may18)
git-svn-id: svn://tug.org/texlive/trunk@47739 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/knowledge/README.md4
-rw-r--r--Master/texmf-dist/doc/latex/knowledge/knowledge.pdfbin673977 -> 677639 bytes
-rw-r--r--Master/texmf-dist/doc/latex/knowledge/knowledge.tex75
3 files changed, 56 insertions, 23 deletions
diff --git a/Master/texmf-dist/doc/latex/knowledge/README.md b/Master/texmf-dist/doc/latex/knowledge/README.md
index e78dd4ff02d..c05535030e0 100644
--- a/Master/texmf-dist/doc/latex/knowledge/README.md
+++ b/Master/texmf-dist/doc/latex/knowledge/README.md
@@ -3,8 +3,8 @@ This directory contains the package
name: knowledge
license: LaTeX Project Public License version 1.2 or above
- version: v1.10
- date: 2018/02/17
+ version: v1.11
+ date: 2018/05/17
author: Thomas Colcombet
mail: thomas.colcombet@irif.fr
web: https://www.irif.fr/~colcombe/knowledge_en.html
diff --git a/Master/texmf-dist/doc/latex/knowledge/knowledge.pdf b/Master/texmf-dist/doc/latex/knowledge/knowledge.pdf
index d3b3246c9fc..8c5970a16ad 100644
--- a/Master/texmf-dist/doc/latex/knowledge/knowledge.pdf
+++ b/Master/texmf-dist/doc/latex/knowledge/knowledge.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/knowledge/knowledge.tex b/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
index d104052f6bc..72f8bb013b7 100644
--- a/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
+++ b/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
@@ -33,6 +33,7 @@
\renewrobustcmd\bibitem\oldbibitem
+\expandafter\let\expandafter\item\csname switch item\endcsname
\ifcodeTF{
\NewDocumentCommand\textmenu{m}{#1}
@@ -389,6 +390,7 @@
\knowledge{import}{kenvironment}
\knowledge{theorem}{environment}
\knowledge{tikzcd}{environment,ref=section:tikzcd}
+ \knowledge{thebibliography}{environment,ref=section:thebibliography}
\knowledge{document}{environment}
\end{scope}
@@ -630,8 +632,8 @@ This is essentially a list for personal referencing of what has to be done.
\item[2017-01-15] Added the \kl[\knowledge directives]{directive} \kl{synonym}.
\item[2017-01-15] Added the \texttt{noknowledge package} for minimizing the effects of not having "knowledge@@package" activated.
\item[2017-01-17] Changed the way options are handled, decoupling the package options (options of \cs{\usepackage}) from the configuration options (see \cs{\knowledgeconfigure}).
-\item[2017-01-17] Proper treatment of `final` option and \kl[composition mode]{composition} options.
-\item[2017-01-17] Added \robustdisplaycs{IfKnowledgeFinalMode}\texttt{[TF]} commands for the user.
+\item[2017-01-17] Proper treatment of `final' option and \kl[composition mode]{composition} options.
+\item[2017-01-17] Added \cs{\IfKnowledgeFinalMode}\texttt{[TF]} commands for the user.
\item[2017-01-17] Added the option \kl{fix hyperref twocolumn} as a shorthand for calling \cs{\knowledgeFixHyperrefTwocolumn} (thanks to Daniela Petrisan and Luca Reggio).
\item[2017-01-18] Added the configuration option \kl(option){notion} that offers a basic configuration compatible with \kl(package){xcolor} or not, and \texttt{final} and \kl{composition} modes.
\item[2017-01-19] Added \cs{\phantomintro} and an explanation on how to deal with \kl{align*}.
@@ -660,34 +662,33 @@ This is essentially a list for personal referencing of what has to be done.
\item[2017-06-08] The file \texttt{knowledge-example.sty} as been improved.
\item[2017-06-09] First release of version 1.0 on "CTAN".
\item[2017-06-10] Corrected the "quotation notation" to make it expandable for avoiding problems in table of contents (the @ was not working).
-\item[2017-06-11] Corrected a bug linked to changes of expl3 on recent distributions (pointed by Murray Eisenberg)
-\item[2017-06-11] Release of v1.01
+\item[2017-06-11] Corrected a bug linked to changes of expl3 on recent distributions (pointed by Murray Eisenberg). Release of v1.01 on CTAN.
\item[2017-06-27] Overloaded labels now perform an expansion of the argument (this was causing problems with biblatex).
-\item[2017-06-28] Options \texttt{log-declarations} of "xparse@@package" package removed (causing clash wit other packages, as pointed by Juliusz Chroboczek).
-\item[2017-06-28] Release of v1.02.
+\item[2017-06-28] Options \texttt{log-declarations} of "xparse@@package" package removed (causing clash with other packages, as pointed by Juliusz Chroboczek). Release of v1.02 on CTAN.
\item[2017-06-30] added the field \texttt{\robustdisplay{labelizable_bool}} to areas. Coded missing features of scoping. Now the "scope=" directive works with as parameter an enclosing "area", or a label.
\item [2017-06-30] Added in the source a Regression subdirectory containing files to be tested (so far only one: regression-scope.tex)
\item [2017-07-01] Corrected a conflict between the "scope@@option" and "makeidx@@option" option.
\item [2017-07-03] Scoping becomes operational.
\item [2017-07-04] The documentation for "notion@@style" and "intro notion@@style" are added (thanks to Fabian Reiter).
-\item [2017-07-09] The boolean \cs{environment_bool} has been added to "areas" in order to not always trigger the scope from an environment. Now the environment "document@@env" has this Boolean set to false, and it resolves a bug with the package "standalone@@package" noticed by Fabian Reiter.
+\item [2017-07-09] Added boolean \cs{environment_bool} field to "areas",in order to resolve an incompatibility with the package "standalone@@package" noticed by Fabian Reiter.
\item [2017-07-20] "Scoping" becomes fully operational, with the parenthesis notation of \cs{\kl} and \cs{\intro}. The use of scope has been recoded. Now scope links reuse implicitly the key as a link. Documentation updated.
\item[2017-07-26] File and line numbers added in the "kaux file". Added the option "diagnose line=" to deactivate it.
-\item[2017-07-26] Corrections to the documentation.
-\item[2017-07-27] Version 1.03.
+\item[2017-07-26] Corrections to the documentation. Version 1.03 on CTAN.
\item[2017-07-28] Corrected a bug of scoping in the context of synonyms. Added ctan for producing the ctan zip file.
\item[2017-08-06] Now passes the compliance test \texttt{check-declarations} of "expl3@@package"
(thanks to Marc Zeitoun)
\item[2017-09-12] The "hidelinks" option of "hyperref@@package" is now always activated.
-\item[2017-09-25] Ancient version of "xparse@@package" does not have \cs{\NewExpandableDocumentCommand}. Corrected.
-\item[2017-09-26] Version 1.05 on "CTAN".
-\item[2017-10-10] Bug in the implementation of \cs{\knowledgenewvariant} (that was invisible for older versions of "expl3@@package"). Found and corrected (thanks to Marc Zeitoun).
-\item[2017-10-10] Version 1.06 on "CTAN".
+\item[2017-09-25] Ancient version of "xparse@@package" does not have \cs{\NewExpandableDocumentCommand}. Corrected. Version 1.05 on "CTAN".
+\item[2017-10-10] Bug in the implementation of \cs{\knowledgenewvariant} (that was invisible for older versions of "expl3@@package"). Found and corrected (thanks to Marc Zeitoun). Version 1.06 on "CTAN".
\item[2017-10-15] Diagnose extended (suggested by Fabian Reiter). Minor corrections. Version 1.07 on "CTAN".
\item[2017-10-17] Added "cyclic color" and "cyclic colors=@@option". Reorganization of the structure of the code for producing a better "CTAN" archive. Version 1.08 on "CTAN".
\item[2018-01-31] Added the "strict" configuration option.
\item[2018-02-05] Added the "smallcaps" formatting directive.
-\item[2018-02-17] Corrected incompatibility with latest version of "expl3@@package".
+\item[2018-02-17] Corrected incompatibility with latest version of "expl3@@package". Version 1.10 on "CTAN".
+\item[2018-02-21] Bug correction concerning the activation of scopes.
+\item[2018-02-21] Documentation improvement for "Emacs" (thanks to Michaƫl Cadilhac).
+\item[2018-02-24] Documentation improvement for the environment "thebibliography@@env".
+\item[2018-05-17] Correction to be compatible with the lastest version of "expl3@@package" (thanks to Leo Stefanesco).
\end{compactdesc}
\normalsize
%\restoregeometry
@@ -960,7 +961,12 @@ Now, using code like
\end{code}
\noindent will properly be linked to the definition of a semigroup and a monoid.
+%
+%\subsection{Managing an index}
+%Though it is not its primary goal, without using its hyperlinking capabilities, the "knowledge@@package" offers convenient features for easily managing data for the construction of an index.
+%For instance, let us imagine that one wants to write a book
+%
\subsection{Mathematics}
\label{subsection:mathematics scenario}
@@ -2298,24 +2304,44 @@ A workaround is to use the \texttt{breaklinks} option of \kl(package){hyperref}
\subsection{Problems with scope}
-\subsubsection{Problems in combination with \cs{\bibitem}}
-
-The "scope option" of the package triggers some analysis of the code, and restrains the structure of the code (in particular, this is because "scopes" have to be nested, and thus some not so well nested part of "LaTeX" yields error). In particular, the "scope option" does not allow to have a \cs{\section} command inside a list. However, this is what does \cs{\bibitem}.
+\subsubsection{Problems in combination with \cs{\bibitem} and "thebibliography@@env"}
+\section{}
+The "scope option" of the package triggers some analysis of the code, and restrains the structure of the code (in particular, this is because "scopes" have to be nested, and thus some not so well nested part of \LaTeX{} yields error). In particular, the "scope option" does not allow to have a \cs{\section} command inside a list.
+However, this is what does the environment "thebibliography@@env", yielding a scoping error.
+
+A simple hack to treat this situation:
+\begin{code}[6cm]
+\cs\let\cs\section\cs\SUPERsection\\
+\cs\begin\{"thebibliography@@env"\}\\
+\cs\bibitem\dots\\
+{}[...]\\
+\cs\end\{"thebibliography@@env"\}\\
+\cs\let\cs\section\cs\NEWsection
+\end{code}
+The result is to revert to the original version of the macro \smallcode{\cs\section}, which does not make any structural test, and then reactivate the modified version of the command.
-Here is a hack to treat this situation:
+Another solution is to reconfigure the environment "thebibliography@@env" using in the preamble:
+\begin{code}
+\cs\ScopeConfigure\{"thebibliography@@env"\}\par
+\hspace{3cm}\{push code=\cs\let\cs\section\cs\SUPERsection,\par
+\hspace{3cm}~pop code=\cs\let\cs\section\cs\NEWsection\}
+\end{code}
-\subsection{Editor}
+\subsection{Editors}
\newenvironment{pquote}{\begin{quote}}{\end{quote}}
\knowledgeconfigure{protect quotation=pquote}
\subsubsection{"Emacs" editor and \kl[quotation notation]{quotes}}
-The "AucTex" mode in "Emacs" binds the quote symbol to other characters. This is not convenient when using the "knowledge@@package" package.
+The "AucTex" mode in "Emacs" binds the quote symbol to other characters, cycling
+through \verb|``|, \quotesymbol, and \quotesymbol\quotesymbol. This is not
+convenient when using the "knowledge@@package" package.
This behavior can be deactivated temporarily using:
\begin{pquote}
-\texttt{M-x local-unset-key $\backslash$\quotesymbol.}
+%\texttt{M-x local-unset-key $\backslash$\quotesymbol.}
+\texttt{M-x local-unset-key RET \quotesymbol{} RET}
\end{pquote}\noindent
or definitively using:
\begin{pquote}
@@ -2325,6 +2351,13 @@ or definitively using:
% source: Sylvain Perifel, and:
%(source : https://stackoverflow.com/questions/24835536/insert-regular-double-quotes-in-latex-mode-with-auctex)
+Alternatively, this can be changed so as to cycle through \quotesymbol,
+\verb|``|, and \quotesymbol\quotesymbol, which is slightly more convenient than
+the default. This is achieved by customizing \texttt{TeX-quote-after-quote}:
+\begin{pquote}
+ \texttt{M-x customize-set-variable RET TeX-quote-after-quote RET y}
+\end{pquote}
+
\subsection{Others}
If other kind of problems occur, report them to \texttt{thomas.colcombet@irif.fr}.