diff options
author | Karl Berry <karl@freefriends.org> | 2022-06-29 20:10:26 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-06-29 20:10:26 +0000 |
commit | eea3fd6730ed6c06905319be992f9b583dfd3e6f (patch) | |
tree | 1fff20a4e2109373c7562e3fe9d28e8839c05f0f /Master/texmf-dist/doc | |
parent | e107916fe454b6ab807d132b971adfc2022dd4b2 (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.md | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/markdown/VERSION | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/markdown/markdown.html | 24 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/markdown/markdown.pdf | bin | 795566 -> 830652 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/markdown/examples/latex.tex | 2 |
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'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 Binary files differindex 811122f8a1a..997690ca4d8 100644 --- a/Master/texmf-dist/doc/generic/markdown/markdown.pdf +++ b/Master/texmf-dist/doc/generic/markdown/markdown.pdf 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: |