summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/knowledge/knowledge-code.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-09-23 03:03:31 +0000
committerNorbert Preining <norbert@preining.info>2020-09-23 03:03:31 +0000
commit6639178e654b36f7065a0cdbab783d687550e896 (patch)
tree409157d10a0e6d3d9c828b926a60d23195eb4abb /macros/latex/contrib/knowledge/knowledge-code.dtx
parent1a37a060977fa92be44dcee0fb99c59e46023afe (diff)
CTAN sync 202009230303
Diffstat (limited to 'macros/latex/contrib/knowledge/knowledge-code.dtx')
-rw-r--r--macros/latex/contrib/knowledge/knowledge-code.dtx76
1 files changed, 55 insertions, 21 deletions
diff --git a/macros/latex/contrib/knowledge/knowledge-code.dtx b/macros/latex/contrib/knowledge/knowledge-code.dtx
index c76b3f0aac..947040dac9 100644
--- a/macros/latex/contrib/knowledge/knowledge-code.dtx
+++ b/macros/latex/contrib/knowledge/knowledge-code.dtx
@@ -23,7 +23,7 @@
%
% \iffalse
%<head>\usepackage{expl3}
-%<head>\ProvidesExplPackage{knowledge}{2020/03/05}{1.23}{}
+%<head>\ProvidesExplPackage{knowledge}{2020/09/22}{1.24}{}
%<*driver>
\def\knowledgecode{active}
\input{knowledge.tex}
@@ -56,6 +56,7 @@
% \changes{1.21}{2020/01/26}{bug fix} %
% \changes{1.22}{2020/03/05}{improvements} %
% \changes{1.23}{2020/04/25}{minor change} %
+% \changes{1.24}{2020/09/22}{silent option} %
% \GetFileInfo{knowledge.sty} %
% \DoNotIndex{}
%
@@ -73,31 +74,31 @@
% \begin{macrocode}
This directory contains the package
- name: knowledge
- license: LaTeX Project Public License version 1.2 or above
- version: v1.23
- date: 2020/04/25
- author: Thomas Colcombet
- mail: thomas.colcombet@irif.fr
- web: https://www.irif.fr/~colcombe/knowledge_en.html
+ name: knowledge
+ license: LaTeX Project Public License version 1.2 or above
+ version: v1.24
+ date: 2020/09/22
+ author: Thomas Colcombet
+ mail: thomas.colcombet@irif.fr
+ web: https://www.irif.fr/~colcombe/knowledge_en.html
-Purpose:
+### Purpose:
The knowledge package for LaTeX offers a systematic way to handle
notions/concepts/terms throughout a document. In combination with
- hyperref, it is used for easily handling links inside a document (every
+ `hyperref`, it is used for easily handling links inside a document (every
use of a concept is linked to its introduction), or outside the document
(for centralizing the url's in a separate part). It also helps building an
index, and deals with scoping of concepts as well as mathematics.
It is designed to--as much as possible--not interfere with the writing of
the document.
-Install:
+### Install:
It is sufficient to have the file knowledge.sty accessible by LaTeX.
- It can be produced by `make knowledge.sty' if necessary.
- The documentation is in the file knowledge.pdf.
- A starting example can be found in knowledge-example.tex.
+ It can be produced by `make knowledge.sty` if necessary.
+ The documentation is in the file `knowledge.pdf`.
+ A starting example can be found in `knowledge-example.tex`.
-Content of the file knowledge-sources.zip:
+### Content of knowledge-sources.zip:
- README.md: this file generated while compiling knowledge.ins,
the content is in knowledge-code.dtx
- knowledge.sty: the package file (generated using knowledge.ins)
@@ -200,10 +201,11 @@ Content of the file knowledge-sources.zip:
% \begin{macrocode}
\cs_new:Nn\knowledge_info:n
{\msg_info:nnn{knowledge}{knowledge~info}{#1}}
-\cs_new:Nn\knowledge_warning:n
- {\msg_warning:nnn{knowledge}{knowledge~warning}{#1}}
+\cs_new:Nn\knowledge_warning:n{
+ \msg_warning:nnn{knowledge}{knowledge~warning}{#1}
+ }
\cs_new:Nn\knowledge_error:n
- {\msg_error:nnn{knowledge}{knowledge~error}{#1}}
+ {\msg_error:nnn{knowledge}{knowledge~error}{#1}}
% \end{macrocode}
% The command \csintro{\knowledge_werror:Nn} takes a boolean as argument, and behaves like \cs{\knowledge_error:n} if it is true, and \cs{\knowledge_warning:n} otherwise.
% \begin{macrocode}
@@ -220,6 +222,33 @@ Content of the file knowledge-sources.zip:
\cs_generate_variant:Nn\knowledge_warning:n{x}
\cs_generate_variant:Nn\knowledge_error:n{x}
% \end{macrocode}
+%
+% \begin{macrocode}
+\cs_new:Npn\knowledge_warning:nn{
+ \bool_if:NTF\knowledge_warningsilent_bool
+ \use_none:nn
+ \msg_warning:nn
+}
+\cs_new:Npn\knowledge_warning:nnn{
+ \bool_if:NTF\knowledge_warningsilent_bool
+ \use_none:nnn
+ \msg_warning:nnn
+}
+\cs_new:Npn\knowledge_warning:nnnn{
+ \bool_if:NTF\knowledge_warningsilent_bool
+ \use_none:nnnn
+ \msg_warning:nnnn
+}
+\cs_generate_variant:Nn\knowledge_warning:nnnn{nnxx}
+\cs_new:Npn\knowledge_warning:nnnnn{
+ \bool_if:NTF\knowledge_warningsilent_bool
+ \use_none:nnnnn
+ \msg_warning:nnnnn
+}
+\cs_generate_variant:Nn\knowledge_warning:nnnnn{nnxxx}
+% \end{macrocode}
+%
+%
%\AP We provide now the `official' messages \csintro{knowledge~recursion}, \csintro{knowledge~unknown},
% \csintro{knowledge~unknown~in~scope}, \csintro{knowledge~unknown~label}, \csintro{package~required} and \csintro{knowledge~exists}.
% \begin{macrocode}
@@ -440,6 +469,11 @@ Content of the file knowledge-sources.zip:
\KnowledgeConfigureBooleanOption[\knowledge_warningstrict_bool]{strict}
% \end{macrocode}
% \begin{macrocode}
+\bool_new:N\knowledge_warningsilent_bool
+\bool_set_false:N\knowledge_warningsilent_bool
+\KnowledgeConfigureBooleanOption[\knowledge_warningsilent_bool]{silent}
+% \end{macrocode}
+% \begin{macrocode}
\bool_new:N\knowledge_configuration_quotation_bool
\KnowledgeConfigureBooleanOptionTF[\knowledge_configuration_quotation_bool]{quotation}{\klactivatequotation}{\kldeactivatequotation}
\KnowledgeConfigureTrigger{protect~quotation}{\kl_protect_environment_quotation:n{#1}}
@@ -2799,7 +2833,7 @@ Content of the file knowledge-sources.zip:
\cs_new:Nn\knowledge_kl_error_unknown_firsttime:
{\bool_if:cTF{\knowledge_variant_var:n{unknownwarning_bool}}
{\IfKnowledgePaperModeF{
- \msg_warning:nnxxx{ knowledge }{ knowledge~unknown }
+ \knowledge_warning:nnxxx{ knowledge }{ knowledge~unknown }
{\exp_not:V\knowledge_kl_key_tl}
{\exp_not:V\knowledge_kl_namespace_tl}
{\seq_use:Nn\knowledge_visible_instances_seq{|}}}
@@ -2833,7 +2867,7 @@ Content of the file knowledge-sources.zip:
\cs_new:Nn\knowledge_kl_error_unknown_in_scope_firsttime:
{\bool_if:cTF{\knowledge_variant_var:n{unknownwarning_bool}}
{\IfKnowledgePaperModeF{
- \msg_warning:nnxxx{ knowledge }{ knowledge~unknown~in~scope }
+ \knowledge_warning:nnxxx{ knowledge }{ knowledge~unknown~in~scope }
{\exp_not:V\knowledge_kl_key_tl}
{\exp_not:V\knowledge_kl_namespace_tl}
{\knowledge_kl_linkscope_tl}}}{}
@@ -2869,7 +2903,7 @@ Content of the file knowledge-sources.zip:
}
%
\IfKnowledgePaperModeF{
- \msg_warning:nnxx{ knowledge }{ knowledge~unknown~label }
+ \knowledge_warning:nnxx{ knowledge }{ knowledge~unknown~label }
{\exp_not:V\knowledge_kl_key_tl}
{\knowledge_kl_linkscope_tl}}
%