summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-06-29 20:10:26 +0000
committerKarl Berry <karl@freefriends.org>2022-06-29 20:10:26 +0000
commiteea3fd6730ed6c06905319be992f9b583dfd3e6f (patch)
tree1fff20a4e2109373c7562e3fe9d28e8839c05f0f /Master/texmf-dist/doc
parente107916fe454b6ab807d132b971adfc2022dd4b2 (diff)
markdown (29jun22)
git-svn-id: svn://tug.org/texlive/trunk@63757 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/markdown/README.md10
-rw-r--r--Master/texmf-dist/doc/generic/markdown/VERSION2
-rw-r--r--Master/texmf-dist/doc/generic/markdown/markdown.html24
-rw-r--r--Master/texmf-dist/doc/generic/markdown/markdown.pdfbin795566 -> 830652 bytes
-rw-r--r--Master/texmf-dist/doc/latex/markdown/examples/latex.tex2
5 files changed, 18 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/generic/markdown/README.md b/Master/texmf-dist/doc/generic/markdown/README.md
index 2cc772807bb..3fd5e5fef6e 100644
--- a/Master/texmf-dist/doc/generic/markdown/README.md
+++ b/Master/texmf-dist/doc/generic/markdown/README.md
@@ -2,10 +2,8 @@ Markdown
========
[![license](https://img.shields.io/github/license/witiko/markdown)](LICENSE)
-[![release](https://img.shields.io/github/release/witiko/markdown.svg)][release]
-[![docker pulls](https://img.shields.io/docker/pulls/witiko/markdown)][docker-witiko/markdown]
-[![docker image size](https://img.shields.io/docker/image-size/witiko/markdown/latest)][docker-witiko/markdown]
[![ci](https://github.com/witiko/markdown/actions/workflows/main.yml/badge.svg)][ci]
+[![release](https://img.shields.io/github/release/witiko/markdown)][release]
[release]: https://github.com/Witiko/markdown/releases/latest "Releases · Witiko/markdown"
[ci]: https://github.com/Witiko/markdown/actions "GitHub Actions"
@@ -207,7 +205,7 @@ For further information, consult one of the following:
[tb133]: https://www.overleaf.com/read/pshkckczmmjn "Markdown 2.15.0: What's New?"
[tb131-slides]: https://tug.org/tug2021/assets/pdf/tug2021-novotny-slides.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
- [tb131-video]: https://youtu.be/i2GJMnLCZls "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
+ [tb131-video]: https://youtu.be/THmPkAncMnc "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
[10.5300/2016-1-4/78]: https://bulletin.cstug.cz/pdf/2016-1-4.pdf#page=80 "Rendering Markdown inside TeX Documents"
[10.5300/2020-1-2/48]: https://bulletin.cstug.cz/pdf/2020-1-2.pdf#page=50 "Markdown 2.8.1: Boldly Unto the Throne of Lightweight Markup in TeX"
@@ -262,7 +260,7 @@ such as XeTeX (`xetex markdown.ins`) or LuaTeX (`luatex markdown.ins`), several
files are produced from the `markdown.dtx` document. The `make base` command
is provided by `Makefile` for convenience. In `markdown.dtx`, the boundaries
between the produced files are marked up using an XML-like syntax provided by
-the [DocStrip][] plain TeX package.
+the [l3docstrip][] plain TeX package.
Running the [LaTeXMK][] tool on the `markdown.dtx` file
(`latexmk markdown.dtx`) after the Markdown package has been
@@ -279,7 +277,7 @@ reproduced by running the `docker build` command on `Dockerfile` (`docker build
`Makefile` for convenience.
[doc]: https://ctan.org/pkg/doc "doc – Format LaTeX documentation"
- [DocStrip]: https://ctan.org/pkg/docstrip "docstrip – Remove comments from file"
+ [l3docstrip]: https://ctan.org/pkg/l3docstrip "l3docstrip – Strip documentation in LaTeX3 source"
[LaTeXMK]: https://ctan.org/pkg/latexmk "latexmk – Fully automated LaTeX document generation"
[literate programming]: https://en.wikipedia.org/wiki/Literate_programming "Literate programming"
[ltxdockit]: https://ctan.org/pkg/ltxdockit "ltxdockit – Documentation support"
diff --git a/Master/texmf-dist/doc/generic/markdown/VERSION b/Master/texmf-dist/doc/generic/markdown/VERSION
index 2ce872efb1a..f0e62420c66 100644
--- a/Master/texmf-dist/doc/generic/markdown/VERSION
+++ b/Master/texmf-dist/doc/generic/markdown/VERSION
@@ -1 +1 @@
-2.15.2-0-gb238dbc (2022/05/31)
+2.15.3-0-g7c8e03d (2022/06/27)
diff --git a/Master/texmf-dist/doc/generic/markdown/markdown.html b/Master/texmf-dist/doc/generic/markdown/markdown.html
index ebc1a310cf9..4645973e467 100644
--- a/Master/texmf-dist/doc/generic/markdown/markdown.html
+++ b/Master/texmf-dist/doc/generic/markdown/markdown.html
@@ -82,7 +82,7 @@
<header id="title-block-header">
<h1 class="title">Markdown Package User Manual</h1>
<p class="author">Vít Novotný</p>
-<p class="date">2.15.2-0-gb238dbc (2022/05/31)</p>
+<p class="date">2.15.3-0-g7c8e03d (2022/06/27)</p>
</header>
<nav id="TOC" role="doc-toc">
<ul>
@@ -1273,7 +1273,7 @@
<dt><code>citations</code> (default value: <code>false</code>)</dt>
<dd><dl>
<dt>true</dt>
-<dd><p>Enable the pandoc citation syntax extension:</p>
+<dd><p>Enable the Pandoc citation syntax extension:</p>
<div class="sourceCode" id="cb123"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb123-1"><a href="#cb123-1" aria-hidden="true"></a>Here is a simple parenthetical citation <span class="co">[</span><span class="ot">@doe99</span><span class="co">]</span> and here</span>
<span id="cb123-2"><a href="#cb123-2" aria-hidden="true"></a>is a string of several [see @doe99, pp. 33-35; also</span>
<span id="cb123-3"><a href="#cb123-3" aria-hidden="true"></a>@smith04, chap. 1].</span>
@@ -1292,7 +1292,7 @@
</dd>
<dd><dl>
<dt>false</dt>
-<dd><p>Disable the pandoc citation syntax extension.</p>
+<dd><p>Disable the Pandoc citation syntax extension.</p>
</dd>
</dl>
</dd>
@@ -1610,7 +1610,7 @@ Thomas,Edison,1847</code></pre>
<h4 data-number="2.2.1.11" id="option-contentblockslanguagemap"><span class="header-section-number">2.2.1.11</span> Option <code>contentBlocksLanguageMap</code></h4>
<dl>
<dt><code>contentBlocksLanguageMap</code> (default value: <code>"markdown-languages.json"</code>)</dt>
-<dd><p>The filename of the JSON file that maps filename extensions to programming language names in the iA Writer content blocks.</p>
+<dd><p>The filename of the <abbr>JSON</abbr> file that maps filename extensions to programming language names in the iA Writer content blocks.</p>
</dd>
</dl>
<h5 class="unnumbered" data-number="" id="latex-example-10"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
@@ -2141,7 +2141,7 @@ Thomas,Edison,1847</code></pre>
<dt><code>footnotes</code> (default value: <code>false</code>)</dt>
<dd><dl>
<dt>true</dt>
-<dd><p>Enable the pandoc footnote syntax extension:</p>
+<dd><p>Enable the Pandoc footnote syntax extension:</p>
<div class="sourceCode" id="cb208"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb208-1"><a href="#cb208-1" aria-hidden="true"></a>Here is a footnote reference,<span class="ot">[^1]</span> and another.<span class="ot">[^longnote]</span></span>
<span id="cb208-2"><a href="#cb208-2" aria-hidden="true"></a></span>
<span id="cb208-3"><a href="#cb208-3" aria-hidden="true"></a><span class="ot">[^1]: </span>Here is the footnote.</span>
@@ -2164,7 +2164,7 @@ Thomas,Edison,1847</code></pre>
</dd>
<dd><dl>
<dt>false</dt>
-<dd><p>Disable the pandoc footnote syntax extension.</p>
+<dd><p>Disable the Pandoc footnote syntax extension.</p>
</dd>
</dl>
</dd>
@@ -2709,7 +2709,7 @@ Thomas,Edison,1847</code></pre>
<dt><code>inlineFootnotes</code> (default value: <code>false</code>)</dt>
<dd><dl>
<dt>true</dt>
-<dd><p>Enable the pandoc inline footnote syntax extension:</p>
+<dd><p>Enable the Pandoc inline footnote syntax extension:</p>
<div class="sourceCode" id="cb247"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb247-1"><a href="#cb247-1" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span>
<span id="cb247-2"><a href="#cb247-2" aria-hidden="true"></a>write, since you don&#39;t have to pick an identifier and</span>
<span id="cb247-3"><a href="#cb247-3" aria-hidden="true"></a>move down to type the note.]</span></code></pre></div>
@@ -2718,7 +2718,7 @@ Thomas,Edison,1847</code></pre>
</dd>
<dd><dl>
<dt>false</dt>
-<dd><p>Disable the pandoc inline footnote syntax extension.</p>
+<dd><p>Disable the Pandoc inline footnote syntax extension.</p>
</dd>
</dl>
</dd>
@@ -2879,7 +2879,7 @@ Thomas,Edison,1847</code></pre>
<dt><code>pipeTables</code> (default value: <code>false</code>)</dt>
<dd><dl>
<dt>true</dt>
-<dd><p>Enable the <abbr>PHP</abbr> Markdown table syntax extension:</p>
+<dd><p>Enable the <abbr>PHP</abbr> Markdown pipe table syntax extension:</p>
<div class="sourceCode" id="cb259"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb259-1"><a href="#cb259-1" aria-hidden="true"></a>| Right | Left | Default | Center |</span>
<span id="cb259-2"><a href="#cb259-2" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span>
<span id="cb259-3"><a href="#cb259-3" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span>
@@ -2890,7 +2890,7 @@ Thomas,Edison,1847</code></pre>
</dd>
<dd><dl>
<dt>false</dt>
-<dd><p>Disable the <abbr>PHP</abbr> Markdown table syntax extension.</p>
+<dd><p>Disable the <abbr>PHP</abbr> Markdown pipe table syntax extension.</p>
</dd>
</dl>
</dd>
@@ -3825,7 +3825,7 @@ Thomas,Edison,1847</code></pre>
<dt><code>tightLists</code> (default value: <code>true</code>)</dt>
<dd><dl>
<dt>true</dt>
-<dd><p>Unordered and ordered Lists whose items do not consist of multiple paragraphs will be considered <em>tight</em>. Tight lists will produce tight renderers that may produce different output than lists that are not tight:</p>
+<dd><p>Unordered and ordered lists whose items do not consist of multiple paragraphs will be considered <em>tight</em>. Tight lists will produce tight renderers that may produce different output than lists that are not tight:</p>
<div class="sourceCode" id="cb322"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb322-1"><a href="#cb322-1" aria-hidden="true"></a><span class="ss">- </span>This is</span>
<span id="cb322-2"><a href="#cb322-2" aria-hidden="true"></a><span class="ss">- </span>a tight</span>
<span id="cb322-3"><a href="#cb322-3" aria-hidden="true"></a><span class="ss">- </span>unordered list.</span>
@@ -4069,7 +4069,7 @@ Thomas,Edison,1847</code></pre>
<span id="cb339-2"><a href="#cb339-2" aria-hidden="true"></a> helperScriptFileName = helper-script.lua,</span>
<span id="cb339-3"><a href="#cb339-3" aria-hidden="true"></a>}</span></code></pre></div>
<h4 data-number="2.2.3.2" id="latexplain"><span class="header-section-number">2.2.3.2</span> No default token renderer prototypes</h4>
-<p>Default token renderer prototypes require <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> packages that may clash with other packages used in a document. Additionally, if we redefine token renderers and renderer prototypes ourselves, the default definitions will bring no benefit to us. Using the <code>plain</code> package option, we can keep the default definitions from the plain <span class="tex">T<sub>e</sub>X</span> implementation and prevent the soft <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> prerequisites from being loaded:</p>
+<p>Default token renderer prototypes require <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> packages that may clash with other packages used in a document. Additionally, if we redefine token renderers and renderer prototypes ourselves, the default definitions will bring no benefit to us. Using the <code>plain</code> package option, we can keep the default definitions from the plain <span class="tex">T<sub>e</sub>X</span> implementation and prevent the soft <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> prerequisites from being loaded: The plain option must be set before or when loading the package. Setting the option after loading the package will have no effect.</p>
<div class="sourceCode" id="cb340"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb340-1"><a href="#cb340-1" aria-hidden="true"></a><span class="bu">\usepackage</span>[plain]{<span class="ex">markdown</span>}</span></code></pre></div>
<h4 data-number="2.2.3.3" id="latexthemes"><span class="header-section-number">2.2.3.3</span> <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> themes</h4>
<p>User-contributed <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> themes for the Markdown package provide a domain-specific interpretation of some Markdown tokens. Similarly to <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> packages, themes allow the authors to achieve a specific look and other high-level goals without low-level programming.</p>
diff --git a/Master/texmf-dist/doc/generic/markdown/markdown.pdf b/Master/texmf-dist/doc/generic/markdown/markdown.pdf
index 811122f8a1a..997690ca4d8 100644
--- a/Master/texmf-dist/doc/generic/markdown/markdown.pdf
+++ b/Master/texmf-dist/doc/generic/markdown/markdown.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/markdown/examples/latex.tex b/Master/texmf-dist/doc/latex/markdown/examples/latex.tex
index 337263d38fc..a09706a8ae2 100644
--- a/Master/texmf-dist/doc/latex/markdown/examples/latex.tex
+++ b/Master/texmf-dist/doc/latex/markdown/examples/latex.tex
@@ -52,7 +52,7 @@ Here are some non-ASCII characters: *ěščřžýáíé*.
\end{markdown}
\begin{markdown*}{html, hybrid}
-Here is some <b>HTML code</b> mixed *with Markdown*. In pdf \TeX, the HTML code
+Here is some <b>HTML code</b> mixed *with Markdown*. In \TeX, the HTML code
will be silently ignored, whereas in \TeX 4ht, the HTML code will be passed
through to the output: