diff options
author | Norbert Preining <norbert@preining.info> | 2022-10-02 03:04:14 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-10-02 03:04:14 +0000 |
commit | 097f244236b682cc77c6ecf25be4150091d8daf9 (patch) | |
tree | 26998e72d2b56a87033d9fb72923258fc93ebe53 /macros | |
parent | 4043e29dc8ac56047ac45f872a2ea1f3031b6b05 (diff) |
CTAN sync 202210020304
Diffstat (limited to 'macros')
36 files changed, 5296 insertions, 4186 deletions
diff --git a/macros/generic/markdown/CHANGES.md b/macros/generic/markdown/CHANGES.md index e36d6b2e83..fae1a5a717 100644 --- a/macros/generic/markdown/CHANGES.md +++ b/macros/generic/markdown/CHANGES.md @@ -1,12 +1,22 @@ # Changes +## 2.17.0 (2022-10-01) + +Development: + +- Add support for user-defined syntax extensions. (#182) + ## 2.16.1 (2022-08-30) Fixes: - Fix default rendering of fancy lists in LaTeX. (#179, #180) - Change category code of hash sign (`#`) to other in the - `\markdownInput` command. (#181) + `\markdownInput` command. (#181, d067ae8) + +Deprecation: + +- Use `make4ht` instead of `htlatex` in `examples/Makefile`. (#183) Continuous Integration: diff --git a/macros/generic/markdown/README.md b/macros/generic/markdown/README.md index 2f98e28512..c47b1074a2 100644 --- a/macros/generic/markdown/README.md +++ b/macros/generic/markdown/README.md @@ -208,7 +208,7 @@ For further information, consult one of the following: [tb124]: https://www.tug.org/TUGboat/tb40-1/tb124novotny-markdown.pdf "Markdown 2.7.0: Towards lightweight markup in TeX" [tb129]: https://www.tug.org/TUGboat/tb41-3/tb129novotny-frozen.pdf "Making Markdown into a Microwave Meal" [tb131]: https://www.tug.org/TUGboat/tb42-2/tb131novotny-markdown.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX" - [tb133]: https://www.overleaf.com/read/pshkckczmmjn "Markdown 2.15.0: What's New?" + [tb133]: https://tug.org/TUGboat/tb43-1/tb133novotny-markdown.pdf "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/THmPkAncMnc "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX" diff --git a/macros/generic/markdown/VERSION b/macros/generic/markdown/VERSION index b46b43bebb..3b4985a362 100644 --- a/macros/generic/markdown/VERSION +++ b/macros/generic/markdown/VERSION @@ -1 +1 @@ -2.16.1-0-gf8a4bea (2022-08-30) +2.17.0-0-g6428569 (2022-09-30) diff --git a/macros/generic/markdown/examples/context-mkii.tex b/macros/generic/markdown/examples/context-mkii.tex index 7a49793ab8..13ce98fd60 100644 --- a/macros/generic/markdown/examples/context-mkii.tex +++ b/macros/generic/markdown/examples/context-mkii.tex @@ -43,8 +43,10 @@ % Lua command-line interface and that contains a plain TeX representation % of the document `example.md`. \catcode`\%=12\relax +\catcode`\#=12\relax \doiffileelse{./example.tex}{\input example}{} \catcode`\%=14\relax +\catcode`\#=6\relax % Typeset inline markdown text. \startmarkdown diff --git a/macros/generic/markdown/examples/context-mkiv.tex b/macros/generic/markdown/examples/context-mkiv.tex index 419b34b554..415cf2a4dd 100644 --- a/macros/generic/markdown/examples/context-mkiv.tex +++ b/macros/generic/markdown/examples/context-mkiv.tex @@ -55,8 +55,10 @@ % Lua command-line interface and that contains a plain TeX representation % of the document `example.md`. \catcode`\%=12\relax +\catcode`\#=12\relax \doiffileelse{./example.tex}{\input example}{} \catcode`\%=14\relax +\catcode`\#=6\relax % Typeset inline markdown text. \startmarkdown diff --git a/macros/generic/markdown/examples/latex.tex b/macros/generic/markdown/examples/latex.tex index e29f9a418b..cb2bce39b8 100644 --- a/macros/generic/markdown/examples/latex.tex +++ b/macros/generic/markdown/examples/latex.tex @@ -48,8 +48,10 @@ date: \today % Lua command-line interface of the Markdown package and that contains a % plain TeX representation of the document `example.md`. \catcode`\%=12\relax +\catcode`\#=12\relax \InputIfFileExists{./example.tex}{}{} \catcode`\%=14\relax +\catcode`\#=6\relax \begin{markdown} Here are some non-ASCII characters: *ěščřžýáíé*. diff --git a/macros/generic/markdown/markdown.dtx b/macros/generic/markdown/markdown.dtx index 4db4ecfcc3..f419af48a2 100644 --- a/macros/generic/markdown/markdown.dtx +++ b/macros/generic/markdown/markdown.dtx @@ -680,13 +680,13 @@ abbr { date = {2017-01-19}, url = {https://github.com/iainc/Markdown-Content-Blocks}, urldate = {2018-01-08}} -@book{luatex17, +@book{luatex21, author = {{Lua\TeX{} development team}}, title = {Lua\TeX{} reference manual}, - year = {2017}, - month = {2}, - url = {http://www.luatex.org/svn/trunk/manual/luatex.pdf}, - urldate = {2018-01-08}} + date = {2021-07-23}, + note = {Version 1.10 (stable)}, + url = {https://www.pragma-ade.com/general/manuals/luatex.pdf}, + urldate = {2022-09-30}} @book{latex17, author = {Braams, Johannes and Carlisle, David and Jeffrey, Alan and Lamport, Leslie and Mittelbach, Frank and Rowley, Chris and @@ -1080,7 +1080,7 @@ local md5 = require("md5") % \begin{markdown} % % All the abovelisted modules are statically linked into the current version of -% the Lua\TeX{} engine~[@luatex17, Section 3.3]. Beside these, we also carry +% the Lua\TeX{} engine~[@luatex21, Section 4.3]. Beside these, we also carry % the following third-party Lua libraries: % % \pkg{api7/lua-tinyyaml} @@ -1137,10 +1137,10 @@ local md5 = require("md5") % % The plain \TeX{} code makes use of the \luamref{isdir} method that was added % to the \pkg{Lua File System} library by the Lua\TeX{} engine -% developers~[@luatex17, Section 3.2]. +% developers~[@luatex21, Section 4.2.4]. % % The \pkg{Lua File System} module is statically linked into the Lua\TeX{} -% engine~[@luatex17, Section~3.3]. +% engine~[@luatex21, Section 4.3]. % % Unless you convert markdown documents to \TeX{} manually using the Lua % command-line interface (see Section <#sec:lua-cli-interface>), the plain @@ -1585,12 +1585,12 @@ local M = {metadata = metadata} % %### Conversion from Markdown to Plain \TeX{} {#luaconversion} % -% The Lua interface exposes the \luamdef{new}`(options)` method. This -% method creates converter functions that perform the conversion from markdown -% to plain \TeX{} according to the table `options` that contains options -% recognized by the Lua interface. (see Section <#sec:luaoptions>). The -% `options` parameter is optional; when unspecified, the behaviour will be -% the same as if `options` were an empty table. +% The Lua interface exposes the \luamdef{new}`(options)` function. This +% function returns a conversion function from markdown to plain \TeX{} according +% to the table `options` that contains options recognized by the Lua interface +% (see Section <#sec:luaoptions>). The `options` parameter is optional; when +% unspecified, the behaviour will be the same as if `options` were an empty +% table. % % The following example Lua code converts the markdown string `Hello % *world*!` to a \TeX{} output using the default options and prints the \TeX{} @@ -1601,6 +1601,70 @@ local M = {metadata = metadata} % print(convert("Hello *world*!")) % ``````` % +%### User-Defined Syntax Extensions {#luauserextensions} +% +% For the purpose of user-defined syntax extensions, the Lua interface also +% exposes the \luamdef{reader} object, which performs the lexical and +% syntactic analysis of markdown text and which exposes the +% \luamdef{reader->insert_pattern} and \luamdef{reader->add_special_character} +% methods for extending the \acro{peg} grammar of markdown. +% +% The read-only \luamdef{walkable_syntax} hash table stores those rules of the +% \acro{peg} grammar of markdown that can be represented as an ordered choice +% of terminal symbols. These rules can be modified by user-defined syntax +% extensions. +% +% \end{markdown} +% \begin{macrocode} +local walkable_syntax = { + Block = { + "Blockquote", + "Verbatim", + "HorizontalRule", + "BulletList", + "OrderedList", + "Heading", + "DisplayHtml", + "Paragraph", + "Plain", + }, + Inline = { + "Str", + "Space", + "Endline", + "UlOrStarLine", + "Strong", + "Emph", + "Link", + "Image", + "Code", + "AutoLinkUrl", + "AutoLinkEmail", + "AutoLinkRelativeReference", + "InlineHtml", + "HtmlEntity", + "EscapedChar", + "Smart", + "Symbol", + }, +} +% \end{macrocode} +% \par +% \begin{markdown} +% +% The \luamref{reader->insert_pattern} method inserts a \acro{peg} pattern into +% the grammar of markdown. The method receives two arguments: a selector string +% in the form `"`\meta{left-hand side terminal symbol} \meta{`before`, `after`, +% or `instead of`} \meta{right-hand side terminal symbol}`"` and a \acro{peg} +% pattarn to insert. For example. if we'd like to insert `pattern` into the +% grammar between the `Inline -> Emph` and `Inline -> Link` rules, we would +% call \luamref{reader->insert_pattern} with `"Inline after Emph"` (or `"Inline +% before Link"`) and `pattern` as the arguments. +% +% The \luamdef{reader->add_special_character} method adds a new character with +% special meaning to the grammar of markdown. The method receives the character +% as its only argument. +% % \end{markdown} % \iffalse %</lua> @@ -1897,6 +1961,8 @@ interfaces and all the way up to the \LaTeX{} and \Hologo{ConTeXt} interfaces. \msg_error:nnnn { nnnV } \seq_new:N \g_@@_option_types_seq +\tl_const:Nn \c_@@_option_type_clist_tl { clist } +\seq_put_right:NV \g_@@_option_types_seq \c_@@_option_type_clist_tl \tl_const:Nn \c_@@_option_type_counter_tl { counter } \seq_put_right:NV \g_@@_option_types_seq \c_@@_option_type_counter_tl \tl_const:Nn \c_@@_option_type_boolean_tl { boolean } @@ -4365,6 +4431,153 @@ defaultOptions.eagerCache = true %</lua,lua-cli> %<*manual-options> +#### Option `extensions` + +`extensions` (default value: `{}`) + +% \fi +% \begin{markdown} +% +% \Valitem[\{\}]{extensions}{filenames} +% +: The filenames of user-defined syntax extensions that will be applied to the + markdown reader. If the \pkg{kpathsea} library is available, files will be + searched for not only in the current working directory but also in the + \TeX{} directory structure. + +% A user-defined syntax extension is a Lua file in the following format: +% +% ``` lua +% local strike_through = { +% api_version = 1, +% grammar_version = 1, +% finalize_grammar = function(reader) +% local nonspacechar = lpeg.P(1) - lpeg.S("\t ") +% local doubleslashes = lpeg.P("//") +% local function between(p, starter, ender) +% ender = lpeg.B(nonspacechar) * ender +% return (starter * #nonspacechar +% * lpeg.Ct(p * (p - ender)^0) * ender) +% end +% +% local read_strike_through = between( +% lpeg.V("Inline"), doubletildes, doubletildes +% ) / function(s) return {"\\st{", s, "}"} end +% +% reader.insert_pattern("Inline after Emph", read_strike_through) +% reader.add_special_character("/") +% end +% } +% +% return strike_through +% ``````` +% +% The `api_version` and `grammar_version` fields specify the version of the +% user-defined syntax extension API and the markdown grammar for which +% the extension was written. See the current API and grammar versions +% below: +% +% \end{markdown} +% \iffalse +%</manual-options> +%<*lua> +% \fi +% \begin{macrocode} +metadata.user_extension_api_version = 1 +metadata.grammar_version = 1 +% \end{macrocode} +% \iffalse +%</lua> +%<*manual-options> +% \fi +% \begin{markdown} +% +% Any changes to the syntax extension API or grammar will cause the +% corresponding current version to be incremented. After Markdown 3.0.0, +% any changes to the API and the grammar will be either backwards-compatible +% or constitute a breaking change that will cause the major version of the +% Markdown package to increment (to 4.0.0). +% +% The `finalize_grammar` field is a function that finalizes the grammar of +% markdown using the interface of a Lua \luamref{reader} object, such as +% the \luamref{reader->insert_pattern} and +% \luamref{reader->add_special_character} methods, +% see Section <#luauserextensions>. +% +% \end{markdown} +% \iffalse + +##### \LaTeX{} Example {.unnumbered} + +Using a text editor, create a text document named `strike-through.lua` with the +following content: +``` lua +local strike_through = { + api_version = 1, + grammar_version = 1, + finalize_grammar = function(reader) + local nonspacechar = lpeg.P(1) - lpeg.S("\t ") + local doubleslashes = lpeg.P("//") + local function between(p, starter, ender) + ender = lpeg.B(nonspacechar) * ender + return (starter * #nonspacechar + * lpeg.Ct(p * (p - ender)^0) * ender) + end + + local read_strike_through = between( + lpeg.V("Inline"), doubletildes, doubletildes + ) / function(s) return {"\\st{", s, "}"} end + + reader.insert_pattern("Inline after Emph", read_strike_through) + reader.add_special_character("/") + end +} +``````` +Using a text editor, create also a text document named `document.tex` with the +following content: +``` tex +\documentclass{article} +\usepackage{soul} +\usepackage[extension = strike-through.lua]{markdown} +\begin{document} +\begin{markdown} +This is //a lunar roving vehicle// strike-through text. +\end{markdown} +\end{document} +``````` +Next, invoke LuaTeX from the terminal: +``` sh +lualatex document.tex +`````` +A PDF document named `document.pdf` should be produced and contain the +following text: + +> This is ~~a lunar roving vehicle~~ strike-through text. + +%</manual-options> +%<*tex> +% \fi +% \begin{macrocode} +\cs_generate_variant:Nn + \@@_add_lua_option:nnn + { nnV } +\@@_add_lua_option:nnV + { extensions } + { clist } + \c_empty_clist +% \end{macrocode} +% \iffalse +%</tex> +%<*lua,lua-cli> +% \fi +% \begin{macrocode} +defaultOptions.extensions = {} +% \end{macrocode} +% \par +% \iffalse +%</lua,lua-cli> +%<*manual-options> + #### Option `expectJekyllData` `expectJekyllData` (default value: `false`) @@ -8250,6 +8463,11 @@ for i = 1, #arg do options[key] = (value == "true") elseif default_type == "number" then options[key] = tonumber(value) + elseif default_type == "table" then + options[key] = {} + for item in value:gmatch("[^ ,]+") do + table.insert(options[key], item) + end else if default_type ~= "string" then if default_type == "nil" then @@ -10461,11 +10679,11 @@ as \mref{markdownRendererContentBlock}. The \mdef{markdownRendererContentBlockCode} macro represents an iA\,Writer content block that was recognized as a file in a known programming language by its filename extension $s$. If any `markdown-languages.json` file found -by \pkg{kpathsea}\footnote{Local files take precedence. Filenames other -than `markdown-languages.json` may be specified using the -`contentBlocksLanguageMap` Lua option.} contains a record $(k, v)$, then a -non-online-image content block with the filename extension $s, -s$`:lower()`${}=k$ is considered to be in a known programming language $v$. +by \pkg{kpathsea}\footnote{Filenames other than `markdown-languages.json` may +be specified using the `contentBlocksLanguageMap` Lua option.} contains a +record $(k, v)$, then a non-online-image content block with the filename +extension $s, s$`:lower()`${}=k$ is considered to be in a known programming +language $v$. The macro receives five arguments: the local file name extension $s$ cast to the lower case, the language $v$, the fully escaped \acro{uri} that can be directly typeset, the raw \acro{uri} that can be used outside typesetting, @@ -15615,8 +15833,8 @@ pdflatex --shell-escape document.tex ### \LaTeX{} \LaTeX{} options allow us to disable the redefinition of the default renderer -prototypes from plain \TeX{}, load user-contributed themes, and invoke -user-defined setup snippets. +prototypes from plain \TeX{}, load user-defined themes, and invoke user-defined +setup snippets. #### Setting Lua and plain \TeX{} options from \LaTeX{} @@ -15720,20 +15938,19 @@ package. Setting the option after loading the package will have no effect. #### \LaTeX{} themes {#latexthemes} -User-contributed \LaTeX{} themes for the Markdown package provide a -domain-specific interpretation of some Markdown tokens. Similarly to \LaTeX{} -packages, themes allow the authors to achieve a specific look and other -high-level goals without low-level programming. - -% The \LaTeX{} option with key `theme` loads a \LaTeX{} package (further -% referred to as *a theme*) named `markdowntheme`\meta{munged theme -% name}`.sty`, where the *munged theme name* is the *theme name* after a -% substitution of all forward slashes (\texttt{/}) for an underscore -% (\texttt{_}), the theme name is a value that is *qualified* and contains no -% underscores, and a value is qualified if and only if it contains at least one -% forward slash. Themes are inspired by the Beamer \LaTeX{} package, which -% provides similar functionality with its \mref{usetheme} macro [@tantau21, -% Section 15.1]. +User-defined \LaTeX{} themes for the Markdown package provide a domain-specific +interpretation of Markdown tokens. Similarly to \LaTeX{} packages, themes +allow the authors to achieve a specific look and other high-level goals +without low-level programming. + +% The \LaTeX{} option `theme`=\meta{theme name} loads a \LaTeX{} package +% (further referred to as *a theme*) named `markdowntheme`\meta{munged theme +% name}`.sty`, where the *munged theme name* is the *theme name* after the +% substitution of all forward slashes (`/`) for an underscore (`_`), the theme +% *name* is *qualified* and contains no underscores, and a value is qualified +% if and only if it contains at least one forward slash. Themes are inspired by +% the Beamer \LaTeX{} package, which provides similar functionality with its +% \mref{usetheme} macro [@tantau21, Section 15.1]. % % Theme names must be qualified to minimize naming conflicts between different % themes intended for a single \LaTeX{} document class or for a single \LaTeX{} @@ -15790,13 +16007,21 @@ would use the following code in the preamble of your document: \cs_new:Nn \@@_set_latex_theme:n { - \str_if_in:NnF + \str_if_in:nnF { #1 } { / } { \markdownError - { Won't load theme with unqualified name #1 } - { Theme names must contain at least one forward slash } + { Won't~load~theme~with~unqualified~name~#1 } + { Theme~names~must~contain~at~least~one~forward~slash } + } + \str_if_in:nnT + { #1 } + { _ } + { + \markdownError + { Won't~load~theme~with~an~underscore~in~its~name~#1 } + { Theme~names~must~not~contain~underscores~in~their~names } } \tl_set:Nn \markdownLaTeXThemePackageName { #1 } \str_replace_all:Nnn @@ -16121,7 +16346,7 @@ following text, where the middot (`·`) denotes a non-breaking space: % \end{markdown} % \iffalse -User-contributed \LaTeX{} themes provide global control over high-level goals. +User-defined \LaTeX{} themes provide global control over high-level goals. However, it is often desirable to change only some local aspects of a document. \LaTeX{} setup snippets provide syntactic sugar for defining and invoking various options locally. @@ -16257,6 +16482,85 @@ The following ordered list will be preceded by roman numerals: #2 .default:n = { true }, } } +% \end{macrocode} +% \begin{markdown} +% +% For options of type `clist`, we assume that \meta{key} is a regular English +% noun in plural (such as `extensions`) and we also define the +% \meta{singular key}`=`\meta{value} interface, where \meta{singular key} is +% \meta{key} after stripping the trailing -s (such as `extension`). Rather +% than setting the option to \meta{value}, this interface appends \meta{value} +% to the current value as the rightmost item in the list. +% +% \end{markdown} +% \begin{macrocode} + \str_if_eq:VVT + \l_tmpa_tl + \c_@@_option_type_clist_tl + { + \tl_set:Nn + \l_tmpa_tl + { #2 } + \tl_reverse:N + \l_tmpa_tl + \str_if_eq:enF + { + \tl_head:V + \l_tmpa_tl + } + { s } + { + \msg_error:nnn + { @@ } + { malformed-name-for-clist-option } + { #2 } + } + \tl_set:Nx + \l_tmpa_tl + { + \tl_tail:V + \l_tmpa_tl + } + \tl_reverse:N + \l_tmpa_tl + \tl_put_right:Nn + \l_tmpa_tl + { + .code:n = { + \@@_get_option_value:nN + { #2 } + \l_tmpa_tl + \clist_set:NV + \l_tmpa_clist + { \l_tmpa_tl, { ##1 } } + \@@_set_option_value:nV + { #2 } + \l_tmpa_clist + } + } + \keys_define:nV + { markdown/latex-options } + \l_tmpa_tl + } + } +\cs_generate_variant:Nn + \clist_set:Nn + { NV } +\cs_generate_variant:Nn + \keys_define:nn + { nV } +\cs_generate_variant:Nn + \@@_set_option_value:nn + { nV } +\prg_generate_conditional_variant:Nnn + \str_if_eq:nn + { en } + { F } +\msg_new:nnn + { @@ } + { malformed-name-for-clist-option } + { + Clist~option~name~#1~does~not~end~with~-s. } \@@_latex_define_option_commands_and_keyvals: \ExplSyntaxOff @@ -16722,7 +17026,7 @@ texexec --passon=--shell-escape document.tex % Lua Implementation {#luaimplementation} %-------------------- % -% The Lua implementation implements \luamdef{writer} and \luamdef{reader} +% The Lua implementation implements \luamdef{writer} and \luamref{reader} % objects, which provide the conversion from markdown to plain \TeX, and % \luamdef{extensions} objects, which provide syntax extensions for the % \luamref{writer} and \luamref{reader} objects. @@ -16784,7 +17088,7 @@ function util.cache(dir, string, salt, transform, suffix) local file = io.open(name, "r") if file == nil then -- If no cache entry exists, then create a new one. file = assert(io.open(name, "w"), - [[could not open file "]] .. name .. [[" for writing]]) + [[Could not open file "]] .. name .. [[" for writing]]) local result = string if transform ~= nil then result = transform(result) @@ -16812,6 +17116,32 @@ end % \par % \begin{markdown} % +% The \luamdef{util.lookup_files} method looks up files with filename `f` +% and returns its path. If the \pkg{kpathsea} library is available, it will +% search for files not only in the current working directory but also in the +% \TeX{} directory structure. Further options for \pkg{kpathsea} can be +% specified in table `options`. [@luatex21, Section 10.7.4] +% +% \end{markdown} +% \begin{macrocode} +util.lookup_files = (function() + local ran_ok, kpse = pcall(require, "kpse") + if ran_ok then + kpse.set_program_name("luatex") + else + kpse = { lookup = function(f, _) return f end } + end + + local function lookup_files(f, options) + return kpse.lookup(f, options) + end + + return lookup_files +end)() +% \end{macrocode} +% \par +% \begin{markdown} +% % The \luamdef{util.expand_tabs_in_line} expands tabs in string `s`. If % `tabstop` is specified, it is used as the tab stop width. Otherwise, % the tab stop width of 4 characters is used. The method is a copy of the tab @@ -20432,14 +20762,6 @@ end % \par % \begin{markdown} % -%#### Lists -% -% \end{markdown} -% \begin{macrocode} -% \end{macrocode} -% \par -% \begin{markdown} -% %#### Headings % % \end{markdown} @@ -20479,12 +20801,6 @@ end % markdown reader object that was located in the % `lunamark/reader/markdown.lua` file in the Lunamark Lua module. % -% Although not specified in the Lua interface (see Section -% <#sec:luainterface>), the \luamref{reader} object is exported, so that the -% curious user could easily tinker with the methods of the objects produced by -% the \luamref{reader.new} method described below. The user should be aware, -% however, that the implementation may change in a future revision. -% % The \luamdef{reader.new} method creates and returns a new \TeX{} reader % object associated with the Lua interface options (see Section % <#sec:luaoptions>) `options` and with a writer object `writer`. When @@ -20498,7 +20814,7 @@ end % \end{markdown} % \begin{macrocode} M.reader = {} -function M.reader.new(writer, options, extensions) +function M.reader.new(writer, options) local self = {} % \end{macrocode} % \par @@ -21147,150 +21463,174 @@ function M.reader.new(writer, options, extensions) % \begin{markdown} % %#### Syntax Specification +% Define \luamdef{reader->finalize_grammar} as a function that constructs the +% \acro{peg} grammar of markdown, applies syntax extensions `extensions` and +% returns a conversion function that takes a markdown string and turns it into +% a plain \TeX{} output. % -% Create a \luamdef{reader->syntax} hash table that stores the \acro{peg} -% grammar. -% -% \end{markdown} -% \begin{macrocode} - self.syntax = - { "Blocks", - - Blocks = ( V("ExpectedJekyllData") - * (V("Blank")^0 / writer.interblocksep) - )^-1 - * V("Blank")^0 - * V("Block")^-1 - * (V("Blank")^0 / writer.interblocksep - * V("Block"))^0 - * V("Blank")^0 * parsers.eof, - - Blank = parsers.Blank, - - UnexpectedJekyllData = parsers.fail, - ExpectedJekyllData = parsers.fail, - - Block = V("ContentBlock") - + V("UnexpectedJekyllData") - + V("Blockquote") - + V("PipeTable") - + V("Verbatim") - + V("FencedCode") - + V("HorizontalRule") - + V("BulletList") - + V("OrderedList") - + V("Heading") - + V("DefinitionList") - + V("DisplayHtml") - + V("Paragraph") - + V("Plain"), - - ContentBlock = parsers.fail, - Blockquote = parsers.Blockquote, - Verbatim = parsers.Verbatim, - FencedCode = parsers.fail, - HorizontalRule = parsers.HorizontalRule, - BulletList = parsers.BulletList, - OrderedList = parsers.OrderedList, - Heading = parsers.Heading, - DefinitionList = parsers.fail, - DisplayHtml = parsers.DisplayHtml, - Paragraph = parsers.Paragraph, - PipeTable = parsers.fail, - Plain = parsers.Plain, - EndlineExceptions = parsers.EndlineExceptions, - - Inline = V("Str") - + V("Space") - + V("Endline") - + V("UlOrStarLine") - + V("Strong") - + V("Emph") - + V("StrikeThrough") - + V("Superscript") - + V("Subscript") - + V("InlineNote") - + V("NoteRef") - + V("Citations") - + V("Link") - + V("Image") - + V("Code") - + V("AutoLinkUrl") - + V("AutoLinkEmail") - + V("AutoLinkRelativeReference") - + V("InlineHtml") - + V("HtmlEntity") - + V("EscapedChar") - + V("Smart") - + V("Symbol"), - - IndentedInline = V("Str") - + V("OptionalIndent") - + V("Endline") - + V("UlOrStarLine") - + V("Strong") - + V("Emph") - + V("StrikeThrough") - + V("Superscript") - + V("Subscript") - + V("InlineNote") - + V("NoteRef") - + V("Citations") - + V("Link") - + V("Image") - + V("Code") - + V("AutoLinkUrl") - + V("AutoLinkEmail") - + V("AutoLinkRelativeReference") - + V("InlineHtml") - + V("HtmlEntity") - + V("EscapedChar") - + V("Smart") - + V("Symbol"), - - Str = parsers.Str, - Space = parsers.Space, - OptionalIndent = parsers.OptionalIndent, - Endline = parsers.Endline, - UlOrStarLine = parsers.UlOrStarLine, - Strong = parsers.Strong, - Emph = parsers.Emph, - StrikeThrough = parsers.fail, - Superscript = parsers.fail, - Subscript = parsers.fail, - InlineNote = parsers.fail, - NoteRef = parsers.fail, - Citations = parsers.fail, - Link = parsers.Link, - Image = parsers.Image, - Code = parsers.Code, - AutoLinkUrl = parsers.AutoLinkUrl, - AutoLinkEmail = parsers.AutoLinkEmail, - AutoLinkRelativeReference - = parsers.AutoLinkRelativeReference, - InlineHtml = parsers.InlineHtml, - HtmlEntity = parsers.HtmlEntity, - EscapedChar = parsers.EscapedChar, - Smart = parsers.Smart, - Symbol = parsers.Symbol, - SpecialChar = parsers.fail, - } +% \end{markdown} +% \begin{macrocode} + function self.finalize_grammar(extensions) +% \end{macrocode} +% \begin{markdown} +% +% Create a local writable copy of the global read-only +% \luamdef{walkable_syntax} hash table. This table can be used by user-defined +% syntax extensions to insert new \acro{peg} patterns into existing rules +% of the \acro{peg} grammar of markdown using +% the \luamref{reader->insert_pattern} method. Furthermore, built-in syntax +% extensions can use this table to override existing rules using the +% \luamref{reader->update_rule} method. +% +% \end{markdown} +% \begin{macrocode} + local walkable_syntax = (function(global_walkable_syntax) + local local_walkable_syntax = {} + for lhs, rule in pairs(global_walkable_syntax) do + local_walkable_syntax[lhs] = util.table_copy(rule) + end + return local_walkable_syntax + end)(walkable_syntax) +% \end{macrocode} +% \par +% \begin{markdown} +% +% Define \luamref{reader->insert_pattern} as a function that receives two +% arguments: a selector string in the form `"`\meta{left-hand side terminal +% symbol} \meta{`before`, `after`, or `instead of`} \meta{right-hand side +% terminal symbol}`"` and a \acro{peg} pattarn to insert. The function adds +% the pattern to \luamref{walkable_syntax}`[`*left-hand side terminal +% symbol*`]` before or after *right-hand side terminal symbol*. +% +% \end{markdown} +% \begin{macrocode} + self.insert_pattern = function(selector, pattern) + local _, _, lhs, pos, rhs = selector:find("^(%a+)%s+([%a%s]+%a+)%s+(%a+)$") + assert(lhs ~= nil, + [[Expected selector in form "LHS (before|after|instead of) RHS", not "]] + .. selector .. [["]]) + assert(walkable_syntax[lhs] ~= nil, + [[Rule ]] .. lhs .. [[ -> ... does not exist in markdown grammar]]) + assert(pos == "before" or pos == "after" or pos == "instead of", + [[Expected positional specifier "before", "after", or "instead of", not "]] + .. pos .. [["]]) + local rule = walkable_syntax[lhs] + local index = nil + for current_index, current_rhs in ipairs(rule) do + if type(current_rhs) == "string" and current_rhs == rhs then + index = current_index + if pos == "after" then + index = index + 1 + end + break + end + end + assert(index ~= nil, + [[Rule ]] .. lhs .. [[ -> ]] .. rhs + .. [[ does not exist in markdown grammar]]) + if pos == "instead of" then + rule[index] = pattern + else + table.insert(rule, index, pattern) + end + end +% \end{macrocode} +% \par +% \begin{markdown} +% +% Create a local \luamdef{syntax} hash table that stores those rules of the +% \acro{peg} grammar of markdown that can't be represented as an ordered choice +% of terminal symbols. +% +% \end{markdown} +% \begin{macrocode} + local syntax = + { "Blocks", + + Blocks = ( V("ExpectedJekyllData") + * (V("Blank")^0 / writer.interblocksep) + )^-1 + * V("Blank")^0 + * V("Block")^-1 + * (V("Blank")^0 / writer.interblocksep + * V("Block"))^0 + * V("Blank")^0 * parsers.eof, + + ExpectedJekyllData = parsers.fail, + + Blank = parsers.Blank, + + Blockquote = parsers.Blockquote, + Verbatim = parsers.Verbatim, + HorizontalRule = parsers.HorizontalRule, + BulletList = parsers.BulletList, + OrderedList = parsers.OrderedList, + Heading = parsers.Heading, + DisplayHtml = parsers.DisplayHtml, + Paragraph = parsers.Paragraph, + Plain = parsers.Plain, + EndlineExceptions = parsers.EndlineExceptions, + + Str = parsers.Str, + Space = parsers.Space, + OptionalIndent = parsers.OptionalIndent, + Endline = parsers.Endline, + UlOrStarLine = parsers.UlOrStarLine, + Strong = parsers.Strong, + Emph = parsers.Emph, + Link = parsers.Link, + Image = parsers.Image, + Code = parsers.Code, + AutoLinkUrl = parsers.AutoLinkUrl, + AutoLinkEmail = parsers.AutoLinkEmail, + AutoLinkRelativeReference + = parsers.AutoLinkRelativeReference, + InlineHtml = parsers.InlineHtml, + HtmlEntity = parsers.HtmlEntity, + EscapedChar = parsers.EscapedChar, + Smart = parsers.Smart, + Symbol = parsers.Symbol, + SpecialChar = parsers.fail, + } +% \end{macrocode} +% \par +% \begin{markdown} +% +% Define \luamref{reader->update_rule} as a function that receives two arguments: +% a left-hand side terminal symbol and a \acro{peg} pattarn. The function +% (re)defines \luamref{walkable_syntax}`[`left-hand side terminal symbol`]` to +% be equal to pattern. +% +% \end{markdown} +% \begin{macrocode} + self.update_rule = function(rule_name, pattern) + assert(syntax[rule_name] ~= nil, + [[Rule ]] .. rule_name .. [[ -> ... does not exist in markdown grammar]]) + walkable_syntax[rule_name] = { pattern } + end % \end{macrocode} % \par % \begin{markdown} % % Define a hash table of all characters with special meaning and add method -% `reader->add_special_character` that extends the hash table and updates the -% \acro{peg} grammar. +% \luamref{reader->add_special_character} that extends the hash table and +% updates the \acro{peg} grammar of markdown. % % \end{markdown} % \begin{macrocode} - local special_characters = {"*", "`", "[", "]", "<", "!", "\\"} - self.add_special_character = function(c) - table.insert(special_characters, c) - self.syntax.SpecialChar = S(table.concat(special_characters, "")) - end - self.syntax.SpecialChar = S(table.concat(special_characters, "")) + local special_characters = {} + self.add_special_character = function(c) + table.insert(special_characters, c) + syntax.SpecialChar = S(table.concat(special_characters, "")) + end + + self.add_special_character("*") + self.add_special_character("`") + self.add_special_character("[") + self.add_special_character("]") + self.add_special_character("<") + self.add_special_character("!") + self.add_special_character("\\") % \end{macrocode} % \par % \begin{markdown} @@ -21299,83 +21639,128 @@ function M.reader.new(writer, options, extensions) % % \end{markdown} % \begin{macrocode} - for _, extension in ipairs(extensions) do - extension.extend_writer(writer) - extension.extend_reader(self) - end - - if options.underscores then - self.add_special_character("_") - end + for _, extension in ipairs(extensions) do + extension.extend_writer(writer) + extension.extend_reader(self) + end +% \end{macrocode} +% \par +% \begin{markdown} +% +% Duplicate the `Inline` rule as `IndentedInline` with the right-hand-side +% terminal symbol `Space` replaced with `OptionalIndent`. +% +% \end{markdown} +% \begin{macrocode} + walkable_syntax["IndentedInline"] = util.table_copy( + walkable_syntax["Inline"]) + self.insert_pattern( + "IndentedInline instead of Space", + "OptionalIndent") +% \end{macrocode} +% \par +% \begin{markdown} +% +% Materialize \luamref{walkable_syntax} and merge it into \luamref{syntax} to +% produce the complete \acro{peg} grammar of markdown. Whenever a rule exists +% in both \luamref{walkable_syntax} and \luamref{syntax}, the rule from +% \luamref{walkable_syntax} overrides the rule from \luamref{syntax}. +% +% \end{markdown} +% \begin{macrocode} + for lhs, rule in pairs(walkable_syntax) do + syntax[lhs] = parsers.fail + for _, rhs in ipairs(rule) do + local pattern + if type(rhs) == "string" then + pattern = V(rhs) + else + pattern = rhs + end + syntax[lhs] = syntax[lhs] + pattern + end + end +% \end{macrocode} +% \par +% \begin{markdown} +% +% Finalize the parser by enabling built-in syntax extensions and producing +% special parsers for difficult edge cases such as blocks nested in definition +% lists or inline content nested in link, note, and image labels. +% +% \end{markdown} +% \begin{macrocode} + if options.underscores then + self.add_special_character("_") + end - if not options.codeSpans then - self.syntax.Code = parsers.fail - end + if not options.codeSpans then + syntax.Code = parsers.fail + end - if not options.html then - self.syntax.DisplayHtml = parsers.fail - self.syntax.InlineHtml = parsers.fail - self.syntax.HtmlEntity = parsers.fail - else - self.add_special_character("&") - end + if not options.html then + syntax.DisplayHtml = parsers.fail + syntax.InlineHtml = parsers.fail + syntax.HtmlEntity = parsers.fail + else + self.add_special_character("&") + end - if options.preserveTabs then - options.stripIndent = false - end + if options.preserveTabs then + options.stripIndent = false + end - if not options.smartEllipses then - self.syntax.Smart = parsers.fail - else - self.add_special_character(".") - end + if not options.smartEllipses then + syntax.Smart = parsers.fail + else + self.add_special_character(".") + end - if not options.relativeReferences then - self.syntax.AutoLinkRelativeReference = parsers.fail - end + if not options.relativeReferences then + syntax.AutoLinkRelativeReference = parsers.fail + end - local blocks_nested_t = util.table_copy(self.syntax) - blocks_nested_t.ExpectedJekyllData = parsers.fail - parsers.blocks_nested = Ct(blocks_nested_t) + local blocks_nested_t = util.table_copy(syntax) + blocks_nested_t.ExpectedJekyllData = parsers.fail + parsers.blocks_nested = Ct(blocks_nested_t) - parsers.blocks = Ct(self.syntax) + parsers.blocks = Ct(syntax) - local inlines_t = util.table_copy(self.syntax) - inlines_t[1] = "Inlines" - inlines_t.Inlines = parsers.Inline^0 * (parsers.spacing^0 * parsers.eof / "") - parsers.inlines = Ct(inlines_t) + local inlines_t = util.table_copy(syntax) + inlines_t[1] = "Inlines" + inlines_t.Inlines = parsers.Inline^0 * (parsers.spacing^0 * parsers.eof / "") + parsers.inlines = Ct(inlines_t) - local inlines_no_link_t = util.table_copy(inlines_t) - inlines_no_link_t.Link = parsers.fail - parsers.inlines_no_link = Ct(inlines_no_link_t) + local inlines_no_link_t = util.table_copy(inlines_t) + inlines_no_link_t.Link = parsers.fail + parsers.inlines_no_link = Ct(inlines_no_link_t) - local inlines_no_inline_note_t = util.table_copy(inlines_t) - inlines_no_inline_note_t.InlineNote = parsers.fail - parsers.inlines_no_inline_note = Ct(inlines_no_inline_note_t) + local inlines_no_inline_note_t = util.table_copy(inlines_t) + inlines_no_inline_note_t.InlineNote = parsers.fail + parsers.inlines_no_inline_note = Ct(inlines_no_inline_note_t) - local inlines_no_html_t = util.table_copy(inlines_t) - inlines_no_html_t.DisplayHtml = parsers.fail - inlines_no_html_t.InlineHtml = parsers.fail - inlines_no_html_t.HtmlEntity = parsers.fail - parsers.inlines_no_html = Ct(inlines_no_html_t) + local inlines_no_html_t = util.table_copy(inlines_t) + inlines_no_html_t.DisplayHtml = parsers.fail + inlines_no_html_t.InlineHtml = parsers.fail + inlines_no_html_t.HtmlEntity = parsers.fail + parsers.inlines_no_html = Ct(inlines_no_html_t) - local inlines_nbsp_t = util.table_copy(inlines_t) - inlines_nbsp_t.Endline = parsers.NonbreakingEndline - inlines_nbsp_t.Space = parsers.NonbreakingSpace - parsers.inlines_nbsp = Ct(inlines_nbsp_t) + local inlines_nbsp_t = util.table_copy(inlines_t) + inlines_nbsp_t.Endline = parsers.NonbreakingEndline + inlines_nbsp_t.Space = parsers.NonbreakingSpace + parsers.inlines_nbsp = Ct(inlines_nbsp_t) % \end{macrocode} % \par % \begin{markdown} % -%#### Exported Conversion Function -% Define \luamdef{reader->convert} as a function that converts markdown string -% `input` into a plain \TeX{} output and returns it. Note that the converter -% assumes that the input has \acro{unix} line endings. +% Return a function that converts markdown string `input` into a plain \TeX{} +% output and returns it. Note that the converter assumes that the input has +% \acro{unix} line endings. % % \end{markdown} % \begin{macrocode} - function self.convert(input) - references = {} + return function(input) + references = {} % \end{macrocode} % \begin{markdown} % When determining the name of the cache file, create salt for the hashing @@ -21384,37 +21769,42 @@ function M.reader.new(writer, options, extensions) % is disregarded. % \end{markdown} % \begin{macrocode} - local opt_string = {} - for k,_ in pairs(defaultOptions) do - local v = options[k] - if k ~= "cacheDir" then - opt_string[#opt_string+1] = k .. "=" .. tostring(v) + local opt_string = {} + for k, _ in pairs(defaultOptions) do + local v = options[k] + if type(v) == "table" then + for _, i in ipairs(v) do + opt_string[#opt_string+1] = k .. "=" .. tostring(i) + end + elseif k ~= "cacheDir" then + opt_string[#opt_string+1] = k .. "=" .. tostring(v) + end end - end - table.sort(opt_string) - local salt = table.concat(opt_string, ",") .. "," .. metadata.version - local output + table.sort(opt_string) + local salt = table.concat(opt_string, ",") .. "," .. metadata.version + local output % \end{macrocode} % \begin{markdown} % If we cache markdown documents, produce the cache file and transform its % filename to plain \TeX{} output via the \luamref{writer->pack} method. % \end{markdown} % \begin{macrocode} - local function convert(input) - local document = self.parser_functions.parse_blocks(input) - return util.rope_to_string(writer.document(document)) - end - if options.eagerCache or options.finalizeCache then - local name = util.cache(options.cacheDir, input, salt, convert, ".md" .. writer.suffix) - output = writer.pack(name) + local function convert(input) + local document = self.parser_functions.parse_blocks(input) + return util.rope_to_string(writer.document(document)) + end + if options.eagerCache or options.finalizeCache then + local name = util.cache(options.cacheDir, input, salt, convert, + ".md" .. writer.suffix) + output = writer.pack(name) % \end{macrocode} % \begin{markdown} % Otherwise, return the result of the conversion directly. % \end{markdown} % \begin{macrocode} - else - output = convert(input) - end + else + output = convert(input) + end % \end{macrocode} % \begin{markdown} % If the \Opt{finalizeCache} option is enabled, populate the frozen cache in @@ -21422,36 +21812,37 @@ function M.reader.new(writer, options, extensions) % number \Opt{frozenCacheCounter}. % \end{markdown} % \begin{macrocode} - if options.finalizeCache then - local file, mode - if options.frozenCacheCounter > 0 then - mode = "a" - else - mode = "w" + if options.finalizeCache then + local file, mode + if options.frozenCacheCounter > 0 then + mode = "a" + else + mode = "w" + end + file = assert(io.open(options.frozenCacheFileName, mode), + [[Could not open file "]] .. options.frozenCacheFileName + .. [[" for writing]]) + assert(file:write([[\expandafter\global\expandafter\def\csname ]] + .. [[markdownFrozenCache]] .. options.frozenCacheCounter + .. [[\endcsname{]] .. output .. [[}]] .. "\n")) + assert(file:close()) end - file = assert(io.open(options.frozenCacheFileName, mode), - [[could not open file "]] .. options.frozenCacheFileName - .. [[" for writing]]) - assert(file:write([[\expandafter\global\expandafter\def\csname ]] - .. [[markdownFrozenCache]] .. options.frozenCacheCounter - .. [[\endcsname{]] .. output .. [[}]] .. "\n")) - assert(file:close()) + return output end - return output end return self end % \end{macrocode} % \begin{markdown} % -%### Syntax Extensions for Markdown +%### Built-In Syntax Extensions {#luabuiltinextensions} % -% Create \luamdef{extensions} hash table that contains syntax extensions. -% Syntax extensions are functions that produce objects with two methods: -% `extend_writer` and `extend_reader`. The `extend_writer` object takes a -% \luamref{writer} object as the only parameter and mutates it. Similarly, -% `extend_reader` takes a \luamref{reader} object as the only parameter and -% mutates it. +% Create \luamdef{extensions} hash table that contains built-in syntax +% extensions. Syntax extensions are functions that produce objects with two +% methods: `extend_writer` and `extend_reader`. The `extend_writer` object +% takes a \luamref{writer} object as the only parameter and mutates it. +% Similarly, `extend_reader` takes a \luamref{reader} object as the only +% parameter and mutates it. % % \end{markdown} % \begin{macrocode} @@ -21548,7 +21939,6 @@ M.extensions.citations = function(citation_nbsps) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local citation_chars @@ -21656,7 +22046,7 @@ M.extensions.citations = function(citation_nbsps) local Citations = TextCitations + ParenthesizedCitations - syntax.Citations = Citations + self.insert_pattern("Inline after Emph", Citations) self.add_special_character("@") self.add_special_character("-") @@ -21682,37 +22072,21 @@ M.extensions.content_blocks = function(language_map) % % The \luamdef{languages_json} table maps programming language filename % extensions to fence infostrings. All `language_map` files located by the -% KPathSea library are loaded into a chain of tables. \luamref{languages_json} -% corresponds to the first table and is chained with the rest via Lua -% metatables. +% \pkg{kpathsea} library are loaded into a chain of tables. +% \luamref{languages_json} corresponds to the first table and is chained with +% the rest via Lua metatables. % % \end{markdown} % \begin{macrocode} local languages_json = (function() - local ran_ok, kpse = pcall(require, "kpse") - if ran_ok then - kpse.set_program_name("luatex") -% \end{macrocode} -% \begin{markdown} -% -% If the KPathSea library is unavailable, perhaps because we are using -% LuaMeta\TeX, we will only locate the `options.`\luamref{contentBlocksLanguageMap} -% in the current working directory: -% -% \end{markdown} -% \begin{macrocode} - else - kpse = {lookup=function(filename, _) return filename end} - end local base, prev, curr - for _, filename in ipairs{kpse.lookup(language_map, { all=true })} do - local file = io.open(filename, "r") + for _, pathname in ipairs{util.lookup_files(language_map, { all=true })} do + local file = io.open(pathname, "r") if not file then goto continue end - local json = file:read("*all"):gsub('("[^\n]-"):','[%1]=') - curr = (function() - local _ENV={ json=json, load=load } -- luacheck: ignore _ENV - return load("return "..json)() - end)() + local input = assert(file:read("*a")) + assert(file:close()) + local json = input:gsub('("[^\n]-"):','[%1]=') + curr = load("_ENV = {}; return "..json)() if type(curr) == "table" then if base == nil then base = curr @@ -21764,7 +22138,6 @@ M.extensions.content_blocks = function(language_map) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local contentblock_tail @@ -21838,7 +22211,7 @@ M.extensions.content_blocks = function(language_map) * contentblock_tail / writer.contentblock - syntax.ContentBlock = ContentBlock + self.insert_pattern("Block before Blockquote", ContentBlock) end } end @@ -21894,7 +22267,6 @@ M.extensions.definition_lists = function(tight_lists) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local defstartchar = S("~:") @@ -21937,7 +22309,7 @@ M.extensions.definition_lists = function(tight_lists) * -DefinitionListItemLoose * Cc(true)) ) / writer.definitionlist - syntax.DefinitionList = DefinitionList + self.insert_pattern("Block after Heading", DefinitionList) end } end @@ -21976,7 +22348,6 @@ M.extensions.fenced_code = function(blank_before_code_fence) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local function captures_geq_length(_,i,a,b) @@ -22039,7 +22410,8 @@ M.extensions.fenced_code = function(blank_before_code_fence) self.expandtabs(code)) end - syntax.FencedCode = FencedCode + self.insert_pattern("Block after Verbatim", + FencedCode) local fencestart if blank_before_code_fence then @@ -22049,8 +22421,8 @@ M.extensions.fenced_code = function(blank_before_code_fence) + fencehead(parsers.tilde) end - parsers.EndlineExceptions = parsers.EndlineExceptions + fencestart - syntax.EndlineExceptions = parsers.EndlineExceptions + local EndlineExceptions = parsers.EndlineExceptions + fencestart + self.update_rule("EndlineExceptions", EndlineExceptions) self.add_special_character("~") end @@ -22087,9 +22459,16 @@ M.extensions.footnotes = function(footnotes, inline_footnotes) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer + if inline_footnotes then + local InlineNote + = parsers.circumflex + * (parsers.tag / self.parser_functions.parse_inlines_no_inline_note) + / writer.note + + self.insert_pattern("Inline after Emph", InlineNote) + end if footnotes then local function strip_first_char(s) return s:sub(2) @@ -22127,17 +22506,10 @@ M.extensions.footnotes = function(footnotes, inline_footnotes) * parsers.spnl * parsers.indented_blocks(parsers.chunk) / register_note - parsers.Blank = NoteBlock + parsers.Blank - syntax.Blank = parsers.Blank + local Blank = NoteBlock + parsers.Blank + self.update_rule("Blank", Blank) - syntax.NoteRef = NoteRef - end - if inline_footnotes then - local InlineNote - = parsers.circumflex - * (parsers.tag / self.parser_functions.parse_inlines_no_inline_note) - / writer.note - syntax.InlineNote = InlineNote + self.insert_pattern("Inline after Emph", NoteRef) end self.add_special_character("^") @@ -22159,7 +22531,6 @@ M.extensions.header_attributes = function() extend_writer = function() end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer parsers.AtxHeading = Cg(parsers.HeadingStart,"level") @@ -22204,8 +22575,8 @@ M.extensions.header_attributes = function() * parsers.newline / writer.heading - parsers.Heading = parsers.AtxHeading + parsers.SetextHeading - syntax.Heading = parsers.Heading + local Heading = parsers.AtxHeading + parsers.SetextHeading + self.update_rule("Heading", Heading) end } end @@ -22322,7 +22693,6 @@ M.extensions.jekyll_data = function(expect_jekyll_data) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local JekyllData @@ -22358,9 +22728,9 @@ M.extensions.jekyll_data = function(expect_jekyll_data) * JekyllData * (P("---") + P("..."))^-1 - syntax.UnexpectedJekyllData = UnexpectedJekyllData + self.insert_pattern("Block before Blockquote", UnexpectedJekyllData) if expect_jekyll_data then - syntax.ExpectedJekyllData = ExpectedJekyllData + self.update_rule("ExpectedJekyllData", ExpectedJekyllData) end end } @@ -22468,7 +22838,6 @@ M.extensions.pipe_tables = function(table_captions) end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local table_hline_separator = parsers.pipe + parsers.plus @@ -22523,7 +22892,7 @@ M.extensions.pipe_tables = function(table_captions) * table_caption^-1 / writer.table - syntax.PipeTable = PipeTable + self.insert_pattern("Block after Blockquote", PipeTable) end } end @@ -22554,7 +22923,6 @@ M.extensions.strike_through = function() end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local StrikeThrough = ( @@ -22562,7 +22930,7 @@ M.extensions.strike_through = function() parsers.doubletildes) ) / writer.strike_through - syntax.StrikeThrough = StrikeThrough + self.insert_pattern("Inline after Emph", StrikeThrough) self.add_special_character("~") end @@ -22595,14 +22963,13 @@ M.extensions.superscripts = function() end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local Superscript = ( parsers.between(parsers.Str, parsers.circumflex, parsers.circumflex) ) / writer.superscript - syntax.Superscript = Superscript + self.insert_pattern("Inline after Emph", Superscript) self.add_special_character("^") end @@ -22635,14 +23002,13 @@ M.extensions.subscripts = function() end end, extend_reader = function(self) local parsers = self.parsers - local syntax = self.syntax local writer = self.writer local Subscript = ( parsers.between(parsers.Str, parsers.tilde, parsers.tilde) ) / writer.subscript - syntax.Subscript = Subscript + self.insert_pattern("Inline after Emph", Subscript) self.add_special_character("~") end @@ -22729,7 +23095,6 @@ M.extensions.fancy_lists = function() end, extend_reader = function(self) local parsers = self.parsers local options = self.options - local syntax = self.syntax local writer = self.writer local label = parsers.dig + parsers.letter @@ -22845,8 +23210,7 @@ M.extensions.fancy_lists = function() * Cc(false) * parsers.skipblanklines ) * Cb("listtype") / fancylist - syntax.OrderedList = FancyList - + self.update_rule("OrderedList", FancyList) end } end @@ -22855,10 +23219,9 @@ end % %### Conversion from Markdown to Plain \TeX{} % -% The \luamref{new} method returns the \luamref{reader->convert} function of a reader -% object associated with the Lua interface options (see Section -% <#sec:luaoptions>) `options` and with a writer object associated with -% `options`. +% The \luamref{new} function returns a conversion function that takes a +% markdown string and turns it into a plain \TeX{} output. See Section +% <#luaconversion>. % % \end{markdown} % \begin{macrocode} @@ -22874,20 +23237,16 @@ function M.new(options) options = options or {} setmetatable(options, { __index = function (_, key) return defaultOptions[key] end }) +% \end{macrocode} % \par % \begin{markdown} % -% Apply syntax extensions based on `options`. +% Apply built-in syntax extensions based on `options`. % % \end{markdown} % \begin{macrocode} local extensions = {} - if options.citations then - local citations_extension = M.extensions.citations(options.citationNbsps) - table.insert(extensions, citations_extension) - end - if options.contentBlocks then local content_blocks_extension = M.extensions.content_blocks( options.contentBlocksLanguageMap) @@ -22906,12 +23265,6 @@ function M.new(options) table.insert(extensions, fenced_code_extension) end - if options.footnotes or options.inlineFootnotes then - local footnotes_extension = M.extensions.footnotes( - options.footnotes, options.inlineFootnotes) - table.insert(extensions, footnotes_extension) - end - if options.headerAttributes then local header_attributes_extension = M.extensions.header_attributes() table.insert(extensions, header_attributes_extension) @@ -22944,15 +23297,128 @@ function M.new(options) table.insert(extensions, superscript_extension) end + if options.footnotes or options.inlineFootnotes then + local footnotes_extension = M.extensions.footnotes( + options.footnotes, options.inlineFootnotes) + table.insert(extensions, footnotes_extension) + end + + if options.citations then + local citations_extension = M.extensions.citations(options.citationNbsps) + table.insert(extensions, citations_extension) + end + if options.fancyLists then local fancy_lists_extension = M.extensions.fancy_lists() table.insert(extensions, fancy_lists_extension) end +% \end{macrocode} +% \par +% \begin{markdown} +% +% Apply user-defined syntax extensions based on `options.extensions`. +% +% \end{markdown} +% \begin{macrocode} + for _, user_extension_filename in ipairs(options.extensions) do + local user_extension = (function(filename) +% \end{macrocode} +% \begin{markdown} +% +% First, load and compile the contents of the user-defined syntax extension. +% +% \end{markdown} +% \begin{macrocode} + local pathname = util.lookup_files(filename) + local input_file = assert(io.open(pathname, "r"), + [[Could not open user-defined syntax extension "]] + .. pathname .. [[" for reading]]) + local input = assert(input_file:read("*a")) + assert(input_file:close()) + local user_extension, err = load([[ + local sandbox = {} + setmetatable(sandbox, {__index = _G}) + _ENV = sandbox + ]] .. input)() + assert(user_extension, + [[Failed to compile user-defined syntax extension "]] + .. pathname .. [[": ]] .. (err or [[]])) +% \end{macrocode} +% \begin{markdown} +% +% Then, validate the user-defined syntax extension. +% +% \end{markdown} +% \begin{macrocode} + assert(user_extension.api_version ~= nil, + [[User-defined syntax extension "]] .. pathname + .. [[" does not specify mandatory field "api_version"]]) + assert(type(user_extension.api_version) == "number", + [[User-defined syntax extension "]] .. pathname + .. [[" specifies field "api_version" of type "]] + .. type(user_extension.api_version) + .. [[" but "number" was expected]]) + assert(user_extension.api_version == metadata.user_extension_api_version, + [[User-defined syntax extension "]] .. pathname + .. [[" uses syntax extension API version "]] + .. user_extension.api_version .. [[ but markdown.lua ]] + .. metadata.version .. [[ uses API version ]] + .. metadata.user_extension_api_version + .. [[, which is incompatible]]) + + assert(user_extension.grammar_version ~= nil, + [[User-defined syntax extension "]] .. pathname + .. [[" does not specify mandatory field "grammar_version"]]) + assert(type(user_extension.grammar_version) == "number", + [[User-defined syntax extension "]] .. pathname + .. [[" specifies field "grammar_version" of type "]] + .. type(user_extension.grammar_version) + .. [[" but "number" was expected]]) + assert(user_extension.grammar_version == metadata.grammar_version, + [[User-defined syntax extension "]] .. pathname + .. [[" uses grammar version "]] .. user_extension.grammar_version + .. [[ but markdown.lua ]] .. metadata.version + .. [[ uses grammar version ]] .. metadata.grammar_version + .. [[, which is incompatible]]) + assert(user_extension.finalize_grammar ~= nil, + [[User-defined syntax extension "]] .. pathname + .. [[" does not specify mandatory "finalize_grammar" field]]) + assert(type(user_extension.finalize_grammar) == "function", + [[User-defined syntax extension "]] .. pathname + .. [[" specifies field "finalize_grammar" of type "]] + .. type(user_extension.finalize_grammar) + .. [[" but "function" was expected]]) +% \end{macrocode} +% \begin{markdown} +% +% Finally, cast the user-defined syntax extension to the internal format +% of user extensions used by the Markdown package (see Section +% <#luabuiltinextensions>.) +% +% \end{markdown} +% \begin{macrocode} + local extension = { + extend_reader = user_extension.finalize_grammar, + extend_writer = function() end, + } + return extension + end)(user_extension_filename) + table.insert(extensions, user_extension) + end +% \end{macrocode} +% \par +% \begin{markdown} +% +% Produce and return a conversion function from markdown to plain \TeX. +% +% \end{markdown} +% \begin{macrocode} local writer = M.writer.new(options) - local reader = M.reader.new(writer, options, extensions) + local reader = M.reader.new(writer, options) + local convert = reader.finalize_grammar(extensions) - return reader.convert + return convert end return M @@ -22975,7 +23441,7 @@ return M local input if input_filename then local input_file = assert(io.open(input_filename, "r"), - [[could not open file "]] .. input_filename .. [[" for reading]]) + [[Could not open file "]] .. input_filename .. [[" for reading]]) input = assert(input_file:read("*a")) assert(input_file:close()) else @@ -23018,7 +23484,7 @@ local output = convert(input:gsub("\r\n?", "\n") .. "\n") if output_filename then local output_file = assert(io.open(output_filename, "w"), - [[could not open file "]] .. output_filename .. [[" for writing]]) + [[Could not open file "]] .. output_filename .. [[" for writing]]) assert(output_file:write(output)) assert(output_file:close()) else @@ -23409,25 +23875,50 @@ end \@@_get_option_type:nN { #1 } \l_tmpa_tl - \bool_if:nTF + \bool_case_true:nF { - \str_if_eq_p:VV - \l_tmpa_tl - \c_@@_option_type_boolean_tl || - \str_if_eq_p:VV - \l_tmpa_tl - \c_@@_option_type_number_tl || - \str_if_eq_p:VV - \l_tmpa_tl - \c_@@_option_type_counter_tl - } - { - \@@_get_option_value:nN - { #1 } - \l_tmpa_tl - \tl_gput_right:Nx - \g_@@_formatted_lua_options_tl - { #1~=~ \l_tmpa_tl ,~ } + { + \str_if_eq_p:VV + \l_tmpa_tl + \c_@@_option_type_boolean_tl || + \str_if_eq_p:VV + \l_tmpa_tl + \c_@@_option_type_number_tl || + \str_if_eq_p:VV + \l_tmpa_tl + \c_@@_option_type_counter_tl + } + { + \@@_get_option_value:nN + { #1 } + \l_tmpa_tl + \tl_gput_right:Nx + \g_@@_formatted_lua_options_tl + { #1~=~ \l_tmpa_tl ,~ } + } + { + \str_if_eq_p:VV + \l_tmpa_tl + \c_@@_option_type_clist_tl + } + { + \@@_get_option_value:nN + { #1 } + \l_tmpa_tl + \tl_gput_right:Nx + \g_@@_formatted_lua_options_tl + { #1~=~\c_left_brace_str } + \clist_map_inline:Vn + \l_tmpa_tl + { + \tl_gput_right:Nx + \g_@@_formatted_lua_options_tl + { "##1" ,~ } + } + \tl_gput_right:Nx + \g_@@_formatted_lua_options_tl + { \c_right_brace_str ,~ } + } } { \@@_get_option_value:nN @@ -23438,6 +23929,9 @@ end { #1~=~ " \l_tmpa_tl " ,~ } } } +\cs_generate_variant:Nn + \clist_map_inline:nn + { Vn } \let\markdownPrepareLuaOptions=\@@_format_lua_options: \def\markdownLuaOptions{{ \g_@@_formatted_lua_options_tl }} \ExplSyntaxOff @@ -23737,8 +24231,8 @@ end % % The package assumes that although the user is not using the Lua\TeX{} engine, % their \TeX{} distribution contains it, and uses shell access to produce and -% execute Lua scripts using the \TeX{}Lua interpreter~[@luatex17, Section -% 3.1.1]. +% execute Lua scripts using the \TeX{}Lua interpreter~[@luatex21, Section +% 4.1.1]. % % \end{markdown} % \begin{macrocode} @@ -24020,7 +24514,7 @@ end |markdownLuaExecute{% |markdownPrepare local file = assert(io.open("&1", "r"), - [[could not open file "&1" for reading]]) + [[Could not open file "&1" for reading]]) local input = assert(file:read("*a")) assert(file:close()) % \end{macrocode} diff --git a/macros/generic/markdown/markdown.html b/macros/generic/markdown/markdown.html index a16e967818..834e756529 100644 --- a/macros/generic/markdown/markdown.html +++ b/macros/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.16.1-0-gf8a4bea 2022-08-30</p> +<p class="date">2.17.0-0-g6428569 2022-09-30</p> </header> <nav id="TOC" role="doc-toc"> <ul> @@ -1873,93 +1873,136 @@ Thomas,Edison,1847</code></pre> <div class="sourceCode" id="cb180"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb180-1"><a href="#cb180-1" aria-hidden="true"></a><span class="fu">\input</span> ./⟨hash⟩.md.tex<span class="fu">\relax</span></span></code></pre></div> <p>Additionally, a <span class="tex">T<sub>e</sub>X</span> document named <code>⟨hash⟩.md.tex</code> should be produced and contain the following code:</p> <div class="sourceCode" id="cb181"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb181-1"><a href="#cb181-1" aria-hidden="true"></a>Hello <span class="fu">\markdownRendererEmphasis</span>{world}!<span class="fu">\relax</span></span></code></pre></div> -<h4 data-number="2.2.1.14" id="option-expectjekylldata"><span class="header-section-number">2.2.1.14</span> Option <code>expectJekyllData</code></h4> +<h4 data-number="2.2.1.14" id="option-extensions"><span class="header-section-number">2.2.1.14</span> Option <code>extensions</code></h4> +<dl> +<dt><code>extensions</code> (default value: <code>{}</code>)</dt> +<dd><p>The filenames of user-defined syntax extensions that will be applied to the markdown reader. If the <strong><code>kpathsea</code></strong> library is available, files will be searched for not only in the current working directory but also in the <span class="tex">T<sub>e</sub>X</span> directory structure.</p> +</dd> +</dl> +<h5 class="unnumbered" data-number="" id="latex-example-12"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<p>Using a text editor, create a text document named <code>strike-through.lua</code> with the following content:</p> +<div class="sourceCode" id="cb182"><pre class="sourceCode lua"><code class="sourceCode lua"><span id="cb182-1"><a href="#cb182-1" aria-hidden="true"></a><span class="kw">local</span> strike_through <span class="op">=</span> <span class="op">{</span></span> +<span id="cb182-2"><a href="#cb182-2" aria-hidden="true"></a> api_version <span class="op">=</span> <span class="dv">1</span><span class="op">,</span></span> +<span id="cb182-3"><a href="#cb182-3" aria-hidden="true"></a> grammar_version <span class="op">=</span> <span class="dv">1</span><span class="op">,</span></span> +<span id="cb182-4"><a href="#cb182-4" aria-hidden="true"></a> finalize_grammar <span class="op">=</span> <span class="kw">function</span><span class="op">(</span>reader<span class="op">)</span></span> +<span id="cb182-5"><a href="#cb182-5" aria-hidden="true"></a> <span class="kw">local</span> nonspacechar <span class="op">=</span> lpeg<span class="op">.</span>P<span class="op">(</span><span class="dv">1</span><span class="op">)</span> <span class="op">-</span> lpeg<span class="op">.</span>S<span class="op">(</span><span class="st">"</span><span class="sc">\t</span><span class="st"> "</span><span class="op">)</span></span> +<span id="cb182-6"><a href="#cb182-6" aria-hidden="true"></a> <span class="kw">local</span> doubleslashes <span class="op">=</span> lpeg<span class="op">.</span>P<span class="op">(</span><span class="st">"//"</span><span class="op">)</span></span> +<span id="cb182-7"><a href="#cb182-7" aria-hidden="true"></a> <span class="kw">local</span> <span class="kw">function</span> between<span class="op">(</span>p<span class="op">,</span> starter<span class="op">,</span> ender<span class="op">)</span></span> +<span id="cb182-8"><a href="#cb182-8" aria-hidden="true"></a> ender <span class="op">=</span> lpeg<span class="op">.</span>B<span class="op">(</span>nonspacechar<span class="op">)</span> <span class="op">*</span> ender</span> +<span id="cb182-9"><a href="#cb182-9" aria-hidden="true"></a> <span class="cf">return</span> <span class="op">(</span>starter <span class="op">*</span> <span class="op">#</span>nonspacechar</span> +<span id="cb182-10"><a href="#cb182-10" aria-hidden="true"></a> <span class="op">*</span> lpeg<span class="op">.</span>Ct<span class="op">(</span>p <span class="op">*</span> <span class="op">(</span>p <span class="op">-</span> ender<span class="op">)^</span><span class="dv">0</span><span class="op">)</span> <span class="op">*</span> ender<span class="op">)</span></span> +<span id="cb182-11"><a href="#cb182-11" aria-hidden="true"></a> <span class="kw">end</span></span> +<span id="cb182-12"><a href="#cb182-12" aria-hidden="true"></a></span> +<span id="cb182-13"><a href="#cb182-13" aria-hidden="true"></a> <span class="kw">local</span> read_strike_through <span class="op">=</span> between<span class="op">(</span></span> +<span id="cb182-14"><a href="#cb182-14" aria-hidden="true"></a> lpeg<span class="op">.</span>V<span class="op">(</span><span class="st">"Inline"</span><span class="op">),</span> doubletildes<span class="op">,</span> doubletildes</span> +<span id="cb182-15"><a href="#cb182-15" aria-hidden="true"></a> <span class="op">)</span> <span class="op">/</span> <span class="kw">function</span><span class="op">(</span>s<span class="op">)</span> <span class="cf">return</span> <span class="op">{</span><span class="st">"</span><span class="sc">\\</span><span class="st">st{"</span><span class="op">,</span> s<span class="op">,</span> <span class="st">"}"</span><span class="op">}</span> <span class="kw">end</span></span> +<span id="cb182-16"><a href="#cb182-16" aria-hidden="true"></a></span> +<span id="cb182-17"><a href="#cb182-17" aria-hidden="true"></a> reader<span class="op">.</span>insert_pattern<span class="op">(</span><span class="st">"Inline after Emph"</span><span class="op">,</span> read_strike_through<span class="op">)</span></span> +<span id="cb182-18"><a href="#cb182-18" aria-hidden="true"></a> reader<span class="op">.</span>add_special_character<span class="op">(</span><span class="st">"/"</span><span class="op">)</span></span> +<span id="cb182-19"><a href="#cb182-19" aria-hidden="true"></a> <span class="kw">end</span></span> +<span id="cb182-20"><a href="#cb182-20" aria-hidden="true"></a><span class="op">}</span></span></code></pre></div> +<p>Using a text editor, create also a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb183"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb183-1"><a href="#cb183-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb183-2"><a href="#cb183-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">soul</span>}</span> +<span id="cb183-3"><a href="#cb183-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[extension = strike-through.lua]{<span class="ex">markdown</span>}</span> +<span id="cb183-4"><a href="#cb183-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb183-5"><a href="#cb183-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb183-6"><a href="#cb183-6" aria-hidden="true"></a>This is //a lunar roving vehicle// strike-through text.</span> +<span id="cb183-7"><a href="#cb183-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb183-8"><a href="#cb183-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb184"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb184-1"><a href="#cb184-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> +<blockquote> +<p>This is <del>a lunar roving vehicle</del> strike-through text.</p> +</blockquote> +<h4 data-number="2.2.1.15" id="option-expectjekylldata"><span class="header-section-number">2.2.1.15</span> Option <code>expectJekyllData</code></h4> <dl> <dt><code>expectJekyllData</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>false</dt> <dd><p>When the <strong><code>jekyllData</code></strong> option is enabled, then a markdown document may begin with <abbr>yaml</abbr> metadata if and only if the metadata begin with the end-of-directives marker (<code>---</code>) and they end with either the end-of-directives or the end-of-document marker (<code>...</code>):</p> -<div class="sourceCode" id="cb182"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb182-1"><a href="#cb182-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb182-2"><a href="#cb182-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb182-3"><a href="#cb182-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb182-4"><a href="#cb182-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb182-5"><a href="#cb182-5" aria-hidden="true"></a>---</span> -<span id="cb182-6"><a href="#cb182-6" aria-hidden="true"></a>- this</span> -<span id="cb182-7"><a href="#cb182-7" aria-hidden="true"></a>- is</span> -<span id="cb182-8"><a href="#cb182-8" aria-hidden="true"></a>- YAML</span> -<span id="cb182-9"><a href="#cb182-9" aria-hidden="true"></a>...</span> -<span id="cb182-10"><a href="#cb182-10" aria-hidden="true"></a>- followed</span> -<span id="cb182-11"><a href="#cb182-11" aria-hidden="true"></a>- by</span> -<span id="cb182-12"><a href="#cb182-12" aria-hidden="true"></a>- Markdown</span> -<span id="cb182-13"><a href="#cb182-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb182-14"><a href="#cb182-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb182-15"><a href="#cb182-15" aria-hidden="true"></a>- this</span> -<span id="cb182-16"><a href="#cb182-16" aria-hidden="true"></a>- is</span> -<span id="cb182-17"><a href="#cb182-17" aria-hidden="true"></a>- Markdown</span> -<span id="cb182-18"><a href="#cb182-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb182-19"><a href="#cb182-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb185"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb185-1"><a href="#cb185-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb185-2"><a href="#cb185-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb185-3"><a href="#cb185-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb185-4"><a href="#cb185-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb185-5"><a href="#cb185-5" aria-hidden="true"></a>---</span> +<span id="cb185-6"><a href="#cb185-6" aria-hidden="true"></a>- this</span> +<span id="cb185-7"><a href="#cb185-7" aria-hidden="true"></a>- is</span> +<span id="cb185-8"><a href="#cb185-8" aria-hidden="true"></a>- YAML</span> +<span id="cb185-9"><a href="#cb185-9" aria-hidden="true"></a>...</span> +<span id="cb185-10"><a href="#cb185-10" aria-hidden="true"></a>- followed</span> +<span id="cb185-11"><a href="#cb185-11" aria-hidden="true"></a>- by</span> +<span id="cb185-12"><a href="#cb185-12" aria-hidden="true"></a>- Markdown</span> +<span id="cb185-13"><a href="#cb185-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb185-14"><a href="#cb185-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb185-15"><a href="#cb185-15" aria-hidden="true"></a>- this</span> +<span id="cb185-16"><a href="#cb185-16" aria-hidden="true"></a>- is</span> +<span id="cb185-17"><a href="#cb185-17" aria-hidden="true"></a>- Markdown</span> +<span id="cb185-18"><a href="#cb185-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb185-19"><a href="#cb185-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> </dd> </dl> </dd> <dd><dl> <dt>true</dt> <dd><p>When the <strong><code>jekyllData</code></strong> option is enabled, then a markdown document may begin directly with <abbr>yaml</abbr> metadata and may contain nothing but <abbr>yaml</abbr> metadata.</p> -<div class="sourceCode" id="cb183"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb183-1"><a href="#cb183-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb183-2"><a href="#cb183-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData, expectJekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb183-3"><a href="#cb183-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb183-4"><a href="#cb183-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb183-5"><a href="#cb183-5" aria-hidden="true"></a>- this</span> -<span id="cb183-6"><a href="#cb183-6" aria-hidden="true"></a>- is</span> -<span id="cb183-7"><a href="#cb183-7" aria-hidden="true"></a>- YAML</span> -<span id="cb183-8"><a href="#cb183-8" aria-hidden="true"></a>...</span> -<span id="cb183-9"><a href="#cb183-9" aria-hidden="true"></a>- followed</span> -<span id="cb183-10"><a href="#cb183-10" aria-hidden="true"></a>- by</span> -<span id="cb183-11"><a href="#cb183-11" aria-hidden="true"></a>- Markdown</span> -<span id="cb183-12"><a href="#cb183-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb183-13"><a href="#cb183-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb183-14"><a href="#cb183-14" aria-hidden="true"></a>- this</span> -<span id="cb183-15"><a href="#cb183-15" aria-hidden="true"></a>- is</span> -<span id="cb183-16"><a href="#cb183-16" aria-hidden="true"></a>- YAML</span> -<span id="cb183-17"><a href="#cb183-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb183-18"><a href="#cb183-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb186"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb186-1"><a href="#cb186-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb186-2"><a href="#cb186-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData, expectJekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb186-3"><a href="#cb186-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb186-4"><a href="#cb186-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb186-5"><a href="#cb186-5" aria-hidden="true"></a>- this</span> +<span id="cb186-6"><a href="#cb186-6" aria-hidden="true"></a>- is</span> +<span id="cb186-7"><a href="#cb186-7" aria-hidden="true"></a>- YAML</span> +<span id="cb186-8"><a href="#cb186-8" aria-hidden="true"></a>...</span> +<span id="cb186-9"><a href="#cb186-9" aria-hidden="true"></a>- followed</span> +<span id="cb186-10"><a href="#cb186-10" aria-hidden="true"></a>- by</span> +<span id="cb186-11"><a href="#cb186-11" aria-hidden="true"></a>- Markdown</span> +<span id="cb186-12"><a href="#cb186-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb186-13"><a href="#cb186-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb186-14"><a href="#cb186-14" aria-hidden="true"></a>- this</span> +<span id="cb186-15"><a href="#cb186-15" aria-hidden="true"></a>- is</span> +<span id="cb186-16"><a href="#cb186-16" aria-hidden="true"></a>- YAML</span> +<span id="cb186-17"><a href="#cb186-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb186-18"><a href="#cb186-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> </dd> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-12"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-13"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>jane-doe.yml</code> with the following content:</p> -<div class="sourceCode" id="cb184"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb184-1"><a href="#cb184-1" aria-hidden="true"></a><span class="fu">name</span><span class="kw">:</span><span class="at"> Jane Doe</span></span> -<span id="cb184-2"><a href="#cb184-2" aria-hidden="true"></a><span class="fu">age</span><span class="kw">:</span><span class="at"> </span><span class="dv">99</span></span></code></pre></div> +<div class="sourceCode" id="cb187"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb187-1"><a href="#cb187-1" aria-hidden="true"></a><span class="fu">name</span><span class="kw">:</span><span class="at"> Jane Doe</span></span> +<span id="cb187-2"><a href="#cb187-2" aria-hidden="true"></a><span class="fu">age</span><span class="kw">:</span><span class="at"> </span><span class="dv">99</span></span></code></pre></div> <p>Using a text editor, create also a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb185"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb185-1"><a href="#cb185-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb185-2"><a href="#cb185-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb185-3"><a href="#cb185-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb185-4"><a href="#cb185-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> -<span id="cb185-5"><a href="#cb185-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> -<span id="cb185-6"><a href="#cb185-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> -<span id="cb185-7"><a href="#cb185-7" aria-hidden="true"></a> },</span> -<span id="cb185-8"><a href="#cb185-8" aria-hidden="true"></a> renderers = {</span> -<span id="cb185-9"><a href="#cb185-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> -<span id="cb185-10"><a href="#cb185-10" aria-hidden="true"></a> }</span> -<span id="cb185-11"><a href="#cb185-11" aria-hidden="true"></a>}</span> -<span id="cb185-12"><a href="#cb185-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb185-13"><a href="#cb185-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>[expectJekyllData]{jane-doe.yml}</span> -<span id="cb185-14"><a href="#cb185-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb186"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb186-1"><a href="#cb186-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb188"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb188-1"><a href="#cb188-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb188-2"><a href="#cb188-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb188-3"><a href="#cb188-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb188-4"><a href="#cb188-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> +<span id="cb188-5"><a href="#cb188-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> +<span id="cb188-6"><a href="#cb188-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> +<span id="cb188-7"><a href="#cb188-7" aria-hidden="true"></a> },</span> +<span id="cb188-8"><a href="#cb188-8" aria-hidden="true"></a> renderers = {</span> +<span id="cb188-9"><a href="#cb188-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> +<span id="cb188-10"><a href="#cb188-10" aria-hidden="true"></a> }</span> +<span id="cb188-11"><a href="#cb188-11" aria-hidden="true"></a>}</span> +<span id="cb188-12"><a href="#cb188-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb188-13"><a href="#cb188-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>[expectJekyllData]{jane-doe.yml}</span> +<span id="cb188-14"><a href="#cb188-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb189"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb189-1"><a href="#cb189-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> -<h4 data-number="2.2.1.15" id="option-fancylists"><span class="header-section-number">2.2.1.15</span> Option <code>fancyLists</code></h4> +<h4 data-number="2.2.1.16" id="option-fancylists"><span class="header-section-number">2.2.1.16</span> Option <code>fancyLists</code></h4> <dl> <dt><code>fancyLists</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc fancy list extension:</p> -<div class="sourceCode" id="cb187"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb187-1"><a href="#cb187-1" aria-hidden="true"></a>a) first item</span> -<span id="cb187-2"><a href="#cb187-2" aria-hidden="true"></a>b) second item</span> -<span id="cb187-3"><a href="#cb187-3" aria-hidden="true"></a>c) third item</span></code></pre></div> +<div class="sourceCode" id="cb190"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb190-1"><a href="#cb190-1" aria-hidden="true"></a>a) first item</span> +<span id="cb190-2"><a href="#cb190-2" aria-hidden="true"></a>b) second item</span> +<span id="cb190-3"><a href="#cb190-3" aria-hidden="true"></a>c) third item</span></code></pre></div> </dd> </dl> </dd> @@ -1970,20 +2013,20 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-13"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-14"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb188"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb188-1"><a href="#cb188-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb188-2"><a href="#cb188-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span> -<span id="cb188-3"><a href="#cb188-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[fancyLists]{<span class="ex">markdown</span>}</span> -<span id="cb188-4"><a href="#cb188-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb188-5"><a href="#cb188-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb188-6"><a href="#cb188-6" aria-hidden="true"></a>a) first item</span> -<span id="cb188-7"><a href="#cb188-7" aria-hidden="true"></a>b) second item</span> -<span id="cb188-8"><a href="#cb188-8" aria-hidden="true"></a>c) third item</span> -<span id="cb188-9"><a href="#cb188-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb188-10"><a href="#cb188-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb191"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb191-1"><a href="#cb191-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb191-2"><a href="#cb191-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span> +<span id="cb191-3"><a href="#cb191-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[fancyLists]{<span class="ex">markdown</span>}</span> +<span id="cb191-4"><a href="#cb191-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb191-5"><a href="#cb191-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb191-6"><a href="#cb191-6" aria-hidden="true"></a>a) first item</span> +<span id="cb191-7"><a href="#cb191-7" aria-hidden="true"></a>b) second item</span> +<span id="cb191-8"><a href="#cb191-8" aria-hidden="true"></a>c) third item</span> +<span id="cb191-9"><a href="#cb191-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb191-10"><a href="#cb191-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb189"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb189-1"><a href="#cb189-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb192"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb192-1"><a href="#cb192-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ol type="a"> @@ -1994,17 +2037,17 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-10">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb190"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb190-1"><a href="#cb190-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb190-2"><a href="#cb190-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[fancyLists = yes]</span> -<span id="cb190-3"><a href="#cb190-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb190-4"><a href="#cb190-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb190-5"><a href="#cb190-5" aria-hidden="true"></a>a) first item</span> -<span id="cb190-6"><a href="#cb190-6" aria-hidden="true"></a>b) second item</span> -<span id="cb190-7"><a href="#cb190-7" aria-hidden="true"></a>c) third item</span> -<span id="cb190-8"><a href="#cb190-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb190-9"><a href="#cb190-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb193"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb193-1"><a href="#cb193-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb193-2"><a href="#cb193-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[fancyLists = yes]</span> +<span id="cb193-3"><a href="#cb193-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb193-4"><a href="#cb193-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb193-5"><a href="#cb193-5" aria-hidden="true"></a>a) first item</span> +<span id="cb193-6"><a href="#cb193-6" aria-hidden="true"></a>b) second item</span> +<span id="cb193-7"><a href="#cb193-7" aria-hidden="true"></a>c) third item</span> +<span id="cb193-8"><a href="#cb193-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb193-9"><a href="#cb193-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb191"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb191-1"><a href="#cb191-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb194"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb194-1"><a href="#cb194-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ol type="a"> @@ -2013,28 +2056,28 @@ Thomas,Edison,1847</code></pre> <li>third item</li> </ol> </blockquote> -<h4 data-number="2.2.1.16" id="option-fencedcode"><span class="header-section-number">2.2.1.16</span> Option <code>fencedCode</code></h4> +<h4 data-number="2.2.1.17" id="option-fencedcode"><span class="header-section-number">2.2.1.17</span> Option <code>fencedCode</code></h4> <dl> <dt><code>fencedCode</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the commonmark fenced code block extension:</p> -<div class="sourceCode" id="cb192"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb192-1"><a href="#cb192-1" aria-hidden="true"></a><span class="in">~~~ js</span></span> -<span id="cb192-2"><a href="#cb192-2" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> -<span id="cb192-3"><a href="#cb192-3" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> -<span id="cb192-4"><a href="#cb192-4" aria-hidden="true"></a>}</span> -<span id="cb192-5"><a href="#cb192-5" aria-hidden="true"></a><span class="op">~~~~~~</span></span> -<span id="cb192-6"><a href="#cb192-6" aria-hidden="true"></a></span> -<span id="cb192-7"><a href="#cb192-7" aria-hidden="true"></a> <span class="vs">``` html</span></span> -<span id="cb192-8"><a href="#cb192-8" aria-hidden="true"></a><span class="vs"> <pre></span></span> -<span id="cb192-9"><a href="#cb192-9" aria-hidden="true"></a><span class="vs"> <code></span></span> -<span id="cb192-10"><a href="#cb192-10" aria-hidden="true"></a><span class="vs"> // Some comments</span></span> -<span id="cb192-11"><a href="#cb192-11" aria-hidden="true"></a><span class="vs"> line 1 of code</span></span> -<span id="cb192-12"><a href="#cb192-12" aria-hidden="true"></a><span class="vs"> line 2 of code</span></span> -<span id="cb192-13"><a href="#cb192-13" aria-hidden="true"></a><span class="vs"> line 3 of code</span></span> -<span id="cb192-14"><a href="#cb192-14" aria-hidden="true"></a><span class="vs"> </code></span></span> -<span id="cb192-15"><a href="#cb192-15" aria-hidden="true"></a><span class="vs"> </pre></span></span> -<span id="cb192-16"><a href="#cb192-16" aria-hidden="true"></a><span class="vs"> ```</span></span></code></pre></div> +<div class="sourceCode" id="cb195"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb195-1"><a href="#cb195-1" aria-hidden="true"></a><span class="in">~~~ js</span></span> +<span id="cb195-2"><a href="#cb195-2" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> +<span id="cb195-3"><a href="#cb195-3" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> +<span id="cb195-4"><a href="#cb195-4" aria-hidden="true"></a>}</span> +<span id="cb195-5"><a href="#cb195-5" aria-hidden="true"></a><span class="op">~~~~~~</span></span> +<span id="cb195-6"><a href="#cb195-6" aria-hidden="true"></a></span> +<span id="cb195-7"><a href="#cb195-7" aria-hidden="true"></a> <span class="vs">``` html</span></span> +<span id="cb195-8"><a href="#cb195-8" aria-hidden="true"></a><span class="vs"> <pre></span></span> +<span id="cb195-9"><a href="#cb195-9" aria-hidden="true"></a><span class="vs"> <code></span></span> +<span id="cb195-10"><a href="#cb195-10" aria-hidden="true"></a><span class="vs"> // Some comments</span></span> +<span id="cb195-11"><a href="#cb195-11" aria-hidden="true"></a><span class="vs"> line 1 of code</span></span> +<span id="cb195-12"><a href="#cb195-12" aria-hidden="true"></a><span class="vs"> line 2 of code</span></span> +<span id="cb195-13"><a href="#cb195-13" aria-hidden="true"></a><span class="vs"> line 3 of code</span></span> +<span id="cb195-14"><a href="#cb195-14" aria-hidden="true"></a><span class="vs"> </code></span></span> +<span id="cb195-15"><a href="#cb195-15" aria-hidden="true"></a><span class="vs"> </pre></span></span> +<span id="cb195-16"><a href="#cb195-16" aria-hidden="true"></a><span class="vs"> ```</span></span></code></pre></div> </dd> </dl> </dd> @@ -2045,91 +2088,91 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-14"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-15"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb193"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb193-1"><a href="#cb193-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb193-2"><a href="#cb193-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span> -<span id="cb193-3"><a href="#cb193-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span> -<span id="cb193-4"><a href="#cb193-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb193-5"><a href="#cb193-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb193-6"><a href="#cb193-6" aria-hidden="true"></a>~~~ js</span> -<span id="cb193-7"><a href="#cb193-7" aria-hidden="true"></a>if (a > 3) {</span> -<span id="cb193-8"><a href="#cb193-8" aria-hidden="true"></a> moveShip(5 * gravity, DOWN);</span> -<span id="cb193-9"><a href="#cb193-9" aria-hidden="true"></a>}</span> -<span id="cb193-10"><a href="#cb193-10" aria-hidden="true"></a>~~~~~~</span> -<span id="cb193-11"><a href="#cb193-11" aria-hidden="true"></a></span> -<span id="cb193-12"><a href="#cb193-12" aria-hidden="true"></a> ``` html</span> -<span id="cb193-13"><a href="#cb193-13" aria-hidden="true"></a> <pre></span> -<span id="cb193-14"><a href="#cb193-14" aria-hidden="true"></a> <code></span> -<span id="cb193-15"><a href="#cb193-15" aria-hidden="true"></a> // Some comments</span> -<span id="cb193-16"><a href="#cb193-16" aria-hidden="true"></a> line 1 of code</span> -<span id="cb193-17"><a href="#cb193-17" aria-hidden="true"></a> line 2 of code</span> -<span id="cb193-18"><a href="#cb193-18" aria-hidden="true"></a> line 3 of code</span> -<span id="cb193-19"><a href="#cb193-19" aria-hidden="true"></a> </code></span> -<span id="cb193-20"><a href="#cb193-20" aria-hidden="true"></a> </pre></span> -<span id="cb193-21"><a href="#cb193-21" aria-hidden="true"></a> ```</span> -<span id="cb193-22"><a href="#cb193-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb193-23"><a href="#cb193-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb194"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb194-1"><a href="#cb194-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> -<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> -<blockquote> -<div class="sourceCode" id="cb195"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb195-1"><a href="#cb195-1" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> -<span id="cb195-2"><a href="#cb195-2" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> -<span id="cb195-3"><a href="#cb195-3" aria-hidden="true"></a>}</span></code></pre></div> -<div class="sourceCode" id="cb196"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb196-1"><a href="#cb196-1" aria-hidden="true"></a><span class="kw"><pre></span></span> -<span id="cb196-2"><a href="#cb196-2" aria-hidden="true"></a> <span class="kw"><code></span></span> -<span id="cb196-3"><a href="#cb196-3" aria-hidden="true"></a> // Some comments</span> -<span id="cb196-4"><a href="#cb196-4" aria-hidden="true"></a> line 1 of code</span> -<span id="cb196-5"><a href="#cb196-5" aria-hidden="true"></a> line 2 of code</span> -<span id="cb196-6"><a href="#cb196-6" aria-hidden="true"></a> line 3 of code</span> -<span id="cb196-7"><a href="#cb196-7" aria-hidden="true"></a> <span class="kw"></code></span></span> -<span id="cb196-8"><a href="#cb196-8" aria-hidden="true"></a><span class="kw"></pre></span></span></code></pre></div> +<div class="sourceCode" id="cb196"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb196-1"><a href="#cb196-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb196-2"><a href="#cb196-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span> +<span id="cb196-3"><a href="#cb196-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span> +<span id="cb196-4"><a href="#cb196-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb196-5"><a href="#cb196-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb196-6"><a href="#cb196-6" aria-hidden="true"></a>~~~ js</span> +<span id="cb196-7"><a href="#cb196-7" aria-hidden="true"></a>if (a > 3) {</span> +<span id="cb196-8"><a href="#cb196-8" aria-hidden="true"></a> moveShip(5 * gravity, DOWN);</span> +<span id="cb196-9"><a href="#cb196-9" aria-hidden="true"></a>}</span> +<span id="cb196-10"><a href="#cb196-10" aria-hidden="true"></a>~~~~~~</span> +<span id="cb196-11"><a href="#cb196-11" aria-hidden="true"></a></span> +<span id="cb196-12"><a href="#cb196-12" aria-hidden="true"></a> ``` html</span> +<span id="cb196-13"><a href="#cb196-13" aria-hidden="true"></a> <pre></span> +<span id="cb196-14"><a href="#cb196-14" aria-hidden="true"></a> <code></span> +<span id="cb196-15"><a href="#cb196-15" aria-hidden="true"></a> // Some comments</span> +<span id="cb196-16"><a href="#cb196-16" aria-hidden="true"></a> line 1 of code</span> +<span id="cb196-17"><a href="#cb196-17" aria-hidden="true"></a> line 2 of code</span> +<span id="cb196-18"><a href="#cb196-18" aria-hidden="true"></a> line 3 of code</span> +<span id="cb196-19"><a href="#cb196-19" aria-hidden="true"></a> </code></span> +<span id="cb196-20"><a href="#cb196-20" aria-hidden="true"></a> </pre></span> +<span id="cb196-21"><a href="#cb196-21" aria-hidden="true"></a> ```</span> +<span id="cb196-22"><a href="#cb196-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb196-23"><a href="#cb196-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb197"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb197-1"><a href="#cb197-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> +<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> +<blockquote> +<div class="sourceCode" id="cb198"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb198-1"><a href="#cb198-1" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> +<span id="cb198-2"><a href="#cb198-2" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> +<span id="cb198-3"><a href="#cb198-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb199"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb199-1"><a href="#cb199-1" aria-hidden="true"></a><span class="kw"><pre></span></span> +<span id="cb199-2"><a href="#cb199-2" aria-hidden="true"></a> <span class="kw"><code></span></span> +<span id="cb199-3"><a href="#cb199-3" aria-hidden="true"></a> // Some comments</span> +<span id="cb199-4"><a href="#cb199-4" aria-hidden="true"></a> line 1 of code</span> +<span id="cb199-5"><a href="#cb199-5" aria-hidden="true"></a> line 2 of code</span> +<span id="cb199-6"><a href="#cb199-6" aria-hidden="true"></a> line 3 of code</span> +<span id="cb199-7"><a href="#cb199-7" aria-hidden="true"></a> <span class="kw"></code></span></span> +<span id="cb199-8"><a href="#cb199-8" aria-hidden="true"></a><span class="kw"></pre></span></span></code></pre></div> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-11">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb197"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb197-1"><a href="#cb197-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb197-2"><a href="#cb197-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[fencedCode = yes]</span> -<span id="cb197-3"><a href="#cb197-3" aria-hidden="true"></a><span class="fu">\definetyping</span> [js]</span> -<span id="cb197-4"><a href="#cb197-4" aria-hidden="true"></a><span class="fu">\definetyping</span> [html]</span> -<span id="cb197-5"><a href="#cb197-5" aria-hidden="true"></a><span class="fu">\setuptyping</span> [html] [option=XML]</span> -<span id="cb197-6"><a href="#cb197-6" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb197-7"><a href="#cb197-7" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb197-8"><a href="#cb197-8" aria-hidden="true"></a>~~~ js</span> -<span id="cb197-9"><a href="#cb197-9" aria-hidden="true"></a>if (a > 3) {</span> -<span id="cb197-10"><a href="#cb197-10" aria-hidden="true"></a> moveShip(5 * gravity, DOWN);</span> -<span id="cb197-11"><a href="#cb197-11" aria-hidden="true"></a>}</span> -<span id="cb197-12"><a href="#cb197-12" aria-hidden="true"></a>~~~~~~</span> -<span id="cb197-13"><a href="#cb197-13" aria-hidden="true"></a></span> -<span id="cb197-14"><a href="#cb197-14" aria-hidden="true"></a> ``` html</span> -<span id="cb197-15"><a href="#cb197-15" aria-hidden="true"></a> <pre></span> -<span id="cb197-16"><a href="#cb197-16" aria-hidden="true"></a> <code></span> -<span id="cb197-17"><a href="#cb197-17" aria-hidden="true"></a> // Some comments</span> -<span id="cb197-18"><a href="#cb197-18" aria-hidden="true"></a> line 1 of code</span> -<span id="cb197-19"><a href="#cb197-19" aria-hidden="true"></a> line 2 of code</span> -<span id="cb197-20"><a href="#cb197-20" aria-hidden="true"></a> line 3 of code</span> -<span id="cb197-21"><a href="#cb197-21" aria-hidden="true"></a> </code></span> -<span id="cb197-22"><a href="#cb197-22" aria-hidden="true"></a> </pre></span> -<span id="cb197-23"><a href="#cb197-23" aria-hidden="true"></a> ```</span> -<span id="cb197-24"><a href="#cb197-24" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb197-25"><a href="#cb197-25" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb198"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb198-1"><a href="#cb198-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> -<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> -<blockquote> -<div class="sourceCode" id="cb199"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb199-1"><a href="#cb199-1" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> -<span id="cb199-2"><a href="#cb199-2" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> -<span id="cb199-3"><a href="#cb199-3" aria-hidden="true"></a>}</span></code></pre></div> -<div class="sourceCode" id="cb200"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb200-1"><a href="#cb200-1" aria-hidden="true"></a><span class="kw"><pre></span></span> -<span id="cb200-2"><a href="#cb200-2" aria-hidden="true"></a> <span class="kw"><code></span></span> -<span id="cb200-3"><a href="#cb200-3" aria-hidden="true"></a> // Some comments</span> -<span id="cb200-4"><a href="#cb200-4" aria-hidden="true"></a> line 1 of code</span> -<span id="cb200-5"><a href="#cb200-5" aria-hidden="true"></a> line 2 of code</span> -<span id="cb200-6"><a href="#cb200-6" aria-hidden="true"></a> line 3 of code</span> -<span id="cb200-7"><a href="#cb200-7" aria-hidden="true"></a> <span class="kw"></code></span></span> -<span id="cb200-8"><a href="#cb200-8" aria-hidden="true"></a><span class="kw"></pre></span></span></code></pre></div> -</blockquote> -<h4 data-number="2.2.1.17" id="option-finalizecache"><span class="header-section-number">2.2.1.17</span> Option <code>finalizeCache</code></h4> +<div class="sourceCode" id="cb200"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb200-1"><a href="#cb200-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb200-2"><a href="#cb200-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[fencedCode = yes]</span> +<span id="cb200-3"><a href="#cb200-3" aria-hidden="true"></a><span class="fu">\definetyping</span> [js]</span> +<span id="cb200-4"><a href="#cb200-4" aria-hidden="true"></a><span class="fu">\definetyping</span> [html]</span> +<span id="cb200-5"><a href="#cb200-5" aria-hidden="true"></a><span class="fu">\setuptyping</span> [html] [option=XML]</span> +<span id="cb200-6"><a href="#cb200-6" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb200-7"><a href="#cb200-7" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb200-8"><a href="#cb200-8" aria-hidden="true"></a>~~~ js</span> +<span id="cb200-9"><a href="#cb200-9" aria-hidden="true"></a>if (a > 3) {</span> +<span id="cb200-10"><a href="#cb200-10" aria-hidden="true"></a> moveShip(5 * gravity, DOWN);</span> +<span id="cb200-11"><a href="#cb200-11" aria-hidden="true"></a>}</span> +<span id="cb200-12"><a href="#cb200-12" aria-hidden="true"></a>~~~~~~</span> +<span id="cb200-13"><a href="#cb200-13" aria-hidden="true"></a></span> +<span id="cb200-14"><a href="#cb200-14" aria-hidden="true"></a> ``` html</span> +<span id="cb200-15"><a href="#cb200-15" aria-hidden="true"></a> <pre></span> +<span id="cb200-16"><a href="#cb200-16" aria-hidden="true"></a> <code></span> +<span id="cb200-17"><a href="#cb200-17" aria-hidden="true"></a> // Some comments</span> +<span id="cb200-18"><a href="#cb200-18" aria-hidden="true"></a> line 1 of code</span> +<span id="cb200-19"><a href="#cb200-19" aria-hidden="true"></a> line 2 of code</span> +<span id="cb200-20"><a href="#cb200-20" aria-hidden="true"></a> line 3 of code</span> +<span id="cb200-21"><a href="#cb200-21" aria-hidden="true"></a> </code></span> +<span id="cb200-22"><a href="#cb200-22" aria-hidden="true"></a> </pre></span> +<span id="cb200-23"><a href="#cb200-23" aria-hidden="true"></a> ```</span> +<span id="cb200-24"><a href="#cb200-24" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb200-25"><a href="#cb200-25" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb201"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb201-1"><a href="#cb201-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> +<blockquote> +<div class="sourceCode" id="cb202"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb202-1"><a href="#cb202-1" aria-hidden="true"></a><span class="cf">if</span> (a <span class="op">></span> <span class="dv">3</span>) {</span> +<span id="cb202-2"><a href="#cb202-2" aria-hidden="true"></a> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span> +<span id="cb202-3"><a href="#cb202-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb203"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb203-1"><a href="#cb203-1" aria-hidden="true"></a><span class="kw"><pre></span></span> +<span id="cb203-2"><a href="#cb203-2" aria-hidden="true"></a> <span class="kw"><code></span></span> +<span id="cb203-3"><a href="#cb203-3" aria-hidden="true"></a> // Some comments</span> +<span id="cb203-4"><a href="#cb203-4" aria-hidden="true"></a> line 1 of code</span> +<span id="cb203-5"><a href="#cb203-5" aria-hidden="true"></a> line 2 of code</span> +<span id="cb203-6"><a href="#cb203-6" aria-hidden="true"></a> line 3 of code</span> +<span id="cb203-7"><a href="#cb203-7" aria-hidden="true"></a> <span class="kw"></code></span></span> +<span id="cb203-8"><a href="#cb203-8" aria-hidden="true"></a><span class="kw"></pre></span></span></code></pre></div> +</blockquote> +<h4 data-number="2.2.1.18" id="option-finalizecache"><span class="header-section-number">2.2.1.18</span> Option <code>finalizeCache</code></h4> <dl> <dt><code>finalizeCache</code> (default value: <code>false</code>)</dt> <dd><p>Whether an output file specified with the <strong><code>frozenCacheFileName</code></strong> option (frozen cache) that contains a mapping between an enumeration of markdown documents and their auxiliary cache files will be created.</p> @@ -2138,94 +2181,94 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-7">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb201"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb201-1"><a href="#cb201-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb201-2"><a href="#cb201-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFinalizeCache</span>{true}</span> -<span id="cb201-3"><a href="#cb201-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb201-4"><a href="#cb201-4" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb201-5"><a href="#cb201-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb201-6"><a href="#cb201-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb204"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb204-1"><a href="#cb204-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb204-2"><a href="#cb204-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFinalizeCache</span>{true}</span> +<span id="cb204-3"><a href="#cb204-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb204-4"><a href="#cb204-4" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb204-5"><a href="#cb204-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb204-6"><a href="#cb204-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb202"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb202-1"><a href="#cb202-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb205"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb205-1"><a href="#cb205-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!” A frozen cache will also be produced as we requested using the <code>finalizeCache</code> option.</p> <p>Next, change the content of <code>document.tex</code> as follows:</p> -<div class="sourceCode" id="cb203"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb203-1"><a href="#cb203-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb203-2"><a href="#cb203-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFrozenCache</span>{true}</span> -<span id="cb203-3"><a href="#cb203-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb203-4"><a href="#cb203-4" aria-hidden="true"></a>Hi *world*!</span> -<span id="cb203-5"><a href="#cb203-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb203-6"><a href="#cb203-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb206"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb206-1"><a href="#cb206-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb206-2"><a href="#cb206-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFrozenCache</span>{true}</span> +<span id="cb206-3"><a href="#cb206-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb206-4"><a href="#cb206-4" aria-hidden="true"></a>Hi *world*!</span> +<span id="cb206-5"><a href="#cb206-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb206-6"><a href="#cb206-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Last, invoke pdfTeX without shell access from the terminal:</p> -<div class="sourceCode" id="cb204"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb204-1"><a href="#cb204-1" aria-hidden="true"></a><span class="ex">pdftex</span> -no-shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb207"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb207-1"><a href="#cb207-1" aria-hidden="true"></a><span class="ex">pdftex</span> -no-shell-escape document.tex</span></code></pre></div> <p>A new PDF document named <code>document.pdf</code> should be produced and contain the same text “Hello <em>world</em>!” Since we used the contents of the frozen cache using the <code>\markdownOptionFrozenCache</code> option, we were able to typeset the document without accessing the shell or invoking Lua, but the change in the content of the markdown document from “Hello <em>world</em>!” to “Hi <em>world</em>!” was not reflected.</p> -<h5 class="unnumbered" data-number="" id="latex-example-15"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-16"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb205"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb205-1"><a href="#cb205-1" aria-hidden="true"></a><span class="bu">\documentclass</span>[finalizecache]{<span class="ex">article</span>}</span> -<span id="cb205-2"><a href="#cb205-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb205-3"><a href="#cb205-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb205-4"><a href="#cb205-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb205-5"><a href="#cb205-5" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb205-6"><a href="#cb205-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb205-7"><a href="#cb205-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb208"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb208-1"><a href="#cb208-1" aria-hidden="true"></a><span class="bu">\documentclass</span>[finalizecache]{<span class="ex">article</span>}</span> +<span id="cb208-2"><a href="#cb208-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb208-3"><a href="#cb208-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb208-4"><a href="#cb208-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb208-5"><a href="#cb208-5" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb208-6"><a href="#cb208-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb208-7"><a href="#cb208-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb206"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb206-1"><a href="#cb206-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb209"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb209-1"><a href="#cb209-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!” A frozen cache will also be produced as we requested using the <code>finalizecache</code> option.</p> <p>Next, change the content of <code>document.tex</code> as follows:</p> -<div class="sourceCode" id="cb207"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb207-1"><a href="#cb207-1" aria-hidden="true"></a><span class="bu">\documentclass</span>[frozencache]{<span class="ex">article</span>}</span> -<span id="cb207-2"><a href="#cb207-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb207-3"><a href="#cb207-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb207-4"><a href="#cb207-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb207-5"><a href="#cb207-5" aria-hidden="true"></a>Hi *world*!</span> -<span id="cb207-6"><a href="#cb207-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb207-7"><a href="#cb207-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb210"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb210-1"><a href="#cb210-1" aria-hidden="true"></a><span class="bu">\documentclass</span>[frozencache]{<span class="ex">article</span>}</span> +<span id="cb210-2"><a href="#cb210-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb210-3"><a href="#cb210-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb210-4"><a href="#cb210-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb210-5"><a href="#cb210-5" aria-hidden="true"></a>Hi *world*!</span> +<span id="cb210-6"><a href="#cb210-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb210-7"><a href="#cb210-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Last, invoke pdfTeX without shell access from the terminal:</p> -<div class="sourceCode" id="cb208"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb208-1"><a href="#cb208-1" aria-hidden="true"></a><span class="ex">pdflatex</span> -no-shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb211"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb211-1"><a href="#cb211-1" aria-hidden="true"></a><span class="ex">pdflatex</span> -no-shell-escape document.tex</span></code></pre></div> <p>A new PDF document named <code>document.pdf</code> should be produced and contain the same text “Hello <em>world</em>!” Since we used the contents of the frozen cache using the <code>\markdownOptionFrozenCache</code> option, we were able to typeset the document without accessing the shell or invoking Lua, but the change in the content of the markdown document from “Hello <em>world</em>!” to “Hi <em>world</em>!” was not reflected.</p> <h5 class="unnumbered" data-number="" id="context-example-12">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb209"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb209-1"><a href="#cb209-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb209-2"><a href="#cb209-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[finalizeCache = yes]</span> -<span id="cb209-3"><a href="#cb209-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb209-4"><a href="#cb209-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb209-5"><a href="#cb209-5" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb209-6"><a href="#cb209-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb209-7"><a href="#cb209-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb212"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb212-1"><a href="#cb212-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb212-2"><a href="#cb212-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[finalizeCache = yes]</span> +<span id="cb212-3"><a href="#cb212-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb212-4"><a href="#cb212-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb212-5"><a href="#cb212-5" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb212-6"><a href="#cb212-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb212-7"><a href="#cb212-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb210"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb210-1"><a href="#cb210-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb213"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb213-1"><a href="#cb213-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!” A frozen cache will also be produced in the <code>cache.tex</code> output file as we requested using the <code>finalizeCache</code> option.</p> <p>Next, change the content of <code>document.tex</code> as follows:</p> -<div class="sourceCode" id="cb211"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb211-1"><a href="#cb211-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb211-2"><a href="#cb211-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[frozenCache = yes]</span> -<span id="cb211-3"><a href="#cb211-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb211-4"><a href="#cb211-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb211-5"><a href="#cb211-5" aria-hidden="true"></a>Hi *world*!</span> -<span id="cb211-6"><a href="#cb211-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb211-7"><a href="#cb211-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb214"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb214-1"><a href="#cb214-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb214-2"><a href="#cb214-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[frozenCache = yes]</span> +<span id="cb214-3"><a href="#cb214-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb214-4"><a href="#cb214-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb214-5"><a href="#cb214-5" aria-hidden="true"></a>Hi *world*!</span> +<span id="cb214-6"><a href="#cb214-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb214-7"><a href="#cb214-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Last, invoke pdfTeX without shell access from the terminal:</p> -<div class="sourceCode" id="cb212"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb212-1"><a href="#cb212-1" aria-hidden="true"></a><span class="ex">texexec</span> --passon=--no-shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb215"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb215-1"><a href="#cb215-1" aria-hidden="true"></a><span class="ex">texexec</span> --passon=--no-shell-escape document.tex</span></code></pre></div> <p>A new PDF document named <code>document.pdf</code> should be produced and contain the same text “Hello <em>world</em>!” Since we used the contents of the frozen cache using the <code>\markdownOptionFrozenCache</code> option, we were able to typeset the document without accessing the shell or invoking Lua, but the change in the content of the markdown document from “Hello <em>world</em>!” to “Hi <em>world</em>!” was not reflected.</p> -<h4 data-number="2.2.1.18" id="option-footnotes"><span class="header-section-number">2.2.1.18</span> Option <code>footnotes</code></h4> +<h4 data-number="2.2.1.19" id="option-footnotes"><span class="header-section-number">2.2.1.19</span> Option <code>footnotes</code></h4> <dl> <dt><code>footnotes</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc footnote syntax extension:</p> -<div class="sourceCode" id="cb213"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb213-1"><a href="#cb213-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="cb213-2"><a href="#cb213-2" aria-hidden="true"></a></span> -<span id="cb213-3"><a href="#cb213-3" aria-hidden="true"></a><span class="ot">[^1]: </span>Here is the footnote.</span> -<span id="cb213-4"><a href="#cb213-4" aria-hidden="true"></a></span> -<span id="cb213-5"><a href="#cb213-5" aria-hidden="true"></a><span class="ot">[^longnote]: </span>Here's one with multiple blocks.</span> -<span id="cb213-6"><a href="#cb213-6" aria-hidden="true"></a></span> -<span id="cb213-7"><a href="#cb213-7" aria-hidden="true"></a><span class="in"> Subsequent paragraphs are indented to show that they</span></span> -<span id="cb213-8"><a href="#cb213-8" aria-hidden="true"></a>belong to the previous footnote.</span> -<span id="cb213-9"><a href="#cb213-9" aria-hidden="true"></a></span> -<span id="cb213-10"><a href="#cb213-10" aria-hidden="true"></a><span class="in"> { some.code }</span></span> -<span id="cb213-11"><a href="#cb213-11" aria-hidden="true"></a></span> -<span id="cb213-12"><a href="#cb213-12" aria-hidden="true"></a><span class="in"> The whole paragraph can be indented, or just the</span></span> -<span id="cb213-13"><a href="#cb213-13" aria-hidden="true"></a><span class="in"> first line. In this way, multi-paragraph footnotes</span></span> -<span id="cb213-14"><a href="#cb213-14" aria-hidden="true"></a><span class="in"> work like multi-paragraph list items.</span></span> -<span id="cb213-15"><a href="#cb213-15" aria-hidden="true"></a></span> -<span id="cb213-16"><a href="#cb213-16" aria-hidden="true"></a>This paragraph won't be part of the note, because it</span> -<span id="cb213-17"><a href="#cb213-17" aria-hidden="true"></a>isn't indented.</span></code></pre></div> +<div class="sourceCode" id="cb216"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb216-1"><a href="#cb216-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="cb216-2"><a href="#cb216-2" aria-hidden="true"></a></span> +<span id="cb216-3"><a href="#cb216-3" aria-hidden="true"></a><span class="ot">[^1]: </span>Here is the footnote.</span> +<span id="cb216-4"><a href="#cb216-4" aria-hidden="true"></a></span> +<span id="cb216-5"><a href="#cb216-5" aria-hidden="true"></a><span class="ot">[^longnote]: </span>Here's one with multiple blocks.</span> +<span id="cb216-6"><a href="#cb216-6" aria-hidden="true"></a></span> +<span id="cb216-7"><a href="#cb216-7" aria-hidden="true"></a><span class="in"> Subsequent paragraphs are indented to show that they</span></span> +<span id="cb216-8"><a href="#cb216-8" aria-hidden="true"></a>belong to the previous footnote.</span> +<span id="cb216-9"><a href="#cb216-9" aria-hidden="true"></a></span> +<span id="cb216-10"><a href="#cb216-10" aria-hidden="true"></a><span class="in"> { some.code }</span></span> +<span id="cb216-11"><a href="#cb216-11" aria-hidden="true"></a></span> +<span id="cb216-12"><a href="#cb216-12" aria-hidden="true"></a><span class="in"> The whole paragraph can be indented, or just the</span></span> +<span id="cb216-13"><a href="#cb216-13" aria-hidden="true"></a><span class="in"> first line. In this way, multi-paragraph footnotes</span></span> +<span id="cb216-14"><a href="#cb216-14" aria-hidden="true"></a><span class="in"> work like multi-paragraph list items.</span></span> +<span id="cb216-15"><a href="#cb216-15" aria-hidden="true"></a></span> +<span id="cb216-16"><a href="#cb216-16" aria-hidden="true"></a>This paragraph won't be part of the note, because it</span> +<span id="cb216-17"><a href="#cb216-17" aria-hidden="true"></a>isn't indented.</span></code></pre></div> </dd> </dl> </dd> @@ -2236,44 +2279,12 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-16"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb214"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb214-1"><a href="#cb214-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb214-2"><a href="#cb214-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[footnotes]{<span class="ex">markdown</span>}</span> -<span id="cb214-3"><a href="#cb214-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb214-4"><a href="#cb214-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb214-5"><a href="#cb214-5" aria-hidden="true"></a>Here is a footnote reference,[^1] and another.[^longnote]</span> -<span id="cb214-6"><a href="#cb214-6" aria-hidden="true"></a></span> -<span id="cb214-7"><a href="#cb214-7" aria-hidden="true"></a>[^1]: Here is the footnote.</span> -<span id="cb214-8"><a href="#cb214-8" aria-hidden="true"></a></span> -<span id="cb214-9"><a href="#cb214-9" aria-hidden="true"></a>[^longnote]: Here's one with multiple blocks.</span> -<span id="cb214-10"><a href="#cb214-10" aria-hidden="true"></a></span> -<span id="cb214-11"><a href="#cb214-11" aria-hidden="true"></a> Subsequent paragraphs are indented to show that they</span> -<span id="cb214-12"><a href="#cb214-12" aria-hidden="true"></a>belong to the previous footnote.</span> -<span id="cb214-13"><a href="#cb214-13" aria-hidden="true"></a></span> -<span id="cb214-14"><a href="#cb214-14" aria-hidden="true"></a> { some.code }</span> -<span id="cb214-15"><a href="#cb214-15" aria-hidden="true"></a></span> -<span id="cb214-16"><a href="#cb214-16" aria-hidden="true"></a> The whole paragraph can be indented, or just the</span> -<span id="cb214-17"><a href="#cb214-17" aria-hidden="true"></a> first line. In this way, multi-paragraph footnotes</span> -<span id="cb214-18"><a href="#cb214-18" aria-hidden="true"></a> work like multi-paragraph list items.</span> -<span id="cb214-19"><a href="#cb214-19" aria-hidden="true"></a></span> -<span id="cb214-20"><a href="#cb214-20" aria-hidden="true"></a>This paragraph won't be part of the note, because it</span> -<span id="cb214-21"><a href="#cb214-21" aria-hidden="true"></a>isn't indented.</span> -<span id="cb214-22"><a href="#cb214-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb214-23"><a href="#cb214-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb215"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb215-1"><a href="#cb215-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> -<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> -<blockquote> -<p>Here is a footnote reference,<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a> and another.<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a></p> -<p>This paragraph won’t be part of the note, because it isn’t indented.</p> -</blockquote> -<h5 class="unnumbered" data-number="" id="context-example-13">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-17"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb217"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb217-1"><a href="#cb217-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb217-2"><a href="#cb217-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[footnotes = yes]</span> -<span id="cb217-3"><a href="#cb217-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb217-4"><a href="#cb217-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<div class="sourceCode" id="cb217"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb217-1"><a href="#cb217-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb217-2"><a href="#cb217-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[footnotes]{<span class="ex">markdown</span>}</span> +<span id="cb217-3"><a href="#cb217-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb217-4"><a href="#cb217-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> <span id="cb217-5"><a href="#cb217-5" aria-hidden="true"></a>Here is a footnote reference,[^1] and another.[^longnote]</span> <span id="cb217-6"><a href="#cb217-6" aria-hidden="true"></a></span> <span id="cb217-7"><a href="#cb217-7" aria-hidden="true"></a>[^1]: Here is the footnote.</span> @@ -2291,16 +2302,48 @@ Thomas,Edison,1847</code></pre> <span id="cb217-19"><a href="#cb217-19" aria-hidden="true"></a></span> <span id="cb217-20"><a href="#cb217-20" aria-hidden="true"></a>This paragraph won't be part of the note, because it</span> <span id="cb217-21"><a href="#cb217-21" aria-hidden="true"></a>isn't indented.</span> -<span id="cb217-22"><a href="#cb217-22" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb217-23"><a href="#cb217-23" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<span id="cb217-22"><a href="#cb217-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb217-23"><a href="#cb217-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb218"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb218-1"><a href="#cb218-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb218"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb218-1"><a href="#cb218-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> +<blockquote> +<p>Here is a footnote reference,<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a> and another.<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a></p> +<p>This paragraph won’t be part of the note, because it isn’t indented.</p> +</blockquote> +<h5 class="unnumbered" data-number="" id="context-example-13">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb220"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb220-1"><a href="#cb220-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb220-2"><a href="#cb220-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[footnotes = yes]</span> +<span id="cb220-3"><a href="#cb220-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb220-4"><a href="#cb220-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb220-5"><a href="#cb220-5" aria-hidden="true"></a>Here is a footnote reference,[^1] and another.[^longnote]</span> +<span id="cb220-6"><a href="#cb220-6" aria-hidden="true"></a></span> +<span id="cb220-7"><a href="#cb220-7" aria-hidden="true"></a>[^1]: Here is the footnote.</span> +<span id="cb220-8"><a href="#cb220-8" aria-hidden="true"></a></span> +<span id="cb220-9"><a href="#cb220-9" aria-hidden="true"></a>[^longnote]: Here's one with multiple blocks.</span> +<span id="cb220-10"><a href="#cb220-10" aria-hidden="true"></a></span> +<span id="cb220-11"><a href="#cb220-11" aria-hidden="true"></a> Subsequent paragraphs are indented to show that they</span> +<span id="cb220-12"><a href="#cb220-12" aria-hidden="true"></a>belong to the previous footnote.</span> +<span id="cb220-13"><a href="#cb220-13" aria-hidden="true"></a></span> +<span id="cb220-14"><a href="#cb220-14" aria-hidden="true"></a> { some.code }</span> +<span id="cb220-15"><a href="#cb220-15" aria-hidden="true"></a></span> +<span id="cb220-16"><a href="#cb220-16" aria-hidden="true"></a> The whole paragraph can be indented, or just the</span> +<span id="cb220-17"><a href="#cb220-17" aria-hidden="true"></a> first line. In this way, multi-paragraph footnotes</span> +<span id="cb220-18"><a href="#cb220-18" aria-hidden="true"></a> work like multi-paragraph list items.</span> +<span id="cb220-19"><a href="#cb220-19" aria-hidden="true"></a></span> +<span id="cb220-20"><a href="#cb220-20" aria-hidden="true"></a>This paragraph won't be part of the note, because it</span> +<span id="cb220-21"><a href="#cb220-21" aria-hidden="true"></a>isn't indented.</span> +<span id="cb220-22"><a href="#cb220-22" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb220-23"><a href="#cb220-23" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb221"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb221-1"><a href="#cb221-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Here is a footnote reference,<a href="#fn3" class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</sup></a> and another.<a href="#fn4" class="footnote-ref" id="fnref4" role="doc-noteref"><sup>4</sup></a></p> <p>This paragraph won’t be part of the note, because it isn’t indented.</p> </blockquote> -<h4 data-number="2.2.1.19" id="option-frozencachecounter"><span class="header-section-number">2.2.1.19</span> Option <code>frozenCacheCounter</code></h4> +<h4 data-number="2.2.1.20" id="option-frozencachecounter"><span class="header-section-number">2.2.1.20</span> Option <code>frozenCacheCounter</code></h4> <dl> <dt><code>frozenCacheCounter</code> (default value: <code>0</code>)</dt> <dd><p>The number of the current markdown document that will be stored in an output file (frozen cache) when the <strong><code>finalizeCache</code></strong> is enabled. When the document number is 0, then a new frozen cache will be created. Otherwise, the frozen cache will be appended.</p> @@ -2309,19 +2352,19 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="lua-module-example-8">Lua Module Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb220"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb220-1"><a href="#cb220-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb220-2"><a href="#cb220-2" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb220-3"><a href="#cb220-3" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb220-4"><a href="#cb220-4" aria-hidden="true"></a> local firstConvert = markdown.new({finalizeCache = true, frozenCacheCounter = 0})</span> -<span id="cb220-5"><a href="#cb220-5" aria-hidden="true"></a> local firstInput = "Hello"</span> -<span id="cb220-6"><a href="#cb220-6" aria-hidden="true"></a> local secondConvert = markdown.new({finalizeCache = true, frozenCacheCounter = 1})</span> -<span id="cb220-7"><a href="#cb220-7" aria-hidden="true"></a> local secondInput = "*world*!"</span> -<span id="cb220-8"><a href="#cb220-8" aria-hidden="true"></a> tex.sprint(firstConvert(firstInput) .. [[ ]] .. secondConvert(secondInput)) }</span> -<span id="cb220-9"><a href="#cb220-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb223"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb223-1"><a href="#cb223-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb223-2"><a href="#cb223-2" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb223-3"><a href="#cb223-3" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb223-4"><a href="#cb223-4" aria-hidden="true"></a> local firstConvert = markdown.new({finalizeCache = true, frozenCacheCounter = 0})</span> +<span id="cb223-5"><a href="#cb223-5" aria-hidden="true"></a> local firstInput = "Hello"</span> +<span id="cb223-6"><a href="#cb223-6" aria-hidden="true"></a> local secondConvert = markdown.new({finalizeCache = true, frozenCacheCounter = 1})</span> +<span id="cb223-7"><a href="#cb223-7" aria-hidden="true"></a> local secondInput = "*world*!"</span> +<span id="cb223-8"><a href="#cb223-8" aria-hidden="true"></a> tex.sprint(firstConvert(firstInput) .. [[ ]] .. secondConvert(secondInput)) }</span> +<span id="cb223-9"><a href="#cb223-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Then, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb221"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb221-1"><a href="#cb221-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb224"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb224-1"><a href="#cb224-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!” A frozen cache with two entries will also be produced as we requested using the <code>frozenCacheCounter</code> option.</p> -<h4 data-number="2.2.1.20" id="option-hardlinebreaks"><span class="header-section-number">2.2.1.20</span> Option <code>hardLineBreaks</code></h4> +<h4 data-number="2.2.1.21" id="option-hardlinebreaks"><span class="header-section-number">2.2.1.21</span> Option <code>hardLineBreaks</code></h4> <dl> <dt><code>hardLineBreaks</code> (default value: <code>false</code>)</dt> <dd><dl> @@ -2337,43 +2380,43 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-17"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-18"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb222"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb222-1"><a href="#cb222-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb222-2"><a href="#cb222-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb222-3"><a href="#cb222-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb222-4"><a href="#cb222-4" aria-hidden="true"></a></span> -<span id="cb222-5"><a href="#cb222-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb222-6"><a href="#cb222-6" aria-hidden="true"></a>'Twas brillig, and the slithy toves</span> -<span id="cb222-7"><a href="#cb222-7" aria-hidden="true"></a>Did gyre and gimble in the wabe;</span> -<span id="cb222-8"><a href="#cb222-8" aria-hidden="true"></a>All mimsy were the borogoves,</span> -<span id="cb222-9"><a href="#cb222-9" aria-hidden="true"></a>And the mome raths outgrabe.</span> -<span id="cb222-10"><a href="#cb222-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb222-11"><a href="#cb222-11" aria-hidden="true"></a></span> -<span id="cb222-12"><a href="#cb222-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hardLineBreaks}</span> -<span id="cb222-13"><a href="#cb222-13" aria-hidden="true"></a>'Twas brillig, and the slithy toves</span> -<span id="cb222-14"><a href="#cb222-14" aria-hidden="true"></a>Did gyre and gimble in the wabe;</span> -<span id="cb222-15"><a href="#cb222-15" aria-hidden="true"></a>All mimsy were the borogoves,</span> -<span id="cb222-16"><a href="#cb222-16" aria-hidden="true"></a>And the mome raths outgrabe.</span> -<span id="cb222-17"><a href="#cb222-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb222-18"><a href="#cb222-18" aria-hidden="true"></a></span> -<span id="cb222-19"><a href="#cb222-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb223"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb223-1"><a href="#cb223-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb225"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb225-1"><a href="#cb225-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb225-2"><a href="#cb225-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb225-3"><a href="#cb225-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb225-4"><a href="#cb225-4" aria-hidden="true"></a></span> +<span id="cb225-5"><a href="#cb225-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb225-6"><a href="#cb225-6" aria-hidden="true"></a>'Twas brillig, and the slithy toves</span> +<span id="cb225-7"><a href="#cb225-7" aria-hidden="true"></a>Did gyre and gimble in the wabe;</span> +<span id="cb225-8"><a href="#cb225-8" aria-hidden="true"></a>All mimsy were the borogoves,</span> +<span id="cb225-9"><a href="#cb225-9" aria-hidden="true"></a>And the mome raths outgrabe.</span> +<span id="cb225-10"><a href="#cb225-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb225-11"><a href="#cb225-11" aria-hidden="true"></a></span> +<span id="cb225-12"><a href="#cb225-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hardLineBreaks}</span> +<span id="cb225-13"><a href="#cb225-13" aria-hidden="true"></a>'Twas brillig, and the slithy toves</span> +<span id="cb225-14"><a href="#cb225-14" aria-hidden="true"></a>Did gyre and gimble in the wabe;</span> +<span id="cb225-15"><a href="#cb225-15" aria-hidden="true"></a>All mimsy were the borogoves,</span> +<span id="cb225-16"><a href="#cb225-16" aria-hidden="true"></a>And the mome raths outgrabe.</span> +<span id="cb225-17"><a href="#cb225-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb225-18"><a href="#cb225-18" aria-hidden="true"></a></span> +<span id="cb225-19"><a href="#cb225-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb226"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb226-1"><a href="#cb226-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>’Twas brillig, and the slithy toves Did gyre and gimble in the wabe; All mimsy were the borogoves, And the mome raths outgrabe.</p> <p>’Twas brillig, and the slithy toves Did gyre and gimble in the wabe; All mimsy were the borogoves, And the mome raths outgrabe.</p> </blockquote> -<h4 data-number="2.2.1.21" id="option-hashenumerators"><span class="header-section-number">2.2.1.21</span> Option <code>hashEnumerators</code></h4> +<h4 data-number="2.2.1.22" id="option-hashenumerators"><span class="header-section-number">2.2.1.22</span> Option <code>hashEnumerators</code></h4> <dl> <dt><code>hashEnumerators</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the use of hash symbols (<code>#</code>) as ordered item list markers:</p> -<div class="sourceCode" id="cb224"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb224-1"><a href="#cb224-1" aria-hidden="true"></a>#. Bird</span> -<span id="cb224-2"><a href="#cb224-2" aria-hidden="true"></a>#. McHale</span> -<span id="cb224-3"><a href="#cb224-3" aria-hidden="true"></a>#. Parish</span></code></pre></div> +<div class="sourceCode" id="cb227"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb227-1"><a href="#cb227-1" aria-hidden="true"></a>#. Bird</span> +<span id="cb227-2"><a href="#cb227-2" aria-hidden="true"></a>#. McHale</span> +<span id="cb227-3"><a href="#cb227-3" aria-hidden="true"></a>#. Parish</span></code></pre></div> </dd> </dl> </dd> @@ -2384,27 +2427,27 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-18"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-19"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb225"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb225-1"><a href="#cb225-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb225-2"><a href="#cb225-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb225-3"><a href="#cb225-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb225-4"><a href="#cb225-4" aria-hidden="true"></a></span> -<span id="cb225-5"><a href="#cb225-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb225-6"><a href="#cb225-6" aria-hidden="true"></a>#. Bird</span> -<span id="cb225-7"><a href="#cb225-7" aria-hidden="true"></a>#. McHale</span> -<span id="cb225-8"><a href="#cb225-8" aria-hidden="true"></a>#. Parish</span> -<span id="cb225-9"><a href="#cb225-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb225-10"><a href="#cb225-10" aria-hidden="true"></a></span> -<span id="cb225-11"><a href="#cb225-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hashEnumerators}</span> -<span id="cb225-12"><a href="#cb225-12" aria-hidden="true"></a>#. Bird</span> -<span id="cb225-13"><a href="#cb225-13" aria-hidden="true"></a>#. McHale</span> -<span id="cb225-14"><a href="#cb225-14" aria-hidden="true"></a>#. Parish</span> -<span id="cb225-15"><a href="#cb225-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb225-16"><a href="#cb225-16" aria-hidden="true"></a></span> -<span id="cb225-17"><a href="#cb225-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb226"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb226-1"><a href="#cb226-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb228"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb228-1"><a href="#cb228-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb228-2"><a href="#cb228-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb228-3"><a href="#cb228-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb228-4"><a href="#cb228-4" aria-hidden="true"></a></span> +<span id="cb228-5"><a href="#cb228-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb228-6"><a href="#cb228-6" aria-hidden="true"></a>#. Bird</span> +<span id="cb228-7"><a href="#cb228-7" aria-hidden="true"></a>#. McHale</span> +<span id="cb228-8"><a href="#cb228-8" aria-hidden="true"></a>#. Parish</span> +<span id="cb228-9"><a href="#cb228-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb228-10"><a href="#cb228-10" aria-hidden="true"></a></span> +<span id="cb228-11"><a href="#cb228-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hashEnumerators}</span> +<span id="cb228-12"><a href="#cb228-12" aria-hidden="true"></a>#. Bird</span> +<span id="cb228-13"><a href="#cb228-13" aria-hidden="true"></a>#. McHale</span> +<span id="cb228-14"><a href="#cb228-14" aria-hidden="true"></a>#. Parish</span> +<span id="cb228-15"><a href="#cb228-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb228-16"><a href="#cb228-16" aria-hidden="true"></a></span> +<span id="cb228-17"><a href="#cb228-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb229"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb229-1"><a href="#cb229-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="bird">. Bird</h1> @@ -2418,25 +2461,25 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-14">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb227"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb227-1"><a href="#cb227-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb227-2"><a href="#cb227-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb227-3"><a href="#cb227-3" aria-hidden="true"></a></span> -<span id="cb227-4"><a href="#cb227-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb227-5"><a href="#cb227-5" aria-hidden="true"></a>#. Bird</span> -<span id="cb227-6"><a href="#cb227-6" aria-hidden="true"></a>#. McHale</span> -<span id="cb227-7"><a href="#cb227-7" aria-hidden="true"></a>#. Parish</span> -<span id="cb227-8"><a href="#cb227-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb227-9"><a href="#cb227-9" aria-hidden="true"></a></span> -<span id="cb227-10"><a href="#cb227-10" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hashEnumerators = yes]</span> -<span id="cb227-11"><a href="#cb227-11" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb227-12"><a href="#cb227-12" aria-hidden="true"></a>#. Bird</span> -<span id="cb227-13"><a href="#cb227-13" aria-hidden="true"></a>#. McHale</span> -<span id="cb227-14"><a href="#cb227-14" aria-hidden="true"></a>#. Parish</span> -<span id="cb227-15"><a href="#cb227-15" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb227-16"><a href="#cb227-16" aria-hidden="true"></a></span> -<span id="cb227-17"><a href="#cb227-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb228"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb228-1"><a href="#cb228-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb230"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb230-1"><a href="#cb230-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb230-2"><a href="#cb230-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb230-3"><a href="#cb230-3" aria-hidden="true"></a></span> +<span id="cb230-4"><a href="#cb230-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb230-5"><a href="#cb230-5" aria-hidden="true"></a>#. Bird</span> +<span id="cb230-6"><a href="#cb230-6" aria-hidden="true"></a>#. McHale</span> +<span id="cb230-7"><a href="#cb230-7" aria-hidden="true"></a>#. Parish</span> +<span id="cb230-8"><a href="#cb230-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb230-9"><a href="#cb230-9" aria-hidden="true"></a></span> +<span id="cb230-10"><a href="#cb230-10" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hashEnumerators = yes]</span> +<span id="cb230-11"><a href="#cb230-11" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb230-12"><a href="#cb230-12" aria-hidden="true"></a>#. Bird</span> +<span id="cb230-13"><a href="#cb230-13" aria-hidden="true"></a>#. McHale</span> +<span id="cb230-14"><a href="#cb230-14" aria-hidden="true"></a>#. Parish</span> +<span id="cb230-15"><a href="#cb230-15" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb230-16"><a href="#cb230-16" aria-hidden="true"></a></span> +<span id="cb230-17"><a href="#cb230-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb231"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb231-1"><a href="#cb231-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="bird-1">. Bird</h1> @@ -2448,18 +2491,18 @@ Thomas,Edison,1847</code></pre> <li>Parish</li> </ol> </blockquote> -<h4 data-number="2.2.1.22" id="header-attributes"><span class="header-section-number">2.2.1.22</span> Option <code>headerAttributes</code></h4> +<h4 data-number="2.2.1.23" id="header-attributes"><span class="header-section-number">2.2.1.23</span> Option <code>headerAttributes</code></h4> <dl> <dt><code>headerAttributes</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the assignment of HTML attributes to headings:</p> -<div class="sourceCode" id="cb229"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb229-1"><a href="#cb229-1" aria-hidden="true"></a><span class="fu"># My first heading {#foo}</span></span> -<span id="cb229-2"><a href="#cb229-2" aria-hidden="true"></a></span> -<span id="cb229-3"><a href="#cb229-3" aria-hidden="true"></a><span class="fu">## My second heading ## {#bar .baz}</span></span> -<span id="cb229-4"><a href="#cb229-4" aria-hidden="true"></a></span> -<span id="cb229-5"><a href="#cb229-5" aria-hidden="true"></a>Yet another heading {key=value}</span> -<span id="cb229-6"><a href="#cb229-6" aria-hidden="true"></a><span class="fu">===================</span></span></code></pre></div> +<div class="sourceCode" id="cb232"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb232-1"><a href="#cb232-1" aria-hidden="true"></a><span class="fu"># My first heading {#foo}</span></span> +<span id="cb232-2"><a href="#cb232-2" aria-hidden="true"></a></span> +<span id="cb232-3"><a href="#cb232-3" aria-hidden="true"></a><span class="fu">## My second heading ## {#bar .baz}</span></span> +<span id="cb232-4"><a href="#cb232-4" aria-hidden="true"></a></span> +<span id="cb232-5"><a href="#cb232-5" aria-hidden="true"></a>Yet another heading {key=value}</span> +<span id="cb232-6"><a href="#cb232-6" aria-hidden="true"></a><span class="fu">===================</span></span></code></pre></div> <p>These HTML attributes have currently no effect other than enabling <a href="#slice">content slicing</a>.</p> </dd> </dl> @@ -2471,7 +2514,7 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h4 data-number="2.2.1.23" id="option-html"><span class="header-section-number">2.2.1.23</span> Option <code>html</code></h4> +<h4 data-number="2.2.1.24" id="option-html"><span class="header-section-number">2.2.1.24</span> Option <code>html</code></h4> <dl> <dt><code>html</code> (default value: <code>false</code>)</dt> <dd><dl> @@ -2489,31 +2532,31 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="lua-module-example-9">Lua Module Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb230"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb230-1"><a href="#cb230-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb230-2"><a href="#cb230-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb230-3"><a href="#cb230-3" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb230-4"><a href="#cb230-4" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb230-5"><a href="#cb230-5" aria-hidden="true"></a> local convert = markdown.new()</span> -<span id="cb230-6"><a href="#cb230-6" aria-hidden="true"></a> local newline = [[^^J^^J]]</span> -<span id="cb230-7"><a href="#cb230-7" aria-hidden="true"></a> local input =</span> -<span id="cb230-8"><a href="#cb230-8" aria-hidden="true"></a> "<div>*There is no block tag support.*</div>" .. newline ..</span> -<span id="cb230-9"><a href="#cb230-9" aria-hidden="true"></a> "*There is no <inline tag="tag"></inline> support.*" .. newline ..</span> -<span id="cb230-10"><a href="#cb230-10" aria-hidden="true"></a> "_There is no <!-- comment --> support._" .. newline ..</span> -<span id="cb230-11"><a href="#cb230-11" aria-hidden="true"></a> "_There is no <? HTML instruction ?> support._"</span> -<span id="cb230-12"><a href="#cb230-12" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> -<span id="cb230-13"><a href="#cb230-13" aria-hidden="true"></a><span class="fu">\par</span></span> -<span id="cb230-14"><a href="#cb230-14" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb230-15"><a href="#cb230-15" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb230-16"><a href="#cb230-16" aria-hidden="true"></a> local convert = markdown.new({html = true})</span> -<span id="cb230-17"><a href="#cb230-17" aria-hidden="true"></a> local input =</span> -<span id="cb230-18"><a href="#cb230-18" aria-hidden="true"></a> "<div>*There is block tag support.*</div>" .. newline ..</span> -<span id="cb230-19"><a href="#cb230-19" aria-hidden="true"></a> "*There is <inline tag="tag"></inline> support.*" .. newline ..</span> -<span id="cb230-20"><a href="#cb230-20" aria-hidden="true"></a> "_There is <!-- comment --> support._" .. newline ..</span> -<span id="cb230-21"><a href="#cb230-21" aria-hidden="true"></a> "_There is <? HTML instruction ?> support._"</span> -<span id="cb230-22"><a href="#cb230-22" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> -<span id="cb230-23"><a href="#cb230-23" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb233"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb233-1"><a href="#cb233-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb233-2"><a href="#cb233-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb233-3"><a href="#cb233-3" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb233-4"><a href="#cb233-4" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb233-5"><a href="#cb233-5" aria-hidden="true"></a> local convert = markdown.new()</span> +<span id="cb233-6"><a href="#cb233-6" aria-hidden="true"></a> local newline = [[^^J^^J]]</span> +<span id="cb233-7"><a href="#cb233-7" aria-hidden="true"></a> local input =</span> +<span id="cb233-8"><a href="#cb233-8" aria-hidden="true"></a> "<div>*There is no block tag support.*</div>" .. newline ..</span> +<span id="cb233-9"><a href="#cb233-9" aria-hidden="true"></a> "*There is no <inline tag="tag"></inline> support.*" .. newline ..</span> +<span id="cb233-10"><a href="#cb233-10" aria-hidden="true"></a> "_There is no <!-- comment --> support._" .. newline ..</span> +<span id="cb233-11"><a href="#cb233-11" aria-hidden="true"></a> "_There is no <? HTML instruction ?> support._"</span> +<span id="cb233-12"><a href="#cb233-12" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> +<span id="cb233-13"><a href="#cb233-13" aria-hidden="true"></a><span class="fu">\par</span></span> +<span id="cb233-14"><a href="#cb233-14" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb233-15"><a href="#cb233-15" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb233-16"><a href="#cb233-16" aria-hidden="true"></a> local convert = markdown.new({html = true})</span> +<span id="cb233-17"><a href="#cb233-17" aria-hidden="true"></a> local input =</span> +<span id="cb233-18"><a href="#cb233-18" aria-hidden="true"></a> "<div>*There is block tag support.*</div>" .. newline ..</span> +<span id="cb233-19"><a href="#cb233-19" aria-hidden="true"></a> "*There is <inline tag="tag"></inline> support.*" .. newline ..</span> +<span id="cb233-20"><a href="#cb233-20" aria-hidden="true"></a> "_There is <!-- comment --> support._" .. newline ..</span> +<span id="cb233-21"><a href="#cb233-21" aria-hidden="true"></a> "_There is <? HTML instruction ?> support._"</span> +<span id="cb233-22"><a href="#cb233-22" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> +<span id="cb233-23"><a href="#cb233-23" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Then, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb231"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb231-1"><a href="#cb231-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb234"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb234-1"><a href="#cb234-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p><div>There is no block tag support.</div> There is no <inline tag=”tag”></inline> support. There is no <!– comment –> support. There is no <? HTML instruction ?> support.</p> @@ -2521,23 +2564,23 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="lua-cli-example-7">Lua CLI Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb232"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb232-1"><a href="#cb232-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb232-2"><a href="#cb232-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb232-3"><a href="#cb232-3" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> -<span id="cb232-4"><a href="#cb232-4" aria-hidden="true"></a><span class="fu">\par</span></span> -<span id="cb232-5"><a href="#cb232-5" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> -<span id="cb232-6"><a href="#cb232-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb235"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb235-1"><a href="#cb235-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb235-2"><a href="#cb235-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb235-3"><a href="#cb235-3" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> +<span id="cb235-4"><a href="#cb235-4" aria-hidden="true"></a><span class="fu">\par</span></span> +<span id="cb235-5"><a href="#cb235-5" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> +<span id="cb235-6"><a href="#cb235-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>content.md</code> with the following content:</p> -<div class="sourceCode" id="cb233"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb233-1"><a href="#cb233-1" aria-hidden="true"></a><span class="kw"><div></span></span> -<span id="cb233-2"><a href="#cb233-2" aria-hidden="true"></a>*Is there block tag support?*</span> -<span id="cb233-3"><a href="#cb233-3" aria-hidden="true"></a><span class="kw"></div></span></span> -<span id="cb233-4"><a href="#cb233-4" aria-hidden="true"></a>*Is there <span class="kw"><inline</span><span class="ot"> tag=</span><span class="st">"tag"</span><span class="kw">></inline></span> support?*</span> -<span id="cb233-5"><a href="#cb233-5" aria-hidden="true"></a>_Is there <span class="co"><!-- comment --></span> support?_</span> -<span id="cb233-6"><a href="#cb233-6" aria-hidden="true"></a>_Is there <span class="kw"><?</span> HTML instruction <span class="kw">?></span> support?_</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb234"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb234-1"><a href="#cb234-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> -<span id="cb234-2"><a href="#cb234-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ html=true -- content.md optiontrue.tex</span> -<span id="cb234-3"><a href="#cb234-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb236"><pre class="sourceCode html"><code class="sourceCode html"><span id="cb236-1"><a href="#cb236-1" aria-hidden="true"></a><span class="kw"><div></span></span> +<span id="cb236-2"><a href="#cb236-2" aria-hidden="true"></a>*Is there block tag support?*</span> +<span id="cb236-3"><a href="#cb236-3" aria-hidden="true"></a><span class="kw"></div></span></span> +<span id="cb236-4"><a href="#cb236-4" aria-hidden="true"></a>*Is there <span class="kw"><inline</span><span class="ot"> tag=</span><span class="st">"tag"</span><span class="kw">></inline></span> support?*</span> +<span id="cb236-5"><a href="#cb236-5" aria-hidden="true"></a>_Is there <span class="co"><!-- comment --></span> support?_</span> +<span id="cb236-6"><a href="#cb236-6" aria-hidden="true"></a>_Is there <span class="kw"><?</span> HTML instruction <span class="kw">?></span> support?_</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb237"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb237-1"><a href="#cb237-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> +<span id="cb237-2"><a href="#cb237-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ html=true -- content.md optiontrue.tex</span> +<span id="cb237-3"><a href="#cb237-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua CLI script file, such as <code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems or <code>C:\Users\</code>⟨<em>Your username</em>⟩<code>\texmf\scripts\markdown\markdown-cli.lua</code> on Windows systems. Use the command <code>kpsewhich -a markdown-cli.lua</code> to locate the Lua CLI script file using <a href="https://tug.org/kpathsea/" title="Kpathsea - TeX Users Group">Kpathsea</a>.</p> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> @@ -2546,63 +2589,63 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="plain-tex-example-8">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb235"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb235-1"><a href="#cb235-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb235-2"><a href="#cb235-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb235-3"><a href="#cb235-3" aria-hidden="true"></a></span> -<span id="cb235-4"><a href="#cb235-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb235-5"><a href="#cb235-5" aria-hidden="true"></a><div></span> -<span id="cb235-6"><a href="#cb235-6" aria-hidden="true"></a>*There is no block tag support.*</span> -<span id="cb235-7"><a href="#cb235-7" aria-hidden="true"></a></div></span> -<span id="cb235-8"><a href="#cb235-8" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> -<span id="cb235-9"><a href="#cb235-9" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> -<span id="cb235-10"><a href="#cb235-10" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> -<span id="cb235-11"><a href="#cb235-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb235-12"><a href="#cb235-12" aria-hidden="true"></a></span> -<span id="cb235-13"><a href="#cb235-13" aria-hidden="true"></a><span class="fu">\def\markdownOptionHtml</span>{true}</span> -<span id="cb235-14"><a href="#cb235-14" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb235-15"><a href="#cb235-15" aria-hidden="true"></a><div></span> -<span id="cb235-16"><a href="#cb235-16" aria-hidden="true"></a>*There is block tag support.*</span> -<span id="cb235-17"><a href="#cb235-17" aria-hidden="true"></a></div></span> -<span id="cb235-18"><a href="#cb235-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> -<span id="cb235-19"><a href="#cb235-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> -<span id="cb235-20"><a href="#cb235-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> -<span id="cb235-21"><a href="#cb235-21" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb235-22"><a href="#cb235-22" aria-hidden="true"></a></span> -<span id="cb235-23"><a href="#cb235-23" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb236"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb236-1"><a href="#cb236-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb238"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb238-1"><a href="#cb238-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb238-2"><a href="#cb238-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb238-3"><a href="#cb238-3" aria-hidden="true"></a></span> +<span id="cb238-4"><a href="#cb238-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb238-5"><a href="#cb238-5" aria-hidden="true"></a><div></span> +<span id="cb238-6"><a href="#cb238-6" aria-hidden="true"></a>*There is no block tag support.*</span> +<span id="cb238-7"><a href="#cb238-7" aria-hidden="true"></a></div></span> +<span id="cb238-8"><a href="#cb238-8" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> +<span id="cb238-9"><a href="#cb238-9" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> +<span id="cb238-10"><a href="#cb238-10" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> +<span id="cb238-11"><a href="#cb238-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb238-12"><a href="#cb238-12" aria-hidden="true"></a></span> +<span id="cb238-13"><a href="#cb238-13" aria-hidden="true"></a><span class="fu">\def\markdownOptionHtml</span>{true}</span> +<span id="cb238-14"><a href="#cb238-14" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb238-15"><a href="#cb238-15" aria-hidden="true"></a><div></span> +<span id="cb238-16"><a href="#cb238-16" aria-hidden="true"></a>*There is block tag support.*</span> +<span id="cb238-17"><a href="#cb238-17" aria-hidden="true"></a></div></span> +<span id="cb238-18"><a href="#cb238-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> +<span id="cb238-19"><a href="#cb238-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> +<span id="cb238-20"><a href="#cb238-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> +<span id="cb238-21"><a href="#cb238-21" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb238-22"><a href="#cb238-22" aria-hidden="true"></a></span> +<span id="cb238-23"><a href="#cb238-23" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb239"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb239-1"><a href="#cb239-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p><div>There is no block tag support.</div> There is no <inline tag=”tag”></inline> support. There is no <!– comment –> support. There is no <? HTML instruction ?> support.</p> <p>There is support. There is support. There is support.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-19"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-20"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb237"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb237-1"><a href="#cb237-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb237-2"><a href="#cb237-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb237-3"><a href="#cb237-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb237-4"><a href="#cb237-4" aria-hidden="true"></a></span> -<span id="cb237-5"><a href="#cb237-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb237-6"><a href="#cb237-6" aria-hidden="true"></a><div></span> -<span id="cb237-7"><a href="#cb237-7" aria-hidden="true"></a>*There is no block tag support.*</span> -<span id="cb237-8"><a href="#cb237-8" aria-hidden="true"></a></div></span> -<span id="cb237-9"><a href="#cb237-9" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> -<span id="cb237-10"><a href="#cb237-10" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> -<span id="cb237-11"><a href="#cb237-11" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> -<span id="cb237-12"><a href="#cb237-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb237-13"><a href="#cb237-13" aria-hidden="true"></a></span> -<span id="cb237-14"><a href="#cb237-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{html}</span> -<span id="cb237-15"><a href="#cb237-15" aria-hidden="true"></a><div></span> -<span id="cb237-16"><a href="#cb237-16" aria-hidden="true"></a>*There is block tag support.*</span> -<span id="cb237-17"><a href="#cb237-17" aria-hidden="true"></a></div></span> -<span id="cb237-18"><a href="#cb237-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> -<span id="cb237-19"><a href="#cb237-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> -<span id="cb237-20"><a href="#cb237-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> -<span id="cb237-21"><a href="#cb237-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb237-22"><a href="#cb237-22" aria-hidden="true"></a></span> -<span id="cb237-23"><a href="#cb237-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb238"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb238-1"><a href="#cb238-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb240"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb240-1"><a href="#cb240-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb240-2"><a href="#cb240-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb240-3"><a href="#cb240-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb240-4"><a href="#cb240-4" aria-hidden="true"></a></span> +<span id="cb240-5"><a href="#cb240-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb240-6"><a href="#cb240-6" aria-hidden="true"></a><div></span> +<span id="cb240-7"><a href="#cb240-7" aria-hidden="true"></a>*There is no block tag support.*</span> +<span id="cb240-8"><a href="#cb240-8" aria-hidden="true"></a></div></span> +<span id="cb240-9"><a href="#cb240-9" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> +<span id="cb240-10"><a href="#cb240-10" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> +<span id="cb240-11"><a href="#cb240-11" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> +<span id="cb240-12"><a href="#cb240-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb240-13"><a href="#cb240-13" aria-hidden="true"></a></span> +<span id="cb240-14"><a href="#cb240-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{html}</span> +<span id="cb240-15"><a href="#cb240-15" aria-hidden="true"></a><div></span> +<span id="cb240-16"><a href="#cb240-16" aria-hidden="true"></a>*There is block tag support.*</span> +<span id="cb240-17"><a href="#cb240-17" aria-hidden="true"></a></div></span> +<span id="cb240-18"><a href="#cb240-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> +<span id="cb240-19"><a href="#cb240-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> +<span id="cb240-20"><a href="#cb240-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> +<span id="cb240-21"><a href="#cb240-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb240-22"><a href="#cb240-22" aria-hidden="true"></a></span> +<span id="cb240-23"><a href="#cb240-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb241"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb241-1"><a href="#cb241-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p><div>There is no block tag support.</div> There is no <inline tag=”tag”></inline> support. There is no <!– comment –> support. There is no <? HTML instruction ?> support.</p> @@ -2610,37 +2653,37 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-15">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb239"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb239-1"><a href="#cb239-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb239-2"><a href="#cb239-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb239-3"><a href="#cb239-3" aria-hidden="true"></a></span> -<span id="cb239-4"><a href="#cb239-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb239-5"><a href="#cb239-5" aria-hidden="true"></a><div></span> -<span id="cb239-6"><a href="#cb239-6" aria-hidden="true"></a>*There is no block tag support.*</span> -<span id="cb239-7"><a href="#cb239-7" aria-hidden="true"></a></div></span> -<span id="cb239-8"><a href="#cb239-8" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> -<span id="cb239-9"><a href="#cb239-9" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> -<span id="cb239-10"><a href="#cb239-10" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> -<span id="cb239-11"><a href="#cb239-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb239-12"><a href="#cb239-12" aria-hidden="true"></a></span> -<span id="cb239-13"><a href="#cb239-13" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[html = yes]</span> -<span id="cb239-14"><a href="#cb239-14" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb239-15"><a href="#cb239-15" aria-hidden="true"></a><div></span> -<span id="cb239-16"><a href="#cb239-16" aria-hidden="true"></a>*There is block tag support.*</span> -<span id="cb239-17"><a href="#cb239-17" aria-hidden="true"></a></div></span> -<span id="cb239-18"><a href="#cb239-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> -<span id="cb239-19"><a href="#cb239-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> -<span id="cb239-20"><a href="#cb239-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> -<span id="cb239-21"><a href="#cb239-21" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb239-22"><a href="#cb239-22" aria-hidden="true"></a></span> -<span id="cb239-23"><a href="#cb239-23" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb240"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb240-1"><a href="#cb240-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb242"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb242-1"><a href="#cb242-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb242-2"><a href="#cb242-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb242-3"><a href="#cb242-3" aria-hidden="true"></a></span> +<span id="cb242-4"><a href="#cb242-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb242-5"><a href="#cb242-5" aria-hidden="true"></a><div></span> +<span id="cb242-6"><a href="#cb242-6" aria-hidden="true"></a>*There is no block tag support.*</span> +<span id="cb242-7"><a href="#cb242-7" aria-hidden="true"></a></div></span> +<span id="cb242-8"><a href="#cb242-8" aria-hidden="true"></a>*There is no <inline tag="tag"></inline> support.*</span> +<span id="cb242-9"><a href="#cb242-9" aria-hidden="true"></a>_There is no <!-- comment --> support._</span> +<span id="cb242-10"><a href="#cb242-10" aria-hidden="true"></a>_There is no <? HTML instruction ?> support._</span> +<span id="cb242-11"><a href="#cb242-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb242-12"><a href="#cb242-12" aria-hidden="true"></a></span> +<span id="cb242-13"><a href="#cb242-13" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[html = yes]</span> +<span id="cb242-14"><a href="#cb242-14" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb242-15"><a href="#cb242-15" aria-hidden="true"></a><div></span> +<span id="cb242-16"><a href="#cb242-16" aria-hidden="true"></a>*There is block tag support.*</span> +<span id="cb242-17"><a href="#cb242-17" aria-hidden="true"></a></div></span> +<span id="cb242-18"><a href="#cb242-18" aria-hidden="true"></a>*There is <inline tag="tag"></inline> support.*</span> +<span id="cb242-19"><a href="#cb242-19" aria-hidden="true"></a>_There is <!-- comment --> support._</span> +<span id="cb242-20"><a href="#cb242-20" aria-hidden="true"></a>_There is <? HTML instruction ?> support._</span> +<span id="cb242-21"><a href="#cb242-21" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb242-22"><a href="#cb242-22" aria-hidden="true"></a></span> +<span id="cb242-23"><a href="#cb242-23" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb243"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb243-1"><a href="#cb243-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p><div>There is no block tag support.</div> There is no <inline tag=”tag”></inline> support. There is no <!– comment –> support. There is no <? HTML instruction ?> support.</p> <p>There is support. There is support. There is support.</p> </blockquote> -<h4 data-number="2.2.1.24" id="option-hybrid"><span class="header-section-number">2.2.1.24</span> Option <code>hybrid</code></h4> +<h4 data-number="2.2.1.25" id="option-hybrid"><span class="header-section-number">2.2.1.25</span> Option <code>hybrid</code></h4> <dl> <dt><code>hybrid</code> (default value: <code>false</code>)</dt> <dd><dl> @@ -2658,25 +2701,25 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="lua-module-example-10">Lua Module Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb241"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb241-1"><a href="#cb241-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb241-2"><a href="#cb241-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb241-3"><a href="#cb241-3" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb241-4"><a href="#cb241-4" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb241-5"><a href="#cb241-5" aria-hidden="true"></a> local input, convert_safe, convert_unsafe, paragraph</span> -<span id="cb241-6"><a href="#cb241-6" aria-hidden="true"></a></span> -<span id="cb241-7"><a href="#cb241-7" aria-hidden="true"></a> input = [[<span class="ss">$</span><span class="sc">\string\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.]]</span> -<span id="cb241-8"><a href="#cb241-8" aria-hidden="true"></a> convert_safe = markdown.new()</span> -<span id="cb241-9"><a href="#cb241-9" aria-hidden="true"></a> convert_unsafe = markdown.new({hybrid = true})</span> -<span id="cb241-10"><a href="#cb241-10" aria-hidden="true"></a> paragraph = [[<span class="fu">\par</span>]]</span> -<span id="cb241-11"><a href="#cb241-11" aria-hidden="true"></a></span> -<span id="cb241-12"><a href="#cb241-12" aria-hidden="true"></a> tex.sprint(</span> -<span id="cb241-13"><a href="#cb241-13" aria-hidden="true"></a> convert_safe(input) .. paragraph ..</span> -<span id="cb241-14"><a href="#cb241-14" aria-hidden="true"></a> convert_unsafe(input)</span> -<span id="cb241-15"><a href="#cb241-15" aria-hidden="true"></a> )</span> -<span id="cb241-16"><a href="#cb241-16" aria-hidden="true"></a>}</span> -<span id="cb241-17"><a href="#cb241-17" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb244"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb244-1"><a href="#cb244-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb244-2"><a href="#cb244-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb244-3"><a href="#cb244-3" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb244-4"><a href="#cb244-4" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb244-5"><a href="#cb244-5" aria-hidden="true"></a> local input, convert_safe, convert_unsafe, paragraph</span> +<span id="cb244-6"><a href="#cb244-6" aria-hidden="true"></a></span> +<span id="cb244-7"><a href="#cb244-7" aria-hidden="true"></a> input = [[<span class="ss">$</span><span class="sc">\string\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.]]</span> +<span id="cb244-8"><a href="#cb244-8" aria-hidden="true"></a> convert_safe = markdown.new()</span> +<span id="cb244-9"><a href="#cb244-9" aria-hidden="true"></a> convert_unsafe = markdown.new({hybrid = true})</span> +<span id="cb244-10"><a href="#cb244-10" aria-hidden="true"></a> paragraph = [[<span class="fu">\par</span>]]</span> +<span id="cb244-11"><a href="#cb244-11" aria-hidden="true"></a></span> +<span id="cb244-12"><a href="#cb244-12" aria-hidden="true"></a> tex.sprint(</span> +<span id="cb244-13"><a href="#cb244-13" aria-hidden="true"></a> convert_safe(input) .. paragraph ..</span> +<span id="cb244-14"><a href="#cb244-14" aria-hidden="true"></a> convert_unsafe(input)</span> +<span id="cb244-15"><a href="#cb244-15" aria-hidden="true"></a> )</span> +<span id="cb244-16"><a href="#cb244-16" aria-hidden="true"></a>}</span> +<span id="cb244-17"><a href="#cb244-17" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Then, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb242"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb242-1"><a href="#cb242-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb245"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb245-1"><a href="#cb245-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt {-1}$ <em>equals</em> $i$.</p> @@ -2684,21 +2727,21 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="lua-cli-example-8">Lua CLI Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb243"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb243-1"><a href="#cb243-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb243-2"><a href="#cb243-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb243-3"><a href="#cb243-3" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> -<span id="cb243-4"><a href="#cb243-4" aria-hidden="true"></a></span> -<span id="cb243-5"><a href="#cb243-5" aria-hidden="true"></a><span class="fu">\begingroup</span></span> -<span id="cb243-6"><a href="#cb243-6" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span> -<span id="cb243-7"><a href="#cb243-7" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> -<span id="cb243-8"><a href="#cb243-8" aria-hidden="true"></a><span class="fu">\endgroup</span></span> -<span id="cb243-9"><a href="#cb243-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb246"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb246-1"><a href="#cb246-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb246-2"><a href="#cb246-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb246-3"><a href="#cb246-3" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> +<span id="cb246-4"><a href="#cb246-4" aria-hidden="true"></a></span> +<span id="cb246-5"><a href="#cb246-5" aria-hidden="true"></a><span class="fu">\begingroup</span></span> +<span id="cb246-6"><a href="#cb246-6" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span> +<span id="cb246-7"><a href="#cb246-7" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> +<span id="cb246-8"><a href="#cb246-8" aria-hidden="true"></a><span class="fu">\endgroup</span></span> +<span id="cb246-9"><a href="#cb246-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>content.md</code> with the following content:</p> -<div class="sourceCode" id="cb244"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb244-1"><a href="#cb244-1" aria-hidden="true"></a>$\sqrt{-1}$ *equals* $i$.</span></code></pre></div> +<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>$\sqrt{-1}$ *equals* $i$.</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb245"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb245-1"><a href="#cb245-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> -<span id="cb245-2"><a href="#cb245-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ hybrid=true -- content.md optiontrue.tex</span> -<span id="cb245-3"><a href="#cb245-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb248"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb248-1"><a href="#cb248-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> +<span id="cb248-2"><a href="#cb248-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ hybrid=true -- content.md optiontrue.tex</span> +<span id="cb248-3"><a href="#cb248-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua CLI script file, such as <code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems or <code>C:\Users\</code>⟨<em>Your username</em>⟩<code>\texmf\scripts\markdown\markdown-cli.lua</code> on Windows systems. Use the command <code>kpsewhich -a markdown-cli.lua</code> to locate the Lua CLI script file using <a href="https://tug.org/kpathsea/" title="Kpathsea - TeX Users Group">Kpathsea</a>.</p> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> @@ -2707,43 +2750,43 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="plain-tex-example-9">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb246"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb246-1"><a href="#cb246-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb246-2"><a href="#cb246-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb246-3"><a href="#cb246-3" aria-hidden="true"></a></span> -<span id="cb246-4"><a href="#cb246-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb246-5"><a href="#cb246-5" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb246-6"><a href="#cb246-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb246-7"><a href="#cb246-7" aria-hidden="true"></a></span> -<span id="cb246-8"><a href="#cb246-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> -<span id="cb246-9"><a href="#cb246-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb246-10"><a href="#cb246-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb246-11"><a href="#cb246-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb246-12"><a href="#cb246-12" aria-hidden="true"></a></span> -<span id="cb246-13"><a href="#cb246-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb249"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb249-1"><a href="#cb249-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb249-2"><a href="#cb249-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb249-3"><a href="#cb249-3" aria-hidden="true"></a></span> +<span id="cb249-4"><a href="#cb249-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb249-5"><a href="#cb249-5" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb249-6"><a href="#cb249-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb249-7"><a href="#cb249-7" aria-hidden="true"></a></span> +<span id="cb249-8"><a href="#cb249-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> +<span id="cb249-9"><a href="#cb249-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb249-10"><a href="#cb249-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb249-11"><a href="#cb249-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb249-12"><a href="#cb249-12" aria-hidden="true"></a></span> +<span id="cb249-13"><a href="#cb249-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb247"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb247-1"><a href="#cb247-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb250"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb250-1"><a href="#cb250-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt {-1}$ <em>equals</em> $i$.</p> <p>√-̅1̅ <em>equals</em> <span class="math inline"><em>i</em></span>.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-20"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-21"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb248"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb248-1"><a href="#cb248-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb248-2"><a href="#cb248-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb248-3"><a href="#cb248-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb248-4"><a href="#cb248-4" aria-hidden="true"></a></span> -<span id="cb248-5"><a href="#cb248-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb248-6"><a href="#cb248-6" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb248-7"><a href="#cb248-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb248-8"><a href="#cb248-8" aria-hidden="true"></a></span> -<span id="cb248-9"><a href="#cb248-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hybrid}</span> -<span id="cb248-10"><a href="#cb248-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb248-11"><a href="#cb248-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb248-12"><a href="#cb248-12" aria-hidden="true"></a></span> -<span id="cb248-13"><a href="#cb248-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb251"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb251-1"><a href="#cb251-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb251-2"><a href="#cb251-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb251-3"><a href="#cb251-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb251-4"><a href="#cb251-4" aria-hidden="true"></a></span> +<span id="cb251-5"><a href="#cb251-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb251-6"><a href="#cb251-6" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb251-7"><a href="#cb251-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb251-8"><a href="#cb251-8" aria-hidden="true"></a></span> +<span id="cb251-9"><a href="#cb251-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hybrid}</span> +<span id="cb251-10"><a href="#cb251-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb251-11"><a href="#cb251-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb251-12"><a href="#cb251-12" aria-hidden="true"></a></span> +<span id="cb251-13"><a href="#cb251-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb249"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb249-1"><a href="#cb249-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb252"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb252-1"><a href="#cb252-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt {-1}$ <em>equals</em> $i$.</p> @@ -2751,35 +2794,35 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-16">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb250"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb250-1"><a href="#cb250-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb250-2"><a href="#cb250-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb250-3"><a href="#cb250-3" aria-hidden="true"></a></span> -<span id="cb250-4"><a href="#cb250-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb250-5"><a href="#cb250-5" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb250-6"><a href="#cb250-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb250-7"><a href="#cb250-7" aria-hidden="true"></a></span> -<span id="cb250-8"><a href="#cb250-8" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> -<span id="cb250-9"><a href="#cb250-9" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb250-10"><a href="#cb250-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> -<span id="cb250-11"><a href="#cb250-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb250-12"><a href="#cb250-12" aria-hidden="true"></a></span> -<span id="cb250-13"><a href="#cb250-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb253"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb253-1"><a href="#cb253-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb253-2"><a href="#cb253-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb253-3"><a href="#cb253-3" aria-hidden="true"></a></span> +<span id="cb253-4"><a href="#cb253-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb253-5"><a href="#cb253-5" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb253-6"><a href="#cb253-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb253-7"><a href="#cb253-7" aria-hidden="true"></a></span> +<span id="cb253-8"><a href="#cb253-8" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> +<span id="cb253-9"><a href="#cb253-9" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb253-10"><a href="#cb253-10" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span> +<span id="cb253-11"><a href="#cb253-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb253-12"><a href="#cb253-12" aria-hidden="true"></a></span> +<span id="cb253-13"><a href="#cb253-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb251"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb251-1"><a href="#cb251-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb254"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb254-1"><a href="#cb254-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt {-1}$ <em>equals</em> $i$.</p> <p>√-̅1̅ <em>equals</em> <span class="math inline"><em>i</em></span>.</p> </blockquote> -<h4 data-number="2.2.1.25" id="option-inlinefootnotes"><span class="header-section-number">2.2.1.25</span> Option <code>inlineFootnotes</code></h4> +<h4 data-number="2.2.1.26" id="option-inlinefootnotes"><span class="header-section-number">2.2.1.26</span> Option <code>inlineFootnotes</code></h4> <dl> <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> -<div class="sourceCode" id="cb252"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb252-1"><a href="#cb252-1" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> -<span id="cb252-2"><a href="#cb252-2" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> -<span id="cb252-3"><a href="#cb252-3" aria-hidden="true"></a>move down to type the note.]</span></code></pre></div> +<div class="sourceCode" id="cb255"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb255-1"><a href="#cb255-1" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> +<span id="cb255-2"><a href="#cb255-2" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> +<span id="cb255-3"><a href="#cb255-3" aria-hidden="true"></a>move down to type the note.]</span></code></pre></div> </dd> </dl> </dd> @@ -2790,57 +2833,57 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-21"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-22"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb253"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb253-1"><a href="#cb253-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb253-2"><a href="#cb253-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[inlineFootnotes]{<span class="ex">markdown</span>}</span> -<span id="cb253-3"><a href="#cb253-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb253-4"><a href="#cb253-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb253-5"><a href="#cb253-5" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> -<span id="cb253-6"><a href="#cb253-6" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> -<span id="cb253-7"><a href="#cb253-7" aria-hidden="true"></a>move down to type the note.]</span> -<span id="cb253-8"><a href="#cb253-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb253-9"><a href="#cb253-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb256"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb256-1"><a href="#cb256-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb256-2"><a href="#cb256-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[inlineFootnotes]{<span class="ex">markdown</span>}</span> +<span id="cb256-3"><a href="#cb256-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb256-4"><a href="#cb256-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb256-5"><a href="#cb256-5" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> +<span id="cb256-6"><a href="#cb256-6" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> +<span id="cb256-7"><a href="#cb256-7" aria-hidden="true"></a>move down to type the note.]</span> +<span id="cb256-8"><a href="#cb256-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb256-9"><a href="#cb256-9" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb254"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb254-1"><a href="#cb254-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb257"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb257-1"><a href="#cb257-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Here is an inline note.<a href="#fn5" class="footnote-ref" id="fnref5" role="doc-noteref"><sup>5</sup></a></p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-17">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb255"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb255-1"><a href="#cb255-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb255-2"><a href="#cb255-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[inlineFootnotes = yes]</span> -<span id="cb255-3"><a href="#cb255-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb255-4"><a href="#cb255-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb255-5"><a href="#cb255-5" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> -<span id="cb255-6"><a href="#cb255-6" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> -<span id="cb255-7"><a href="#cb255-7" aria-hidden="true"></a>move down to type the note.]</span> -<span id="cb255-8"><a href="#cb255-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb255-9"><a href="#cb255-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb258"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb258-1"><a href="#cb258-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb258-2"><a href="#cb258-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[inlineFootnotes = yes]</span> +<span id="cb258-3"><a href="#cb258-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb258-4"><a href="#cb258-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb258-5"><a href="#cb258-5" aria-hidden="true"></a>Here is an inline note.^[Inlines notes are easier to</span> +<span id="cb258-6"><a href="#cb258-6" aria-hidden="true"></a>write, since you don't have to pick an identifier and</span> +<span id="cb258-7"><a href="#cb258-7" aria-hidden="true"></a>move down to type the note.]</span> +<span id="cb258-8"><a href="#cb258-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb258-9"><a href="#cb258-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb256"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb256-1"><a href="#cb256-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb259"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb259-1"><a href="#cb259-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Here is an inline note.<a href="#fn6" class="footnote-ref" id="fnref6" role="doc-noteref"><sup>6</sup></a></p> </blockquote> -<h4 data-number="2.2.1.26" id="option-jekylldata"><span class="header-section-number">2.2.1.26</span> Option <code>jekyllData</code></h4> +<h4 data-number="2.2.1.27" id="option-jekylldata"><span class="header-section-number">2.2.1.27</span> Option <code>jekyllData</code></h4> <dl> <dt><code>jekyllData</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc <code>yaml_metadata_block</code> syntax extension for entering metadata in <abbr>yaml</abbr>:</p> -<div class="sourceCode" id="cb257"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb257-1"><a href="#cb257-1" aria-hidden="true"></a><span class="pp">---</span></span> -<span id="cb257-2"><a href="#cb257-2" aria-hidden="true"></a><span class="fu">title</span><span class="kw">:</span><span class="at"> </span><span class="st">'This is the title: it contains a colon'</span></span> -<span id="cb257-3"><a href="#cb257-3" aria-hidden="true"></a><span class="fu">author</span><span class="kw">:</span></span> -<span id="cb257-4"><a href="#cb257-4" aria-hidden="true"></a><span class="kw">-</span><span class="at"> Author One</span></span> -<span id="cb257-5"><a href="#cb257-5" aria-hidden="true"></a><span class="kw">-</span><span class="at"> Author Two</span></span> -<span id="cb257-6"><a href="#cb257-6" aria-hidden="true"></a><span class="fu">keywords</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">nothing</span><span class="kw">,</span><span class="at"> nothingness</span><span class="kw">]</span></span> -<span id="cb257-7"><a href="#cb257-7" aria-hidden="true"></a><span class="fu">abstract</span><span class="kw">: </span><span class="ch">|</span></span> -<span id="cb257-8"><a href="#cb257-8" aria-hidden="true"></a> This is the abstract.</span> -<span id="cb257-9"><a href="#cb257-9" aria-hidden="true"></a></span> -<span id="cb257-10"><a href="#cb257-10" aria-hidden="true"></a> It consists of two paragraphs.</span> -<span id="cb257-11"><a href="#cb257-11" aria-hidden="true"></a><span class="pp">---</span></span></code></pre></div> +<div class="sourceCode" id="cb260"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb260-1"><a href="#cb260-1" aria-hidden="true"></a><span class="pp">---</span></span> +<span id="cb260-2"><a href="#cb260-2" aria-hidden="true"></a><span class="fu">title</span><span class="kw">:</span><span class="at"> </span><span class="st">'This is the title: it contains a colon'</span></span> +<span id="cb260-3"><a href="#cb260-3" aria-hidden="true"></a><span class="fu">author</span><span class="kw">:</span></span> +<span id="cb260-4"><a href="#cb260-4" aria-hidden="true"></a><span class="kw">-</span><span class="at"> Author One</span></span> +<span id="cb260-5"><a href="#cb260-5" aria-hidden="true"></a><span class="kw">-</span><span class="at"> Author Two</span></span> +<span id="cb260-6"><a href="#cb260-6" aria-hidden="true"></a><span class="fu">keywords</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">nothing</span><span class="kw">,</span><span class="at"> nothingness</span><span class="kw">]</span></span> +<span id="cb260-7"><a href="#cb260-7" aria-hidden="true"></a><span class="fu">abstract</span><span class="kw">: </span><span class="ch">|</span></span> +<span id="cb260-8"><a href="#cb260-8" aria-hidden="true"></a> This is the abstract.</span> +<span id="cb260-9"><a href="#cb260-9" aria-hidden="true"></a></span> +<span id="cb260-10"><a href="#cb260-10" aria-hidden="true"></a> It consists of two paragraphs.</span> +<span id="cb260-11"><a href="#cb260-11" aria-hidden="true"></a><span class="pp">---</span></span></code></pre></div> </dd> </dl> </dd> @@ -2853,101 +2896,101 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-10">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb258"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb258-1"><a href="#cb258-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb258-2"><a href="#cb258-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> -<span id="cb258-3"><a href="#cb258-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> -<span id="cb258-4"><a href="#cb258-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> -<span id="cb258-5"><a href="#cb258-5" aria-hidden="true"></a> { markdown/jekyllData }</span> -<span id="cb258-6"><a href="#cb258-6" aria-hidden="true"></a> {</span> -<span id="cb258-7"><a href="#cb258-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> -<span id="cb258-8"><a href="#cb258-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> -<span id="cb258-9"><a href="#cb258-9" aria-hidden="true"></a> }</span> -<span id="cb258-10"><a href="#cb258-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> -<span id="cb258-11"><a href="#cb258-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb258-12"><a href="#cb258-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb258-13"><a href="#cb258-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb258-14"><a href="#cb258-14" aria-hidden="true"></a>---</span> -<span id="cb258-15"><a href="#cb258-15" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb258-16"><a href="#cb258-16" aria-hidden="true"></a>age: 99</span> -<span id="cb258-17"><a href="#cb258-17" aria-hidden="true"></a>---</span> -<span id="cb258-18"><a href="#cb258-18" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb258-19"><a href="#cb258-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb259"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb259-1"><a href="#cb259-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb261"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb261-1"><a href="#cb261-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb261-2"><a href="#cb261-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> +<span id="cb261-3"><a href="#cb261-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> +<span id="cb261-4"><a href="#cb261-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> +<span id="cb261-5"><a href="#cb261-5" aria-hidden="true"></a> { markdown/jekyllData }</span> +<span id="cb261-6"><a href="#cb261-6" aria-hidden="true"></a> {</span> +<span id="cb261-7"><a href="#cb261-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> +<span id="cb261-8"><a href="#cb261-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> +<span id="cb261-9"><a href="#cb261-9" aria-hidden="true"></a> }</span> +<span id="cb261-10"><a href="#cb261-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> +<span id="cb261-11"><a href="#cb261-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb261-12"><a href="#cb261-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb261-13"><a href="#cb261-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb261-14"><a href="#cb261-14" aria-hidden="true"></a>---</span> +<span id="cb261-15"><a href="#cb261-15" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb261-16"><a href="#cb261-16" aria-hidden="true"></a>age: 99</span> +<span id="cb261-17"><a href="#cb261-17" aria-hidden="true"></a>---</span> +<span id="cb261-18"><a href="#cb261-18" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb261-19"><a href="#cb261-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb262"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb262-1"><a href="#cb262-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-22"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-23"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb260"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb260-1"><a href="#cb260-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb260-2"><a href="#cb260-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb260-3"><a href="#cb260-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb260-4"><a href="#cb260-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> -<span id="cb260-5"><a href="#cb260-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> -<span id="cb260-6"><a href="#cb260-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> -<span id="cb260-7"><a href="#cb260-7" aria-hidden="true"></a> },</span> -<span id="cb260-8"><a href="#cb260-8" aria-hidden="true"></a> renderers = {</span> -<span id="cb260-9"><a href="#cb260-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> -<span id="cb260-10"><a href="#cb260-10" aria-hidden="true"></a> }</span> -<span id="cb260-11"><a href="#cb260-11" aria-hidden="true"></a>}</span> -<span id="cb260-12"><a href="#cb260-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb260-13"><a href="#cb260-13" aria-hidden="true"></a></span> -<span id="cb260-14"><a href="#cb260-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb260-15"><a href="#cb260-15" aria-hidden="true"></a>---</span> -<span id="cb260-16"><a href="#cb260-16" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb260-17"><a href="#cb260-17" aria-hidden="true"></a>age: 99</span> -<span id="cb260-18"><a href="#cb260-18" aria-hidden="true"></a>---</span> -<span id="cb260-19"><a href="#cb260-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb260-20"><a href="#cb260-20" aria-hidden="true"></a></span> -<span id="cb260-21"><a href="#cb260-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb261"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb261-1"><a href="#cb261-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb263"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb263-1"><a href="#cb263-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb263-2"><a href="#cb263-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb263-3"><a href="#cb263-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb263-4"><a href="#cb263-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> +<span id="cb263-5"><a href="#cb263-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> +<span id="cb263-6"><a href="#cb263-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> +<span id="cb263-7"><a href="#cb263-7" aria-hidden="true"></a> },</span> +<span id="cb263-8"><a href="#cb263-8" aria-hidden="true"></a> renderers = {</span> +<span id="cb263-9"><a href="#cb263-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> +<span id="cb263-10"><a href="#cb263-10" aria-hidden="true"></a> }</span> +<span id="cb263-11"><a href="#cb263-11" aria-hidden="true"></a>}</span> +<span id="cb263-12"><a href="#cb263-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb263-13"><a href="#cb263-13" aria-hidden="true"></a></span> +<span id="cb263-14"><a href="#cb263-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb263-15"><a href="#cb263-15" aria-hidden="true"></a>---</span> +<span id="cb263-16"><a href="#cb263-16" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb263-17"><a href="#cb263-17" aria-hidden="true"></a>age: 99</span> +<span id="cb263-18"><a href="#cb263-18" aria-hidden="true"></a>---</span> +<span id="cb263-19"><a href="#cb263-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb263-20"><a href="#cb263-20" aria-hidden="true"></a></span> +<span id="cb263-21"><a href="#cb263-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb264"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb264-1"><a href="#cb264-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-18">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb262"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb262-1"><a href="#cb262-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb262-2"><a href="#cb262-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> -<span id="cb262-3"><a href="#cb262-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> -<span id="cb262-4"><a href="#cb262-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> -<span id="cb262-5"><a href="#cb262-5" aria-hidden="true"></a> { markdown/jekyllData }</span> -<span id="cb262-6"><a href="#cb262-6" aria-hidden="true"></a> {</span> -<span id="cb262-7"><a href="#cb262-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> -<span id="cb262-8"><a href="#cb262-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> -<span id="cb262-9"><a href="#cb262-9" aria-hidden="true"></a> }</span> -<span id="cb262-10"><a href="#cb262-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> -<span id="cb262-11"><a href="#cb262-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb262-12"><a href="#cb262-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb262-13"><a href="#cb262-13" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb262-14"><a href="#cb262-14" aria-hidden="true"></a></span> -<span id="cb262-15"><a href="#cb262-15" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb262-16"><a href="#cb262-16" aria-hidden="true"></a>---</span> -<span id="cb262-17"><a href="#cb262-17" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb262-18"><a href="#cb262-18" aria-hidden="true"></a>age: 99</span> -<span id="cb262-19"><a href="#cb262-19" aria-hidden="true"></a>---</span> -<span id="cb262-20"><a href="#cb262-20" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb262-21"><a href="#cb262-21" aria-hidden="true"></a></span> -<span id="cb262-22"><a href="#cb262-22" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb263"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb263-1"><a href="#cb263-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb265"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb265-1"><a href="#cb265-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb265-2"><a href="#cb265-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> +<span id="cb265-3"><a href="#cb265-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> +<span id="cb265-4"><a href="#cb265-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> +<span id="cb265-5"><a href="#cb265-5" aria-hidden="true"></a> { markdown/jekyllData }</span> +<span id="cb265-6"><a href="#cb265-6" aria-hidden="true"></a> {</span> +<span id="cb265-7"><a href="#cb265-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> +<span id="cb265-8"><a href="#cb265-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> +<span id="cb265-9"><a href="#cb265-9" aria-hidden="true"></a> }</span> +<span id="cb265-10"><a href="#cb265-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> +<span id="cb265-11"><a href="#cb265-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb265-12"><a href="#cb265-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb265-13"><a href="#cb265-13" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb265-14"><a href="#cb265-14" aria-hidden="true"></a></span> +<span id="cb265-15"><a href="#cb265-15" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb265-16"><a href="#cb265-16" aria-hidden="true"></a>---</span> +<span id="cb265-17"><a href="#cb265-17" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb265-18"><a href="#cb265-18" aria-hidden="true"></a>age: 99</span> +<span id="cb265-19"><a href="#cb265-19" aria-hidden="true"></a>---</span> +<span id="cb265-20"><a href="#cb265-20" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb265-21"><a href="#cb265-21" aria-hidden="true"></a></span> +<span id="cb265-22"><a href="#cb265-22" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb266"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb266-1"><a href="#cb266-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> -<h4 data-number="2.2.1.27" id="pipe-tables"><span class="header-section-number">2.2.1.27</span> Option <code>pipeTables</code></h4> +<h4 data-number="2.2.1.28" id="pipe-tables"><span class="header-section-number">2.2.1.28</span> Option <code>pipeTables</code></h4> <dl> <dt><code>pipeTables</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the <abbr>PHP</abbr> Markdown pipe table syntax extension:</p> -<div class="sourceCode" id="cb264"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb264-1"><a href="#cb264-1" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb264-2"><a href="#cb264-2" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb264-3"><a href="#cb264-3" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb264-4"><a href="#cb264-4" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb264-5"><a href="#cb264-5" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span></code></pre></div> +<div class="sourceCode" id="cb267"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb267-1"><a href="#cb267-1" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb267-2"><a href="#cb267-2" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb267-3"><a href="#cb267-3" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb267-4"><a href="#cb267-4" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb267-5"><a href="#cb267-5" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span></code></pre></div> </dd> </dl> </dd> @@ -2958,21 +3001,21 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-23"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-24"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb265"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb265-1"><a href="#cb265-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb265-2"><a href="#cb265-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables]{<span class="ex">markdown</span>}</span> -<span id="cb265-3"><a href="#cb265-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb265-4"><a href="#cb265-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb265-5"><a href="#cb265-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb265-6"><a href="#cb265-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb265-7"><a href="#cb265-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb265-8"><a href="#cb265-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb265-9"><a href="#cb265-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb265-10"><a href="#cb265-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb265-11"><a href="#cb265-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb268"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb268-1"><a href="#cb268-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb268-2"><a href="#cb268-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables]{<span class="ex">markdown</span>}</span> +<span id="cb268-3"><a href="#cb268-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb268-4"><a href="#cb268-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb268-5"><a href="#cb268-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb268-6"><a href="#cb268-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb268-7"><a href="#cb268-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb268-8"><a href="#cb268-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb268-9"><a href="#cb268-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb268-10"><a href="#cb268-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb268-11"><a href="#cb268-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb266"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb266-1"><a href="#cb266-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb269"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb269-1"><a href="#cb269-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <table> @@ -3008,19 +3051,19 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-19">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb267"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb267-1"><a href="#cb267-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb267-2"><a href="#cb267-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[pipeTables = yes]</span> -<span id="cb267-3"><a href="#cb267-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb267-4"><a href="#cb267-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb267-5"><a href="#cb267-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb267-6"><a href="#cb267-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb267-7"><a href="#cb267-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb267-8"><a href="#cb267-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb267-9"><a href="#cb267-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb267-10"><a href="#cb267-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb267-11"><a href="#cb267-11" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb270"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb270-1"><a href="#cb270-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb270-2"><a href="#cb270-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[pipeTables = yes]</span> +<span id="cb270-3"><a href="#cb270-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb270-4"><a href="#cb270-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb270-5"><a href="#cb270-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb270-6"><a href="#cb270-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb270-7"><a href="#cb270-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb270-8"><a href="#cb270-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb270-9"><a href="#cb270-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb270-10"><a href="#cb270-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb270-11"><a href="#cb270-11" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb268"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb268-1"><a href="#cb268-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb271"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb271-1"><a href="#cb271-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <table> @@ -3054,7 +3097,7 @@ Thomas,Edison,1847</code></pre> </tbody> </table> </blockquote> -<h4 data-number="2.2.1.28" id="option-preservetabs"><span class="header-section-number">2.2.1.28</span> Option <code>preserveTabs</code></h4> +<h4 data-number="2.2.1.29" id="option-preservetabs"><span class="header-section-number">2.2.1.29</span> Option <code>preserveTabs</code></h4> <dl> <dt><code>preserveTabs</code> (default value: <code>false</code>)</dt> <dd><dl> @@ -3070,19 +3113,19 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h4 data-number="2.2.1.29" id="option-relativereferences"><span class="header-section-number">2.2.1.29</span> Option <code>relativeReferences</code></h4> +<h4 data-number="2.2.1.30" id="option-relativereferences"><span class="header-section-number">2.2.1.30</span> Option <code>relativeReferences</code></h4> <dl> <dt><code>relativeReferences</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable <a href="https://datatracker.ietf.org/doc/html/rfc3986#section-4.2">relative references</a> in autolinks:</p> -<div class="sourceCode" id="cb269"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb269-1"><a href="#cb269-1" aria-hidden="true"></a>I conclude in Section <#conclusion>.</span> -<span id="cb269-2"><a href="#cb269-2" aria-hidden="true"></a></span> -<span id="cb269-3"><a href="#cb269-3" aria-hidden="true"></a>Conclusion {#conclusion}</span> -<span id="cb269-4"><a href="#cb269-4" aria-hidden="true"></a><span class="fu">==========</span></span> -<span id="cb269-5"><a href="#cb269-5" aria-hidden="true"></a>In this paper, we have discovered that most</span> -<span id="cb269-6"><a href="#cb269-6" aria-hidden="true"></a>grandmas would rather eat dinner with their</span> -<span id="cb269-7"><a href="#cb269-7" aria-hidden="true"></a>grandchildren than get eaten. Begone, wolf!</span></code></pre></div> +<div class="sourceCode" id="cb272"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb272-1"><a href="#cb272-1" aria-hidden="true"></a>I conclude in Section <#conclusion>.</span> +<span id="cb272-2"><a href="#cb272-2" aria-hidden="true"></a></span> +<span id="cb272-3"><a href="#cb272-3" aria-hidden="true"></a>Conclusion {#conclusion}</span> +<span id="cb272-4"><a href="#cb272-4" aria-hidden="true"></a><span class="fu">==========</span></span> +<span id="cb272-5"><a href="#cb272-5" aria-hidden="true"></a>In this paper, we have discovered that most</span> +<span id="cb272-6"><a href="#cb272-6" aria-hidden="true"></a>grandmas would rather eat dinner with their</span> +<span id="cb272-7"><a href="#cb272-7" aria-hidden="true"></a>grandchildren than get eaten. Begone, wolf!</span></code></pre></div> </dd> </dl> </dd> @@ -3093,33 +3136,33 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-24"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-25"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb270"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb270-1"><a href="#cb270-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb270-2"><a href="#cb270-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes, relativeReferences]{<span class="ex">markdown</span>}</span> -<span id="cb270-3"><a href="#cb270-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb270-4"><a href="#cb270-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb270-5"><a href="#cb270-5" aria-hidden="true"></a></span> -<span id="cb270-6"><a href="#cb270-6" aria-hidden="true"></a>I conclude in Section <#conclusion>.</span> -<span id="cb270-7"><a href="#cb270-7" aria-hidden="true"></a></span> -<span id="cb270-8"><a href="#cb270-8" aria-hidden="true"></a>Conclusion {#conclusion}</span> -<span id="cb270-9"><a href="#cb270-9" aria-hidden="true"></a>==========</span> -<span id="cb270-10"><a href="#cb270-10" aria-hidden="true"></a>In this paper, we have discovered that most</span> -<span id="cb270-11"><a href="#cb270-11" aria-hidden="true"></a>grandmas would rather eat dinner with their</span> -<span id="cb270-12"><a href="#cb270-12" aria-hidden="true"></a>grandchildren than get eaten. Begone, wolf!</span> -<span id="cb270-13"><a href="#cb270-13" aria-hidden="true"></a></span> -<span id="cb270-14"><a href="#cb270-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb270-15"><a href="#cb270-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb273"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb273-1"><a href="#cb273-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb273-2"><a href="#cb273-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes, relativeReferences]{<span class="ex">markdown</span>}</span> +<span id="cb273-3"><a href="#cb273-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb273-4"><a href="#cb273-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb273-5"><a href="#cb273-5" aria-hidden="true"></a></span> +<span id="cb273-6"><a href="#cb273-6" aria-hidden="true"></a>I conclude in Section <#conclusion>.</span> +<span id="cb273-7"><a href="#cb273-7" aria-hidden="true"></a></span> +<span id="cb273-8"><a href="#cb273-8" aria-hidden="true"></a>Conclusion {#conclusion}</span> +<span id="cb273-9"><a href="#cb273-9" aria-hidden="true"></a>==========</span> +<span id="cb273-10"><a href="#cb273-10" aria-hidden="true"></a>In this paper, we have discovered that most</span> +<span id="cb273-11"><a href="#cb273-11" aria-hidden="true"></a>grandmas would rather eat dinner with their</span> +<span id="cb273-12"><a href="#cb273-12" aria-hidden="true"></a>grandchildren than get eaten. Begone, wolf!</span> +<span id="cb273-13"><a href="#cb273-13" aria-hidden="true"></a></span> +<span id="cb273-14"><a href="#cb273-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb273-15"><a href="#cb273-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX twice from the terminal:</p> -<div class="sourceCode" id="cb271"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb271-1"><a href="#cb271-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> -<span id="cb271-2"><a href="#cb271-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb274"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb274-1"><a href="#cb274-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> +<span id="cb274-2"><a href="#cb274-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>I conclude in Section 1.</p> <h1 id="conclusion">1. Conclusion</h1> <p>In this paper, we have discovered that most grandmas would rather eat dinner with their grandchildren than get eaten. Begone, wolf!</p> </blockquote> -<h4 data-number="2.2.1.30" id="option-shiftheadings"><span class="header-section-number">2.2.1.30</span> Option <code>shiftHeadings</code></h4> +<h4 data-number="2.2.1.31" id="option-shiftheadings"><span class="header-section-number">2.2.1.31</span> Option <code>shiftHeadings</code></h4> <dl> <dt><code>shiftHeadings</code> (default value: <code>0</code>)</dt> <dd><p>All headings will be shifted by ⟨<em>shift amount</em>⟩, which can be both positive and negative. Headings will not be shifted beyond level 6 or below level 1. Instead, those headings will be shifted to level 6, when ⟨<em>shift amount</em>⟩ is positive, and to level 1, when ⟨<em>shift amount</em>⟩ is negative.</p> @@ -3127,48 +3170,48 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-11">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>example.md</code> with the following content:</p> -<div class="sourceCode" id="cb272"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb272-1"><a href="#cb272-1" aria-hidden="true"></a><span class="fu">## A section</span></span></code></pre></div> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb273"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb273-1"><a href="#cb273-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb273-2"><a href="#cb273-2" aria-hidden="true"></a></span> -<span id="cb273-3"><a href="#cb273-3" aria-hidden="true"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span> -<span id="cb273-4"><a href="#cb273-4" aria-hidden="true"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span> -<span id="cb273-5"><a href="#cb273-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span> -<span id="cb273-6"><a href="#cb273-6" aria-hidden="true"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span> -<span id="cb273-7"><a href="#cb273-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span> -<span id="cb273-8"><a href="#cb273-8" aria-hidden="true"></a></span> -<span id="cb273-9"><a href="#cb273-9" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{-1}</span> -<span id="cb273-10"><a href="#cb273-10" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb273-11"><a href="#cb273-11" aria-hidden="true"></a></span> -<span id="cb273-12"><a href="#cb273-12" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{0}</span> -<span id="cb273-13"><a href="#cb273-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb273-14"><a href="#cb273-14" aria-hidden="true"></a></span> -<span id="cb273-15"><a href="#cb273-15" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{+1}</span> -<span id="cb273-16"><a href="#cb273-16" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb273-17"><a href="#cb273-17" aria-hidden="true"></a></span> -<span id="cb273-18"><a href="#cb273-18" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb274"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb274-1"><a href="#cb274-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb275"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb275-1"><a href="#cb275-1" aria-hidden="true"></a><span class="fu">## A section</span></span></code></pre></div> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb276"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb276-1"><a href="#cb276-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb276-2"><a href="#cb276-2" aria-hidden="true"></a></span> +<span id="cb276-3"><a href="#cb276-3" aria-hidden="true"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span> +<span id="cb276-4"><a href="#cb276-4" aria-hidden="true"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span> +<span id="cb276-5"><a href="#cb276-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span> +<span id="cb276-6"><a href="#cb276-6" aria-hidden="true"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span> +<span id="cb276-7"><a href="#cb276-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span> +<span id="cb276-8"><a href="#cb276-8" aria-hidden="true"></a></span> +<span id="cb276-9"><a href="#cb276-9" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{-1}</span> +<span id="cb276-10"><a href="#cb276-10" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb276-11"><a href="#cb276-11" aria-hidden="true"></a></span> +<span id="cb276-12"><a href="#cb276-12" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{0}</span> +<span id="cb276-13"><a href="#cb276-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb276-14"><a href="#cb276-14" aria-hidden="true"></a></span> +<span id="cb276-15"><a href="#cb276-15" aria-hidden="true"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{+1}</span> +<span id="cb276-16"><a href="#cb276-16" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb276-17"><a href="#cb276-17" aria-hidden="true"></a></span> +<span id="cb276-18"><a href="#cb276-18" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb277"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb277-1"><a href="#cb277-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="a-section">A section</h1> <h2 id="a-section-1">A section</h2> <h3 id="a-section-2">A section</h3> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-25"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-26"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb275"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb275-1"><a href="#cb275-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb275-2"><a href="#cb275-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb275-3"><a href="#cb275-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{example.md}</span> -<span id="cb275-4"><a href="#cb275-4" aria-hidden="true"></a>## A section</span> -<span id="cb275-5"><a href="#cb275-5" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> -<span id="cb275-6"><a href="#cb275-6" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb275-7"><a href="#cb275-7" aria-hidden="true"></a><span class="fu">\markdownInput</span>[shiftHeadings=-1]{example.md}</span> -<span id="cb275-8"><a href="#cb275-8" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb275-9"><a href="#cb275-9" aria-hidden="true"></a><span class="fu">\markdownInput</span>[shiftHeadings=+1]{example.md}</span> -<span id="cb275-10"><a href="#cb275-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb278"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb278-1"><a href="#cb278-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb278-2"><a href="#cb278-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb278-3"><a href="#cb278-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{example.md}</span> +<span id="cb278-4"><a href="#cb278-4" aria-hidden="true"></a>## A section</span> +<span id="cb278-5"><a href="#cb278-5" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> +<span id="cb278-6"><a href="#cb278-6" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb278-7"><a href="#cb278-7" aria-hidden="true"></a><span class="fu">\markdownInput</span>[shiftHeadings=-1]{example.md}</span> +<span id="cb278-8"><a href="#cb278-8" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb278-9"><a href="#cb278-9" aria-hidden="true"></a><span class="fu">\markdownInput</span>[shiftHeadings=+1]{example.md}</span> +<span id="cb278-10"><a href="#cb278-10" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb276"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb276-1"><a href="#cb276-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb279"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb279-1"><a href="#cb279-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="a-section-3">A section</h1> @@ -3177,25 +3220,25 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-20">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>example.md</code> with the following content:</p> -<div class="sourceCode" id="cb277"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb277-1"><a href="#cb277-1" aria-hidden="true"></a><span class="fu">## A section</span></span></code></pre></div> +<div class="sourceCode" id="cb280"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb280-1"><a href="#cb280-1" aria-hidden="true"></a><span class="fu">## A section</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb278"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb278-1"><a href="#cb278-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb278-2"><a href="#cb278-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb278-3"><a href="#cb278-3" aria-hidden="true"></a></span> -<span id="cb278-4"><a href="#cb278-4" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = -1]{example.md}</span> -<span id="cb278-5"><a href="#cb278-5" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = 0]{example.md}</span> -<span id="cb278-6"><a href="#cb278-6" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = +1]{example.md}</span> -<span id="cb278-7"><a href="#cb278-7" aria-hidden="true"></a></span> -<span id="cb278-8"><a href="#cb278-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb281"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb281-1"><a href="#cb281-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb281-2"><a href="#cb281-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb281-3"><a href="#cb281-3" aria-hidden="true"></a></span> +<span id="cb281-4"><a href="#cb281-4" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = -1]{example.md}</span> +<span id="cb281-5"><a href="#cb281-5" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = 0]{example.md}</span> +<span id="cb281-6"><a href="#cb281-6" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = +1]{example.md}</span> +<span id="cb281-7"><a href="#cb281-7" aria-hidden="true"></a></span> +<span id="cb281-8"><a href="#cb281-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb279"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb279-1"><a href="#cb279-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb282"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb282-1"><a href="#cb282-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="a-section-6">A section</h1> <h2 id="a-section-7">A section</h2> <h3 id="a-section-8">A section</h3> </blockquote> -<h4 data-number="2.2.1.31" id="slice"><span class="header-section-number">2.2.1.31</span> Option <code>slice</code></h4> +<h4 data-number="2.2.1.32" id="slice"><span class="header-section-number">2.2.1.32</span> Option <code>slice</code></h4> <dl> <dt><code>slice</code> (default value: <code>^ $</code>)</dt> <dd><p>Two space-separated selectors that specify the slice of a document that will be processed, whereas the remainder of the document will be ignored. The following selectors are recognized:</p> @@ -3211,39 +3254,39 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-12">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>hamlet.md</code> with the following content:</p> -<div class="sourceCode" id="cb280"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb280-1"><a href="#cb280-1" aria-hidden="true"></a><span class="fu"># The Tragedy of Hamlet</span></span> -<span id="cb280-2"><a href="#cb280-2" aria-hidden="true"></a>Shakespeare's longest play.</span> -<span id="cb280-3"><a href="#cb280-3" aria-hidden="true"></a></span> -<span id="cb280-4"><a href="#cb280-4" aria-hidden="true"></a><span class="fu">## Act III {#act-3}</span></span> -<span id="cb280-5"><a href="#cb280-5" aria-hidden="true"></a>Hamlet kills Polonius.</span> -<span id="cb280-6"><a href="#cb280-6" aria-hidden="true"></a></span> -<span id="cb280-7"><a href="#cb280-7" aria-hidden="true"></a><span class="fu">## Act V {#act-5}</span></span> -<span id="cb280-8"><a href="#cb280-8" aria-hidden="true"></a>Hamlet dies.</span> -<span id="cb280-9"><a href="#cb280-9" aria-hidden="true"></a></span> -<span id="cb280-10"><a href="#cb280-10" aria-hidden="true"></a><span class="fu">## Act I {#act-1}</span></span> -<span id="cb280-11"><a href="#cb280-11" aria-hidden="true"></a>Hamlet talks to ghost.</span></code></pre></div> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb281"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb281-1"><a href="#cb281-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb281-2"><a href="#cb281-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionHeaderAttributes</span>{true}</span> -<span id="cb281-3"><a href="#cb281-3" aria-hidden="true"></a></span> -<span id="cb281-4"><a href="#cb281-4" aria-hidden="true"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span> -<span id="cb281-5"><a href="#cb281-5" aria-hidden="true"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span> -<span id="cb281-6"><a href="#cb281-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span> -<span id="cb281-7"><a href="#cb281-7" aria-hidden="true"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span> -<span id="cb281-8"><a href="#cb281-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span> -<span id="cb281-9"><a href="#cb281-9" aria-hidden="true"></a></span> -<span id="cb281-10"><a href="#cb281-10" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{^ ^act-3}</span> -<span id="cb281-11"><a href="#cb281-11" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> -<span id="cb281-12"><a href="#cb281-12" aria-hidden="true"></a></span> -<span id="cb281-13"><a href="#cb281-13" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{act-1}</span> -<span id="cb281-14"><a href="#cb281-14" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> -<span id="cb281-15"><a href="#cb281-15" aria-hidden="true"></a></span> -<span id="cb281-16"><a href="#cb281-16" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{act-3 act-5}</span> -<span id="cb281-17"><a href="#cb281-17" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> -<span id="cb281-18"><a href="#cb281-18" aria-hidden="true"></a></span> -<span id="cb281-19"><a href="#cb281-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb282"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb282-1"><a href="#cb282-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb283"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb283-1"><a href="#cb283-1" aria-hidden="true"></a><span class="fu"># The Tragedy of Hamlet</span></span> +<span id="cb283-2"><a href="#cb283-2" aria-hidden="true"></a>Shakespeare's longest play.</span> +<span id="cb283-3"><a href="#cb283-3" aria-hidden="true"></a></span> +<span id="cb283-4"><a href="#cb283-4" aria-hidden="true"></a><span class="fu">## Act III {#act-3}</span></span> +<span id="cb283-5"><a href="#cb283-5" aria-hidden="true"></a>Hamlet kills Polonius.</span> +<span id="cb283-6"><a href="#cb283-6" aria-hidden="true"></a></span> +<span id="cb283-7"><a href="#cb283-7" aria-hidden="true"></a><span class="fu">## Act V {#act-5}</span></span> +<span id="cb283-8"><a href="#cb283-8" aria-hidden="true"></a>Hamlet dies.</span> +<span id="cb283-9"><a href="#cb283-9" aria-hidden="true"></a></span> +<span id="cb283-10"><a href="#cb283-10" aria-hidden="true"></a><span class="fu">## Act I {#act-1}</span></span> +<span id="cb283-11"><a href="#cb283-11" aria-hidden="true"></a>Hamlet talks to ghost.</span></code></pre></div> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb284"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb284-1"><a href="#cb284-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb284-2"><a href="#cb284-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionHeaderAttributes</span>{true}</span> +<span id="cb284-3"><a href="#cb284-3" aria-hidden="true"></a></span> +<span id="cb284-4"><a href="#cb284-4" aria-hidden="true"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span> +<span id="cb284-5"><a href="#cb284-5" aria-hidden="true"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span> +<span id="cb284-6"><a href="#cb284-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span> +<span id="cb284-7"><a href="#cb284-7" aria-hidden="true"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span> +<span id="cb284-8"><a href="#cb284-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span> +<span id="cb284-9"><a href="#cb284-9" aria-hidden="true"></a></span> +<span id="cb284-10"><a href="#cb284-10" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{^ ^act-3}</span> +<span id="cb284-11"><a href="#cb284-11" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> +<span id="cb284-12"><a href="#cb284-12" aria-hidden="true"></a></span> +<span id="cb284-13"><a href="#cb284-13" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{act-1}</span> +<span id="cb284-14"><a href="#cb284-14" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> +<span id="cb284-15"><a href="#cb284-15" aria-hidden="true"></a></span> +<span id="cb284-16"><a href="#cb284-16" aria-hidden="true"></a><span class="fu">\def\markdownOptionSlice</span>{act-3 act-5}</span> +<span id="cb284-17"><a href="#cb284-17" aria-hidden="true"></a><span class="fu">\markdownInput</span>{hamlet.md}</span> +<span id="cb284-18"><a href="#cb284-18" aria-hidden="true"></a></span> +<span id="cb284-19"><a href="#cb284-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb285"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb285-1"><a href="#cb285-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="the-tragedy-of-hamlet">The Tragedy of Hamlet</h1> @@ -3255,30 +3298,30 @@ Thomas,Edison,1847</code></pre> <h2 id="act-v">Act V</h2> <p>Hamlet dies.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-26"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-27"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb283"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb283-1"><a href="#cb283-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb283-2"><a href="#cb283-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span> -<span id="cb283-3"><a href="#cb283-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{hamlet.md}</span> -<span id="cb283-4"><a href="#cb283-4" aria-hidden="true"></a># The Tragedy of Hamlet</span> -<span id="cb283-5"><a href="#cb283-5" aria-hidden="true"></a>Shakespeare's longest play.</span> -<span id="cb283-6"><a href="#cb283-6" aria-hidden="true"></a></span> -<span id="cb283-7"><a href="#cb283-7" aria-hidden="true"></a>## Act III {#act-3}</span> -<span id="cb283-8"><a href="#cb283-8" aria-hidden="true"></a>Hamlet kills Polonius.</span> -<span id="cb283-9"><a href="#cb283-9" aria-hidden="true"></a></span> -<span id="cb283-10"><a href="#cb283-10" aria-hidden="true"></a>## Act V {#act-5}</span> -<span id="cb283-11"><a href="#cb283-11" aria-hidden="true"></a>Hamlet dies.</span> -<span id="cb283-12"><a href="#cb283-12" aria-hidden="true"></a></span> -<span id="cb283-13"><a href="#cb283-13" aria-hidden="true"></a>## Act I {#act-1}</span> -<span id="cb283-14"><a href="#cb283-14" aria-hidden="true"></a>Hamlet talks to ghost.</span> -<span id="cb283-15"><a href="#cb283-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> -<span id="cb283-16"><a href="#cb283-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb283-17"><a href="#cb283-17" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=^ ^act-3]{hamlet.md}</span> -<span id="cb283-18"><a href="#cb283-18" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=act-1]{hamlet.md}</span> -<span id="cb283-19"><a href="#cb283-19" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=act-3 act-5]{hamlet.md}</span> -<span id="cb283-20"><a href="#cb283-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb284"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb284-1"><a href="#cb284-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb286"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb286-1"><a href="#cb286-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb286-2"><a href="#cb286-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span> +<span id="cb286-3"><a href="#cb286-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{hamlet.md}</span> +<span id="cb286-4"><a href="#cb286-4" aria-hidden="true"></a># The Tragedy of Hamlet</span> +<span id="cb286-5"><a href="#cb286-5" aria-hidden="true"></a>Shakespeare's longest play.</span> +<span id="cb286-6"><a href="#cb286-6" aria-hidden="true"></a></span> +<span id="cb286-7"><a href="#cb286-7" aria-hidden="true"></a>## Act III {#act-3}</span> +<span id="cb286-8"><a href="#cb286-8" aria-hidden="true"></a>Hamlet kills Polonius.</span> +<span id="cb286-9"><a href="#cb286-9" aria-hidden="true"></a></span> +<span id="cb286-10"><a href="#cb286-10" aria-hidden="true"></a>## Act V {#act-5}</span> +<span id="cb286-11"><a href="#cb286-11" aria-hidden="true"></a>Hamlet dies.</span> +<span id="cb286-12"><a href="#cb286-12" aria-hidden="true"></a></span> +<span id="cb286-13"><a href="#cb286-13" aria-hidden="true"></a>## Act I {#act-1}</span> +<span id="cb286-14"><a href="#cb286-14" aria-hidden="true"></a>Hamlet talks to ghost.</span> +<span id="cb286-15"><a href="#cb286-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> +<span id="cb286-16"><a href="#cb286-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb286-17"><a href="#cb286-17" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=^ ^act-3]{hamlet.md}</span> +<span id="cb286-18"><a href="#cb286-18" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=act-1]{hamlet.md}</span> +<span id="cb286-19"><a href="#cb286-19" aria-hidden="true"></a><span class="fu">\markdownInput</span>[slice=act-3 act-5]{hamlet.md}</span> +<span id="cb286-20"><a href="#cb286-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb287"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb287-1"><a href="#cb287-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="the-tragedy-of-hamlet-1">The Tragedy of Hamlet</h1> @@ -3292,29 +3335,29 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-21">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>hamlet.md</code> with the following content:</p> -<div class="sourceCode" id="cb285"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb285-1"><a href="#cb285-1" aria-hidden="true"></a><span class="fu"># The Tragedy of Hamlet</span></span> -<span id="cb285-2"><a href="#cb285-2" aria-hidden="true"></a>Shakespeare's longest play.</span> -<span id="cb285-3"><a href="#cb285-3" aria-hidden="true"></a></span> -<span id="cb285-4"><a href="#cb285-4" aria-hidden="true"></a><span class="fu">## Act III {#act-3}</span></span> -<span id="cb285-5"><a href="#cb285-5" aria-hidden="true"></a>Hamlet kills Polonius.</span> -<span id="cb285-6"><a href="#cb285-6" aria-hidden="true"></a></span> -<span id="cb285-7"><a href="#cb285-7" aria-hidden="true"></a><span class="fu">## Act V {#act-5}</span></span> -<span id="cb285-8"><a href="#cb285-8" aria-hidden="true"></a>Hamlet dies.</span> -<span id="cb285-9"><a href="#cb285-9" aria-hidden="true"></a></span> -<span id="cb285-10"><a href="#cb285-10" aria-hidden="true"></a><span class="fu">## Act I {#act-1}</span></span> -<span id="cb285-11"><a href="#cb285-11" aria-hidden="true"></a>Hamlet talks to ghost.</span></code></pre></div> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb286"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb286-1"><a href="#cb286-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb286-2"><a href="#cb286-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[headerAttributes = yes]</span> -<span id="cb286-3"><a href="#cb286-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb286-4"><a href="#cb286-4" aria-hidden="true"></a></span> -<span id="cb286-5"><a href="#cb286-5" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = ^ ^act-3]{example.md}</span> -<span id="cb286-6"><a href="#cb286-6" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = act-1]{example.md}</span> -<span id="cb286-7"><a href="#cb286-7" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = act-3 act-5]{example.md}</span> -<span id="cb286-8"><a href="#cb286-8" aria-hidden="true"></a></span> -<span id="cb286-9"><a href="#cb286-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb287"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb287-1"><a href="#cb287-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb288"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb288-1"><a href="#cb288-1" aria-hidden="true"></a><span class="fu"># The Tragedy of Hamlet</span></span> +<span id="cb288-2"><a href="#cb288-2" aria-hidden="true"></a>Shakespeare's longest play.</span> +<span id="cb288-3"><a href="#cb288-3" aria-hidden="true"></a></span> +<span id="cb288-4"><a href="#cb288-4" aria-hidden="true"></a><span class="fu">## Act III {#act-3}</span></span> +<span id="cb288-5"><a href="#cb288-5" aria-hidden="true"></a>Hamlet kills Polonius.</span> +<span id="cb288-6"><a href="#cb288-6" aria-hidden="true"></a></span> +<span id="cb288-7"><a href="#cb288-7" aria-hidden="true"></a><span class="fu">## Act V {#act-5}</span></span> +<span id="cb288-8"><a href="#cb288-8" aria-hidden="true"></a>Hamlet dies.</span> +<span id="cb288-9"><a href="#cb288-9" aria-hidden="true"></a></span> +<span id="cb288-10"><a href="#cb288-10" aria-hidden="true"></a><span class="fu">## Act I {#act-1}</span></span> +<span id="cb288-11"><a href="#cb288-11" aria-hidden="true"></a>Hamlet talks to ghost.</span></code></pre></div> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb289"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb289-1"><a href="#cb289-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb289-2"><a href="#cb289-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[headerAttributes = yes]</span> +<span id="cb289-3"><a href="#cb289-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb289-4"><a href="#cb289-4" aria-hidden="true"></a></span> +<span id="cb289-5"><a href="#cb289-5" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = ^ ^act-3]{example.md}</span> +<span id="cb289-6"><a href="#cb289-6" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = act-1]{example.md}</span> +<span id="cb289-7"><a href="#cb289-7" aria-hidden="true"></a><span class="fu">\inputmarkdown</span>[slice = act-3 act-5]{example.md}</span> +<span id="cb289-8"><a href="#cb289-8" aria-hidden="true"></a></span> +<span id="cb289-9"><a href="#cb289-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb290"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb290-1"><a href="#cb290-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="the-tragedy-of-hamlet-2">The Tragedy of Hamlet</h1> @@ -3326,7 +3369,7 @@ Thomas,Edison,1847</code></pre> <h2 id="act-v-2">Act V</h2> <p>Hamlet dies.</p> </blockquote> -<h4 data-number="2.2.1.32" id="option-smartellipses"><span class="header-section-number">2.2.1.32</span> Option <code>smartEllipses</code></h4> +<h4 data-number="2.2.1.33" id="option-smartellipses"><span class="header-section-number">2.2.1.33</span> Option <code>smartEllipses</code></h4> <dl> <dt><code>smartEllipses</code> (default value: <code>false</code>)</dt> <dd><dl> @@ -3344,23 +3387,23 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="lua-module-example-11">Lua Module Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb288"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb288-1"><a href="#cb288-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb288-2"><a href="#cb288-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> -<span id="cb288-3"><a href="#cb288-3" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb288-4"><a href="#cb288-4" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb288-5"><a href="#cb288-5" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb288-6"><a href="#cb288-6" aria-hidden="true"></a> local convert = markdown.new()</span> -<span id="cb288-7"><a href="#cb288-7" aria-hidden="true"></a> local input = "These are just three regular dots ..."</span> -<span id="cb288-8"><a href="#cb288-8" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> -<span id="cb288-9"><a href="#cb288-9" aria-hidden="true"></a><span class="fu">\par</span></span> -<span id="cb288-10"><a href="#cb288-10" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> -<span id="cb288-11"><a href="#cb288-11" aria-hidden="true"></a> local markdown = require("markdown")</span> -<span id="cb288-12"><a href="#cb288-12" aria-hidden="true"></a> local convert = markdown.new({smartEllipses = true})</span> -<span id="cb288-13"><a href="#cb288-13" aria-hidden="true"></a> local input = "... and this is a victorian ellipsis."</span> -<span id="cb288-14"><a href="#cb288-14" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> -<span id="cb288-15"><a href="#cb288-15" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb291"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb291-1"><a href="#cb291-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb291-2"><a href="#cb291-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> +<span id="cb291-3"><a href="#cb291-3" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb291-4"><a href="#cb291-4" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb291-5"><a href="#cb291-5" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb291-6"><a href="#cb291-6" aria-hidden="true"></a> local convert = markdown.new()</span> +<span id="cb291-7"><a href="#cb291-7" aria-hidden="true"></a> local input = "These are just three regular dots ..."</span> +<span id="cb291-8"><a href="#cb291-8" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> +<span id="cb291-9"><a href="#cb291-9" aria-hidden="true"></a><span class="fu">\par</span></span> +<span id="cb291-10"><a href="#cb291-10" aria-hidden="true"></a><span class="fu">\directlua</span>{</span> +<span id="cb291-11"><a href="#cb291-11" aria-hidden="true"></a> local markdown = require("markdown")</span> +<span id="cb291-12"><a href="#cb291-12" aria-hidden="true"></a> local convert = markdown.new({smartEllipses = true})</span> +<span id="cb291-13"><a href="#cb291-13" aria-hidden="true"></a> local input = "... and this is a victorian ellipsis."</span> +<span id="cb291-14"><a href="#cb291-14" aria-hidden="true"></a> tex.sprint(convert(input)) }</span> +<span id="cb291-15"><a href="#cb291-15" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Then, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb289"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb289-1"><a href="#cb289-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb292"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb292-1"><a href="#cb292-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>These are just three regular dots …</p> @@ -3368,19 +3411,19 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="lua-cli-example-9">Lua CLI Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb290"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb290-1"><a href="#cb290-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb290-2"><a href="#cb290-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> -<span id="cb290-3"><a href="#cb290-3" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb290-4"><a href="#cb290-4" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> -<span id="cb290-5"><a href="#cb290-5" aria-hidden="true"></a><span class="fu">\par</span></span> -<span id="cb290-6"><a href="#cb290-6" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> -<span id="cb290-7"><a href="#cb290-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb293"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb293-1"><a href="#cb293-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb293-2"><a href="#cb293-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> +<span id="cb293-3"><a href="#cb293-3" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb293-4"><a href="#cb293-4" aria-hidden="true"></a><span class="fu">\input</span> optionfalse</span> +<span id="cb293-5"><a href="#cb293-5" aria-hidden="true"></a><span class="fu">\par</span></span> +<span id="cb293-6"><a href="#cb293-6" aria-hidden="true"></a><span class="fu">\input</span> optiontrue</span> +<span id="cb293-7"><a href="#cb293-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>content.md</code> with the following content:</p> -<div class="sourceCode" id="cb291"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb291-1"><a href="#cb291-1" aria-hidden="true"></a>Are these just three regular dots, a victorian ellipsis, or ... ?</span></code></pre></div> +<div class="sourceCode" id="cb294"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb294-1"><a href="#cb294-1" aria-hidden="true"></a>Are these just three regular dots, a victorian ellipsis, or ... ?</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb292"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb292-1"><a href="#cb292-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> -<span id="cb292-2"><a href="#cb292-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ smartEllipses=true -- content.md optiontrue.tex</span> -<span id="cb292-3"><a href="#cb292-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb295"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb295-1"><a href="#cb295-1" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ -- content.md optionfalse.tex</span> +<span id="cb295-2"><a href="#cb295-2" aria-hidden="true"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ smartEllipses=true -- content.md optiontrue.tex</span> +<span id="cb295-3"><a href="#cb295-3" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua CLI script file, such as <code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems or <code>C:\Users\</code>⟨<em>Your username</em>⟩<code>\texmf\scripts\markdown\markdown-cli.lua</code> on Windows systems. Use the command <code>kpsewhich -a markdown-cli.lua</code> to locate the Lua CLI script file using <a href="https://tug.org/kpathsea/" title="Kpathsea - TeX Users Group">Kpathsea</a>.</p> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> @@ -3389,48 +3432,48 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="plain-tex-example-13">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb293"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb293-1"><a href="#cb293-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb293-2"><a href="#cb293-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> -<span id="cb293-3"><a href="#cb293-3" aria-hidden="true"></a></span> -<span id="cb293-4"><a href="#cb293-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb293-5"><a href="#cb293-5" aria-hidden="true"></a>These are just three regular dots ...</span> -<span id="cb293-6"><a href="#cb293-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb293-7"><a href="#cb293-7" aria-hidden="true"></a></span> -<span id="cb293-8"><a href="#cb293-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span> -<span id="cb293-9"><a href="#cb293-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb293-10"><a href="#cb293-10" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> -<span id="cb293-11"><a href="#cb293-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb293-12"><a href="#cb293-12" aria-hidden="true"></a></span> -<span id="cb293-13"><a href="#cb293-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb296"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb296-1"><a href="#cb296-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb296-2"><a href="#cb296-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> +<span id="cb296-3"><a href="#cb296-3" aria-hidden="true"></a></span> +<span id="cb296-4"><a href="#cb296-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb296-5"><a href="#cb296-5" aria-hidden="true"></a>These are just three regular dots ...</span> +<span id="cb296-6"><a href="#cb296-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb296-7"><a href="#cb296-7" aria-hidden="true"></a></span> +<span id="cb296-8"><a href="#cb296-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span> +<span id="cb296-9"><a href="#cb296-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb296-10"><a href="#cb296-10" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> +<span id="cb296-11"><a href="#cb296-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb296-12"><a href="#cb296-12" aria-hidden="true"></a></span> +<span id="cb296-13"><a href="#cb296-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb294"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb294-1"><a href="#cb294-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb297"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb297-1"><a href="#cb297-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>These are just three regular dots …</p> <p>. . . and this is a victorian ellipsis.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-27"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-28"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb295"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb295-1"><a href="#cb295-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb295-2"><a href="#cb295-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb295-3"><a href="#cb295-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb295-4"><a href="#cb295-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb295-5"><a href="#cb295-5" aria-hidden="true"></a> ellipsis = {. . .}</span> -<span id="cb295-6"><a href="#cb295-6" aria-hidden="true"></a> }</span> -<span id="cb295-7"><a href="#cb295-7" aria-hidden="true"></a>}</span> -<span id="cb295-8"><a href="#cb295-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb295-9"><a href="#cb295-9" aria-hidden="true"></a></span> -<span id="cb295-10"><a href="#cb295-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb295-11"><a href="#cb295-11" aria-hidden="true"></a>These are just three regular dots ...</span> -<span id="cb295-12"><a href="#cb295-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb295-13"><a href="#cb295-13" aria-hidden="true"></a></span> -<span id="cb295-14"><a href="#cb295-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{smartEllipses}</span> -<span id="cb295-15"><a href="#cb295-15" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> -<span id="cb295-16"><a href="#cb295-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb295-17"><a href="#cb295-17" aria-hidden="true"></a></span> -<span id="cb295-18"><a href="#cb295-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb296"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb296-1"><a href="#cb296-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb298"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb298-1"><a href="#cb298-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb298-2"><a href="#cb298-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb298-3"><a href="#cb298-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb298-4"><a href="#cb298-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb298-5"><a href="#cb298-5" aria-hidden="true"></a> ellipsis = {. . .}</span> +<span id="cb298-6"><a href="#cb298-6" aria-hidden="true"></a> }</span> +<span id="cb298-7"><a href="#cb298-7" aria-hidden="true"></a>}</span> +<span id="cb298-8"><a href="#cb298-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb298-9"><a href="#cb298-9" aria-hidden="true"></a></span> +<span id="cb298-10"><a href="#cb298-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb298-11"><a href="#cb298-11" aria-hidden="true"></a>These are just three regular dots ...</span> +<span id="cb298-12"><a href="#cb298-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb298-13"><a href="#cb298-13" aria-hidden="true"></a></span> +<span id="cb298-14"><a href="#cb298-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{smartEllipses}</span> +<span id="cb298-15"><a href="#cb298-15" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> +<span id="cb298-16"><a href="#cb298-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb298-17"><a href="#cb298-17" aria-hidden="true"></a></span> +<span id="cb298-18"><a href="#cb298-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb299"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb299-1"><a href="#cb299-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>These are just three regular dots …</p> @@ -3438,28 +3481,28 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-22">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb297"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb297-1"><a href="#cb297-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb297-2"><a href="#cb297-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> -<span id="cb297-3"><a href="#cb297-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb297-4"><a href="#cb297-4" aria-hidden="true"></a></span> -<span id="cb297-5"><a href="#cb297-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb297-6"><a href="#cb297-6" aria-hidden="true"></a>These are just three regular dots ...</span> -<span id="cb297-7"><a href="#cb297-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb297-8"><a href="#cb297-8" aria-hidden="true"></a></span> -<span id="cb297-9"><a href="#cb297-9" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span> -<span id="cb297-10"><a href="#cb297-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb297-11"><a href="#cb297-11" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> -<span id="cb297-12"><a href="#cb297-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb297-13"><a href="#cb297-13" aria-hidden="true"></a></span> -<span id="cb297-14"><a href="#cb297-14" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb300"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb300-1"><a href="#cb300-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb300-2"><a href="#cb300-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span> +<span id="cb300-3"><a href="#cb300-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb300-4"><a href="#cb300-4" aria-hidden="true"></a></span> +<span id="cb300-5"><a href="#cb300-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb300-6"><a href="#cb300-6" aria-hidden="true"></a>These are just three regular dots ...</span> +<span id="cb300-7"><a href="#cb300-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb300-8"><a href="#cb300-8" aria-hidden="true"></a></span> +<span id="cb300-9"><a href="#cb300-9" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span> +<span id="cb300-10"><a href="#cb300-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb300-11"><a href="#cb300-11" aria-hidden="true"></a>... and this is a victorian ellipsis.</span> +<span id="cb300-12"><a href="#cb300-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb300-13"><a href="#cb300-13" aria-hidden="true"></a></span> +<span id="cb300-14"><a href="#cb300-14" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb298"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb298-1"><a href="#cb298-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb301"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb301-1"><a href="#cb301-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>These are just three regular dots …</p> <p>. . . and this is a victorian ellipsis.</p> </blockquote> -<h4 data-number="2.2.1.33" id="option-startnumber"><span class="header-section-number">2.2.1.33</span> Option <code>startNumber</code></h4> +<h4 data-number="2.2.1.34" id="option-startnumber"><span class="header-section-number">2.2.1.34</span> Option <code>startNumber</code></h4> <dl> <dt><code>startNumber</code> (default value: <code>true</code>)</dt> <dd><dl> @@ -3475,32 +3518,32 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-28"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-29"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb299"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb299-1"><a href="#cb299-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb299-2"><a href="#cb299-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb299-3"><a href="#cb299-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb299-4"><a href="#cb299-4" aria-hidden="true"></a></span> -<span id="cb299-5"><a href="#cb299-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb299-6"><a href="#cb299-6" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> -<span id="cb299-7"><a href="#cb299-7" aria-hidden="true"></a></span> -<span id="cb299-8"><a href="#cb299-8" aria-hidden="true"></a>3. third item</span> -<span id="cb299-9"><a href="#cb299-9" aria-hidden="true"></a>4. fourth item</span> -<span id="cb299-10"><a href="#cb299-10" aria-hidden="true"></a>5. fifth item</span> -<span id="cb299-11"><a href="#cb299-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb299-12"><a href="#cb299-12" aria-hidden="true"></a></span> -<span id="cb299-13"><a href="#cb299-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{startNumber=false}</span> -<span id="cb299-14"><a href="#cb299-14" aria-hidden="true"></a>The following list does not respect the numbers specified in the</span> -<span id="cb299-15"><a href="#cb299-15" aria-hidden="true"></a>markup:</span> -<span id="cb299-16"><a href="#cb299-16" aria-hidden="true"></a></span> -<span id="cb299-17"><a href="#cb299-17" aria-hidden="true"></a>3. third item</span> -<span id="cb299-18"><a href="#cb299-18" aria-hidden="true"></a>4. fourth item</span> -<span id="cb299-19"><a href="#cb299-19" aria-hidden="true"></a>5. fifth item</span> -<span id="cb299-20"><a href="#cb299-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb299-21"><a href="#cb299-21" aria-hidden="true"></a></span> -<span id="cb299-22"><a href="#cb299-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb300"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb300-1"><a href="#cb300-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb302"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb302-1"><a href="#cb302-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb302-2"><a href="#cb302-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb302-3"><a href="#cb302-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb302-4"><a href="#cb302-4" aria-hidden="true"></a></span> +<span id="cb302-5"><a href="#cb302-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb302-6"><a href="#cb302-6" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> +<span id="cb302-7"><a href="#cb302-7" aria-hidden="true"></a></span> +<span id="cb302-8"><a href="#cb302-8" aria-hidden="true"></a>3. third item</span> +<span id="cb302-9"><a href="#cb302-9" aria-hidden="true"></a>4. fourth item</span> +<span id="cb302-10"><a href="#cb302-10" aria-hidden="true"></a>5. fifth item</span> +<span id="cb302-11"><a href="#cb302-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb302-12"><a href="#cb302-12" aria-hidden="true"></a></span> +<span id="cb302-13"><a href="#cb302-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{startNumber=false}</span> +<span id="cb302-14"><a href="#cb302-14" aria-hidden="true"></a>The following list does not respect the numbers specified in the</span> +<span id="cb302-15"><a href="#cb302-15" aria-hidden="true"></a>markup:</span> +<span id="cb302-16"><a href="#cb302-16" aria-hidden="true"></a></span> +<span id="cb302-17"><a href="#cb302-17" aria-hidden="true"></a>3. third item</span> +<span id="cb302-18"><a href="#cb302-18" aria-hidden="true"></a>4. fourth item</span> +<span id="cb302-19"><a href="#cb302-19" aria-hidden="true"></a>5. fifth item</span> +<span id="cb302-20"><a href="#cb302-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb302-21"><a href="#cb302-21" aria-hidden="true"></a></span> +<span id="cb302-22"><a href="#cb302-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb303"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb303-1"><a href="#cb303-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The following list respects the numbers specified in the markup:</p> @@ -3518,28 +3561,28 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-23">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb301"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb301-1"><a href="#cb301-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb301-2"><a href="#cb301-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb301-3"><a href="#cb301-3" aria-hidden="true"></a></span> -<span id="cb301-4"><a href="#cb301-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb301-5"><a href="#cb301-5" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> -<span id="cb301-6"><a href="#cb301-6" aria-hidden="true"></a></span> -<span id="cb301-7"><a href="#cb301-7" aria-hidden="true"></a>3. third item</span> -<span id="cb301-8"><a href="#cb301-8" aria-hidden="true"></a>4. fourth item</span> -<span id="cb301-9"><a href="#cb301-9" aria-hidden="true"></a>5. fifth item</span> -<span id="cb301-10"><a href="#cb301-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb301-11"><a href="#cb301-11" aria-hidden="true"></a></span> -<span id="cb301-12"><a href="#cb301-12" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[startNumber = no]</span> -<span id="cb301-13"><a href="#cb301-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb301-14"><a href="#cb301-14" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> -<span id="cb301-15"><a href="#cb301-15" aria-hidden="true"></a></span> -<span id="cb301-16"><a href="#cb301-16" aria-hidden="true"></a>3. third item</span> -<span id="cb301-17"><a href="#cb301-17" aria-hidden="true"></a>4. fourth item</span> -<span id="cb301-18"><a href="#cb301-18" aria-hidden="true"></a>5. fifth item</span> -<span id="cb301-19"><a href="#cb301-19" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb301-20"><a href="#cb301-20" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb302"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb302-1"><a href="#cb302-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb304"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb304-1"><a href="#cb304-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb304-2"><a href="#cb304-2" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb304-3"><a href="#cb304-3" aria-hidden="true"></a></span> +<span id="cb304-4"><a href="#cb304-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb304-5"><a href="#cb304-5" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> +<span id="cb304-6"><a href="#cb304-6" aria-hidden="true"></a></span> +<span id="cb304-7"><a href="#cb304-7" aria-hidden="true"></a>3. third item</span> +<span id="cb304-8"><a href="#cb304-8" aria-hidden="true"></a>4. fourth item</span> +<span id="cb304-9"><a href="#cb304-9" aria-hidden="true"></a>5. fifth item</span> +<span id="cb304-10"><a href="#cb304-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb304-11"><a href="#cb304-11" aria-hidden="true"></a></span> +<span id="cb304-12"><a href="#cb304-12" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[startNumber = no]</span> +<span id="cb304-13"><a href="#cb304-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb304-14"><a href="#cb304-14" aria-hidden="true"></a>The following list respects the numbers specified in the markup:</span> +<span id="cb304-15"><a href="#cb304-15" aria-hidden="true"></a></span> +<span id="cb304-16"><a href="#cb304-16" aria-hidden="true"></a>3. third item</span> +<span id="cb304-17"><a href="#cb304-17" aria-hidden="true"></a>4. fourth item</span> +<span id="cb304-18"><a href="#cb304-18" aria-hidden="true"></a>5. fifth item</span> +<span id="cb304-19"><a href="#cb304-19" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb304-20"><a href="#cb304-20" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb305"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb305-1"><a href="#cb305-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The following list respects the numbers specified in the markup:</p> @@ -3555,13 +3598,13 @@ Thomas,Edison,1847</code></pre> <li>fifth item</li> </ol> </blockquote> -<h4 data-number="2.2.1.34" id="option-strikethrough"><span class="header-section-number">2.2.1.34</span> Option <code>strikeThrough</code></h4> +<h4 data-number="2.2.1.35" id="option-strikethrough"><span class="header-section-number">2.2.1.35</span> Option <code>strikeThrough</code></h4> <dl> <dt><code>strikeThrough</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc strike-through syntax extension:</p> -<div class="sourceCode" id="cb303"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb303-1"><a href="#cb303-1" aria-hidden="true"></a>This ~~is deleted text.~~</span></code></pre></div> +<div class="sourceCode" id="cb306"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb306-1"><a href="#cb306-1" aria-hidden="true"></a>This ~~is deleted text.~~</span></code></pre></div> </dd> </dl> </dd> @@ -3574,70 +3617,70 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-14">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb304"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb304-1"><a href="#cb304-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb304-2"><a href="#cb304-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span> -<span id="cb304-3"><a href="#cb304-3" aria-hidden="true"></a><span class="fu">\input</span> soulutf8.sty</span> -<span id="cb304-4"><a href="#cb304-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span> -<span id="cb304-5"><a href="#cb304-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb304-6"><a href="#cb304-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb304-7"><a href="#cb304-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb304-8"><a href="#cb304-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb307"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb307-1"><a href="#cb307-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb307-2"><a href="#cb307-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span> +<span id="cb307-3"><a href="#cb307-3" aria-hidden="true"></a><span class="fu">\input</span> soulutf8.sty</span> +<span id="cb307-4"><a href="#cb307-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span> +<span id="cb307-5"><a href="#cb307-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb307-6"><a href="#cb307-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb307-7"><a href="#cb307-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb307-8"><a href="#cb307-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb305"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb305-1"><a href="#cb305-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb308"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb308-1"><a href="#cb308-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-29"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-30"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb306"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb306-1"><a href="#cb306-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb306-2"><a href="#cb306-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span> -<span id="cb306-3"><a href="#cb306-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span> -<span id="cb306-4"><a href="#cb306-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb306-5"><a href="#cb306-5" aria-hidden="true"></a> renderers = {</span> -<span id="cb306-6"><a href="#cb306-6" aria-hidden="true"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span> -<span id="cb306-7"><a href="#cb306-7" aria-hidden="true"></a> },</span> -<span id="cb306-8"><a href="#cb306-8" aria-hidden="true"></a>}</span> -<span id="cb306-9"><a href="#cb306-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb306-10"><a href="#cb306-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb306-11"><a href="#cb306-11" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb306-12"><a href="#cb306-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb306-13"><a href="#cb306-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb309"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb309-1"><a href="#cb309-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb309-2"><a href="#cb309-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span> +<span id="cb309-3"><a href="#cb309-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span> +<span id="cb309-4"><a href="#cb309-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb309-5"><a href="#cb309-5" aria-hidden="true"></a> renderers = {</span> +<span id="cb309-6"><a href="#cb309-6" aria-hidden="true"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span> +<span id="cb309-7"><a href="#cb309-7" aria-hidden="true"></a> },</span> +<span id="cb309-8"><a href="#cb309-8" aria-hidden="true"></a>}</span> +<span id="cb309-9"><a href="#cb309-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb309-10"><a href="#cb309-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb309-11"><a href="#cb309-11" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb309-12"><a href="#cb309-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb309-13"><a href="#cb309-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb307"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb307-1"><a href="#cb307-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb310"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb310-1"><a href="#cb310-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-24">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb308"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb308-1"><a href="#cb308-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb308-2"><a href="#cb308-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span> -<span id="cb308-3"><a href="#cb308-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span> -<span id="cb308-4"><a href="#cb308-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb308-5"><a href="#cb308-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb308-6"><a href="#cb308-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb308-7"><a href="#cb308-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb308-8"><a href="#cb308-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb311"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb311-1"><a href="#cb311-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb311-2"><a href="#cb311-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span> +<span id="cb311-3"><a href="#cb311-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span> +<span id="cb311-4"><a href="#cb311-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb311-5"><a href="#cb311-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb311-6"><a href="#cb311-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb311-7"><a href="#cb311-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb311-8"><a href="#cb311-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb309"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb309-1"><a href="#cb309-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb312"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb312-1"><a href="#cb312-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> </blockquote> -<h4 data-number="2.2.1.35" id="option-stripindent"><span class="header-section-number">2.2.1.35</span> Option <code>stripIndent</code></h4> +<h4 data-number="2.2.1.36" id="option-stripindent"><span class="header-section-number">2.2.1.36</span> Option <code>stripIndent</code></h4> <dl> <dt><code>stripIndent</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Strip the minimal indentation of non-blank lines from all lines in a markdown document. Requires that the <strong><code>preserveTabs</code></strong> Lua option is disabled:</p> -<div class="sourceCode" id="cb310"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb310-1"><a href="#cb310-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb310-2"><a href="#cb310-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span> -<span id="cb310-3"><a href="#cb310-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb310-4"><a href="#cb310-4" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb310-5"><a href="#cb310-5" aria-hidden="true"></a> Hello *world*!</span> -<span id="cb310-6"><a href="#cb310-6" aria-hidden="true"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb310-7"><a href="#cb310-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb313"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb313-1"><a href="#cb313-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb313-2"><a href="#cb313-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span> +<span id="cb313-3"><a href="#cb313-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb313-4"><a href="#cb313-4" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb313-5"><a href="#cb313-5" aria-hidden="true"></a> Hello *world*!</span> +<span id="cb313-6"><a href="#cb313-6" aria-hidden="true"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb313-7"><a href="#cb313-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> </dd> </dl> </dd> @@ -3650,46 +3693,46 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-15">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb311"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb311-1"><a href="#cb311-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb311-2"><a href="#cb311-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStripIndent</span>{true}</span> -<span id="cb311-3"><a href="#cb311-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb311-4"><a href="#cb311-4" aria-hidden="true"></a> Hello *world*!</span> -<span id="cb311-5"><a href="#cb311-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb311-6"><a href="#cb311-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb314"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb314-1"><a href="#cb314-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb314-2"><a href="#cb314-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStripIndent</span>{true}</span> +<span id="cb314-3"><a href="#cb314-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb314-4"><a href="#cb314-4" aria-hidden="true"></a> Hello *world*!</span> +<span id="cb314-5"><a href="#cb314-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb314-6"><a href="#cb314-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb312"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb312-1"><a href="#cb312-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb315"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb315-1"><a href="#cb315-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> -<h5 class="unnumbered" data-number="" id="latex-example-30"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-31"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb313"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb313-1"><a href="#cb313-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb313-2"><a href="#cb313-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span> -<span id="cb313-3"><a href="#cb313-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb313-4"><a href="#cb313-4" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb313-5"><a href="#cb313-5" aria-hidden="true"></a> Hello *world*!</span> -<span id="cb313-6"><a href="#cb313-6" aria-hidden="true"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb313-7"><a href="#cb313-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb316"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb316-1"><a href="#cb316-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb316-2"><a href="#cb316-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span> +<span id="cb316-3"><a href="#cb316-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb316-4"><a href="#cb316-4" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb316-5"><a href="#cb316-5" aria-hidden="true"></a> Hello *world*!</span> +<span id="cb316-6"><a href="#cb316-6" aria-hidden="true"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb316-7"><a href="#cb316-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb314"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb314-1"><a href="#cb314-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb317"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb317-1"><a href="#cb317-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> <h5 class="unnumbered" data-number="" id="context-example-25">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb315"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb315-1"><a href="#cb315-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb315-2"><a href="#cb315-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[stripIndent = yes]</span> -<span id="cb315-3"><a href="#cb315-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb315-4"><a href="#cb315-4" aria-hidden="true"></a> <span class="fu">\startmarkdown</span></span> -<span id="cb315-5"><a href="#cb315-5" aria-hidden="true"></a> Hello *world*!</span> -<span id="cb315-6"><a href="#cb315-6" aria-hidden="true"></a> <span class="fu">\stopmarkdown</span></span> -<span id="cb315-7"><a href="#cb315-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb318"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb318-1"><a href="#cb318-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb318-2"><a href="#cb318-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[stripIndent = yes]</span> +<span id="cb318-3"><a href="#cb318-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb318-4"><a href="#cb318-4" aria-hidden="true"></a> <span class="fu">\startmarkdown</span></span> +<span id="cb318-5"><a href="#cb318-5" aria-hidden="true"></a> Hello *world*!</span> +<span id="cb318-6"><a href="#cb318-6" aria-hidden="true"></a> <span class="fu">\stopmarkdown</span></span> +<span id="cb318-7"><a href="#cb318-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb316"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb316-1"><a href="#cb316-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb319"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb319-1"><a href="#cb319-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> -<h4 data-number="2.2.1.36" id="option-subscripts"><span class="header-section-number">2.2.1.36</span> Option <code>subscripts</code></h4> +<h4 data-number="2.2.1.37" id="option-subscripts"><span class="header-section-number">2.2.1.37</span> Option <code>subscripts</code></h4> <dl> <dt><code>subscripts</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc subscript syntax extension:</p> -<div class="sourceCode" id="cb317"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb317-1"><a href="#cb317-1" aria-hidden="true"></a>H~2~O is a liquid.</span></code></pre></div> +<div class="sourceCode" id="cb320"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb320-1"><a href="#cb320-1" aria-hidden="true"></a>H~2~O is a liquid.</span></code></pre></div> </dd> </dl> </dd> @@ -3700,43 +3743,43 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-31"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-32"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb318"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb318-1"><a href="#cb318-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb318-2"><a href="#cb318-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span> -<span id="cb318-3"><a href="#cb318-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb318-4"><a href="#cb318-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb318-5"><a href="#cb318-5" aria-hidden="true"></a>H~2~O is a liquid.</span> -<span id="cb318-6"><a href="#cb318-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb318-7"><a href="#cb318-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb321"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb321-1"><a href="#cb321-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb321-2"><a href="#cb321-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span> +<span id="cb321-3"><a href="#cb321-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb321-4"><a href="#cb321-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb321-5"><a href="#cb321-5" aria-hidden="true"></a>H~2~O is a liquid.</span> +<span id="cb321-6"><a href="#cb321-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb321-7"><a href="#cb321-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb319"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb319-1"><a href="#cb319-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb322"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb322-1"><a href="#cb322-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>H<sub>2</sub>O is a liquid.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-26">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb320"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb320-1"><a href="#cb320-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb320-2"><a href="#cb320-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span> -<span id="cb320-3"><a href="#cb320-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb320-4"><a href="#cb320-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb320-5"><a href="#cb320-5" aria-hidden="true"></a>H~2~O is a liquid.</span> -<span id="cb320-6"><a href="#cb320-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb320-7"><a href="#cb320-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb323"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb323-1"><a href="#cb323-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb323-2"><a href="#cb323-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span> +<span id="cb323-3"><a href="#cb323-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb323-4"><a href="#cb323-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb323-5"><a href="#cb323-5" aria-hidden="true"></a>H~2~O is a liquid.</span> +<span id="cb323-6"><a href="#cb323-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb323-7"><a href="#cb323-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb321"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb321-1"><a href="#cb321-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb324"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb324-1"><a href="#cb324-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>H<sub>2</sub>O is a liquid.</p> </blockquote> -<h4 data-number="2.2.1.37" id="option-superscripts"><span class="header-section-number">2.2.1.37</span> Option <code>superscripts</code></h4> +<h4 data-number="2.2.1.38" id="option-superscripts"><span class="header-section-number">2.2.1.38</span> Option <code>superscripts</code></h4> <dl> <dt><code>superscripts</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc superscript syntax extension:</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>2^10^ is 1024.</span></code></pre></div> +<div class="sourceCode" id="cb325"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb325-1"><a href="#cb325-1" aria-hidden="true"></a>2^10^ is 1024.</span></code></pre></div> </dd> </dl> </dd> @@ -3747,49 +3790,49 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-32"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-33"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb323"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb323-1"><a href="#cb323-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb323-2"><a href="#cb323-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span> -<span id="cb323-3"><a href="#cb323-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb323-4"><a href="#cb323-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb323-5"><a href="#cb323-5" aria-hidden="true"></a>2^10^ is 1024.</span> -<span id="cb323-6"><a href="#cb323-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb323-7"><a href="#cb323-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb326"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb326-1"><a href="#cb326-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb326-2"><a href="#cb326-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span> +<span id="cb326-3"><a href="#cb326-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb326-4"><a href="#cb326-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb326-5"><a href="#cb326-5" aria-hidden="true"></a>2^10^ is 1024.</span> +<span id="cb326-6"><a href="#cb326-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb326-7"><a href="#cb326-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb324"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb324-1"><a href="#cb324-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb327"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb327-1"><a href="#cb327-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>2<sup>10</sup> is 1024.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-27">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb325"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb325-1"><a href="#cb325-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb325-2"><a href="#cb325-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span> -<span id="cb325-3"><a href="#cb325-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb325-4"><a href="#cb325-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb325-5"><a href="#cb325-5" aria-hidden="true"></a>2^10^ is 1024.</span> -<span id="cb325-6"><a href="#cb325-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb325-7"><a href="#cb325-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb328"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb328-1"><a href="#cb328-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb328-2"><a href="#cb328-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span> +<span id="cb328-3"><a href="#cb328-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb328-4"><a href="#cb328-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb328-5"><a href="#cb328-5" aria-hidden="true"></a>2^10^ is 1024.</span> +<span id="cb328-6"><a href="#cb328-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb328-7"><a href="#cb328-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb326"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb326-1"><a href="#cb326-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb329"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb329-1"><a href="#cb329-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>2<sup>10</sup> is 1024.</p> </blockquote> -<h4 data-number="2.2.1.38" id="option-tablecaptions"><span class="header-section-number">2.2.1.38</span> Option <code>tableCaptions</code></h4> +<h4 data-number="2.2.1.39" id="option-tablecaptions"><span class="header-section-number">2.2.1.39</span> Option <code>tableCaptions</code></h4> <dl> <dt><code>tableCaptions</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc <code>table_captions</code> syntax extension for <a href="#pipe-tables">pipe tables</a>.</p> -<div class="sourceCode" id="cb327"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb327-1"><a href="#cb327-1" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb327-2"><a href="#cb327-2" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb327-3"><a href="#cb327-3" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb327-4"><a href="#cb327-4" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb327-5"><a href="#cb327-5" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb327-6"><a href="#cb327-6" aria-hidden="true"></a></span> -<span id="cb327-7"><a href="#cb327-7" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span></code></pre></div> +<div class="sourceCode" id="cb330"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb330-1"><a href="#cb330-1" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb330-2"><a href="#cb330-2" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb330-3"><a href="#cb330-3" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb330-4"><a href="#cb330-4" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb330-5"><a href="#cb330-5" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb330-6"><a href="#cb330-6" aria-hidden="true"></a></span> +<span id="cb330-7"><a href="#cb330-7" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span></code></pre></div> </dd> </dl> </dd> @@ -3800,23 +3843,23 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-33"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-34"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb328"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb328-1"><a href="#cb328-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb328-2"><a href="#cb328-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span> -<span id="cb328-3"><a href="#cb328-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb328-4"><a href="#cb328-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb328-5"><a href="#cb328-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb328-6"><a href="#cb328-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb328-7"><a href="#cb328-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb328-8"><a href="#cb328-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb328-9"><a href="#cb328-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb328-10"><a href="#cb328-10" aria-hidden="true"></a></span> -<span id="cb328-11"><a href="#cb328-11" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span> -<span id="cb328-12"><a href="#cb328-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb328-13"><a href="#cb328-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb331"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb331-1"><a href="#cb331-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb331-2"><a href="#cb331-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span> +<span id="cb331-3"><a href="#cb331-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb331-4"><a href="#cb331-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb331-5"><a href="#cb331-5" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb331-6"><a href="#cb331-6" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb331-7"><a href="#cb331-7" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb331-8"><a href="#cb331-8" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb331-9"><a href="#cb331-9" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb331-10"><a href="#cb331-10" aria-hidden="true"></a></span> +<span id="cb331-11"><a href="#cb331-11" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span> +<span id="cb331-12"><a href="#cb331-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb331-13"><a href="#cb331-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb329"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb329-1"><a href="#cb329-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb332"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb332-1"><a href="#cb332-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <table> @@ -3853,25 +3896,25 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-28">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb330"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb330-1"><a href="#cb330-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb330-2"><a href="#cb330-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> -<span id="cb330-3"><a href="#cb330-3" aria-hidden="true"></a> [</span> -<span id="cb330-4"><a href="#cb330-4" aria-hidden="true"></a> pipeTables = yes,</span> -<span id="cb330-5"><a href="#cb330-5" aria-hidden="true"></a> tableCaptions = yes,</span> -<span id="cb330-6"><a href="#cb330-6" aria-hidden="true"></a> ]</span> -<span id="cb330-7"><a href="#cb330-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb330-8"><a href="#cb330-8" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb330-9"><a href="#cb330-9" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb330-10"><a href="#cb330-10" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb330-11"><a href="#cb330-11" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb330-12"><a href="#cb330-12" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb330-13"><a href="#cb330-13" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb330-14"><a href="#cb330-14" aria-hidden="true"></a></span> -<span id="cb330-15"><a href="#cb330-15" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span> -<span id="cb330-16"><a href="#cb330-16" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb330-17"><a href="#cb330-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb331"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb331-1"><a href="#cb331-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb333"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb333-1"><a href="#cb333-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb333-2"><a href="#cb333-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> +<span id="cb333-3"><a href="#cb333-3" aria-hidden="true"></a> [</span> +<span id="cb333-4"><a href="#cb333-4" aria-hidden="true"></a> pipeTables = yes,</span> +<span id="cb333-5"><a href="#cb333-5" aria-hidden="true"></a> tableCaptions = yes,</span> +<span id="cb333-6"><a href="#cb333-6" aria-hidden="true"></a> ]</span> +<span id="cb333-7"><a href="#cb333-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb333-8"><a href="#cb333-8" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb333-9"><a href="#cb333-9" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb333-10"><a href="#cb333-10" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb333-11"><a href="#cb333-11" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb333-12"><a href="#cb333-12" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb333-13"><a href="#cb333-13" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb333-14"><a href="#cb333-14" aria-hidden="true"></a></span> +<span id="cb333-15"><a href="#cb333-15" aria-hidden="true"></a> : Demonstration of pipe table syntax.</span> +<span id="cb333-16"><a href="#cb333-16" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb333-17"><a href="#cb333-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb334"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb334-1"><a href="#cb334-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <table> @@ -3906,15 +3949,15 @@ Thomas,Edison,1847</code></pre> </tbody> </table> </blockquote> -<h4 data-number="2.2.1.39" id="option-tasklists"><span class="header-section-number">2.2.1.39</span> Option <code>taskLists</code></h4> +<h4 data-number="2.2.1.40" id="option-tasklists"><span class="header-section-number">2.2.1.40</span> Option <code>taskLists</code></h4> <dl> <dt><code>taskLists</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Enable the Pandoc <code>task_lists</code> syntax extension.</p> -<div class="sourceCode" id="cb332"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb332-1"><a href="#cb332-1" aria-hidden="true"></a><span class="ss">- </span><span class="va">[ ]</span> an unticked task list item</span> -<span id="cb332-2"><a href="#cb332-2" aria-hidden="true"></a><span class="ss">- </span><span class="co">[</span><span class="ot">/</span><span class="co">]</span> a half-checked task list item</span> -<span id="cb332-3"><a href="#cb332-3" aria-hidden="true"></a><span class="ss">- </span><span class="co">[</span><span class="ot">X</span><span class="co">]</span> a ticked task list item</span></code></pre></div> +<div class="sourceCode" id="cb335"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb335-1"><a href="#cb335-1" aria-hidden="true"></a><span class="ss">- </span><span class="va">[ ]</span> an unticked task list item</span> +<span id="cb335-2"><a href="#cb335-2" aria-hidden="true"></a><span class="ss">- </span><span class="co">[</span><span class="ot">/</span><span class="co">]</span> a half-checked task list item</span> +<span id="cb335-3"><a href="#cb335-3" aria-hidden="true"></a><span class="ss">- </span><span class="co">[</span><span class="ot">X</span><span class="co">]</span> a ticked task list item</span></code></pre></div> </dd> </dl> </dd> @@ -3925,26 +3968,26 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-34"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-35"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb333"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb333-1"><a href="#cb333-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb333-2"><a href="#cb333-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span> -<span id="cb333-3"><a href="#cb333-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb333-4"><a href="#cb333-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb333-5"><a href="#cb333-5" aria-hidden="true"></a> untickedBox = No,</span> -<span id="cb333-6"><a href="#cb333-6" aria-hidden="true"></a> halfTickedBox = Maybe,</span> -<span id="cb333-7"><a href="#cb333-7" aria-hidden="true"></a> tickedBox = Yes,</span> -<span id="cb333-8"><a href="#cb333-8" aria-hidden="true"></a> },</span> -<span id="cb333-9"><a href="#cb333-9" aria-hidden="true"></a>}</span> -<span id="cb333-10"><a href="#cb333-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb333-11"><a href="#cb333-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb333-12"><a href="#cb333-12" aria-hidden="true"></a>- [ ] you can't.</span> -<span id="cb333-13"><a href="#cb333-13" aria-hidden="true"></a>- [/] I can?</span> -<span id="cb333-14"><a href="#cb333-14" aria-hidden="true"></a>- [X] I can!</span> -<span id="cb333-15"><a href="#cb333-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb333-16"><a href="#cb333-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb334"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb334-1"><a href="#cb334-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb336"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb336-1"><a href="#cb336-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb336-2"><a href="#cb336-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span> +<span id="cb336-3"><a href="#cb336-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb336-4"><a href="#cb336-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb336-5"><a href="#cb336-5" aria-hidden="true"></a> untickedBox = No,</span> +<span id="cb336-6"><a href="#cb336-6" aria-hidden="true"></a> halfTickedBox = Maybe,</span> +<span id="cb336-7"><a href="#cb336-7" aria-hidden="true"></a> tickedBox = Yes,</span> +<span id="cb336-8"><a href="#cb336-8" aria-hidden="true"></a> },</span> +<span id="cb336-9"><a href="#cb336-9" aria-hidden="true"></a>}</span> +<span id="cb336-10"><a href="#cb336-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb336-11"><a href="#cb336-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb336-12"><a href="#cb336-12" aria-hidden="true"></a>- [ ] you can't.</span> +<span id="cb336-13"><a href="#cb336-13" aria-hidden="true"></a>- [/] I can?</span> +<span id="cb336-14"><a href="#cb336-14" aria-hidden="true"></a>- [X] I can!</span> +<span id="cb336-15"><a href="#cb336-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb336-16"><a href="#cb336-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb337"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb337-1"><a href="#cb337-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ul> @@ -3955,20 +3998,20 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-29">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb335"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb335-1"><a href="#cb335-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb335-2"><a href="#cb335-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span> -<span id="cb335-3"><a href="#cb335-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span> -<span id="cb335-4"><a href="#cb335-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHalftickedBox</span>{Maybe}</span> -<span id="cb335-5"><a href="#cb335-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span> -<span id="cb335-6"><a href="#cb335-6" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb335-7"><a href="#cb335-7" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb335-8"><a href="#cb335-8" aria-hidden="true"></a>- [ ] you can't.</span> -<span id="cb335-9"><a href="#cb335-9" aria-hidden="true"></a>- [/] I can?</span> -<span id="cb335-10"><a href="#cb335-10" aria-hidden="true"></a>- [X] I can!</span> -<span id="cb335-11"><a href="#cb335-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb335-12"><a href="#cb335-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb338"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb338-1"><a href="#cb338-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb338-2"><a href="#cb338-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span> +<span id="cb338-3"><a href="#cb338-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span> +<span id="cb338-4"><a href="#cb338-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHalftickedBox</span>{Maybe}</span> +<span id="cb338-5"><a href="#cb338-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span> +<span id="cb338-6"><a href="#cb338-6" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb338-7"><a href="#cb338-7" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb338-8"><a href="#cb338-8" aria-hidden="true"></a>- [ ] you can't.</span> +<span id="cb338-9"><a href="#cb338-9" aria-hidden="true"></a>- [/] I can?</span> +<span id="cb338-10"><a href="#cb338-10" aria-hidden="true"></a>- [X] I can!</span> +<span id="cb338-11"><a href="#cb338-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb338-12"><a href="#cb338-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb336"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb336-1"><a href="#cb336-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb339"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb339-1"><a href="#cb339-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ul> @@ -3977,20 +4020,20 @@ Thomas,Edison,1847</code></pre> <li>Yes I can!</li> </ul> </blockquote> -<h4 data-number="2.2.1.40" id="option-texcomments"><span class="header-section-number">2.2.1.40</span> Option <code>texComments</code></h4> +<h4 data-number="2.2.1.41" id="option-texcomments"><span class="header-section-number">2.2.1.41</span> Option <code>texComments</code></h4> <dl> <dt><code>texComments</code> (default value: <code>false</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Strip <span class="tex">T<sub>e</sub>X</span>-style comments.</p> -<div class="sourceCode" id="cb337"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb337-1"><a href="#cb337-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb337-2"><a href="#cb337-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span> -<span id="cb337-3"><a href="#cb337-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb337-4"><a href="#cb337-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb337-5"><a href="#cb337-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> -<span id="cb337-6"><a href="#cb337-6" aria-hidden="true"></a> lo *world*!</span> -<span id="cb337-7"><a href="#cb337-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb337-8"><a href="#cb337-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<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">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb340-2"><a href="#cb340-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span> +<span id="cb340-3"><a href="#cb340-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb340-4"><a href="#cb340-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb340-5"><a href="#cb340-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> +<span id="cb340-6"><a href="#cb340-6" aria-hidden="true"></a> lo *world*!</span> +<span id="cb340-7"><a href="#cb340-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb340-8"><a href="#cb340-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Always enabled when <strong><code>hybrid</code></strong> is enabled.</p> </dd> </dl> @@ -4004,57 +4047,57 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-16">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb338"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb338-1"><a href="#cb338-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb338-2"><a href="#cb338-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTexComments</span>{true}</span> -<span id="cb338-3"><a href="#cb338-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb338-4"><a href="#cb338-4" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> -<span id="cb338-5"><a href="#cb338-5" aria-hidden="true"></a> lo *world*!</span> -<span id="cb338-6"><a href="#cb338-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb338-7"><a href="#cb338-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb341"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb341-1"><a href="#cb341-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb341-2"><a href="#cb341-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTexComments</span>{true}</span> +<span id="cb341-3"><a href="#cb341-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb341-4"><a href="#cb341-4" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> +<span id="cb341-5"><a href="#cb341-5" aria-hidden="true"></a> lo *world*!</span> +<span id="cb341-6"><a href="#cb341-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb341-7"><a href="#cb341-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb339"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb339-1"><a href="#cb339-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb342"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb342-1"><a href="#cb342-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> -<h5 class="unnumbered" data-number="" id="latex-example-35"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-36"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</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">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb340-2"><a href="#cb340-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span> -<span id="cb340-3"><a href="#cb340-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb340-4"><a href="#cb340-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb340-5"><a href="#cb340-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> -<span id="cb340-6"><a href="#cb340-6" aria-hidden="true"></a> lo *world*!</span> -<span id="cb340-7"><a href="#cb340-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb340-8"><a href="#cb340-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb343"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb343-1"><a href="#cb343-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb343-2"><a href="#cb343-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span> +<span id="cb343-3"><a href="#cb343-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb343-4"><a href="#cb343-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb343-5"><a href="#cb343-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> +<span id="cb343-6"><a href="#cb343-6" aria-hidden="true"></a> lo *world*!</span> +<span id="cb343-7"><a href="#cb343-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb343-8"><a href="#cb343-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb341"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb341-1"><a href="#cb341-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb344"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb344-1"><a href="#cb344-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> <h5 class="unnumbered" data-number="" id="context-example-30">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb342"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb342-1"><a href="#cb342-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb342-2"><a href="#cb342-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[texComments = yes]</span> -<span id="cb342-3"><a href="#cb342-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb342-4"><a href="#cb342-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb342-5"><a href="#cb342-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> -<span id="cb342-6"><a href="#cb342-6" aria-hidden="true"></a> lo *world*!</span> -<span id="cb342-7"><a href="#cb342-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb342-8"><a href="#cb342-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb345"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb345-1"><a href="#cb345-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb345-2"><a href="#cb345-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[texComments = yes]</span> +<span id="cb345-3"><a href="#cb345-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb345-4"><a href="#cb345-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb345-5"><a href="#cb345-5" aria-hidden="true"></a>Hel<span class="co">% this is a comment</span></span> +<span id="cb345-6"><a href="#cb345-6" aria-hidden="true"></a> lo *world*!</span> +<span id="cb345-7"><a href="#cb345-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb345-8"><a href="#cb345-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb343"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb343-1"><a href="#cb343-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb346"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb346-1"><a href="#cb346-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> -<h4 data-number="2.2.1.41" id="option-tightlists"><span class="header-section-number">2.2.1.41</span> Option <code>tightLists</code></h4> +<h4 data-number="2.2.1.42" id="option-tightlists"><span class="header-section-number">2.2.1.42</span> Option <code>tightLists</code></h4> <dl> <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> -<div class="sourceCode" id="cb344"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb344-1"><a href="#cb344-1" aria-hidden="true"></a><span class="ss">- </span>This is</span> -<span id="cb344-2"><a href="#cb344-2" aria-hidden="true"></a><span class="ss">- </span>a tight</span> -<span id="cb344-3"><a href="#cb344-3" aria-hidden="true"></a><span class="ss">- </span>unordered list.</span> -<span id="cb344-4"><a href="#cb344-4" aria-hidden="true"></a></span> -<span id="cb344-5"><a href="#cb344-5" aria-hidden="true"></a><span class="ss">- </span>This is</span> -<span id="cb344-6"><a href="#cb344-6" aria-hidden="true"></a></span> -<span id="cb344-7"><a href="#cb344-7" aria-hidden="true"></a> not a tight</span> -<span id="cb344-8"><a href="#cb344-8" aria-hidden="true"></a></span> -<span id="cb344-9"><a href="#cb344-9" aria-hidden="true"></a><span class="ss">- </span>unordered list.</span></code></pre></div> +<div class="sourceCode" id="cb347"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb347-1"><a href="#cb347-1" aria-hidden="true"></a><span class="ss">- </span>This is</span> +<span id="cb347-2"><a href="#cb347-2" aria-hidden="true"></a><span class="ss">- </span>a tight</span> +<span id="cb347-3"><a href="#cb347-3" aria-hidden="true"></a><span class="ss">- </span>unordered list.</span> +<span id="cb347-4"><a href="#cb347-4" aria-hidden="true"></a></span> +<span id="cb347-5"><a href="#cb347-5" aria-hidden="true"></a><span class="ss">- </span>This is</span> +<span id="cb347-6"><a href="#cb347-6" aria-hidden="true"></a></span> +<span id="cb347-7"><a href="#cb347-7" aria-hidden="true"></a> not a tight</span> +<span id="cb347-8"><a href="#cb347-8" aria-hidden="true"></a></span> +<span id="cb347-9"><a href="#cb347-9" aria-hidden="true"></a><span class="ss">- </span>unordered list.</span></code></pre></div> </dd> </dl> </dd> @@ -4065,39 +4108,39 @@ Thomas,Edison,1847</code></pre> </dl> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-36"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-37"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb345"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb345-1"><a href="#cb345-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb345-2"><a href="#cb345-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb345-3"><a href="#cb345-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb345-4"><a href="#cb345-4" aria-hidden="true"></a></span> -<span id="cb345-5"><a href="#cb345-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb345-6"><a href="#cb345-6" aria-hidden="true"></a>The following list is tight:</span> -<span id="cb345-7"><a href="#cb345-7" aria-hidden="true"></a></span> -<span id="cb345-8"><a href="#cb345-8" aria-hidden="true"></a> - first item</span> -<span id="cb345-9"><a href="#cb345-9" aria-hidden="true"></a> - second item</span> -<span id="cb345-10"><a href="#cb345-10" aria-hidden="true"></a> - third item</span> -<span id="cb345-11"><a href="#cb345-11" aria-hidden="true"></a></span> -<span id="cb345-12"><a href="#cb345-12" aria-hidden="true"></a>The following list is loose:</span> -<span id="cb345-13"><a href="#cb345-13" aria-hidden="true"></a></span> -<span id="cb345-14"><a href="#cb345-14" aria-hidden="true"></a> - first item</span> -<span id="cb345-15"><a href="#cb345-15" aria-hidden="true"></a> - second item that spans</span> -<span id="cb345-16"><a href="#cb345-16" aria-hidden="true"></a></span> -<span id="cb345-17"><a href="#cb345-17" aria-hidden="true"></a> multiple paragraphs</span> -<span id="cb345-18"><a href="#cb345-18" aria-hidden="true"></a> - third item</span> -<span id="cb345-19"><a href="#cb345-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb345-20"><a href="#cb345-20" aria-hidden="true"></a></span> -<span id="cb345-21"><a href="#cb345-21" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{tightLists=false}</span> -<span id="cb345-22"><a href="#cb345-22" aria-hidden="true"></a>The following list is now also loose:</span> -<span id="cb345-23"><a href="#cb345-23" aria-hidden="true"></a></span> -<span id="cb345-24"><a href="#cb345-24" aria-hidden="true"></a> - first item</span> -<span id="cb345-25"><a href="#cb345-25" aria-hidden="true"></a> - second item</span> -<span id="cb345-26"><a href="#cb345-26" aria-hidden="true"></a> - third item</span> -<span id="cb345-27"><a href="#cb345-27" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb345-28"><a href="#cb345-28" aria-hidden="true"></a></span> -<span id="cb345-29"><a href="#cb345-29" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb346"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb346-1"><a href="#cb346-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb348"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb348-1"><a href="#cb348-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb348-2"><a href="#cb348-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb348-3"><a href="#cb348-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb348-4"><a href="#cb348-4" aria-hidden="true"></a></span> +<span id="cb348-5"><a href="#cb348-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb348-6"><a href="#cb348-6" aria-hidden="true"></a>The following list is tight:</span> +<span id="cb348-7"><a href="#cb348-7" aria-hidden="true"></a></span> +<span id="cb348-8"><a href="#cb348-8" aria-hidden="true"></a> - first item</span> +<span id="cb348-9"><a href="#cb348-9" aria-hidden="true"></a> - second item</span> +<span id="cb348-10"><a href="#cb348-10" aria-hidden="true"></a> - third item</span> +<span id="cb348-11"><a href="#cb348-11" aria-hidden="true"></a></span> +<span id="cb348-12"><a href="#cb348-12" aria-hidden="true"></a>The following list is loose:</span> +<span id="cb348-13"><a href="#cb348-13" aria-hidden="true"></a></span> +<span id="cb348-14"><a href="#cb348-14" aria-hidden="true"></a> - first item</span> +<span id="cb348-15"><a href="#cb348-15" aria-hidden="true"></a> - second item that spans</span> +<span id="cb348-16"><a href="#cb348-16" aria-hidden="true"></a></span> +<span id="cb348-17"><a href="#cb348-17" aria-hidden="true"></a> multiple paragraphs</span> +<span id="cb348-18"><a href="#cb348-18" aria-hidden="true"></a> - third item</span> +<span id="cb348-19"><a href="#cb348-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb348-20"><a href="#cb348-20" aria-hidden="true"></a></span> +<span id="cb348-21"><a href="#cb348-21" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{tightLists=false}</span> +<span id="cb348-22"><a href="#cb348-22" aria-hidden="true"></a>The following list is now also loose:</span> +<span id="cb348-23"><a href="#cb348-23" aria-hidden="true"></a></span> +<span id="cb348-24"><a href="#cb348-24" aria-hidden="true"></a> - first item</span> +<span id="cb348-25"><a href="#cb348-25" aria-hidden="true"></a> - second item</span> +<span id="cb348-26"><a href="#cb348-26" aria-hidden="true"></a> - third item</span> +<span id="cb348-27"><a href="#cb348-27" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb348-28"><a href="#cb348-28" aria-hidden="true"></a></span> +<span id="cb348-29"><a href="#cb348-29" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb349"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb349-1"><a href="#cb349-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The following list is tight:</p> @@ -4120,16 +4163,16 @@ Thomas,Edison,1847</code></pre> <li><p>third item</p></li> </ul> </blockquote> -<h4 data-number="2.2.1.42" id="option-underscores"><span class="header-section-number">2.2.1.42</span> Option <code>underscores</code></h4> +<h4 data-number="2.2.1.43" id="option-underscores"><span class="header-section-number">2.2.1.43</span> Option <code>underscores</code></h4> <dl> <dt><code>underscores</code> (default value: <code>true</code>)</dt> <dd><dl> <dt>true</dt> <dd><p>Both underscores and asterisks can be used to denote emphasis and strong emphasis:</p> -<div class="sourceCode" id="cb347"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb347-1"><a href="#cb347-1" aria-hidden="true"></a>*single asterisks*</span> -<span id="cb347-2"><a href="#cb347-2" aria-hidden="true"></a>_single underscores_</span> -<span id="cb347-3"><a href="#cb347-3" aria-hidden="true"></a>**double asterisks**</span> -<span id="cb347-4"><a href="#cb347-4" aria-hidden="true"></a>__double underscores__</span></code></pre></div> +<div class="sourceCode" id="cb350"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb350-1"><a href="#cb350-1" aria-hidden="true"></a>*single asterisks*</span> +<span id="cb350-2"><a href="#cb350-2" aria-hidden="true"></a>_single underscores_</span> +<span id="cb350-3"><a href="#cb350-3" aria-hidden="true"></a>**double asterisks**</span> +<span id="cb350-4"><a href="#cb350-4" aria-hidden="true"></a>__double underscores__</span></code></pre></div> </dd> </dl> </dd> @@ -4142,43 +4185,43 @@ Thomas,Edison,1847</code></pre> </dl> <h5 class="unnumbered" data-number="" id="plain-tex-example-17">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb348"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb348-1"><a href="#cb348-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb348-2"><a href="#cb348-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> -<span id="cb348-3"><a href="#cb348-3" aria-hidden="true"></a></span> -<span id="cb348-4"><a href="#cb348-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb348-5"><a href="#cb348-5" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> -<span id="cb348-6"><a href="#cb348-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb348-7"><a href="#cb348-7" aria-hidden="true"></a></span> -<span id="cb348-8"><a href="#cb348-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionUnderscores</span>{false}</span> -<span id="cb348-9"><a href="#cb348-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb348-10"><a href="#cb348-10" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> -<span id="cb348-11"><a href="#cb348-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb348-12"><a href="#cb348-12" aria-hidden="true"></a></span> -<span id="cb348-13"><a href="#cb348-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb351"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb351-1"><a href="#cb351-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb351-2"><a href="#cb351-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> +<span id="cb351-3"><a href="#cb351-3" aria-hidden="true"></a></span> +<span id="cb351-4"><a href="#cb351-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb351-5"><a href="#cb351-5" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> +<span id="cb351-6"><a href="#cb351-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb351-7"><a href="#cb351-7" aria-hidden="true"></a></span> +<span id="cb351-8"><a href="#cb351-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionUnderscores</span>{false}</span> +<span id="cb351-9"><a href="#cb351-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb351-10"><a href="#cb351-10" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> +<span id="cb351-11"><a href="#cb351-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb351-12"><a href="#cb351-12" aria-hidden="true"></a></span> +<span id="cb351-13"><a href="#cb351-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb349"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb349-1"><a href="#cb349-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb352"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb352-1"><a href="#cb352-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasized text</em> and this is a math subscript: <em>mₙ</em>.</p> <p>This is <em>emphasized text</em> and this is a math subscript: <em>mₙ</em>.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-37"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-38"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb350"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb350-1"><a href="#cb350-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb350-2"><a href="#cb350-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[hybrid]{<span class="ex">markdown</span>}</span> -<span id="cb350-3"><a href="#cb350-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb350-4"><a href="#cb350-4" aria-hidden="true"></a></span> -<span id="cb350-5"><a href="#cb350-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb350-6"><a href="#cb350-6" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> -<span id="cb350-7"><a href="#cb350-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb350-8"><a href="#cb350-8" aria-hidden="true"></a></span> -<span id="cb350-9"><a href="#cb350-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{underscores=false}</span> -<span id="cb350-10"><a href="#cb350-10" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> -<span id="cb350-11"><a href="#cb350-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb350-12"><a href="#cb350-12" aria-hidden="true"></a></span> -<span id="cb350-13"><a href="#cb350-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb353"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb353-1"><a href="#cb353-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb353-2"><a href="#cb353-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[hybrid]{<span class="ex">markdown</span>}</span> +<span id="cb353-3"><a href="#cb353-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb353-4"><a href="#cb353-4" aria-hidden="true"></a></span> +<span id="cb353-5"><a href="#cb353-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb353-6"><a href="#cb353-6" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> +<span id="cb353-7"><a href="#cb353-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb353-8"><a href="#cb353-8" aria-hidden="true"></a></span> +<span id="cb353-9"><a href="#cb353-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{underscores=false}</span> +<span id="cb353-10"><a href="#cb353-10" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> +<span id="cb353-11"><a href="#cb353-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb353-12"><a href="#cb353-12" aria-hidden="true"></a></span> +<span id="cb353-13"><a href="#cb353-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb351"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb351-1"><a href="#cb351-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb354"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb354-1"><a href="#cb354-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasized text</em> and this is a math subscript: <em>mₙ</em>.</p> @@ -4186,22 +4229,22 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-31">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb352"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb352-1"><a href="#cb352-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb352-2"><a href="#cb352-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> -<span id="cb352-3"><a href="#cb352-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb352-4"><a href="#cb352-4" aria-hidden="true"></a></span> -<span id="cb352-5"><a href="#cb352-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb352-6"><a href="#cb352-6" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> -<span id="cb352-7"><a href="#cb352-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb352-8"><a href="#cb352-8" aria-hidden="true"></a></span> -<span id="cb352-9"><a href="#cb352-9" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[underscores = yes]</span> -<span id="cb352-10"><a href="#cb352-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb352-11"><a href="#cb352-11" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> -<span id="cb352-12"><a href="#cb352-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb352-13"><a href="#cb352-13" aria-hidden="true"></a></span> -<span id="cb352-14"><a href="#cb352-14" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb355"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb355-1"><a href="#cb355-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb355-2"><a href="#cb355-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> +<span id="cb355-3"><a href="#cb355-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb355-4"><a href="#cb355-4" aria-hidden="true"></a></span> +<span id="cb355-5"><a href="#cb355-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb355-6"><a href="#cb355-6" aria-hidden="true"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span> +<span id="cb355-7"><a href="#cb355-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb355-8"><a href="#cb355-8" aria-hidden="true"></a></span> +<span id="cb355-9"><a href="#cb355-9" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[underscores = yes]</span> +<span id="cb355-10"><a href="#cb355-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb355-11"><a href="#cb355-11" aria-hidden="true"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span> +<span id="cb355-12"><a href="#cb355-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb355-13"><a href="#cb355-13" aria-hidden="true"></a></span> +<span id="cb355-14"><a href="#cb355-14" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb353"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb353-1"><a href="#cb353-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb356"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb356-1"><a href="#cb356-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasized text</em> and this is a math subscript: <em>mₙ</em>.</p> @@ -4211,7 +4254,7 @@ Thomas,Edison,1847</code></pre> <p>Plain <span class="tex">T<sub>e</sub>X</span> options control the communication between the <span class="tex">T<sub>e</sub>X</span> interface and the <code>markdown</code> Lua module. They are supported by all higher-level interfaces of the Markdown package, i.e. the plain <span class="tex">T<sub>e</sub>X</span>, <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> and Con<span class="tex">T<sub>e</sub>X</span>t interfaces.</p> <h4 data-number="2.2.2.1" id="setting-lua-options-from-plain-tex"><span class="header-section-number">2.2.2.1</span> Setting Lua options from plain <span class="tex">T<sub>e</sub>X</span></h4> <p>As a rule of thumb, you can set all Lua options directly from plain <span class="tex">T<sub>e</sub>X</span>. For example, to set the <strong><code>taskLists</code></strong> Lua option to <code>true</code>, you would include the following code in your plain <span class="tex">T<sub>e</sub>X</span> document:</p> -<div class="sourceCode" id="cb354"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb354-1"><a href="#cb354-1" aria-hidden="true"></a><span class="fu">\def\markdownOptionTaskLists</span>{true}</span></code></pre></div> +<div class="sourceCode" id="cb357"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb357-1"><a href="#cb357-1" aria-hidden="true"></a><span class="fu">\def\markdownOptionTaskLists</span>{true}</span></code></pre></div> <h4 data-number="2.2.2.2" id="finalizing-and-freezing-the-cache"><span class="header-section-number">2.2.2.2</span> Finalizing and Freezing the Cache</h4> <p>The <code>\markdownOptionFrozenCache</code> option uses the mapping previously created by the Lua interface <strong><code>finalizeCache</code></strong> option, and uses it to typeset the plain <span class="tex">T<sub>e</sub>X</span> document without invoking Lua. As a result, the plain <span class="tex">T<sub>e</sub>X</span> document becomes more portable, but further changes in the order and the content of markdown documents will not be reflected. It defaults to <code>false</code>.</p> <p>The standard usage of the <strong><code>finalizeCache</code></strong> and <strong><code>frozenCache</code></strong> options is as follows:</p> @@ -4236,68 +4279,68 @@ Thomas,Edison,1847</code></pre> </ul> <p>The <code>\markdownOptionCacheDir</code> and <code>\markdownOptionFrozenCacheFileName</code> commands correspond to the <code>cacheDir</code> and <code>frozenCacheFileName</code> Lua options.</p> <p>Using a text editor, create a folder named <code>output-directory</code> and a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb355"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb355-1"><a href="#cb355-1" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb355-2"><a href="#cb355-2" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb355-3"><a href="#cb355-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionHelperScriptFileName</span>{helper-script.lua}</span> -<span id="cb355-4"><a href="#cb355-4" aria-hidden="true"></a><span class="fu">\def\markdownOptionInputTempFileName</span>{temporary-input.md}</span> -<span id="cb355-5"><a href="#cb355-5" aria-hidden="true"></a><span class="fu">\def\markdownOptionOutputTempFileName</span>{temporary-output.tex}</span> -<span id="cb355-6"><a href="#cb355-6" aria-hidden="true"></a><span class="fu">\def\markdownOptionErrorTempFileName</span>{error-output.txt}</span> -<span id="cb355-7"><a href="#cb355-7" aria-hidden="true"></a><span class="fu">\def\markdownOptionOutputDir</span>{output-directory}</span> -<span id="cb355-8"><a href="#cb355-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionCacheDir</span>{output-directory/cache-directory}</span> -<span id="cb355-9"><a href="#cb355-9" aria-hidden="true"></a><span class="fu">\markdownOptionFinalizeCachetrue</span></span> -<span id="cb355-10"><a href="#cb355-10" aria-hidden="true"></a><span class="fu">\def\markdownOptionFrozenCacheFileName</span>{output-directory/cache-directory/frozen-cache.tex}</span> -<span id="cb355-11"><a href="#cb355-11" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb355-12"><a href="#cb355-12" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb355-13"><a href="#cb355-13" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb355-14"><a href="#cb355-14" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb356"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb356-1"><a href="#cb356-1" aria-hidden="true"></a><span class="ex">luatex</span> --output-directory output-directory document.tex</span></code></pre></div> +<div class="sourceCode" id="cb358"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb358-1"><a href="#cb358-1" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb358-2"><a href="#cb358-2" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb358-3"><a href="#cb358-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionHelperScriptFileName</span>{helper-script.lua}</span> +<span id="cb358-4"><a href="#cb358-4" aria-hidden="true"></a><span class="fu">\def\markdownOptionInputTempFileName</span>{temporary-input.md}</span> +<span id="cb358-5"><a href="#cb358-5" aria-hidden="true"></a><span class="fu">\def\markdownOptionOutputTempFileName</span>{temporary-output.tex}</span> +<span id="cb358-6"><a href="#cb358-6" aria-hidden="true"></a><span class="fu">\def\markdownOptionErrorTempFileName</span>{error-output.txt}</span> +<span id="cb358-7"><a href="#cb358-7" aria-hidden="true"></a><span class="fu">\def\markdownOptionOutputDir</span>{output-directory}</span> +<span id="cb358-8"><a href="#cb358-8" aria-hidden="true"></a><span class="fu">\def\markdownOptionCacheDir</span>{output-directory/cache-directory}</span> +<span id="cb358-9"><a href="#cb358-9" aria-hidden="true"></a><span class="fu">\markdownOptionFinalizeCachetrue</span></span> +<span id="cb358-10"><a href="#cb358-10" aria-hidden="true"></a><span class="fu">\def\markdownOptionFrozenCacheFileName</span>{output-directory/cache-directory/frozen-cache.tex}</span> +<span id="cb358-11"><a href="#cb358-11" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb358-12"><a href="#cb358-12" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb358-13"><a href="#cb358-13" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb358-14"><a href="#cb358-14" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb359"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb359-1"><a href="#cb359-1" aria-hidden="true"></a><span class="ex">luatex</span> --output-directory output-directory document.tex</span></code></pre></div> <p>A text document named <code>temporary-input.md</code> should be produced in the folder named <code>output-directory</code> and contain the following text:</p> <blockquote> <p>Hello *world*!</p> </blockquote> <p>A folder named <code>output-directory/cache-directory</code> should also be produced and contain fragments of the converted markdown document. LuaTeX does not need other temporary files to perform the conversion from markdown to <span class="tex">T<sub>e</sub>X</span>. To produce the remaining temporary files, invoke pdfTeX from the terminal:</p> -<div class="sourceCode" id="cb357"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb357-1"><a href="#cb357-1" aria-hidden="true"></a><span class="ex">pdftex</span> --output-directory output-directory --shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb360"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb360-1"><a href="#cb360-1" aria-hidden="true"></a><span class="ex">pdftex</span> --output-directory output-directory --shell-escape document.tex</span></code></pre></div> <p>Text documents named <code>helper-script.lua</code>, and <code>temporary-output.md</code> should be produced in the folder named <code>output-directory</code>. The document named <code>helper-script.lua</code> will contain Lua code that was executed to convert markdown to plain <span class="tex">T<sub>e</sub>X</span>. The document named <code>temporary-output.tex</code> will contain the input markdown document converted to <span class="tex">T<sub>e</sub>X</span>.</p> <p>No document named <code>error-output.txt</code> should be produced in the folder named <code>output-directory</code>. This document would only be produced if an error had occured while executing the Lua code. If this happens, please <a href="https://github.com/witiko/markdown/issues">file a bug</a>.</p> <h4 data-number="2.2.2.4" id="package-documentation"><span class="header-section-number">2.2.2.4</span> Package Documentation</h4> <p>The <code>\markdownOptionStripPercentSigns</code> macro controls whether a percent sign (<code>\%</code>) at the beginning of a line will be discarded when reading Markdown input from a <span class="tex">T<sub>e</sub>X</span> document. This enables the use of markdown when writing <span class="tex">T<sub>e</sub>X</span> package documentation using the <a href="https://ctan.org/pkg/doc" title="doc – Format LaTeX documentation">Doc <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> package</a> by Frank Mittelbach. The recognized values of the macro are <code>true</code> (discard) and <code>false</code> (retain). It defaults to <code>false</code>.</p> <p>Using a text editor, create a text document named <code>document.dtx</code> with the following content:</p> -<div class="sourceCode" id="cb358"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb358-1"><a href="#cb358-1" aria-hidden="true"></a><span class="co">% \iffalse</span></span> -<span id="cb358-2"><a href="#cb358-2" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">ltxdoc</span>}</span> -<span id="cb358-3"><a href="#cb358-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripPercentSigns]{<span class="ex">markdown</span>}</span> -<span id="cb358-4"><a href="#cb358-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb358-5"><a href="#cb358-5" aria-hidden="true"></a><span class="fu">\DocInput</span>{document.dtx}</span> -<span id="cb358-6"><a href="#cb358-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span> -<span id="cb358-7"><a href="#cb358-7" aria-hidden="true"></a><span class="co">% \fi</span></span> -<span id="cb358-8"><a href="#cb358-8" aria-hidden="true"></a><span class="co">%</span></span> -<span id="cb358-9"><a href="#cb358-9" aria-hidden="true"></a><span class="co">% \begin{markdown}</span></span> -<span id="cb358-10"><a href="#cb358-10" aria-hidden="true"></a><span class="co">% Hello *world*!</span></span> -<span id="cb358-11"><a href="#cb358-11" aria-hidden="true"></a><span class="co">% \end{markdown}</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb359"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb359-1"><a href="#cb359-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.dtx</span></code></pre></div> +<div class="sourceCode" id="cb361"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb361-1"><a href="#cb361-1" aria-hidden="true"></a><span class="co">% \iffalse</span></span> +<span id="cb361-2"><a href="#cb361-2" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">ltxdoc</span>}</span> +<span id="cb361-3"><a href="#cb361-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[stripPercentSigns]{<span class="ex">markdown</span>}</span> +<span id="cb361-4"><a href="#cb361-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb361-5"><a href="#cb361-5" aria-hidden="true"></a><span class="fu">\DocInput</span>{document.dtx}</span> +<span id="cb361-6"><a href="#cb361-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span> +<span id="cb361-7"><a href="#cb361-7" aria-hidden="true"></a><span class="co">% \fi</span></span> +<span id="cb361-8"><a href="#cb361-8" aria-hidden="true"></a><span class="co">%</span></span> +<span id="cb361-9"><a href="#cb361-9" aria-hidden="true"></a><span class="co">% \begin{markdown}</span></span> +<span id="cb361-10"><a href="#cb361-10" aria-hidden="true"></a><span class="co">% Hello *world*!</span></span> +<span id="cb361-11"><a href="#cb361-11" aria-hidden="true"></a><span class="co">% \end{markdown}</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb362"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb362-1"><a href="#cb362-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.dtx</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the text “Hello <em>world</em>!”</p> <h3 data-number="2.2.3" id="latex-1"><span class="header-section-number">2.2.3</span> <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span></h3> -<p><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> options allow us to disable the redefinition of the default renderer prototypes from plain <span class="tex">T<sub>e</sub>X</span>, load user-contributed themes, and invoke user-defined setup snippets.</p> +<p><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> options allow us to disable the redefinition of the default renderer prototypes from plain <span class="tex">T<sub>e</sub>X</span>, load user-defined themes, and invoke user-defined setup snippets.</p> <h4 data-number="2.2.3.1" id="setting-lua-and-plain-tex-options-from-latex"><span class="header-section-number">2.2.3.1</span> Setting Lua and plain <span class="tex">T<sub>e</sub>X</span> options from <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span></h4> <p>As a rule of thumb, we can set all Lua options directly from <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>. For example, to set the <strong><code>taskLists</code></strong> Lua option to <code>true</code>, we would include the following code in our <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p> -<div class="sourceCode" id="cb360"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb360-1"><a href="#cb360-1" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb360-2"><a href="#cb360-2" aria-hidden="true"></a> taskLists = true,</span> -<span id="cb360-3"><a href="#cb360-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb363"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb363-1"><a href="#cb363-1" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb363-2"><a href="#cb363-2" aria-hidden="true"></a> taskLists = true,</span> +<span id="cb363-3"><a href="#cb363-3" aria-hidden="true"></a>}</span></code></pre></div> <p>We can also set all plain <span class="tex">T<sub>e</sub>X</span> options directly from <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>. For example, to set the <code>\markdownOptionHelperScriptFileName</code> plain <span class="tex">T<sub>e</sub>X</span> option to <code>helper-script.lua</code>, we would inclde the following code in our <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p> -<div class="sourceCode" id="cb361"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb361-1"><a href="#cb361-1" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb361-2"><a href="#cb361-2" aria-hidden="true"></a> helperScriptFileName = helper-script.lua,</span> -<span id="cb361-3"><a href="#cb361-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb364"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb364-1"><a href="#cb364-1" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb364-2"><a href="#cb364-2" aria-hidden="true"></a> helperScriptFileName = helper-script.lua,</span> +<span id="cb364-3"><a href="#cb364-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: 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="cb362"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb362-1"><a href="#cb362-1" aria-hidden="true"></a><span class="bu">\usepackage</span>[plain]{<span class="ex">markdown</span>}</span></code></pre></div> +<div class="sourceCode" id="cb365"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb365-1"><a href="#cb365-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> +<p>User-defined <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> themes for the Markdown package provide a domain-specific interpretation of 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> <p>For example, to load themes named <code>witiko/beamer/MU</code> and <code>witiko/dot</code>, you would use the following code in the preamble of your document:</p> -<div class="sourceCode" id="cb363"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb363-1"><a href="#cb363-1" aria-hidden="true"></a><span class="bu">\usepackage</span>[</span> -<span id="cb363-2"><a href="#cb363-2" aria-hidden="true"></a> theme = witiko/beamer/MU,</span> -<span id="cb363-3"><a href="#cb363-3" aria-hidden="true"></a> theme = witiko/dot,</span> -<span id="cb363-4"><a href="#cb363-4" aria-hidden="true"></a>]{<span class="ex">markdown</span>}</span></code></pre></div> +<div class="sourceCode" id="cb366"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb366-1"><a href="#cb366-1" aria-hidden="true"></a><span class="bu">\usepackage</span>[</span> +<span id="cb366-2"><a href="#cb366-2" aria-hidden="true"></a> theme = witiko/beamer/MU,</span> +<span id="cb366-3"><a href="#cb366-3" aria-hidden="true"></a> theme = witiko/dot,</span> +<span id="cb366-4"><a href="#cb366-4" aria-hidden="true"></a>]{<span class="ex">markdown</span>}</span></code></pre></div> <p>Due to limitations of <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>, themes may not be loaded after the beginning of a <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document.</p> <p>Example themes provided with the Markdown package include:</p> <dl> @@ -4305,44 +4348,44 @@ Thomas,Edison,1847</code></pre> <dd><p>A theme that typesets fenced code blocks with the <code>dot …</code> infostring as images of directed graphs rendered by the Graphviz tools. The right tail of the infostring is used as the image title. The theme requires a Unix-like operating system with GNU Diffutils and Graphviz installed. The theme also requires shell access unless the <code>\markdownOptionFrozenCache</code> plain <span class="tex">T<sub>e</sub>X</span> option is enabled.</p> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-38"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-39"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb364"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb364-1"><a href="#cb364-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb364-2"><a href="#cb364-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/dot]{<span class="ex">markdown</span>}</span> -<span id="cb364-3"><a href="#cb364-3" aria-hidden="true"></a><span class="fu">\setkeys</span>{Gin}{</span> -<span id="cb364-4"><a href="#cb364-4" aria-hidden="true"></a> width=<span class="fu">\columnwidth</span>,</span> -<span id="cb364-5"><a href="#cb364-5" aria-hidden="true"></a> height=0.65<span class="fu">\paperheight</span>,</span> -<span id="cb364-6"><a href="#cb364-6" aria-hidden="true"></a> keepaspectratio}</span> -<span id="cb364-7"><a href="#cb364-7" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb364-8"><a href="#cb364-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb364-9"><a href="#cb364-9" aria-hidden="true"></a>``` dot Various formats of mathemathical formulae</span> -<span id="cb364-10"><a href="#cb364-10" aria-hidden="true"></a>digraph tree {</span> -<span id="cb364-11"><a href="#cb364-11" aria-hidden="true"></a> margin = 0;</span> -<span id="cb364-12"><a href="#cb364-12" aria-hidden="true"></a> rankdir = "LR";</span> -<span id="cb364-13"><a href="#cb364-13" aria-hidden="true"></a></span> -<span id="cb364-14"><a href="#cb364-14" aria-hidden="true"></a> latex -> pmml;</span> -<span id="cb364-15"><a href="#cb364-15" aria-hidden="true"></a> latex -> cmml;</span> -<span id="cb364-16"><a href="#cb364-16" aria-hidden="true"></a> pmml -> slt;</span> -<span id="cb364-17"><a href="#cb364-17" aria-hidden="true"></a> cmml -> opt;</span> -<span id="cb364-18"><a href="#cb364-18" aria-hidden="true"></a> cmml -> prefix;</span> -<span id="cb364-19"><a href="#cb364-19" aria-hidden="true"></a> cmml -> infix;</span> -<span id="cb364-20"><a href="#cb364-20" aria-hidden="true"></a> pmml -> mterms [style=dashed];</span> -<span id="cb364-21"><a href="#cb364-21" aria-hidden="true"></a> cmml -> mterms;</span> -<span id="cb364-22"><a href="#cb364-22" aria-hidden="true"></a></span> -<span id="cb364-23"><a href="#cb364-23" aria-hidden="true"></a> latex [label = "LaTeX"];</span> -<span id="cb364-24"><a href="#cb364-24" aria-hidden="true"></a> pmml [label = "Presentation MathML"];</span> -<span id="cb364-25"><a href="#cb364-25" aria-hidden="true"></a> cmml [label = "Content MathML"];</span> -<span id="cb364-26"><a href="#cb364-26" aria-hidden="true"></a> slt [label = "Symbol Layout Tree"];</span> -<span id="cb364-27"><a href="#cb364-27" aria-hidden="true"></a> opt [label = "Operator Tree"];</span> -<span id="cb364-28"><a href="#cb364-28" aria-hidden="true"></a> prefix [label = "Prefix"];</span> -<span id="cb364-29"><a href="#cb364-29" aria-hidden="true"></a> infix [label = "Infix"];</span> -<span id="cb364-30"><a href="#cb364-30" aria-hidden="true"></a> mterms [label = "M-Terms"];</span> -<span id="cb364-31"><a href="#cb364-31" aria-hidden="true"></a>}</span> -<span id="cb364-32"><a href="#cb364-32" aria-hidden="true"></a>```</span> -<span id="cb364-33"><a href="#cb364-33" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb364-34"><a href="#cb364-34" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb365"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb365-1"><a href="#cb365-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb367"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb367-1"><a href="#cb367-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb367-2"><a href="#cb367-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/dot]{<span class="ex">markdown</span>}</span> +<span id="cb367-3"><a href="#cb367-3" aria-hidden="true"></a><span class="fu">\setkeys</span>{Gin}{</span> +<span id="cb367-4"><a href="#cb367-4" aria-hidden="true"></a> width=<span class="fu">\columnwidth</span>,</span> +<span id="cb367-5"><a href="#cb367-5" aria-hidden="true"></a> height=0.65<span class="fu">\paperheight</span>,</span> +<span id="cb367-6"><a href="#cb367-6" aria-hidden="true"></a> keepaspectratio}</span> +<span id="cb367-7"><a href="#cb367-7" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb367-8"><a href="#cb367-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb367-9"><a href="#cb367-9" aria-hidden="true"></a>``` dot Various formats of mathemathical formulae</span> +<span id="cb367-10"><a href="#cb367-10" aria-hidden="true"></a>digraph tree {</span> +<span id="cb367-11"><a href="#cb367-11" aria-hidden="true"></a> margin = 0;</span> +<span id="cb367-12"><a href="#cb367-12" aria-hidden="true"></a> rankdir = "LR";</span> +<span id="cb367-13"><a href="#cb367-13" aria-hidden="true"></a></span> +<span id="cb367-14"><a href="#cb367-14" aria-hidden="true"></a> latex -> pmml;</span> +<span id="cb367-15"><a href="#cb367-15" aria-hidden="true"></a> latex -> cmml;</span> +<span id="cb367-16"><a href="#cb367-16" aria-hidden="true"></a> pmml -> slt;</span> +<span id="cb367-17"><a href="#cb367-17" aria-hidden="true"></a> cmml -> opt;</span> +<span id="cb367-18"><a href="#cb367-18" aria-hidden="true"></a> cmml -> prefix;</span> +<span id="cb367-19"><a href="#cb367-19" aria-hidden="true"></a> cmml -> infix;</span> +<span id="cb367-20"><a href="#cb367-20" aria-hidden="true"></a> pmml -> mterms [style=dashed];</span> +<span id="cb367-21"><a href="#cb367-21" aria-hidden="true"></a> cmml -> mterms;</span> +<span id="cb367-22"><a href="#cb367-22" aria-hidden="true"></a></span> +<span id="cb367-23"><a href="#cb367-23" aria-hidden="true"></a> latex [label = "LaTeX"];</span> +<span id="cb367-24"><a href="#cb367-24" aria-hidden="true"></a> pmml [label = "Presentation MathML"];</span> +<span id="cb367-25"><a href="#cb367-25" aria-hidden="true"></a> cmml [label = "Content MathML"];</span> +<span id="cb367-26"><a href="#cb367-26" aria-hidden="true"></a> slt [label = "Symbol Layout Tree"];</span> +<span id="cb367-27"><a href="#cb367-27" aria-hidden="true"></a> opt [label = "Operator Tree"];</span> +<span id="cb367-28"><a href="#cb367-28" aria-hidden="true"></a> prefix [label = "Prefix"];</span> +<span id="cb367-29"><a href="#cb367-29" aria-hidden="true"></a> infix [label = "Infix"];</span> +<span id="cb367-30"><a href="#cb367-30" aria-hidden="true"></a> mterms [label = "M-Terms"];</span> +<span id="cb367-31"><a href="#cb367-31" aria-hidden="true"></a>}</span> +<span id="cb367-32"><a href="#cb367-32" aria-hidden="true"></a>```</span> +<span id="cb367-33"><a href="#cb367-33" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb367-34"><a href="#cb367-34" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb368"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb368-1"><a href="#cb368-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain a drawing of a directed graph similar to Figure 1 from the following conference article:</p> <blockquote> <p>NOVOTNÝ, Vít, Petr SOJKA, Michal ŠTEFÁNIK and Dávid LUPTÁK. Three is Better than One: Ensembling Math Information Retrieval Systems. <em>CEUR Workshop Proceedings</em>. Thessaloniki, Greece: M. Jeusfeld c/o Redaktion Sun SITE, Informatik V, RWTH Aachen., 2020, vol. 2020, No 2696, p. 1-30. ISSN 1613-0073. <a href="http://ceur-ws.org/Vol-2696/paper_235.pdf" class="uri">http://ceur-ws.org/Vol-2696/paper_235.pdf</a></p> @@ -4352,18 +4395,18 @@ Thomas,Edison,1847</code></pre> <dd><p>A theme that adds support for downloading images whose URL has the http or https protocol. The theme requires the <strong><code>catchfile</code></strong> <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> package and a Unix-like operating system with GNU Coreutils <code>md5sum</code> and either GNU Wget or cURL installed. The theme also requires shell access unless the <code>\markdownOptionFrozenCache</code> plain <span class="tex">T<sub>e</sub>X</span> option is enabled.</p> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-39"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-40"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb366"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb366-1"><a href="#cb366-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb366-2"><a href="#cb366-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/graphicx/http]{<span class="ex">markdown</span>}</span> -<span id="cb366-3"><a href="#cb366-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb366-4"><a href="#cb366-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb366-5"><a href="#cb366-5" aria-hidden="true"></a>![img](https://github.com/witiko/markdown/raw/main/markdown.png</span> -<span id="cb366-6"><a href="#cb366-6" aria-hidden="true"></a> "The banner of the Markdown package")</span> -<span id="cb366-7"><a href="#cb366-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb366-8"><a href="#cb366-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb369"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb369-1"><a href="#cb369-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb369-2"><a href="#cb369-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/graphicx/http]{<span class="ex">markdown</span>}</span> +<span id="cb369-3"><a href="#cb369-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb369-4"><a href="#cb369-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb369-5"><a href="#cb369-5" aria-hidden="true"></a>![img](https://github.com/witiko/markdown/raw/main/markdown.png</span> +<span id="cb369-6"><a href="#cb369-6" aria-hidden="true"></a> "The banner of the Markdown package")</span> +<span id="cb369-7"><a href="#cb369-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb369-8"><a href="#cb369-8" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb367"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb367-1"><a href="#cb367-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb370"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb370-1"><a href="#cb370-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following image:</p> <blockquote> <figure> @@ -4375,71 +4418,71 @@ Thomas,Edison,1847</code></pre> <dd><p>A theme that makes tilde (<code>~</code>) always typeset the non-breaking space even when the <strong><code>hybrid</code></strong> Lua option is disabled.</p> </dd> </dl> -<h5 class="unnumbered" data-number="" id="latex-example-40"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-41"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb368"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb368-1"><a href="#cb368-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb368-2"><a href="#cb368-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/tilde]{<span class="ex">markdown</span>}</span> -<span id="cb368-3"><a href="#cb368-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb368-4"><a href="#cb368-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb368-5"><a href="#cb368-5" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> -<span id="cb368-6"><a href="#cb368-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb368-7"><a href="#cb368-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb371"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb371-1"><a href="#cb371-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb371-2"><a href="#cb371-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[theme=witiko/tilde]{<span class="ex">markdown</span>}</span> +<span id="cb371-3"><a href="#cb371-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb371-4"><a href="#cb371-4" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb371-5"><a href="#cb371-5" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> +<span id="cb371-6"><a href="#cb371-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb371-7"><a href="#cb371-7" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb369"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb369-1"><a href="#cb369-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb372"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb372-1"><a href="#cb372-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text, where the middot (<code>·</code>) denotes a non-breaking space:</p> <blockquote> <p>Bartel·Leendert van·der·Waerden</p> </blockquote> <h4 data-number="2.2.3.4" id="latexsetupsnippets"><span class="header-section-number">2.2.3.4</span> <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> setup snippets</h4> -<p>User-contributed <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> themes provide global control over high-level goals. However, it is often desirable to change only some local aspects of a document. <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> setup snippets provide syntactic sugar for defining and invoking various options locally.</p> +<p>User-defined <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> themes provide global control over high-level goals. However, it is often desirable to change only some local aspects of a document. <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> setup snippets provide syntactic sugar for defining and invoking various options locally.</p> <p>Here is how we can use setup snippets to store options and invoke them later:</p> -<div class="sourceCode" id="cb370"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb370-1"><a href="#cb370-1" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{romanNumerals}{</span> -<span id="cb370-2"><a href="#cb370-2" aria-hidden="true"></a> renderers = {</span> -<span id="cb370-3"><a href="#cb370-3" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> -<span id="cb370-4"><a href="#cb370-4" aria-hidden="true"></a> <span class="fu">\item</span>[<span class="fu">\romannumeral</span>#1<span class="fu">\relax</span>.]<span class="co">%</span></span> -<span id="cb370-5"><a href="#cb370-5" aria-hidden="true"></a> },</span> -<span id="cb370-6"><a href="#cb370-6" aria-hidden="true"></a> },</span> -<span id="cb370-7"><a href="#cb370-7" aria-hidden="true"></a>}</span> -<span id="cb370-8"><a href="#cb370-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb370-9"><a href="#cb370-9" aria-hidden="true"></a></span> -<span id="cb370-10"><a href="#cb370-10" aria-hidden="true"></a>The following ordered list will be preceded by arabic numerals:</span> -<span id="cb370-11"><a href="#cb370-11" aria-hidden="true"></a></span> -<span id="cb370-12"><a href="#cb370-12" aria-hidden="true"></a>1. wahid</span> -<span id="cb370-13"><a href="#cb370-13" aria-hidden="true"></a>2. aithnayn</span> -<span id="cb370-14"><a href="#cb370-14" aria-hidden="true"></a></span> -<span id="cb370-15"><a href="#cb370-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb370-16"><a href="#cb370-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{snippet=romanNumerals}</span> -<span id="cb370-17"><a href="#cb370-17" aria-hidden="true"></a></span> -<span id="cb370-18"><a href="#cb370-18" aria-hidden="true"></a>The following ordered list will be preceded by roman numerals:</span> -<span id="cb370-19"><a href="#cb370-19" aria-hidden="true"></a></span> -<span id="cb370-20"><a href="#cb370-20" aria-hidden="true"></a>3. tres</span> -<span id="cb370-21"><a href="#cb370-21" aria-hidden="true"></a>4. quattuor</span> -<span id="cb370-22"><a href="#cb370-22" aria-hidden="true"></a></span> -<span id="cb370-23"><a href="#cb370-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span></code></pre></div> +<div class="sourceCode" id="cb373"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb373-1"><a href="#cb373-1" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{romanNumerals}{</span> +<span id="cb373-2"><a href="#cb373-2" aria-hidden="true"></a> renderers = {</span> +<span id="cb373-3"><a href="#cb373-3" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> +<span id="cb373-4"><a href="#cb373-4" aria-hidden="true"></a> <span class="fu">\item</span>[<span class="fu">\romannumeral</span>#1<span class="fu">\relax</span>.]<span class="co">%</span></span> +<span id="cb373-5"><a href="#cb373-5" aria-hidden="true"></a> },</span> +<span id="cb373-6"><a href="#cb373-6" aria-hidden="true"></a> },</span> +<span id="cb373-7"><a href="#cb373-7" aria-hidden="true"></a>}</span> +<span id="cb373-8"><a href="#cb373-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb373-9"><a href="#cb373-9" aria-hidden="true"></a></span> +<span id="cb373-10"><a href="#cb373-10" aria-hidden="true"></a>The following ordered list will be preceded by arabic numerals:</span> +<span id="cb373-11"><a href="#cb373-11" aria-hidden="true"></a></span> +<span id="cb373-12"><a href="#cb373-12" aria-hidden="true"></a>1. wahid</span> +<span id="cb373-13"><a href="#cb373-13" aria-hidden="true"></a>2. aithnayn</span> +<span id="cb373-14"><a href="#cb373-14" aria-hidden="true"></a></span> +<span id="cb373-15"><a href="#cb373-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb373-16"><a href="#cb373-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{snippet=romanNumerals}</span> +<span id="cb373-17"><a href="#cb373-17" aria-hidden="true"></a></span> +<span id="cb373-18"><a href="#cb373-18" aria-hidden="true"></a>The following ordered list will be preceded by roman numerals:</span> +<span id="cb373-19"><a href="#cb373-19" aria-hidden="true"></a></span> +<span id="cb373-20"><a href="#cb373-20" aria-hidden="true"></a>3. tres</span> +<span id="cb373-21"><a href="#cb373-21" aria-hidden="true"></a>4. quattuor</span> +<span id="cb373-22"><a href="#cb373-22" aria-hidden="true"></a></span> +<span id="cb373-23"><a href="#cb373-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span></code></pre></div> <h2 data-number="2.3" id="markdown-tokens"><span class="header-section-number">2.3</span> Markdown Tokens</h2> <p>A key feature of the Markdown package is the support for manipulating markdown tokens, such as headings, emphasized text, links, and lists, in <span class="tex">T<sub>e</sub>X</span>. Instead of reducing <span class="tex">T<sub>e</sub>X</span> to a PDF document producer, the Markdown package allows the user to specify how every markdown token should be processed and rendered.</p> <h3 data-number="2.3.1" id="texrenderersuser"><span class="header-section-number">2.3.1</span> Token Renderers</h3> <p>Token renderers are user-defined <span class="tex">T<sub>e</sub>X</span> macros, which render markdown tokens. In this section, I will describe the individual token renderers.</p> <h4 data-number="2.3.1.1" id="tickbox-renderers"><span class="header-section-number">2.3.1.1</span> Tickbox Renderers</h4> <p>The macros named <code>\markdownRendererTickedBox</code>, <code>\markdownRendererHalfTickedBox</code>, and <code>\markdownRendererUntickedBox</code> represent ticked and unticked boxes, respectively. These macros will either be produced, when the <strong><code>taskLists</code></strong> option is enabled, or when the Ballot Box with X (☒, U+2612), Hourglass (⌛, U+231B) or Ballot Box (☐, U+2610) Unicode characters are encountered in the markdown input, respectively.</p> -<h5 class="unnumbered" data-number="" id="latex-example-41"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-42"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb371"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb371-1"><a href="#cb371-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb371-2"><a href="#cb371-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span> -<span id="cb371-3"><a href="#cb371-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb371-4"><a href="#cb371-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb371-5"><a href="#cb371-5" aria-hidden="true"></a> untickedBox = No,</span> -<span id="cb371-6"><a href="#cb371-6" aria-hidden="true"></a> tickedBox = Yes,</span> -<span id="cb371-7"><a href="#cb371-7" aria-hidden="true"></a> },</span> -<span id="cb371-8"><a href="#cb371-8" aria-hidden="true"></a>}</span> -<span id="cb371-9"><a href="#cb371-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb371-10"><a href="#cb371-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb371-11"><a href="#cb371-11" aria-hidden="true"></a>- [ ] you can't.</span> -<span id="cb371-12"><a href="#cb371-12" aria-hidden="true"></a>- [x] I can!</span> -<span id="cb371-13"><a href="#cb371-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb371-14"><a href="#cb371-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb374"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb374-1"><a href="#cb374-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb374-2"><a href="#cb374-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span> +<span id="cb374-3"><a href="#cb374-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb374-4"><a href="#cb374-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb374-5"><a href="#cb374-5" aria-hidden="true"></a> untickedBox = No,</span> +<span id="cb374-6"><a href="#cb374-6" aria-hidden="true"></a> tickedBox = Yes,</span> +<span id="cb374-7"><a href="#cb374-7" aria-hidden="true"></a> },</span> +<span id="cb374-8"><a href="#cb374-8" aria-hidden="true"></a>}</span> +<span id="cb374-9"><a href="#cb374-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb374-10"><a href="#cb374-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb374-11"><a href="#cb374-11" aria-hidden="true"></a>- [ ] you can't.</span> +<span id="cb374-12"><a href="#cb374-12" aria-hidden="true"></a>- [x] I can!</span> +<span id="cb374-13"><a href="#cb374-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb374-14"><a href="#cb374-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb372"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb372-1"><a href="#cb372-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb375"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb375-1"><a href="#cb375-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ul> @@ -4449,18 +4492,18 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-32">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb373"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb373-1"><a href="#cb373-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb373-2"><a href="#cb373-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span> -<span id="cb373-3"><a href="#cb373-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span> -<span id="cb373-4"><a href="#cb373-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span> -<span id="cb373-5"><a href="#cb373-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb373-6"><a href="#cb373-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb373-7"><a href="#cb373-7" aria-hidden="true"></a>- [ ] you can't.</span> -<span id="cb373-8"><a href="#cb373-8" aria-hidden="true"></a>- [x] I can!</span> -<span id="cb373-9"><a href="#cb373-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb373-10"><a href="#cb373-10" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb376"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb376-1"><a href="#cb376-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb376-2"><a href="#cb376-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span> +<span id="cb376-3"><a href="#cb376-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span> +<span id="cb376-4"><a href="#cb376-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span> +<span id="cb376-5"><a href="#cb376-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb376-6"><a href="#cb376-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb376-7"><a href="#cb376-7" aria-hidden="true"></a>- [ ] you can't.</span> +<span id="cb376-8"><a href="#cb376-8" aria-hidden="true"></a>- [x] I can!</span> +<span id="cb376-9"><a href="#cb376-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb376-10"><a href="#cb376-10" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb374"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb374-1"><a href="#cb374-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb377"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb377-1"><a href="#cb377-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <ul> @@ -4471,75 +4514,75 @@ Thomas,Edison,1847</code></pre> <h4 data-number="2.3.1.2" id="markdown-document-renderers"><span class="header-section-number">2.3.1.2</span> Markdown Document Renderers</h4> <p>The <code>\markdownRendererDocumentBegin</code> and <code>\markdownRendererDocumentEnd</code> macros represent the beginning and the end of a <em>markdown</em> document. The macros receive no arguments.</p> <p>A <span class="tex">T<sub>e</sub>X</span> document may contain any number of markdown documents. Additionally, markdown documents may appear not only in a sequence, but several markdown documents may also be <em>nested</em>. Redefinitions of the macros should take this into account.</p> -<h5 class="unnumbered" data-number="" id="latex-example-42"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-43"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>nested.md</code> with the following content:</p> -<div class="sourceCode" id="cb375"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb375-1"><a href="#cb375-1" aria-hidden="true"></a>This is a *nested* markdown document.</span></code></pre></div> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb376"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb376-1"><a href="#cb376-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb376-2"><a href="#cb376-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span> -<span id="cb376-3"><a href="#cb376-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb376-4"><a href="#cb376-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb376-5"><a href="#cb376-5" aria-hidden="true"></a> contentBlock = {<span class="co">%</span></span> -<span id="cb376-6"><a href="#cb376-6" aria-hidden="true"></a> <span class="fu">\markdownInput</span>{#3}<span class="co">%</span></span> -<span id="cb376-7"><a href="#cb376-7" aria-hidden="true"></a> },</span> -<span id="cb376-8"><a href="#cb376-8" aria-hidden="true"></a> documentBegin = {<span class="co">%</span></span> -<span id="cb376-9"><a href="#cb376-9" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-10"><a href="#cb376-10" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a document)}</span> -<span id="cb376-11"><a href="#cb376-11" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-12"><a href="#cb376-12" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> -<span id="cb376-13"><a href="#cb376-13" aria-hidden="true"></a> <span class="fu">\markdownSetup</span>{snippet=first-nesting-level}<span class="co">%</span></span> -<span id="cb376-14"><a href="#cb376-14" aria-hidden="true"></a> },</span> -<span id="cb376-15"><a href="#cb376-15" aria-hidden="true"></a> documentEnd = {<span class="co">%</span></span> -<span id="cb376-16"><a href="#cb376-16" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> -<span id="cb376-17"><a href="#cb376-17" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-18"><a href="#cb376-18" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a document)}</span> -<span id="cb376-19"><a href="#cb376-19" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-20"><a href="#cb376-20" aria-hidden="true"></a> },</span> -<span id="cb376-21"><a href="#cb376-21" aria-hidden="true"></a> },</span> -<span id="cb376-22"><a href="#cb376-22" aria-hidden="true"></a>}</span> -<span id="cb376-23"><a href="#cb376-23" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{first-nesting-level}{</span> -<span id="cb376-24"><a href="#cb376-24" aria-hidden="true"></a> renderers = {</span> -<span id="cb376-25"><a href="#cb376-25" aria-hidden="true"></a> documentBegin = {</span> -<span id="cb376-26"><a href="#cb376-26" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-27"><a href="#cb376-27" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span> -<span id="cb376-28"><a href="#cb376-28" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-29"><a href="#cb376-29" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> -<span id="cb376-30"><a href="#cb376-30" aria-hidden="true"></a> <span class="fu">\markdownSetup</span>{snippet=second-nesting-level-and-below}</span> -<span id="cb376-31"><a href="#cb376-31" aria-hidden="true"></a> },</span> -<span id="cb376-32"><a href="#cb376-32" aria-hidden="true"></a> },</span> -<span id="cb376-33"><a href="#cb376-33" aria-hidden="true"></a>}</span> -<span id="cb376-34"><a href="#cb376-34" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{second-nesting-level-and-below}{</span> -<span id="cb376-35"><a href="#cb376-35" aria-hidden="true"></a> renderers = {</span> -<span id="cb376-36"><a href="#cb376-36" aria-hidden="true"></a> documentBegin = {</span> -<span id="cb376-37"><a href="#cb376-37" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-38"><a href="#cb376-38" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span> -<span id="cb376-39"><a href="#cb376-39" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-40"><a href="#cb376-40" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> -<span id="cb376-41"><a href="#cb376-41" aria-hidden="true"></a> },</span> -<span id="cb376-42"><a href="#cb376-42" aria-hidden="true"></a> documentEnd = {</span> -<span id="cb376-43"><a href="#cb376-43" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> -<span id="cb376-44"><a href="#cb376-44" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-45"><a href="#cb376-45" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a nested document)}</span> -<span id="cb376-46"><a href="#cb376-46" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb376-47"><a href="#cb376-47" aria-hidden="true"></a> },</span> -<span id="cb376-48"><a href="#cb376-48" aria-hidden="true"></a> },</span> -<span id="cb376-49"><a href="#cb376-49" aria-hidden="true"></a>}</span> -<span id="cb376-50"><a href="#cb376-50" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb376-51"><a href="#cb376-51" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb376-52"><a href="#cb376-52" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb376-53"><a href="#cb376-53" aria-hidden="true"></a></span> -<span id="cb376-54"><a href="#cb376-54" aria-hidden="true"></a>/nested.md</span> -<span id="cb376-55"><a href="#cb376-55" aria-hidden="true"></a></span> -<span id="cb376-56"><a href="#cb376-56" aria-hidden="true"></a>_Foo_ bar!</span> -<span id="cb376-57"><a href="#cb376-57" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb376-58"><a href="#cb376-58" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb376-59"><a href="#cb376-59" aria-hidden="true"></a></span> -<span id="cb376-60"><a href="#cb376-60" aria-hidden="true"></a>Bar baz!</span> -<span id="cb376-61"><a href="#cb376-61" aria-hidden="true"></a></span> -<span id="cb376-62"><a href="#cb376-62" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb376-63"><a href="#cb376-63" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb377"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb377-1"><a href="#cb377-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb378"><pre class="sourceCode md"><code class="sourceCode markdown"><span id="cb378-1"><a href="#cb378-1" aria-hidden="true"></a>This is a *nested* markdown document.</span></code></pre></div> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb379"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb379-1"><a href="#cb379-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb379-2"><a href="#cb379-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span> +<span id="cb379-3"><a href="#cb379-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb379-4"><a href="#cb379-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb379-5"><a href="#cb379-5" aria-hidden="true"></a> contentBlock = {<span class="co">%</span></span> +<span id="cb379-6"><a href="#cb379-6" aria-hidden="true"></a> <span class="fu">\markdownInput</span>{#3}<span class="co">%</span></span> +<span id="cb379-7"><a href="#cb379-7" aria-hidden="true"></a> },</span> +<span id="cb379-8"><a href="#cb379-8" aria-hidden="true"></a> documentBegin = {<span class="co">%</span></span> +<span id="cb379-9"><a href="#cb379-9" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-10"><a href="#cb379-10" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a document)}</span> +<span id="cb379-11"><a href="#cb379-11" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-12"><a href="#cb379-12" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> +<span id="cb379-13"><a href="#cb379-13" aria-hidden="true"></a> <span class="fu">\markdownSetup</span>{snippet=first-nesting-level}<span class="co">%</span></span> +<span id="cb379-14"><a href="#cb379-14" aria-hidden="true"></a> },</span> +<span id="cb379-15"><a href="#cb379-15" aria-hidden="true"></a> documentEnd = {<span class="co">%</span></span> +<span id="cb379-16"><a href="#cb379-16" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> +<span id="cb379-17"><a href="#cb379-17" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-18"><a href="#cb379-18" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a document)}</span> +<span id="cb379-19"><a href="#cb379-19" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-20"><a href="#cb379-20" aria-hidden="true"></a> },</span> +<span id="cb379-21"><a href="#cb379-21" aria-hidden="true"></a> },</span> +<span id="cb379-22"><a href="#cb379-22" aria-hidden="true"></a>}</span> +<span id="cb379-23"><a href="#cb379-23" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{first-nesting-level}{</span> +<span id="cb379-24"><a href="#cb379-24" aria-hidden="true"></a> renderers = {</span> +<span id="cb379-25"><a href="#cb379-25" aria-hidden="true"></a> documentBegin = {</span> +<span id="cb379-26"><a href="#cb379-26" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-27"><a href="#cb379-27" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span> +<span id="cb379-28"><a href="#cb379-28" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-29"><a href="#cb379-29" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> +<span id="cb379-30"><a href="#cb379-30" aria-hidden="true"></a> <span class="fu">\markdownSetup</span>{snippet=second-nesting-level-and-below}</span> +<span id="cb379-31"><a href="#cb379-31" aria-hidden="true"></a> },</span> +<span id="cb379-32"><a href="#cb379-32" aria-hidden="true"></a> },</span> +<span id="cb379-33"><a href="#cb379-33" aria-hidden="true"></a>}</span> +<span id="cb379-34"><a href="#cb379-34" aria-hidden="true"></a><span class="fu">\markdownSetupSnippet</span>{second-nesting-level-and-below}{</span> +<span id="cb379-35"><a href="#cb379-35" aria-hidden="true"></a> renderers = {</span> +<span id="cb379-36"><a href="#cb379-36" aria-hidden="true"></a> documentBegin = {</span> +<span id="cb379-37"><a href="#cb379-37" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-38"><a href="#cb379-38" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span> +<span id="cb379-39"><a href="#cb379-39" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-40"><a href="#cb379-40" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> +<span id="cb379-41"><a href="#cb379-41" aria-hidden="true"></a> },</span> +<span id="cb379-42"><a href="#cb379-42" aria-hidden="true"></a> documentEnd = {</span> +<span id="cb379-43"><a href="#cb379-43" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> +<span id="cb379-44"><a href="#cb379-44" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-45"><a href="#cb379-45" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a nested document)}</span> +<span id="cb379-46"><a href="#cb379-46" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb379-47"><a href="#cb379-47" aria-hidden="true"></a> },</span> +<span id="cb379-48"><a href="#cb379-48" aria-hidden="true"></a> },</span> +<span id="cb379-49"><a href="#cb379-49" aria-hidden="true"></a>}</span> +<span id="cb379-50"><a href="#cb379-50" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb379-51"><a href="#cb379-51" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb379-52"><a href="#cb379-52" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb379-53"><a href="#cb379-53" aria-hidden="true"></a></span> +<span id="cb379-54"><a href="#cb379-54" aria-hidden="true"></a>/nested.md</span> +<span id="cb379-55"><a href="#cb379-55" aria-hidden="true"></a></span> +<span id="cb379-56"><a href="#cb379-56" aria-hidden="true"></a>_Foo_ bar!</span> +<span id="cb379-57"><a href="#cb379-57" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb379-58"><a href="#cb379-58" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb379-59"><a href="#cb379-59" aria-hidden="true"></a></span> +<span id="cb379-60"><a href="#cb379-60" aria-hidden="true"></a>Bar baz!</span> +<span id="cb379-61"><a href="#cb379-61" aria-hidden="true"></a></span> +<span id="cb379-62"><a href="#cb379-62" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb379-63"><a href="#cb379-63" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb380"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb380-1"><a href="#cb380-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p><em>(The beginning of a document)</em></p> @@ -4557,48 +4600,48 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererInterblockSeparator</code> macro represents a separator between two markdown block elements. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-18">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb378"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb378-1"><a href="#cb378-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb378-2"><a href="#cb378-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb378-3"><a href="#cb378-3" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb378-4"><a href="#cb378-4" aria-hidden="true"></a> {<span class="fu">\it</span>(The end of a block)}<span class="co">%</span></span> -<span id="cb378-5"><a href="#cb378-5" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb378-6"><a href="#cb378-6" aria-hidden="true"></a>}</span> -<span id="cb378-7"><a href="#cb378-7" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb378-8"><a href="#cb378-8" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb378-9"><a href="#cb378-9" aria-hidden="true"></a></span> -<span id="cb378-10"><a href="#cb378-10" aria-hidden="true"></a>_Foo_ bar!</span> -<span id="cb378-11"><a href="#cb378-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb378-12"><a href="#cb378-12" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb381"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb381-1"><a href="#cb381-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb381-2"><a href="#cb381-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb381-3"><a href="#cb381-3" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb381-4"><a href="#cb381-4" aria-hidden="true"></a> {<span class="fu">\it</span>(The end of a block)}<span class="co">%</span></span> +<span id="cb381-5"><a href="#cb381-5" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb381-6"><a href="#cb381-6" aria-hidden="true"></a>}</span> +<span id="cb381-7"><a href="#cb381-7" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb381-8"><a href="#cb381-8" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb381-9"><a href="#cb381-9" aria-hidden="true"></a></span> +<span id="cb381-10"><a href="#cb381-10" aria-hidden="true"></a>_Foo_ bar!</span> +<span id="cb381-11"><a href="#cb381-11" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb381-12"><a href="#cb381-12" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb379"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb379-1"><a href="#cb379-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb382"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb382-1"><a href="#cb382-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> <p><em>(The end of a block)</em></p> <p><em>Foo</em> bar!</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-43"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-44"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb380"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb380-1"><a href="#cb380-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb380-2"><a href="#cb380-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb380-3"><a href="#cb380-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb380-4"><a href="#cb380-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb380-5"><a href="#cb380-5" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> -<span id="cb380-6"><a href="#cb380-6" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb380-7"><a href="#cb380-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span> -<span id="cb380-8"><a href="#cb380-8" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb380-9"><a href="#cb380-9" aria-hidden="true"></a> },</span> -<span id="cb380-10"><a href="#cb380-10" aria-hidden="true"></a> },</span> -<span id="cb380-11"><a href="#cb380-11" aria-hidden="true"></a>}</span> -<span id="cb380-12"><a href="#cb380-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb380-13"><a href="#cb380-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb380-14"><a href="#cb380-14" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb380-15"><a href="#cb380-15" aria-hidden="true"></a></span> -<span id="cb380-16"><a href="#cb380-16" aria-hidden="true"></a>_Foo_ bar!</span> -<span id="cb380-17"><a href="#cb380-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb380-18"><a href="#cb380-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb381"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb381-1"><a href="#cb381-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb383"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb383-1"><a href="#cb383-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb383-2"><a href="#cb383-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb383-3"><a href="#cb383-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb383-4"><a href="#cb383-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb383-5"><a href="#cb383-5" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> +<span id="cb383-6"><a href="#cb383-6" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb383-7"><a href="#cb383-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span> +<span id="cb383-8"><a href="#cb383-8" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb383-9"><a href="#cb383-9" aria-hidden="true"></a> },</span> +<span id="cb383-10"><a href="#cb383-10" aria-hidden="true"></a> },</span> +<span id="cb383-11"><a href="#cb383-11" aria-hidden="true"></a>}</span> +<span id="cb383-12"><a href="#cb383-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb383-13"><a href="#cb383-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb383-14"><a href="#cb383-14" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb383-15"><a href="#cb383-15" aria-hidden="true"></a></span> +<span id="cb383-16"><a href="#cb383-16" aria-hidden="true"></a>_Foo_ bar!</span> +<span id="cb383-17"><a href="#cb383-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb383-18"><a href="#cb383-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb384"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb384-1"><a href="#cb384-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> @@ -4607,21 +4650,21 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-33">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb382"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb382-1"><a href="#cb382-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb382-2"><a href="#cb382-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb382-3"><a href="#cb382-3" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb382-4"><a href="#cb382-4" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span> -<span id="cb382-5"><a href="#cb382-5" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb382-6"><a href="#cb382-6" aria-hidden="true"></a>}</span> -<span id="cb382-7"><a href="#cb382-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb382-8"><a href="#cb382-8" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb382-9"><a href="#cb382-9" aria-hidden="true"></a>Hello *world*!</span> -<span id="cb382-10"><a href="#cb382-10" aria-hidden="true"></a></span> -<span id="cb382-11"><a href="#cb382-11" aria-hidden="true"></a>_Foo_ bar!</span> -<span id="cb382-12"><a href="#cb382-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb382-13"><a href="#cb382-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb385"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb385-1"><a href="#cb385-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb385-2"><a href="#cb385-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb385-3"><a href="#cb385-3" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb385-4"><a href="#cb385-4" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span> +<span id="cb385-5"><a href="#cb385-5" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb385-6"><a href="#cb385-6" aria-hidden="true"></a>}</span> +<span id="cb385-7"><a href="#cb385-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb385-8"><a href="#cb385-8" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb385-9"><a href="#cb385-9" aria-hidden="true"></a>Hello *world*!</span> +<span id="cb385-10"><a href="#cb385-10" aria-hidden="true"></a></span> +<span id="cb385-11"><a href="#cb385-11" aria-hidden="true"></a>_Foo_ bar!</span> +<span id="cb385-12"><a href="#cb385-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb385-13"><a href="#cb385-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb383"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb383-1"><a href="#cb383-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb386"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb386-1"><a href="#cb386-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> @@ -4632,44 +4675,44 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererLineBreak</code> macro represents a forced line break. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-19">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb384"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb384-1"><a href="#cb384-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb384-2"><a href="#cb384-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLineBreak</span>{<span class="co">%</span></span> -<span id="cb384-3"><a href="#cb384-3" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb384-4"><a href="#cb384-4" aria-hidden="true"></a> {<span class="fu">\it</span>(A forced linebreak)}<span class="co">%</span></span> -<span id="cb384-5"><a href="#cb384-5" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb384-6"><a href="#cb384-6" aria-hidden="true"></a>}</span> -<span id="cb384-7"><a href="#cb384-7" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb384-8"><a href="#cb384-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb387"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb387-1"><a href="#cb387-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb387-2"><a href="#cb387-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLineBreak</span>{<span class="co">%</span></span> +<span id="cb387-3"><a href="#cb387-3" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb387-4"><a href="#cb387-4" aria-hidden="true"></a> {<span class="fu">\it</span>(A forced linebreak)}<span class="co">%</span></span> +<span id="cb387-5"><a href="#cb387-5" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb387-6"><a href="#cb387-6" aria-hidden="true"></a>}</span> +<span id="cb387-7"><a href="#cb387-7" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb387-8"><a href="#cb387-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>example.md</code> with the following content. Note the two spaces at the end of the first line, which specify a hard linebreak. Due to the limitations of the <span class="tex">T<sub>e</sub>X</span> input processor, hard linebreaks would be ignored if we typed them directly into the <code>document.tex</code> document.</p> <pre><code>Hello world! <br/>_Foo_ bar!</code></pre> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb385"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb385-1"><a href="#cb385-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb388"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb388-1"><a href="#cb388-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> <p><em>(A forced linebreak)</em></p> <p><em>Foo</em> bar!</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-44"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-45"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb386"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb386-1"><a href="#cb386-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb386-2"><a href="#cb386-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb386-3"><a href="#cb386-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb386-4"><a href="#cb386-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb386-5"><a href="#cb386-5" aria-hidden="true"></a> lineBreak = {<span class="co">%</span></span> -<span id="cb386-6"><a href="#cb386-6" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb386-7"><a href="#cb386-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(A forced linebreak)}<span class="co">%</span></span> -<span id="cb386-8"><a href="#cb386-8" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb386-9"><a href="#cb386-9" aria-hidden="true"></a> },</span> -<span id="cb386-10"><a href="#cb386-10" aria-hidden="true"></a> },</span> -<span id="cb386-11"><a href="#cb386-11" aria-hidden="true"></a>}</span> -<span id="cb386-12"><a href="#cb386-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb386-13"><a href="#cb386-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb386-14"><a href="#cb386-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb389"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb389-1"><a href="#cb389-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb389-2"><a href="#cb389-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb389-3"><a href="#cb389-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb389-4"><a href="#cb389-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb389-5"><a href="#cb389-5" aria-hidden="true"></a> lineBreak = {<span class="co">%</span></span> +<span id="cb389-6"><a href="#cb389-6" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb389-7"><a href="#cb389-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(A forced linebreak)}<span class="co">%</span></span> +<span id="cb389-8"><a href="#cb389-8" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb389-9"><a href="#cb389-9" aria-hidden="true"></a> },</span> +<span id="cb389-10"><a href="#cb389-10" aria-hidden="true"></a> },</span> +<span id="cb389-11"><a href="#cb389-11" aria-hidden="true"></a>}</span> +<span id="cb389-12"><a href="#cb389-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb389-13"><a href="#cb389-13" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb389-14"><a href="#cb389-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Using a text editor, create a text document named <code>example.md</code> with the following content. Note the two spaces at the end of the first line, which specify a hard linebreak. Due to the limitations of the <span class="tex">T<sub>e</sub>X</span> input processor, hard linebreaks would be ignored if we typed them directly into the <code>document.tex</code> document.</p> <pre><code>Hello world! <br/>_Foo_ bar!</code></pre> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb387"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb387-1"><a href="#cb387-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb390"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb390-1"><a href="#cb390-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> @@ -4678,19 +4721,19 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-34">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb388"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb388-1"><a href="#cb388-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb388-2"><a href="#cb388-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLineBreak</span>{<span class="co">%</span></span> -<span id="cb388-3"><a href="#cb388-3" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb388-4"><a href="#cb388-4" aria-hidden="true"></a> <span class="fu">\emph</span>{(A forced linebreak)}<span class="co">%</span></span> -<span id="cb388-5"><a href="#cb388-5" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb388-6"><a href="#cb388-6" aria-hidden="true"></a>}</span> -<span id="cb388-7"><a href="#cb388-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb388-8"><a href="#cb388-8" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> -<span id="cb388-9"><a href="#cb388-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb391"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb391-1"><a href="#cb391-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb391-2"><a href="#cb391-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLineBreak</span>{<span class="co">%</span></span> +<span id="cb391-3"><a href="#cb391-3" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb391-4"><a href="#cb391-4" aria-hidden="true"></a> <span class="fu">\emph</span>{(A forced linebreak)}<span class="co">%</span></span> +<span id="cb391-5"><a href="#cb391-5" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb391-6"><a href="#cb391-6" aria-hidden="true"></a>}</span> +<span id="cb391-7"><a href="#cb391-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb391-8"><a href="#cb391-8" aria-hidden="true"></a><span class="fu">\markdownInput</span>{example.md}</span> +<span id="cb391-9"><a href="#cb391-9" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Using a text editor, create a text document named <code>example.md</code> with the following content. Note the two spaces at the end of the first line, which specify a hard linebreak. Due to the limitations of the <span class="tex">T<sub>e</sub>X</span> input processor, hard linebreaks would be ignored if we typed them directly into the <code>document.tex</code> document.</p> <pre><code>Hello world! <br/>_Foo_ bar!</code></pre> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb389"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb389-1"><a href="#cb389-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb392"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb392-1"><a href="#cb392-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> @@ -4701,51 +4744,51 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererEllipsis</code> macro replaces any occurance of ASCII ellipses in the input text. This macro will only be produced, when the <strong><code>smartEllipses</code></strong> option is enabled. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-20">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb390"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb390-1"><a href="#cb390-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb390-2"><a href="#cb390-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span> -<span id="cb390-3"><a href="#cb390-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{{<span class="fu">\it</span> SHAZAM}!}</span> -<span id="cb390-4"><a href="#cb390-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb390-5"><a href="#cb390-5" aria-hidden="true"></a>The secret word is ...</span> -<span id="cb390-6"><a href="#cb390-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb390-7"><a href="#cb390-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb393"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb393-1"><a href="#cb393-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb393-2"><a href="#cb393-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span> +<span id="cb393-3"><a href="#cb393-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{{<span class="fu">\it</span> SHAZAM}!}</span> +<span id="cb393-4"><a href="#cb393-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb393-5"><a href="#cb393-5" aria-hidden="true"></a>The secret word is ...</span> +<span id="cb393-6"><a href="#cb393-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb393-7"><a href="#cb393-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb391"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb391-1"><a href="#cb391-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb394"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb394-1"><a href="#cb394-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The secret word is <em>SHAZAM</em>!</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-45"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-46"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb392"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb392-1"><a href="#cb392-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb392-2"><a href="#cb392-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span> -<span id="cb392-3"><a href="#cb392-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb392-4"><a href="#cb392-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb392-5"><a href="#cb392-5" aria-hidden="true"></a> ellipsis = <span class="fu">\emph</span>{SHAZAM}!,</span> -<span id="cb392-6"><a href="#cb392-6" aria-hidden="true"></a> },</span> -<span id="cb392-7"><a href="#cb392-7" aria-hidden="true"></a>}</span> -<span id="cb392-8"><a href="#cb392-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb392-9"><a href="#cb392-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb392-10"><a href="#cb392-10" aria-hidden="true"></a>The secret word is ...</span> -<span id="cb392-11"><a href="#cb392-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb392-12"><a href="#cb392-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb395"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb395-1"><a href="#cb395-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb395-2"><a href="#cb395-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span> +<span id="cb395-3"><a href="#cb395-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb395-4"><a href="#cb395-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb395-5"><a href="#cb395-5" aria-hidden="true"></a> ellipsis = <span class="fu">\emph</span>{SHAZAM}!,</span> +<span id="cb395-6"><a href="#cb395-6" aria-hidden="true"></a> },</span> +<span id="cb395-7"><a href="#cb395-7" aria-hidden="true"></a>}</span> +<span id="cb395-8"><a href="#cb395-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb395-9"><a href="#cb395-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb395-10"><a href="#cb395-10" aria-hidden="true"></a>The secret word is ...</span> +<span id="cb395-11"><a href="#cb395-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb395-12"><a href="#cb395-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb393"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb393-1"><a href="#cb393-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb396"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb396-1"><a href="#cb396-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The secret word is <em>SHAZAM</em>!</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-35">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb394"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb394-1"><a href="#cb394-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb394-2"><a href="#cb394-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span> -<span id="cb394-3"><a href="#cb394-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{<span class="fu">\emph</span>{SHAZAM}!}</span> -<span id="cb394-4"><a href="#cb394-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb394-5"><a href="#cb394-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb394-6"><a href="#cb394-6" aria-hidden="true"></a>The secret word is ...</span> -<span id="cb394-7"><a href="#cb394-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb394-8"><a href="#cb394-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb397"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb397-1"><a href="#cb397-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb397-2"><a href="#cb397-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span> +<span id="cb397-3"><a href="#cb397-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererEllipsis</span>{<span class="fu">\emph</span>{SHAZAM}!}</span> +<span id="cb397-4"><a href="#cb397-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb397-5"><a href="#cb397-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb397-6"><a href="#cb397-6" aria-hidden="true"></a>The secret word is ...</span> +<span id="cb397-7"><a href="#cb397-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb397-8"><a href="#cb397-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb395"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb395-1"><a href="#cb395-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb398"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb398-1"><a href="#cb398-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Hello <em>world</em>!</p> @@ -4754,40 +4797,40 @@ Thomas,Edison,1847</code></pre> </blockquote> <h4 data-number="2.3.1.6" id="non-breaking-space-renderer"><span class="header-section-number">2.3.1.6</span> Non-Breaking Space Renderer</h4> <p>The <code>\markdownRendererNbsp</code> macro represents a non-breaking space.</p> -<h5 class="unnumbered" data-number="" id="latex-example-46"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-47"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.bib</code> with the following content:</p> -<div class="sourceCode" id="cb396"><pre class="sourceCode bib"><code class="sourceCode bibtex"><span id="cb396-1"><a href="#cb396-1" aria-hidden="true"></a><span class="va">@book</span>{<span class="ot">knuth:tex</span>,</span> -<span id="cb396-2"><a href="#cb396-2" aria-hidden="true"></a> <span class="dt">author</span> = "<span class="st">Knuth, Donald Ervin</span>",</span> -<span id="cb396-3"><a href="#cb396-3" aria-hidden="true"></a> <span class="dt">title</span> = "<span class="st">The </span><span class="ch">\TeX</span><span class="st"> book, volume A of Computers and typesetting</span>",</span> -<span id="cb396-4"><a href="#cb396-4" aria-hidden="true"></a> <span class="dt">publisher</span> = "<span class="st">Addison-Wesley</span>",</span> -<span id="cb396-5"><a href="#cb396-5" aria-hidden="true"></a> <span class="dt">year</span> = "<span class="st">1984</span>"</span> -<span id="cb396-6"><a href="#cb396-6" aria-hidden="true"></a>}</span></code></pre></div> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb397"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb397-1"><a href="#cb397-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb397-2"><a href="#cb397-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[</span> -<span id="cb397-3"><a href="#cb397-3" aria-hidden="true"></a> citations,</span> -<span id="cb397-4"><a href="#cb397-4" aria-hidden="true"></a> citationNbsps,</span> -<span id="cb397-5"><a href="#cb397-5" aria-hidden="true"></a>]{<span class="ex">markdown</span>}</span> -<span id="cb397-6"><a href="#cb397-6" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb397-7"><a href="#cb397-7" aria-hidden="true"></a> renderers = {</span> -<span id="cb397-8"><a href="#cb397-8" aria-hidden="true"></a> nbsp = {<span class="ss">$</span><span class="sc">\cdot</span><span class="ss">$</span>},</span> -<span id="cb397-9"><a href="#cb397-9" aria-hidden="true"></a> },</span> -<span id="cb397-10"><a href="#cb397-10" aria-hidden="true"></a>}</span> -<span id="cb397-11"><a href="#cb397-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb397-12"><a href="#cb397-12" aria-hidden="true"></a></span> -<span id="cb397-13"><a href="#cb397-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb397-14"><a href="#cb397-14" aria-hidden="true"></a>The TeXbook [@knuth:tex, p. 123 and 130] is good.</span> -<span id="cb397-15"><a href="#cb397-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb397-16"><a href="#cb397-16" aria-hidden="true"></a></span> -<span id="cb397-17"><a href="#cb397-17" aria-hidden="true"></a><span class="bu">\bibliographystyle</span>{<span class="ex">plain</span>}</span> -<span id="cb397-18"><a href="#cb397-18" aria-hidden="true"></a><span class="bu">\bibliography</span>{<span class="ex">document.bib</span>}</span> -<span id="cb397-19"><a href="#cb397-19" aria-hidden="true"></a></span> -<span id="cb397-20"><a href="#cb397-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb399"><pre class="sourceCode bib"><code class="sourceCode bibtex"><span id="cb399-1"><a href="#cb399-1" aria-hidden="true"></a><span class="va">@book</span>{<span class="ot">knuth:tex</span>,</span> +<span id="cb399-2"><a href="#cb399-2" aria-hidden="true"></a> <span class="dt">author</span> = "<span class="st">Knuth, Donald Ervin</span>",</span> +<span id="cb399-3"><a href="#cb399-3" aria-hidden="true"></a> <span class="dt">title</span> = "<span class="st">The </span><span class="ch">\TeX</span><span class="st"> book, volume A of Computers and typesetting</span>",</span> +<span id="cb399-4"><a href="#cb399-4" aria-hidden="true"></a> <span class="dt">publisher</span> = "<span class="st">Addison-Wesley</span>",</span> +<span id="cb399-5"><a href="#cb399-5" aria-hidden="true"></a> <span class="dt">year</span> = "<span class="st">1984</span>"</span> +<span id="cb399-6"><a href="#cb399-6" aria-hidden="true"></a>}</span></code></pre></div> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb400"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb400-1"><a href="#cb400-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb400-2"><a href="#cb400-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[</span> +<span id="cb400-3"><a href="#cb400-3" aria-hidden="true"></a> citations,</span> +<span id="cb400-4"><a href="#cb400-4" aria-hidden="true"></a> citationNbsps,</span> +<span id="cb400-5"><a href="#cb400-5" aria-hidden="true"></a>]{<span class="ex">markdown</span>}</span> +<span id="cb400-6"><a href="#cb400-6" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb400-7"><a href="#cb400-7" aria-hidden="true"></a> renderers = {</span> +<span id="cb400-8"><a href="#cb400-8" aria-hidden="true"></a> nbsp = {<span class="ss">$</span><span class="sc">\cdot</span><span class="ss">$</span>},</span> +<span id="cb400-9"><a href="#cb400-9" aria-hidden="true"></a> },</span> +<span id="cb400-10"><a href="#cb400-10" aria-hidden="true"></a>}</span> +<span id="cb400-11"><a href="#cb400-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb400-12"><a href="#cb400-12" aria-hidden="true"></a></span> +<span id="cb400-13"><a href="#cb400-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb400-14"><a href="#cb400-14" aria-hidden="true"></a>The TeXbook [@knuth:tex, p. 123 and 130] is good.</span> +<span id="cb400-15"><a href="#cb400-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb400-16"><a href="#cb400-16" aria-hidden="true"></a></span> +<span id="cb400-17"><a href="#cb400-17" aria-hidden="true"></a><span class="bu">\bibliographystyle</span>{<span class="ex">plain</span>}</span> +<span id="cb400-18"><a href="#cb400-18" aria-hidden="true"></a><span class="bu">\bibliography</span>{<span class="ex">document.bib</span>}</span> +<span id="cb400-19"><a href="#cb400-19" aria-hidden="true"></a></span> +<span id="cb400-20"><a href="#cb400-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX and BibTeX from the terminal:</p> -<div class="sourceCode" id="cb398"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb398-1"><a href="#cb398-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> -<span id="cb398-2"><a href="#cb398-2" aria-hidden="true"></a><span class="ex">bibtex</span> document.aux</span> -<span id="cb398-3"><a href="#cb398-3" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> -<span id="cb398-4"><a href="#cb398-4" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb401"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb401-1"><a href="#cb401-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> +<span id="cb401-2"><a href="#cb401-2" aria-hidden="true"></a><span class="ex">bibtex</span> document.aux</span> +<span id="cb401-3"><a href="#cb401-3" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> +<span id="cb401-4"><a href="#cb401-4" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>The TeXbook [1, p.·123·and·130] is good.</p> @@ -4811,49 +4854,49 @@ Thomas,Edison,1847</code></pre> </ul> <h5 class="unnumbered" data-number="" id="plain-tex-example-21">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content. We will make the tilde behave as if it were written in <span class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking space.</p> -<div class="sourceCode" id="cb399"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb399-1"><a href="#cb399-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb399-2"><a href="#cb399-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span> -<span id="cb399-3"><a href="#cb399-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb399-4"><a href="#cb399-4" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> -<span id="cb399-5"><a href="#cb399-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb399-6"><a href="#cb399-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb400"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb400-1"><a href="#cb400-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb402"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb402-1"><a href="#cb402-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb402-2"><a href="#cb402-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span> +<span id="cb402-3"><a href="#cb402-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb402-4"><a href="#cb402-4" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> +<span id="cb402-5"><a href="#cb402-5" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb402-6"><a href="#cb402-6" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb403"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb403-1"><a href="#cb403-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text, where the middot (<code>·</code>) denotes a non-breaking space:</p> <blockquote> <p>Bartel·Leendert van·der·Waerden</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-47"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-48"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content. We will make the tilde behave as if it were written in <span class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking space.</p> -<div class="sourceCode" id="cb401"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb401-1"><a href="#cb401-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb401-2"><a href="#cb401-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb401-3"><a href="#cb401-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb401-4"><a href="#cb401-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb401-5"><a href="#cb401-5" aria-hidden="true"></a> tilde = ~,</span> -<span id="cb401-6"><a href="#cb401-6" aria-hidden="true"></a> },</span> -<span id="cb401-7"><a href="#cb401-7" aria-hidden="true"></a>}</span> -<span id="cb401-8"><a href="#cb401-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb401-9"><a href="#cb401-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb401-10"><a href="#cb401-10" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> -<span id="cb401-11"><a href="#cb401-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb401-12"><a href="#cb401-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb402"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb402-1"><a href="#cb402-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb404"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb404-1"><a href="#cb404-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb404-2"><a href="#cb404-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb404-3"><a href="#cb404-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb404-4"><a href="#cb404-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb404-5"><a href="#cb404-5" aria-hidden="true"></a> tilde = ~,</span> +<span id="cb404-6"><a href="#cb404-6" aria-hidden="true"></a> },</span> +<span id="cb404-7"><a href="#cb404-7" aria-hidden="true"></a>}</span> +<span id="cb404-8"><a href="#cb404-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb404-9"><a href="#cb404-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb404-10"><a href="#cb404-10" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> +<span id="cb404-11"><a href="#cb404-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb404-12"><a href="#cb404-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb405"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb405-1"><a href="#cb405-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text, where the middot (<code>·</code>) denotes a non-breaking space:</p> <blockquote> <p>Bartel·Leendert van·der·Waerden</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-36">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content. We will make the tilde behave as if it were written in <span class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking space.</p> -<div class="sourceCode" id="cb403"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb403-1"><a href="#cb403-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb403-2"><a href="#cb403-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span> -<span id="cb403-3"><a href="#cb403-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb403-4"><a href="#cb403-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb403-5"><a href="#cb403-5" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> -<span id="cb403-6"><a href="#cb403-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb403-7"><a href="#cb403-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb404"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb404-1"><a href="#cb404-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb406"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb406-1"><a href="#cb406-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb406-2"><a href="#cb406-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span> +<span id="cb406-3"><a href="#cb406-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb406-4"><a href="#cb406-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb406-5"><a href="#cb406-5" aria-hidden="true"></a>Bartel~Leendert van~der~Waerden</span> +<span id="cb406-6"><a href="#cb406-6" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb406-7"><a href="#cb406-7" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb407"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb407-1"><a href="#cb407-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text, where the middot (<code>·</code>) denotes a non-breaking space:</p> <blockquote> <p>Bartel·Leendert van·der·Waerden</p> @@ -4862,55 +4905,55 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererCodeSpan</code> macro represents inlined code span in the input text. It receives a single argument that corresponds to the inlined code span.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-22">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb405"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb405-1"><a href="#cb405-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb405-2"><a href="#cb405-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> -<span id="cb405-3"><a href="#cb405-3" aria-hidden="true"></a></span> -<span id="cb405-4"><a href="#cb405-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span> -<span id="cb405-5"><a href="#cb405-5" aria-hidden="true"></a></span> -<span id="cb405-6"><a href="#cb405-6" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb405-7"><a href="#cb405-7" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> -<span id="cb405-8"><a href="#cb405-8" aria-hidden="true"></a></span> -<span id="cb405-9"><a href="#cb405-9" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb405-10"><a href="#cb405-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb405-11"><a href="#cb405-11" aria-hidden="true"></a></span> -<span id="cb405-12"><a href="#cb405-12" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> -<span id="cb405-13"><a href="#cb405-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb405-14"><a href="#cb405-14" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb405-15"><a href="#cb405-15" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb405-16"><a href="#cb405-16" aria-hidden="true"></a></span> -<span id="cb405-17"><a href="#cb405-17" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb406"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb406-1"><a href="#cb406-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb408"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb408-1"><a href="#cb408-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb408-2"><a href="#cb408-2" aria-hidden="true"></a><span class="fu">\input</span> lmfonts</span> +<span id="cb408-3"><a href="#cb408-3" aria-hidden="true"></a></span> +<span id="cb408-4"><a href="#cb408-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span> +<span id="cb408-5"><a href="#cb408-5" aria-hidden="true"></a></span> +<span id="cb408-6"><a href="#cb408-6" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb408-7"><a href="#cb408-7" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> +<span id="cb408-8"><a href="#cb408-8" aria-hidden="true"></a></span> +<span id="cb408-9"><a href="#cb408-9" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb408-10"><a href="#cb408-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb408-11"><a href="#cb408-11" aria-hidden="true"></a></span> +<span id="cb408-12"><a href="#cb408-12" aria-hidden="true"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span> +<span id="cb408-13"><a href="#cb408-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb408-14"><a href="#cb408-14" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb408-15"><a href="#cb408-15" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb408-16"><a href="#cb408-16" aria-hidden="true"></a></span> +<span id="cb408-17"><a href="#cb408-17" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb409"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb409-1"><a href="#cb409-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt{-1}$ *equals* $i$.</p> <p>$\sqrt{-1}$ <em>equals</em> $i$.</p> <p>√-̅1̅ <em>equals</em> <span class="math inline"><em>i</em></span>.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-48"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-49"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb407"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb407-1"><a href="#cb407-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb407-2"><a href="#cb407-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span> -<span id="cb407-3"><a href="#cb407-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb407-4"><a href="#cb407-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb407-5"><a href="#cb407-5" aria-hidden="true"></a> codeSpan = {#1},</span> -<span id="cb407-6"><a href="#cb407-6" aria-hidden="true"></a> },</span> -<span id="cb407-7"><a href="#cb407-7" aria-hidden="true"></a>}</span> -<span id="cb407-8"><a href="#cb407-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb407-9"><a href="#cb407-9" aria-hidden="true"></a></span> -<span id="cb407-10"><a href="#cb407-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb407-11"><a href="#cb407-11" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> -<span id="cb407-12"><a href="#cb407-12" aria-hidden="true"></a></span> -<span id="cb407-13"><a href="#cb407-13" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb407-14"><a href="#cb407-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb407-15"><a href="#cb407-15" aria-hidden="true"></a></span> -<span id="cb407-16"><a href="#cb407-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hybrid}</span> -<span id="cb407-17"><a href="#cb407-17" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb407-18"><a href="#cb407-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb407-19"><a href="#cb407-19" aria-hidden="true"></a></span> -<span id="cb407-20"><a href="#cb407-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb408"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb408-1"><a href="#cb408-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb410"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb410-1"><a href="#cb410-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb410-2"><a href="#cb410-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span> +<span id="cb410-3"><a href="#cb410-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb410-4"><a href="#cb410-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb410-5"><a href="#cb410-5" aria-hidden="true"></a> codeSpan = {#1},</span> +<span id="cb410-6"><a href="#cb410-6" aria-hidden="true"></a> },</span> +<span id="cb410-7"><a href="#cb410-7" aria-hidden="true"></a>}</span> +<span id="cb410-8"><a href="#cb410-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb410-9"><a href="#cb410-9" aria-hidden="true"></a></span> +<span id="cb410-10"><a href="#cb410-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb410-11"><a href="#cb410-11" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> +<span id="cb410-12"><a href="#cb410-12" aria-hidden="true"></a></span> +<span id="cb410-13"><a href="#cb410-13" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb410-14"><a href="#cb410-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb410-15"><a href="#cb410-15" aria-hidden="true"></a></span> +<span id="cb410-16"><a href="#cb410-16" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{hybrid}</span> +<span id="cb410-17"><a href="#cb410-17" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb410-18"><a href="#cb410-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb410-19"><a href="#cb410-19" aria-hidden="true"></a></span> +<span id="cb410-20"><a href="#cb410-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb411"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb411-1"><a href="#cb411-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt{-1}$ *equals* $i$.</p> @@ -4919,24 +4962,24 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-37">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb409"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb409-1"><a href="#cb409-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb409-2"><a href="#cb409-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span> -<span id="cb409-3"><a href="#cb409-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb409-4"><a href="#cb409-4" aria-hidden="true"></a></span> -<span id="cb409-5"><a href="#cb409-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb409-6"><a href="#cb409-6" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> -<span id="cb409-7"><a href="#cb409-7" aria-hidden="true"></a></span> -<span id="cb409-8"><a href="#cb409-8" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb409-9"><a href="#cb409-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb409-10"><a href="#cb409-10" aria-hidden="true"></a></span> -<span id="cb409-11"><a href="#cb409-11" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> -<span id="cb409-12"><a href="#cb409-12" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb409-13"><a href="#cb409-13" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> -<span id="cb409-14"><a href="#cb409-14" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb409-15"><a href="#cb409-15" aria-hidden="true"></a></span> -<span id="cb409-16"><a href="#cb409-16" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb410"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb410-1"><a href="#cb410-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb412"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb412-1"><a href="#cb412-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb412-2"><a href="#cb412-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span> +<span id="cb412-3"><a href="#cb412-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb412-4"><a href="#cb412-4" aria-hidden="true"></a></span> +<span id="cb412-5"><a href="#cb412-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb412-6"><a href="#cb412-6" aria-hidden="true"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span> +<span id="cb412-7"><a href="#cb412-7" aria-hidden="true"></a></span> +<span id="cb412-8"><a href="#cb412-8" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb412-9"><a href="#cb412-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb412-10"><a href="#cb412-10" aria-hidden="true"></a></span> +<span id="cb412-11"><a href="#cb412-11" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span> +<span id="cb412-12"><a href="#cb412-12" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb412-13"><a href="#cb412-13" aria-hidden="true"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span> +<span id="cb412-14"><a href="#cb412-14" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb412-15"><a href="#cb412-15" aria-hidden="true"></a></span> +<span id="cb412-16"><a href="#cb412-16" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb413"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb413-1"><a href="#cb413-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>$\sqrt{-1}$ *equals* $i$.</p> @@ -4947,106 +4990,106 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererLink</code> macro represents a hyperlink. It receives four arguments: the label, the fully escaped <abbr>uri</abbr> that can be directly typeset, the raw <abbr>uri</abbr> that can be used outside typesetting, and the title of the link.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-23">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb411"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb411-1"><a href="#cb411-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb411-2"><a href="#cb411-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb411-3"><a href="#cb411-3" aria-hidden="true"></a> #1 {<span class="fu">\tt</span>#2} titled {<span class="fu">\it</span>#4}<span class="co">%</span></span> -<span id="cb411-4"><a href="#cb411-4" aria-hidden="true"></a>}</span> -<span id="cb411-5"><a href="#cb411-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb411-6"><a href="#cb411-6" aria-hidden="true"></a>Please visit [the link][ctan].</span> -<span id="cb411-7"><a href="#cb411-7" aria-hidden="true"></a></span> -<span id="cb411-8"><a href="#cb411-8" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> -<span id="cb411-9"><a href="#cb411-9" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> -<span id="cb411-10"><a href="#cb411-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb411-11"><a href="#cb411-11" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb414"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb414-1"><a href="#cb414-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb414-2"><a href="#cb414-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb414-3"><a href="#cb414-3" aria-hidden="true"></a> #1 {<span class="fu">\tt</span>#2} titled {<span class="fu">\it</span>#4}<span class="co">%</span></span> +<span id="cb414-4"><a href="#cb414-4" aria-hidden="true"></a>}</span> +<span id="cb414-5"><a href="#cb414-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb414-6"><a href="#cb414-6" aria-hidden="true"></a>Please visit [the link][ctan].</span> +<span id="cb414-7"><a href="#cb414-7" aria-hidden="true"></a></span> +<span id="cb414-8"><a href="#cb414-8" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> +<span id="cb414-9"><a href="#cb414-9" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> +<span id="cb414-10"><a href="#cb414-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb414-11"><a href="#cb414-11" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb412"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb412-1"><a href="#cb412-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb415"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb415-1"><a href="#cb415-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Please visit the link <a href="https://ctan.org/" class="uri">https://ctan.org/</a> titled <em>the Comprehensive TeX Archive Network</em>.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-49"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-50"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb413"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb413-1"><a href="#cb413-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb413-2"><a href="#cb413-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb413-3"><a href="#cb413-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb413-4"><a href="#cb413-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb413-5"><a href="#cb413-5" aria-hidden="true"></a> link = {<span class="co">%</span></span> -<span id="cb413-6"><a href="#cb413-6" aria-hidden="true"></a> #1 <span class="fu">\texttt</span>{#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span> -<span id="cb413-7"><a href="#cb413-7" aria-hidden="true"></a> },</span> -<span id="cb413-8"><a href="#cb413-8" aria-hidden="true"></a> },</span> -<span id="cb413-9"><a href="#cb413-9" aria-hidden="true"></a>}</span> -<span id="cb413-10"><a href="#cb413-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb413-11"><a href="#cb413-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb413-12"><a href="#cb413-12" aria-hidden="true"></a>Please visit [the link][ctan].</span> -<span id="cb413-13"><a href="#cb413-13" aria-hidden="true"></a></span> -<span id="cb413-14"><a href="#cb413-14" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> -<span id="cb413-15"><a href="#cb413-15" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> -<span id="cb413-16"><a href="#cb413-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb413-17"><a href="#cb413-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb414"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb414-1"><a href="#cb414-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb416"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb416-1"><a href="#cb416-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb416-2"><a href="#cb416-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb416-3"><a href="#cb416-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb416-4"><a href="#cb416-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb416-5"><a href="#cb416-5" aria-hidden="true"></a> link = {<span class="co">%</span></span> +<span id="cb416-6"><a href="#cb416-6" aria-hidden="true"></a> #1 <span class="fu">\texttt</span>{#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span> +<span id="cb416-7"><a href="#cb416-7" aria-hidden="true"></a> },</span> +<span id="cb416-8"><a href="#cb416-8" aria-hidden="true"></a> },</span> +<span id="cb416-9"><a href="#cb416-9" aria-hidden="true"></a>}</span> +<span id="cb416-10"><a href="#cb416-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb416-11"><a href="#cb416-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb416-12"><a href="#cb416-12" aria-hidden="true"></a>Please visit [the link][ctan].</span> +<span id="cb416-13"><a href="#cb416-13" aria-hidden="true"></a></span> +<span id="cb416-14"><a href="#cb416-14" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> +<span id="cb416-15"><a href="#cb416-15" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> +<span id="cb416-16"><a href="#cb416-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb416-17"><a href="#cb416-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb417"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb417-1"><a href="#cb417-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Please visit the link <a href="https://ctan.org/" class="uri">https://ctan.org/</a> titled <em>the Comprehensive TeX Archive Network</em>.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-38">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb415"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb415-1"><a href="#cb415-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb415-2"><a href="#cb415-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb415-3"><a href="#cb415-3" aria-hidden="true"></a> #1 {<span class="fu">\tt</span>#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span> -<span id="cb415-4"><a href="#cb415-4" aria-hidden="true"></a>}</span> -<span id="cb415-5"><a href="#cb415-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb415-6"><a href="#cb415-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb415-7"><a href="#cb415-7" aria-hidden="true"></a>Please visit [the link][ctan].</span> -<span id="cb415-8"><a href="#cb415-8" aria-hidden="true"></a></span> -<span id="cb415-9"><a href="#cb415-9" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> -<span id="cb415-10"><a href="#cb415-10" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> -<span id="cb415-11"><a href="#cb415-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb415-12"><a href="#cb415-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb418"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb418-1"><a href="#cb418-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb418-2"><a href="#cb418-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb418-3"><a href="#cb418-3" aria-hidden="true"></a> #1 {<span class="fu">\tt</span>#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span> +<span id="cb418-4"><a href="#cb418-4" aria-hidden="true"></a>}</span> +<span id="cb418-5"><a href="#cb418-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb418-6"><a href="#cb418-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb418-7"><a href="#cb418-7" aria-hidden="true"></a>Please visit [the link][ctan].</span> +<span id="cb418-8"><a href="#cb418-8" aria-hidden="true"></a></span> +<span id="cb418-9"><a href="#cb418-9" aria-hidden="true"></a> [ctan]: https://ctan.org/</span> +<span id="cb418-10"><a href="#cb418-10" aria-hidden="true"></a> (the Comprehensive TeX Archive Network)</span> +<span id="cb418-11"><a href="#cb418-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb418-12"><a href="#cb418-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb416"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb416-1"><a href="#cb416-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb419"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb419-1"><a href="#cb419-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Please visit the link <a href="https://ctan.org/" class="uri">https://ctan.org/</a> titled <em>the Comprehensive TeX Archive Network</em>.</p> </blockquote> <h4 data-number="2.3.1.10" id="image-renderer"><span class="header-section-number">2.3.1.10</span> Image Renderer</h4> <p>The <code>\markdownRendererImage</code> macro represents an image. It receives four arguments: the label, the fully escaped <abbr>uri</abbr> that can be directly typeset, the raw <abbr>uri</abbr> that can be used outside typesetting, and the title of the link.</p> -<h5 class="unnumbered" data-number="" id="latex-example-50"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-51"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb417"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb417-1"><a href="#cb417-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb417-2"><a href="#cb417-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb417-3"><a href="#cb417-3" aria-hidden="true"></a><span class="fu">\begingroup</span></span> -<span id="cb417-4"><a href="#cb417-4" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\@</span>=11</span> -<span id="cb417-5"><a href="#cb417-5" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span> -<span id="cb417-6"><a href="#cb417-6" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\^</span>^A=14</span> -<span id="cb417-7"><a href="#cb417-7" aria-hidden="true"></a><span class="fu">\global\def\markdownRendererImage</span>#1#2#3#4{^^A</span> -<span id="cb417-8"><a href="#cb417-8" aria-hidden="true"></a> <span class="fu">\immediate\write</span>18{^^A</span></code></pre></div> -<div class="sourceCode" id="cb418"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb418-1"><a href="#cb418-1" aria-hidden="true"></a> <span class="kw">if</span> <span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="fu">grep</span> -q ^http<span class="kw">;</span> <span class="kw">then</span></span> -<span id="cb418-2"><a href="#cb418-2" aria-hidden="true"></a> <span class="va">OUTPUT=</span><span class="st">"</span><span class="va">$(</span><span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="ex">md5sum</span> <span class="kw">|</span> <span class="fu">cut</span> -d<span class="st">' '</span> -f1<span class="va">)</span><span class="st">.^^A</span></span> -<span id="cb418-3"><a href="#cb418-3" aria-hidden="true"></a><span class="st"> </span><span class="va">$(</span><span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="fu">sed</span> <span class="st">'s/.*[.]//'</span><span class="va">)</span><span class="st">"</span>;</span> -<span id="cb418-4"><a href="#cb418-4" aria-hidden="true"></a> <span class="kw">if</span> !<span class="bu"> [</span> <span class="ot">-e</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="bu"> ]</span>; <span class="kw">then</span></span> -<span id="cb418-5"><a href="#cb418-5" aria-hidden="true"></a> <span class="fu">wget</span> -O <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> <span class="st">'#3'</span> <span class="kw">||</span> <span class="fu">rm</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="kw">;</span></span> -<span id="cb418-6"><a href="#cb418-6" aria-hidden="true"></a> <span class="ex">convert</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> png:<span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="kw">;</span></span> -<span id="cb418-7"><a href="#cb418-7" aria-hidden="true"></a> <span class="kw">fi</span>;</span> -<span id="cb418-8"><a href="#cb418-8" aria-hidden="true"></a> <span class="bu">printf</span> <span class="st">'%s%%'</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> <span class="op">></span> \jobname.fetched<span class="kw">;</span></span> -<span id="cb418-9"><a href="#cb418-9" aria-hidden="true"></a> <span class="kw">else</span></span> -<span id="cb418-10"><a href="#cb418-10" aria-hidden="true"></a> <span class="bu">printf</span> <span class="st">'%s%%'</span> <span class="st">"#3"</span> <span class="op">></span> \jobname.fetched<span class="kw">;</span></span> -<span id="cb418-11"><a href="#cb418-11" aria-hidden="true"></a> <span class="kw">fi</span>^^<span class="ex">A</span></span></code></pre></div> -<div class="sourceCode" id="cb419"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb419-1"><a href="#cb419-1" aria-hidden="true"></a> }^^A</span> -<span id="cb419-2"><a href="#cb419-2" aria-hidden="true"></a> {^^A</span> -<span id="cb419-3"><a href="#cb419-3" aria-hidden="true"></a> <span class="fu">\everyeof</span>={<span class="fu">\noexpand</span>}^^A</span> -<span id="cb419-4"><a href="#cb419-4" aria-hidden="true"></a> <span class="fu">\edef\filename</span>{<span class="fu">\_</span>_markdowninput"<span class="fu">\jobname</span>.fetched" }^^A</span> -<span id="cb419-5"><a href="#cb419-5" aria-hidden="true"></a> <span class="bu">\includegraphics</span>[width=<span class="fu">\textwidth</span>]{<span class="fu">\filename</span>}^^A</span> -<span id="cb419-6"><a href="#cb419-6" aria-hidden="true"></a> }^^A</span> -<span id="cb419-7"><a href="#cb419-7" aria-hidden="true"></a>}</span> -<span id="cb419-8"><a href="#cb419-8" aria-hidden="true"></a><span class="fu">\endgroup</span></span> -<span id="cb419-9"><a href="#cb419-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb419-10"><a href="#cb419-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb419-11"><a href="#cb419-11" aria-hidden="true"></a>![TUGboat](https://tug.org/tugboat/noword.jpg)</span> -<span id="cb419-12"><a href="#cb419-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb419-13"><a href="#cb419-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb420"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb420-1"><a href="#cb420-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> +<div class="sourceCode" id="cb420"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb420-1"><a href="#cb420-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb420-2"><a href="#cb420-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb420-3"><a href="#cb420-3" aria-hidden="true"></a><span class="fu">\begingroup</span></span> +<span id="cb420-4"><a href="#cb420-4" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\@</span>=11</span> +<span id="cb420-5"><a href="#cb420-5" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span> +<span id="cb420-6"><a href="#cb420-6" aria-hidden="true"></a><span class="fu">\catcode</span>`<span class="fu">\^</span>^A=14</span> +<span id="cb420-7"><a href="#cb420-7" aria-hidden="true"></a><span class="fu">\global\def\markdownRendererImage</span>#1#2#3#4{^^A</span> +<span id="cb420-8"><a href="#cb420-8" aria-hidden="true"></a> <span class="fu">\immediate\write</span>18{^^A</span></code></pre></div> +<div class="sourceCode" id="cb421"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb421-1"><a href="#cb421-1" aria-hidden="true"></a> <span class="kw">if</span> <span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="fu">grep</span> -q ^http<span class="kw">;</span> <span class="kw">then</span></span> +<span id="cb421-2"><a href="#cb421-2" aria-hidden="true"></a> <span class="va">OUTPUT=</span><span class="st">"</span><span class="va">$(</span><span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="ex">md5sum</span> <span class="kw">|</span> <span class="fu">cut</span> -d<span class="st">' '</span> -f1<span class="va">)</span><span class="st">.^^A</span></span> +<span id="cb421-3"><a href="#cb421-3" aria-hidden="true"></a><span class="st"> </span><span class="va">$(</span><span class="bu">printf</span> <span class="st">'%s'</span> <span class="st">"#3"</span> <span class="kw">|</span> <span class="fu">sed</span> <span class="st">'s/.*[.]//'</span><span class="va">)</span><span class="st">"</span>;</span> +<span id="cb421-4"><a href="#cb421-4" aria-hidden="true"></a> <span class="kw">if</span> !<span class="bu"> [</span> <span class="ot">-e</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="bu"> ]</span>; <span class="kw">then</span></span> +<span id="cb421-5"><a href="#cb421-5" aria-hidden="true"></a> <span class="fu">wget</span> -O <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> <span class="st">'#3'</span> <span class="kw">||</span> <span class="fu">rm</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="kw">;</span></span> +<span id="cb421-6"><a href="#cb421-6" aria-hidden="true"></a> <span class="ex">convert</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> png:<span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span><span class="kw">;</span></span> +<span id="cb421-7"><a href="#cb421-7" aria-hidden="true"></a> <span class="kw">fi</span>;</span> +<span id="cb421-8"><a href="#cb421-8" aria-hidden="true"></a> <span class="bu">printf</span> <span class="st">'%s%%'</span> <span class="st">"</span><span class="va">$OUTPUT</span><span class="st">"</span> <span class="op">></span> \jobname.fetched<span class="kw">;</span></span> +<span id="cb421-9"><a href="#cb421-9" aria-hidden="true"></a> <span class="kw">else</span></span> +<span id="cb421-10"><a href="#cb421-10" aria-hidden="true"></a> <span class="bu">printf</span> <span class="st">'%s%%'</span> <span class="st">"#3"</span> <span class="op">></span> \jobname.fetched<span class="kw">;</span></span> +<span id="cb421-11"><a href="#cb421-11" aria-hidden="true"></a> <span class="kw">fi</span>^^<span class="ex">A</span></span></code></pre></div> +<div class="sourceCode" id="cb422"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb422-1"><a href="#cb422-1" aria-hidden="true"></a> }^^A</span> +<span id="cb422-2"><a href="#cb422-2" aria-hidden="true"></a> {^^A</span> +<span id="cb422-3"><a href="#cb422-3" aria-hidden="true"></a> <span class="fu">\everyeof</span>={<span class="fu">\noexpand</span>}^^A</span> +<span id="cb422-4"><a href="#cb422-4" aria-hidden="true"></a> <span class="fu">\edef\filename</span>{<span class="fu">\_</span>_markdowninput"<span class="fu">\jobname</span>.fetched" }^^A</span> +<span id="cb422-5"><a href="#cb422-5" aria-hidden="true"></a> <span class="bu">\includegraphics</span>[width=<span class="fu">\textwidth</span>]{<span class="fu">\filename</span>}^^A</span> +<span id="cb422-6"><a href="#cb422-6" aria-hidden="true"></a> }^^A</span> +<span id="cb422-7"><a href="#cb422-7" aria-hidden="true"></a>}</span> +<span id="cb422-8"><a href="#cb422-8" aria-hidden="true"></a><span class="fu">\endgroup</span></span> +<span id="cb422-9"><a href="#cb422-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb422-10"><a href="#cb422-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb422-11"><a href="#cb422-11" aria-hidden="true"></a>![TUGboat](https://tug.org/tugboat/noword.jpg)</span> +<span id="cb422-12"><a href="#cb422-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb422-13"><a href="#cb422-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb423"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb423-1"><a href="#cb423-1" aria-hidden="true"></a><span class="ex">lualatex</span> --shell-escape document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following content. This assumes that you use a Unix-like operating system with Bourne or Bourne again shell as the default shell of the current user. It also assumes that the <code>md5sum</code>, <code>wget</code>, and <code>convert</code> binaries are installed and that the <span class="tex">T<sub>e</sub>X</span> engine has shell access.</p> <blockquote> <p><img src="https://tug.org/tugboat/noword.jpg" title="The Communications of the TeX Users Group" /></p> @@ -5058,64 +5101,64 @@ Thomas,Edison,1847</code></pre> <p>Note that you will need to place place a <code>markdown-languages.json</code> file inside your working directory or inside your local <span class="tex">T<sub>e</sub>X</span> directory structure. In this file, you will define a mapping between filename extensions and the language names recognized by your favorite syntax highlighter; there may exist other creative uses beside syntax highlighting. <a href="https://github.com/iainc/Markdown-Content-Blocks" title="File transclusion syntax for Markdown">The <code>Languages.json</code> file provided by Anton Sotkov</a> is a good starting point.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-24">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb421"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb421-1"><a href="#cb421-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb421-2"><a href="#cb421-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionContentBlocks</span>{true}</span> -<span id="cb421-3"><a href="#cb421-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb421-4"><a href="#cb421-4" aria-hidden="true"></a> This is {<span class="fu">\tt</span> #2}, #4.</span> -<span id="cb421-5"><a href="#cb421-5" aria-hidden="true"></a>}</span> -<span id="cb421-6"><a href="#cb421-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb421-7"><a href="#cb421-7" aria-hidden="true"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span> -<span id="cb421-8"><a href="#cb421-8" aria-hidden="true"></a>}</span> -<span id="cb421-9"><a href="#cb421-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span> -<span id="cb421-10"><a href="#cb421-10" aria-hidden="true"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span> -<span id="cb421-11"><a href="#cb421-11" aria-hidden="true"></a>}</span> -<span id="cb421-12"><a href="#cb421-12" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb421-13"><a href="#cb421-13" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> -<span id="cb421-14"><a href="#cb421-14" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> -<span id="cb421-15"><a href="#cb421-15" aria-hidden="true"></a> and programming language names)</span> -<span id="cb421-16"><a href="#cb421-16" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> -<span id="cb421-17"><a href="#cb421-17" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb421-18"><a href="#cb421-18" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb424"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb424-1"><a href="#cb424-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb424-2"><a href="#cb424-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionContentBlocks</span>{true}</span> +<span id="cb424-3"><a href="#cb424-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb424-4"><a href="#cb424-4" aria-hidden="true"></a> This is {<span class="fu">\tt</span> #2}, #4.</span> +<span id="cb424-5"><a href="#cb424-5" aria-hidden="true"></a>}</span> +<span id="cb424-6"><a href="#cb424-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb424-7"><a href="#cb424-7" aria-hidden="true"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span> +<span id="cb424-8"><a href="#cb424-8" aria-hidden="true"></a>}</span> +<span id="cb424-9"><a href="#cb424-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span> +<span id="cb424-10"><a href="#cb424-10" aria-hidden="true"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span> +<span id="cb424-11"><a href="#cb424-11" aria-hidden="true"></a>}</span> +<span id="cb424-12"><a href="#cb424-12" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb424-13"><a href="#cb424-13" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> +<span id="cb424-14"><a href="#cb424-14" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> +<span id="cb424-15"><a href="#cb424-15" aria-hidden="true"></a> and programming language names)</span> +<span id="cb424-16"><a href="#cb424-16" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> +<span id="cb424-17"><a href="#cb424-17" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb424-18"><a href="#cb424-18" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Create also a text document named <code>markdown-languages.json</code> with the following content:</p> -<div class="sourceCode" id="cb422"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb422-1"><a href="#cb422-1" aria-hidden="true"></a>{</span> -<span id="cb422-2"><a href="#cb422-2" aria-hidden="true"></a> <span class="st">"json"</span><span class="op">:</span> <span class="st">"JavaScript Object Notation"</span><span class="op">,</span></span> -<span id="cb422-3"><a href="#cb422-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb425"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb425-1"><a href="#cb425-1" aria-hidden="true"></a>{</span> +<span id="cb425-2"><a href="#cb425-2" aria-hidden="true"></a> <span class="st">"json"</span><span class="op">:</span> <span class="st">"JavaScript Object Notation"</span><span class="op">,</span></span> +<span id="cb425-3"><a href="#cb425-3" aria-hidden="true"></a>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb423"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb423-1"><a href="#cb423-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb426"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb426-1"><a href="#cb426-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <code>document.tex</code>, the document that we are currently typesetting.</p> <p>This is the JavaScript Object Notation (JSON) document <code>markdown-languages.json</code>, the mapping between filename extensions and programming language names.</p> <p>This is the image <code>https://tug.org/tugboat/noword.jpg</code>, the logotype of TUGboat.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-51"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-52"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb424"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb424-1"><a href="#cb424-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb424-2"><a href="#cb424-2" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{markdown-languages.json}</span> -<span id="cb424-3"><a href="#cb424-3" aria-hidden="true"></a>{</span> -<span id="cb424-4"><a href="#cb424-4" aria-hidden="true"></a> "json": "JavaScript Object Notation",</span> -<span id="cb424-5"><a href="#cb424-5" aria-hidden="true"></a>}</span> -<span id="cb424-6"><a href="#cb424-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> -<span id="cb424-7"><a href="#cb424-7" aria-hidden="true"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span> -<span id="cb424-8"><a href="#cb424-8" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb424-9"><a href="#cb424-9" aria-hidden="true"></a> renderers = {</span> -<span id="cb424-10"><a href="#cb424-10" aria-hidden="true"></a> contentBlock = {This is <span class="fu">\texttt</span>{#2}, #4.},</span> -<span id="cb424-11"><a href="#cb424-11" aria-hidden="true"></a> contentBlockOnlineImage = {This is the image <span class="fu">\texttt</span>{#2}, #4.},</span> -<span id="cb424-12"><a href="#cb424-12" aria-hidden="true"></a> contentBlockCode = {<span class="co">%</span></span> -<span id="cb424-13"><a href="#cb424-13" aria-hidden="true"></a> This is the #2 (<span class="fu">\MakeUppercase</span>{#1}) document <span class="fu">\texttt</span>{#3}, #5.</span> -<span id="cb424-14"><a href="#cb424-14" aria-hidden="true"></a> },</span> -<span id="cb424-15"><a href="#cb424-15" aria-hidden="true"></a> },</span> -<span id="cb424-16"><a href="#cb424-16" aria-hidden="true"></a>}</span> -<span id="cb424-17"><a href="#cb424-17" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb424-18"><a href="#cb424-18" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb424-19"><a href="#cb424-19" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> -<span id="cb424-20"><a href="#cb424-20" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> -<span id="cb424-21"><a href="#cb424-21" aria-hidden="true"></a> and programming language names)</span> -<span id="cb424-22"><a href="#cb424-22" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> -<span id="cb424-23"><a href="#cb424-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb424-24"><a href="#cb424-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb425"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb425-1"><a href="#cb425-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb427"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb427-1"><a href="#cb427-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb427-2"><a href="#cb427-2" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{markdown-languages.json}</span> +<span id="cb427-3"><a href="#cb427-3" aria-hidden="true"></a>{</span> +<span id="cb427-4"><a href="#cb427-4" aria-hidden="true"></a> "json": "JavaScript Object Notation",</span> +<span id="cb427-5"><a href="#cb427-5" aria-hidden="true"></a>}</span> +<span id="cb427-6"><a href="#cb427-6" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span> +<span id="cb427-7"><a href="#cb427-7" aria-hidden="true"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span> +<span id="cb427-8"><a href="#cb427-8" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb427-9"><a href="#cb427-9" aria-hidden="true"></a> renderers = {</span> +<span id="cb427-10"><a href="#cb427-10" aria-hidden="true"></a> contentBlock = {This is <span class="fu">\texttt</span>{#2}, #4.},</span> +<span id="cb427-11"><a href="#cb427-11" aria-hidden="true"></a> contentBlockOnlineImage = {This is the image <span class="fu">\texttt</span>{#2}, #4.},</span> +<span id="cb427-12"><a href="#cb427-12" aria-hidden="true"></a> contentBlockCode = {<span class="co">%</span></span> +<span id="cb427-13"><a href="#cb427-13" aria-hidden="true"></a> This is the #2 (<span class="fu">\MakeUppercase</span>{#1}) document <span class="fu">\texttt</span>{#3}, #5.</span> +<span id="cb427-14"><a href="#cb427-14" aria-hidden="true"></a> },</span> +<span id="cb427-15"><a href="#cb427-15" aria-hidden="true"></a> },</span> +<span id="cb427-16"><a href="#cb427-16" aria-hidden="true"></a>}</span> +<span id="cb427-17"><a href="#cb427-17" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb427-18"><a href="#cb427-18" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb427-19"><a href="#cb427-19" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> +<span id="cb427-20"><a href="#cb427-20" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> +<span id="cb427-21"><a href="#cb427-21" aria-hidden="true"></a> and programming language names)</span> +<span id="cb427-22"><a href="#cb427-22" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> +<span id="cb427-23"><a href="#cb427-23" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb427-24"><a href="#cb427-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb428"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb428-1"><a href="#cb428-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <code>document.tex</code>, the document that we are currently typesetting.</p> @@ -5124,31 +5167,31 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-39">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb426"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb426-1"><a href="#cb426-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb426-2"><a href="#cb426-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[contentBlocks = yes]</span> -<span id="cb426-3"><a href="#cb426-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb426-4"><a href="#cb426-4" aria-hidden="true"></a> This is {<span class="fu">\tt</span> #2}, #4.</span> -<span id="cb426-5"><a href="#cb426-5" aria-hidden="true"></a>}</span> -<span id="cb426-6"><a href="#cb426-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb426-7"><a href="#cb426-7" aria-hidden="true"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span> -<span id="cb426-8"><a href="#cb426-8" aria-hidden="true"></a>}</span> -<span id="cb426-9"><a href="#cb426-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span> -<span id="cb426-10"><a href="#cb426-10" aria-hidden="true"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span> -<span id="cb426-11"><a href="#cb426-11" aria-hidden="true"></a>}</span> -<span id="cb426-12"><a href="#cb426-12" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb426-13"><a href="#cb426-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb426-14"><a href="#cb426-14" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> -<span id="cb426-15"><a href="#cb426-15" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> -<span id="cb426-16"><a href="#cb426-16" aria-hidden="true"></a> and programming language names)</span> -<span id="cb426-17"><a href="#cb426-17" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> -<span id="cb426-18"><a href="#cb426-18" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb426-19"><a href="#cb426-19" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb429"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb429-1"><a href="#cb429-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb429-2"><a href="#cb429-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[contentBlocks = yes]</span> +<span id="cb429-3"><a href="#cb429-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb429-4"><a href="#cb429-4" aria-hidden="true"></a> This is {<span class="fu">\tt</span> #2}, #4.</span> +<span id="cb429-5"><a href="#cb429-5" aria-hidden="true"></a>}</span> +<span id="cb429-6"><a href="#cb429-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb429-7"><a href="#cb429-7" aria-hidden="true"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span> +<span id="cb429-8"><a href="#cb429-8" aria-hidden="true"></a>}</span> +<span id="cb429-9"><a href="#cb429-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span> +<span id="cb429-10"><a href="#cb429-10" aria-hidden="true"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span> +<span id="cb429-11"><a href="#cb429-11" aria-hidden="true"></a>}</span> +<span id="cb429-12"><a href="#cb429-12" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb429-13"><a href="#cb429-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb429-14"><a href="#cb429-14" aria-hidden="true"></a>/document.tex (the document that we are currently typesetting)</span> +<span id="cb429-15"><a href="#cb429-15" aria-hidden="true"></a>/markdown-languages.json (the mapping between filename extensions</span> +<span id="cb429-16"><a href="#cb429-16" aria-hidden="true"></a> and programming language names)</span> +<span id="cb429-17"><a href="#cb429-17" aria-hidden="true"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span> +<span id="cb429-18"><a href="#cb429-18" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb429-19"><a href="#cb429-19" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Create also a text document named <code>markdown-languages.json</code> with the following content:</p> -<div class="sourceCode" id="cb427"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb427-1"><a href="#cb427-1" aria-hidden="true"></a>{</span> -<span id="cb427-2"><a href="#cb427-2" aria-hidden="true"></a> <span class="st">"json"</span><span class="op">:</span> <span class="st">"JavaScript Object Notation"</span><span class="op">,</span></span> -<span id="cb427-3"><a href="#cb427-3" aria-hidden="true"></a>}</span></code></pre></div> +<div class="sourceCode" id="cb430"><pre class="sourceCode js"><code class="sourceCode javascript"><span id="cb430-1"><a href="#cb430-1" aria-hidden="true"></a>{</span> +<span id="cb430-2"><a href="#cb430-2" aria-hidden="true"></a> <span class="st">"json"</span><span class="op">:</span> <span class="st">"JavaScript Object Notation"</span><span class="op">,</span></span> +<span id="cb430-3"><a href="#cb430-3" aria-hidden="true"></a>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb428"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb428-1"><a href="#cb428-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb431"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb431-1"><a href="#cb431-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <code>document.tex</code>, the document that we are currently typesetting.</p> @@ -5164,50 +5207,50 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererUlEndTight</code> macro represents the end of a bulleted list that contains no item with several paragraphs of text (the list is tight). This macro will only be produced, when the <strong><code>tightLists</code></strong> option is disabled. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-25">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb429"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb429-1"><a href="#cb429-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb429-2"><a href="#cb429-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> -<span id="cb429-3"><a href="#cb429-3" aria-hidden="true"></a></span> -<span id="cb429-4"><a href="#cb429-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb429-5"><a href="#cb429-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span> -<span id="cb429-6"><a href="#cb429-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> -<span id="cb429-7"><a href="#cb429-7" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> -<span id="cb429-8"><a href="#cb429-8" aria-hidden="true"></a> ,</span> -<span id="cb429-9"><a href="#cb429-9" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> -<span id="cb429-10"><a href="#cb429-10" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb429-11"><a href="#cb429-11" aria-hidden="true"></a>}</span> -<span id="cb429-12"><a href="#cb429-12" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span> -<span id="cb429-13"><a href="#cb429-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span> -<span id="cb429-14"><a href="#cb429-14" aria-hidden="true"></a></span> -<span id="cb429-15"><a href="#cb429-15" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb429-16"><a href="#cb429-16" aria-hidden="true"></a>This is a tight list</span> -<span id="cb429-17"><a href="#cb429-17" aria-hidden="true"></a></span> -<span id="cb429-18"><a href="#cb429-18" aria-hidden="true"></a>- the first item</span> -<span id="cb429-19"><a href="#cb429-19" aria-hidden="true"></a>- the second item</span> -<span id="cb429-20"><a href="#cb429-20" aria-hidden="true"></a>- the third item</span> -<span id="cb429-21"><a href="#cb429-21" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb429-22"><a href="#cb429-22" aria-hidden="true"></a></span> -<span id="cb429-23"><a href="#cb429-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb429-24"><a href="#cb429-24" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb429-25"><a href="#cb429-25" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb429-26"><a href="#cb429-26" aria-hidden="true"></a>}</span> -<span id="cb429-27"><a href="#cb429-27" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBegin</span>{}</span> -<span id="cb429-28"><a href="#cb429-28" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{--<span class="fu">\kern</span> 0.5em}</span> -<span id="cb429-29"><a href="#cb429-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.<span class="fu">\par</span>}</span> -<span id="cb429-30"><a href="#cb429-30" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEnd</span>{}</span> -<span id="cb429-31"><a href="#cb429-31" aria-hidden="true"></a></span> -<span id="cb429-32"><a href="#cb429-32" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb429-33"><a href="#cb429-33" aria-hidden="true"></a>This is a loose list</span> -<span id="cb429-34"><a href="#cb429-34" aria-hidden="true"></a></span> -<span id="cb429-35"><a href="#cb429-35" aria-hidden="true"></a>- This is the first item</span> -<span id="cb429-36"><a href="#cb429-36" aria-hidden="true"></a></span> -<span id="cb429-37"><a href="#cb429-37" aria-hidden="true"></a>- This is the second item</span> -<span id="cb429-38"><a href="#cb429-38" aria-hidden="true"></a></span> -<span id="cb429-39"><a href="#cb429-39" aria-hidden="true"></a>- This is the third item</span> -<span id="cb429-40"><a href="#cb429-40" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb429-41"><a href="#cb429-41" aria-hidden="true"></a></span> -<span id="cb429-42"><a href="#cb429-42" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb430"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb430-1"><a href="#cb430-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb432"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb432-1"><a href="#cb432-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb432-2"><a href="#cb432-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> +<span id="cb432-3"><a href="#cb432-3" aria-hidden="true"></a></span> +<span id="cb432-4"><a href="#cb432-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb432-5"><a href="#cb432-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span> +<span id="cb432-6"><a href="#cb432-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> +<span id="cb432-7"><a href="#cb432-7" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> +<span id="cb432-8"><a href="#cb432-8" aria-hidden="true"></a> ,</span> +<span id="cb432-9"><a href="#cb432-9" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> +<span id="cb432-10"><a href="#cb432-10" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb432-11"><a href="#cb432-11" aria-hidden="true"></a>}</span> +<span id="cb432-12"><a href="#cb432-12" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span> +<span id="cb432-13"><a href="#cb432-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span> +<span id="cb432-14"><a href="#cb432-14" aria-hidden="true"></a></span> +<span id="cb432-15"><a href="#cb432-15" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb432-16"><a href="#cb432-16" aria-hidden="true"></a>This is a tight list</span> +<span id="cb432-17"><a href="#cb432-17" aria-hidden="true"></a></span> +<span id="cb432-18"><a href="#cb432-18" aria-hidden="true"></a>- the first item</span> +<span id="cb432-19"><a href="#cb432-19" aria-hidden="true"></a>- the second item</span> +<span id="cb432-20"><a href="#cb432-20" aria-hidden="true"></a>- the third item</span> +<span id="cb432-21"><a href="#cb432-21" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb432-22"><a href="#cb432-22" aria-hidden="true"></a></span> +<span id="cb432-23"><a href="#cb432-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb432-24"><a href="#cb432-24" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb432-25"><a href="#cb432-25" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb432-26"><a href="#cb432-26" aria-hidden="true"></a>}</span> +<span id="cb432-27"><a href="#cb432-27" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBegin</span>{}</span> +<span id="cb432-28"><a href="#cb432-28" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{--<span class="fu">\kern</span> 0.5em}</span> +<span id="cb432-29"><a href="#cb432-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.<span class="fu">\par</span>}</span> +<span id="cb432-30"><a href="#cb432-30" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEnd</span>{}</span> +<span id="cb432-31"><a href="#cb432-31" aria-hidden="true"></a></span> +<span id="cb432-32"><a href="#cb432-32" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb432-33"><a href="#cb432-33" aria-hidden="true"></a>This is a loose list</span> +<span id="cb432-34"><a href="#cb432-34" aria-hidden="true"></a></span> +<span id="cb432-35"><a href="#cb432-35" aria-hidden="true"></a>- This is the first item</span> +<span id="cb432-36"><a href="#cb432-36" aria-hidden="true"></a></span> +<span id="cb432-37"><a href="#cb432-37" aria-hidden="true"></a>- This is the second item</span> +<span id="cb432-38"><a href="#cb432-38" aria-hidden="true"></a></span> +<span id="cb432-39"><a href="#cb432-39" aria-hidden="true"></a>- This is the third item</span> +<span id="cb432-40"><a href="#cb432-40" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb432-41"><a href="#cb432-41" aria-hidden="true"></a></span> +<span id="cb432-42"><a href="#cb432-42" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb433"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb433-1"><a href="#cb433-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5218,57 +5261,57 @@ Thomas,Edison,1847</code></pre> <li><p>This is the third item.</p></li> </ul> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-52"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-53"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb431"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb431-1"><a href="#cb431-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb431-2"><a href="#cb431-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[tightLists]{<span class="ex">markdown</span>}</span> -<span id="cb431-3"><a href="#cb431-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb431-4"><a href="#cb431-4" aria-hidden="true"></a></span> -<span id="cb431-5"><a href="#cb431-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb431-6"><a href="#cb431-6" aria-hidden="true"></a> renderers = {</span> -<span id="cb431-7"><a href="#cb431-7" aria-hidden="true"></a> interblockSeparator = {},</span> -<span id="cb431-8"><a href="#cb431-8" aria-hidden="true"></a> ulBeginTight = { (},</span> -<span id="cb431-9"><a href="#cb431-9" aria-hidden="true"></a> ulItem = {<span class="co">%</span></span> -<span id="cb431-10"><a href="#cb431-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> -<span id="cb431-11"><a href="#cb431-11" aria-hidden="true"></a> ,</span> -<span id="cb431-12"><a href="#cb431-12" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> -<span id="cb431-13"><a href="#cb431-13" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb431-14"><a href="#cb431-14" aria-hidden="true"></a> },</span> -<span id="cb431-15"><a href="#cb431-15" aria-hidden="true"></a> ulItemEnd = {},</span> -<span id="cb431-16"><a href="#cb431-16" aria-hidden="true"></a> ulEndTight = {).},</span> -<span id="cb431-17"><a href="#cb431-17" aria-hidden="true"></a> },</span> -<span id="cb431-18"><a href="#cb431-18" aria-hidden="true"></a>}</span> -<span id="cb431-19"><a href="#cb431-19" aria-hidden="true"></a>This is a tight list</span> -<span id="cb431-20"><a href="#cb431-20" aria-hidden="true"></a></span> -<span id="cb431-21"><a href="#cb431-21" aria-hidden="true"></a>- the first item</span> -<span id="cb431-22"><a href="#cb431-22" aria-hidden="true"></a>- the second item</span> -<span id="cb431-23"><a href="#cb431-23" aria-hidden="true"></a>- the third item</span> -<span id="cb431-24"><a href="#cb431-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb431-25"><a href="#cb431-25" aria-hidden="true"></a></span> -<span id="cb431-26"><a href="#cb431-26" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb431-27"><a href="#cb431-27" aria-hidden="true"></a> renderers = {</span> -<span id="cb431-28"><a href="#cb431-28" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> -<span id="cb431-29"><a href="#cb431-29" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb431-30"><a href="#cb431-30" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb431-31"><a href="#cb431-31" aria-hidden="true"></a> },</span> -<span id="cb431-32"><a href="#cb431-32" aria-hidden="true"></a> ulBeginTight = {<span class="kw">\begin</span>{<span class="ex">itemize</span>}},</span> -<span id="cb431-33"><a href="#cb431-33" aria-hidden="true"></a> ulItem = {<span class="fu">\item</span>},</span> -<span id="cb431-34"><a href="#cb431-34" aria-hidden="true"></a> ulItemEnd = {.},</span> -<span id="cb431-35"><a href="#cb431-35" aria-hidden="true"></a> ulEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span> -<span id="cb431-36"><a href="#cb431-36" aria-hidden="true"></a> },</span> -<span id="cb431-37"><a href="#cb431-37" aria-hidden="true"></a>}</span> -<span id="cb431-38"><a href="#cb431-38" aria-hidden="true"></a>This is a loose list</span> -<span id="cb431-39"><a href="#cb431-39" aria-hidden="true"></a></span> -<span id="cb431-40"><a href="#cb431-40" aria-hidden="true"></a>- This is the first item</span> -<span id="cb431-41"><a href="#cb431-41" aria-hidden="true"></a></span> -<span id="cb431-42"><a href="#cb431-42" aria-hidden="true"></a>- This is the second item</span> -<span id="cb431-43"><a href="#cb431-43" aria-hidden="true"></a></span> -<span id="cb431-44"><a href="#cb431-44" aria-hidden="true"></a>- This is the third item</span> -<span id="cb431-45"><a href="#cb431-45" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb431-46"><a href="#cb431-46" aria-hidden="true"></a></span> -<span id="cb431-47"><a href="#cb431-47" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb432"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb432-1"><a href="#cb432-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb434"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb434-1"><a href="#cb434-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb434-2"><a href="#cb434-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[tightLists]{<span class="ex">markdown</span>}</span> +<span id="cb434-3"><a href="#cb434-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb434-4"><a href="#cb434-4" aria-hidden="true"></a></span> +<span id="cb434-5"><a href="#cb434-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb434-6"><a href="#cb434-6" aria-hidden="true"></a> renderers = {</span> +<span id="cb434-7"><a href="#cb434-7" aria-hidden="true"></a> interblockSeparator = {},</span> +<span id="cb434-8"><a href="#cb434-8" aria-hidden="true"></a> ulBeginTight = { (},</span> +<span id="cb434-9"><a href="#cb434-9" aria-hidden="true"></a> ulItem = {<span class="co">%</span></span> +<span id="cb434-10"><a href="#cb434-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> +<span id="cb434-11"><a href="#cb434-11" aria-hidden="true"></a> ,</span> +<span id="cb434-12"><a href="#cb434-12" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> +<span id="cb434-13"><a href="#cb434-13" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb434-14"><a href="#cb434-14" aria-hidden="true"></a> },</span> +<span id="cb434-15"><a href="#cb434-15" aria-hidden="true"></a> ulItemEnd = {},</span> +<span id="cb434-16"><a href="#cb434-16" aria-hidden="true"></a> ulEndTight = {).},</span> +<span id="cb434-17"><a href="#cb434-17" aria-hidden="true"></a> },</span> +<span id="cb434-18"><a href="#cb434-18" aria-hidden="true"></a>}</span> +<span id="cb434-19"><a href="#cb434-19" aria-hidden="true"></a>This is a tight list</span> +<span id="cb434-20"><a href="#cb434-20" aria-hidden="true"></a></span> +<span id="cb434-21"><a href="#cb434-21" aria-hidden="true"></a>- the first item</span> +<span id="cb434-22"><a href="#cb434-22" aria-hidden="true"></a>- the second item</span> +<span id="cb434-23"><a href="#cb434-23" aria-hidden="true"></a>- the third item</span> +<span id="cb434-24"><a href="#cb434-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb434-25"><a href="#cb434-25" aria-hidden="true"></a></span> +<span id="cb434-26"><a href="#cb434-26" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb434-27"><a href="#cb434-27" aria-hidden="true"></a> renderers = {</span> +<span id="cb434-28"><a href="#cb434-28" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> +<span id="cb434-29"><a href="#cb434-29" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb434-30"><a href="#cb434-30" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb434-31"><a href="#cb434-31" aria-hidden="true"></a> },</span> +<span id="cb434-32"><a href="#cb434-32" aria-hidden="true"></a> ulBeginTight = {<span class="kw">\begin</span>{<span class="ex">itemize</span>}},</span> +<span id="cb434-33"><a href="#cb434-33" aria-hidden="true"></a> ulItem = {<span class="fu">\item</span>},</span> +<span id="cb434-34"><a href="#cb434-34" aria-hidden="true"></a> ulItemEnd = {.},</span> +<span id="cb434-35"><a href="#cb434-35" aria-hidden="true"></a> ulEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span> +<span id="cb434-36"><a href="#cb434-36" aria-hidden="true"></a> },</span> +<span id="cb434-37"><a href="#cb434-37" aria-hidden="true"></a>}</span> +<span id="cb434-38"><a href="#cb434-38" aria-hidden="true"></a>This is a loose list</span> +<span id="cb434-39"><a href="#cb434-39" aria-hidden="true"></a></span> +<span id="cb434-40"><a href="#cb434-40" aria-hidden="true"></a>- This is the first item</span> +<span id="cb434-41"><a href="#cb434-41" aria-hidden="true"></a></span> +<span id="cb434-42"><a href="#cb434-42" aria-hidden="true"></a>- This is the second item</span> +<span id="cb434-43"><a href="#cb434-43" aria-hidden="true"></a></span> +<span id="cb434-44"><a href="#cb434-44" aria-hidden="true"></a>- This is the third item</span> +<span id="cb434-45"><a href="#cb434-45" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb434-46"><a href="#cb434-46" aria-hidden="true"></a></span> +<span id="cb434-47"><a href="#cb434-47" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb435"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb435-1"><a href="#cb435-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5281,51 +5324,51 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-40">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb433"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb433-1"><a href="#cb433-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb433-2"><a href="#cb433-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[tightLists = yes]</span> -<span id="cb433-3"><a href="#cb433-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb433-4"><a href="#cb433-4" aria-hidden="true"></a></span> -<span id="cb433-5"><a href="#cb433-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb433-6"><a href="#cb433-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span> -<span id="cb433-7"><a href="#cb433-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> -<span id="cb433-8"><a href="#cb433-8" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> -<span id="cb433-9"><a href="#cb433-9" aria-hidden="true"></a> ,</span> -<span id="cb433-10"><a href="#cb433-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> -<span id="cb433-11"><a href="#cb433-11" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb433-12"><a href="#cb433-12" aria-hidden="true"></a>}</span> -<span id="cb433-13"><a href="#cb433-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span> -<span id="cb433-14"><a href="#cb433-14" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span> -<span id="cb433-15"><a href="#cb433-15" aria-hidden="true"></a></span> -<span id="cb433-16"><a href="#cb433-16" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb433-17"><a href="#cb433-17" aria-hidden="true"></a>This is a tight list</span> -<span id="cb433-18"><a href="#cb433-18" aria-hidden="true"></a></span> -<span id="cb433-19"><a href="#cb433-19" aria-hidden="true"></a>- the first item</span> -<span id="cb433-20"><a href="#cb433-20" aria-hidden="true"></a>- the second item</span> -<span id="cb433-21"><a href="#cb433-21" aria-hidden="true"></a>- the third item</span> -<span id="cb433-22"><a href="#cb433-22" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb433-23"><a href="#cb433-23" aria-hidden="true"></a></span> -<span id="cb433-24"><a href="#cb433-24" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb433-25"><a href="#cb433-25" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb433-26"><a href="#cb433-26" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb433-27"><a href="#cb433-27" aria-hidden="true"></a>}</span> -<span id="cb433-28"><a href="#cb433-28" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBegin</span>{<span class="fu">\startitemize</span>}</span> -<span id="cb433-29"><a href="#cb433-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="fu">\item</span>}</span> -<span id="cb433-30"><a href="#cb433-30" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.}</span> -<span id="cb433-31"><a href="#cb433-31" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEnd</span>{<span class="fu">\stopitemize</span>}</span> -<span id="cb433-32"><a href="#cb433-32" aria-hidden="true"></a></span> -<span id="cb433-33"><a href="#cb433-33" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb433-34"><a href="#cb433-34" aria-hidden="true"></a>This is a loose list</span> -<span id="cb433-35"><a href="#cb433-35" aria-hidden="true"></a></span> -<span id="cb433-36"><a href="#cb433-36" aria-hidden="true"></a>- This is the first item</span> -<span id="cb433-37"><a href="#cb433-37" aria-hidden="true"></a></span> -<span id="cb433-38"><a href="#cb433-38" aria-hidden="true"></a>- This is the second item</span> -<span id="cb433-39"><a href="#cb433-39" aria-hidden="true"></a></span> -<span id="cb433-40"><a href="#cb433-40" aria-hidden="true"></a>- This is the third item</span> -<span id="cb433-41"><a href="#cb433-41" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb433-42"><a href="#cb433-42" aria-hidden="true"></a></span> -<span id="cb433-43"><a href="#cb433-43" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb434"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb434-1"><a href="#cb434-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb436"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb436-1"><a href="#cb436-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb436-2"><a href="#cb436-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[tightLists = yes]</span> +<span id="cb436-3"><a href="#cb436-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb436-4"><a href="#cb436-4" aria-hidden="true"></a></span> +<span id="cb436-5"><a href="#cb436-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb436-6"><a href="#cb436-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span> +<span id="cb436-7"><a href="#cb436-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> +<span id="cb436-8"><a href="#cb436-8" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span> +<span id="cb436-9"><a href="#cb436-9" aria-hidden="true"></a> ,</span> +<span id="cb436-10"><a href="#cb436-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span> +<span id="cb436-11"><a href="#cb436-11" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb436-12"><a href="#cb436-12" aria-hidden="true"></a>}</span> +<span id="cb436-13"><a href="#cb436-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span> +<span id="cb436-14"><a href="#cb436-14" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span> +<span id="cb436-15"><a href="#cb436-15" aria-hidden="true"></a></span> +<span id="cb436-16"><a href="#cb436-16" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb436-17"><a href="#cb436-17" aria-hidden="true"></a>This is a tight list</span> +<span id="cb436-18"><a href="#cb436-18" aria-hidden="true"></a></span> +<span id="cb436-19"><a href="#cb436-19" aria-hidden="true"></a>- the first item</span> +<span id="cb436-20"><a href="#cb436-20" aria-hidden="true"></a>- the second item</span> +<span id="cb436-21"><a href="#cb436-21" aria-hidden="true"></a>- the third item</span> +<span id="cb436-22"><a href="#cb436-22" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb436-23"><a href="#cb436-23" aria-hidden="true"></a></span> +<span id="cb436-24"><a href="#cb436-24" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb436-25"><a href="#cb436-25" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb436-26"><a href="#cb436-26" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb436-27"><a href="#cb436-27" aria-hidden="true"></a>}</span> +<span id="cb436-28"><a href="#cb436-28" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlBegin</span>{<span class="fu">\startitemize</span>}</span> +<span id="cb436-29"><a href="#cb436-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="fu">\item</span>}</span> +<span id="cb436-30"><a href="#cb436-30" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.}</span> +<span id="cb436-31"><a href="#cb436-31" aria-hidden="true"></a><span class="fu">\def\markdownRendererUlEnd</span>{<span class="fu">\stopitemize</span>}</span> +<span id="cb436-32"><a href="#cb436-32" aria-hidden="true"></a></span> +<span id="cb436-33"><a href="#cb436-33" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb436-34"><a href="#cb436-34" aria-hidden="true"></a>This is a loose list</span> +<span id="cb436-35"><a href="#cb436-35" aria-hidden="true"></a></span> +<span id="cb436-36"><a href="#cb436-36" aria-hidden="true"></a>- This is the first item</span> +<span id="cb436-37"><a href="#cb436-37" aria-hidden="true"></a></span> +<span id="cb436-38"><a href="#cb436-38" aria-hidden="true"></a>- This is the second item</span> +<span id="cb436-39"><a href="#cb436-39" aria-hidden="true"></a></span> +<span id="cb436-40"><a href="#cb436-40" aria-hidden="true"></a>- This is the third item</span> +<span id="cb436-41"><a href="#cb436-41" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb436-42"><a href="#cb436-42" aria-hidden="true"></a></span> +<span id="cb436-43"><a href="#cb436-43" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb437"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb437-1"><a href="#cb437-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5353,68 +5396,68 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererFancyOlEndTight</code> macro represents the end of a fancy ordered list that contains no item with several paragraphs of text (the list is tight). This macro will only be produced, when the <strong><code>fancyLists</code></strong> and <strong><code>tightLists</code></strong> options are enabled. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-26">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb435"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb435-1"><a href="#cb435-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb435-2"><a href="#cb435-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> -<span id="cb435-3"><a href="#cb435-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionStartNumber</span>{true}</span> -<span id="cb435-4"><a href="#cb435-4" aria-hidden="true"></a></span> -<span id="cb435-5"><a href="#cb435-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb435-6"><a href="#cb435-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span> -<span id="cb435-7"><a href="#cb435-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> -<span id="cb435-8"><a href="#cb435-8" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb435-9"><a href="#cb435-9" aria-hidden="true"></a> the first</span> -<span id="cb435-10"><a href="#cb435-10" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb435-11"><a href="#cb435-11" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb435-12"><a href="#cb435-12" aria-hidden="true"></a> , the second</span> -<span id="cb435-13"><a href="#cb435-13" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb435-14"><a href="#cb435-14" aria-hidden="true"></a> , and the third</span> -<span id="cb435-15"><a href="#cb435-15" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb435-16"><a href="#cb435-16" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb435-17"><a href="#cb435-17" aria-hidden="true"></a>}</span> -<span id="cb435-18"><a href="#cb435-18" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span> -<span id="cb435-19"><a href="#cb435-19" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span> -<span id="cb435-20"><a href="#cb435-20" aria-hidden="true"></a></span> -<span id="cb435-21"><a href="#cb435-21" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb435-22"><a href="#cb435-22" aria-hidden="true"></a>This is a tight list</span> -<span id="cb435-23"><a href="#cb435-23" aria-hidden="true"></a></span> -<span id="cb435-24"><a href="#cb435-24" aria-hidden="true"></a>1. item</span> -<span id="cb435-25"><a href="#cb435-25" aria-hidden="true"></a>2. item</span> -<span id="cb435-26"><a href="#cb435-26" aria-hidden="true"></a>3. item</span> -<span id="cb435-27"><a href="#cb435-27" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb435-28"><a href="#cb435-28" aria-hidden="true"></a></span> -<span id="cb435-29"><a href="#cb435-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb435-30"><a href="#cb435-30" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb435-31"><a href="#cb435-31" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb435-32"><a href="#cb435-32" aria-hidden="true"></a>}</span> -<span id="cb435-33"><a href="#cb435-33" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBegin</span>{}</span> -<span id="cb435-34"><a href="#cb435-34" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> -<span id="cb435-35"><a href="#cb435-35" aria-hidden="true"></a> #1.<span class="fu">\kern</span> 0.5em<span class="co">%</span></span> -<span id="cb435-36"><a href="#cb435-36" aria-hidden="true"></a> This is the</span> -<span id="cb435-37"><a href="#cb435-37" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb435-38"><a href="#cb435-38" aria-hidden="true"></a> first</span> -<span id="cb435-39"><a href="#cb435-39" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb435-40"><a href="#cb435-40" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb435-41"><a href="#cb435-41" aria-hidden="true"></a> second</span> -<span id="cb435-42"><a href="#cb435-42" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb435-43"><a href="#cb435-43" aria-hidden="true"></a> third</span> -<span id="cb435-44"><a href="#cb435-44" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb435-45"><a href="#cb435-45" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb435-46"><a href="#cb435-46" aria-hidden="true"></a>}</span> -<span id="cb435-47"><a href="#cb435-47" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span> -<span id="cb435-48"><a href="#cb435-48" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEnd</span>{}</span> -<span id="cb435-49"><a href="#cb435-49" aria-hidden="true"></a></span> -<span id="cb435-50"><a href="#cb435-50" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb435-51"><a href="#cb435-51" aria-hidden="true"></a>This is a loose list</span> -<span id="cb435-52"><a href="#cb435-52" aria-hidden="true"></a></span> -<span id="cb435-53"><a href="#cb435-53" aria-hidden="true"></a>1. item</span> -<span id="cb435-54"><a href="#cb435-54" aria-hidden="true"></a></span> -<span id="cb435-55"><a href="#cb435-55" aria-hidden="true"></a>2. item</span> -<span id="cb435-56"><a href="#cb435-56" aria-hidden="true"></a></span> -<span id="cb435-57"><a href="#cb435-57" aria-hidden="true"></a>3. item</span> -<span id="cb435-58"><a href="#cb435-58" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb435-59"><a href="#cb435-59" aria-hidden="true"></a></span> -<span id="cb435-60"><a href="#cb435-60" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb436"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb436-1"><a href="#cb436-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb438"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb438-1"><a href="#cb438-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb438-2"><a href="#cb438-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> +<span id="cb438-3"><a href="#cb438-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionStartNumber</span>{true}</span> +<span id="cb438-4"><a href="#cb438-4" aria-hidden="true"></a></span> +<span id="cb438-5"><a href="#cb438-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb438-6"><a href="#cb438-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span> +<span id="cb438-7"><a href="#cb438-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> +<span id="cb438-8"><a href="#cb438-8" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb438-9"><a href="#cb438-9" aria-hidden="true"></a> the first</span> +<span id="cb438-10"><a href="#cb438-10" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb438-11"><a href="#cb438-11" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb438-12"><a href="#cb438-12" aria-hidden="true"></a> , the second</span> +<span id="cb438-13"><a href="#cb438-13" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb438-14"><a href="#cb438-14" aria-hidden="true"></a> , and the third</span> +<span id="cb438-15"><a href="#cb438-15" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb438-16"><a href="#cb438-16" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb438-17"><a href="#cb438-17" aria-hidden="true"></a>}</span> +<span id="cb438-18"><a href="#cb438-18" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span> +<span id="cb438-19"><a href="#cb438-19" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span> +<span id="cb438-20"><a href="#cb438-20" aria-hidden="true"></a></span> +<span id="cb438-21"><a href="#cb438-21" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb438-22"><a href="#cb438-22" aria-hidden="true"></a>This is a tight list</span> +<span id="cb438-23"><a href="#cb438-23" aria-hidden="true"></a></span> +<span id="cb438-24"><a href="#cb438-24" aria-hidden="true"></a>1. item</span> +<span id="cb438-25"><a href="#cb438-25" aria-hidden="true"></a>2. item</span> +<span id="cb438-26"><a href="#cb438-26" aria-hidden="true"></a>3. item</span> +<span id="cb438-27"><a href="#cb438-27" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb438-28"><a href="#cb438-28" aria-hidden="true"></a></span> +<span id="cb438-29"><a href="#cb438-29" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb438-30"><a href="#cb438-30" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb438-31"><a href="#cb438-31" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb438-32"><a href="#cb438-32" aria-hidden="true"></a>}</span> +<span id="cb438-33"><a href="#cb438-33" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBegin</span>{}</span> +<span id="cb438-34"><a href="#cb438-34" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> +<span id="cb438-35"><a href="#cb438-35" aria-hidden="true"></a> #1.<span class="fu">\kern</span> 0.5em<span class="co">%</span></span> +<span id="cb438-36"><a href="#cb438-36" aria-hidden="true"></a> This is the</span> +<span id="cb438-37"><a href="#cb438-37" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb438-38"><a href="#cb438-38" aria-hidden="true"></a> first</span> +<span id="cb438-39"><a href="#cb438-39" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb438-40"><a href="#cb438-40" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb438-41"><a href="#cb438-41" aria-hidden="true"></a> second</span> +<span id="cb438-42"><a href="#cb438-42" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb438-43"><a href="#cb438-43" aria-hidden="true"></a> third</span> +<span id="cb438-44"><a href="#cb438-44" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb438-45"><a href="#cb438-45" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb438-46"><a href="#cb438-46" aria-hidden="true"></a>}</span> +<span id="cb438-47"><a href="#cb438-47" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span> +<span id="cb438-48"><a href="#cb438-48" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEnd</span>{}</span> +<span id="cb438-49"><a href="#cb438-49" aria-hidden="true"></a></span> +<span id="cb438-50"><a href="#cb438-50" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb438-51"><a href="#cb438-51" aria-hidden="true"></a>This is a loose list</span> +<span id="cb438-52"><a href="#cb438-52" aria-hidden="true"></a></span> +<span id="cb438-53"><a href="#cb438-53" aria-hidden="true"></a>1. item</span> +<span id="cb438-54"><a href="#cb438-54" aria-hidden="true"></a></span> +<span id="cb438-55"><a href="#cb438-55" aria-hidden="true"></a>2. item</span> +<span id="cb438-56"><a href="#cb438-56" aria-hidden="true"></a></span> +<span id="cb438-57"><a href="#cb438-57" aria-hidden="true"></a>3. item</span> +<span id="cb438-58"><a href="#cb438-58" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb438-59"><a href="#cb438-59" aria-hidden="true"></a></span> +<span id="cb438-60"><a href="#cb438-60" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb439"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb439-1"><a href="#cb439-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5425,73 +5468,73 @@ Thomas,Edison,1847</code></pre> <li><p>This is the third item.</p></li> </ol> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-53"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-54"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb437"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb437-1"><a href="#cb437-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb437-2"><a href="#cb437-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[tightLists, startNumber]{<span class="ex">markdown</span>}</span> -<span id="cb437-3"><a href="#cb437-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb437-4"><a href="#cb437-4" aria-hidden="true"></a></span> -<span id="cb437-5"><a href="#cb437-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb437-6"><a href="#cb437-6" aria-hidden="true"></a> renderers = {</span> -<span id="cb437-7"><a href="#cb437-7" aria-hidden="true"></a> interblockSeparator = {},</span> -<span id="cb437-8"><a href="#cb437-8" aria-hidden="true"></a> olBeginTight = { (},</span> -<span id="cb437-9"><a href="#cb437-9" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> -<span id="cb437-10"><a href="#cb437-10" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb437-11"><a href="#cb437-11" aria-hidden="true"></a> the first</span> -<span id="cb437-12"><a href="#cb437-12" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb437-13"><a href="#cb437-13" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb437-14"><a href="#cb437-14" aria-hidden="true"></a> , the second</span> -<span id="cb437-15"><a href="#cb437-15" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb437-16"><a href="#cb437-16" aria-hidden="true"></a> , and the third</span> -<span id="cb437-17"><a href="#cb437-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb437-18"><a href="#cb437-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb437-19"><a href="#cb437-19" aria-hidden="true"></a> },</span> -<span id="cb437-20"><a href="#cb437-20" aria-hidden="true"></a> olItemEnd = {},</span> -<span id="cb437-21"><a href="#cb437-21" aria-hidden="true"></a> olEndTight = {).},</span> -<span id="cb437-22"><a href="#cb437-22" aria-hidden="true"></a> },</span> -<span id="cb437-23"><a href="#cb437-23" aria-hidden="true"></a>}</span> -<span id="cb437-24"><a href="#cb437-24" aria-hidden="true"></a>This is a tight list</span> -<span id="cb437-25"><a href="#cb437-25" aria-hidden="true"></a></span> -<span id="cb437-26"><a href="#cb437-26" aria-hidden="true"></a>1. item</span> -<span id="cb437-27"><a href="#cb437-27" aria-hidden="true"></a>2. item</span> -<span id="cb437-28"><a href="#cb437-28" aria-hidden="true"></a>3. item</span> -<span id="cb437-29"><a href="#cb437-29" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb437-30"><a href="#cb437-30" aria-hidden="true"></a></span> -<span id="cb437-31"><a href="#cb437-31" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb437-32"><a href="#cb437-32" aria-hidden="true"></a> renderers = {</span> -<span id="cb437-33"><a href="#cb437-33" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> -<span id="cb437-34"><a href="#cb437-34" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb437-35"><a href="#cb437-35" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb437-36"><a href="#cb437-36" aria-hidden="true"></a> },</span> -<span id="cb437-37"><a href="#cb437-37" aria-hidden="true"></a> olBeginTight = {<span class="kw">\begin</span>{<span class="ex">enumerate</span>}},</span> -<span id="cb437-38"><a href="#cb437-38" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> -<span id="cb437-39"><a href="#cb437-39" aria-hidden="true"></a> <span class="fu">\item</span> This is the</span> -<span id="cb437-40"><a href="#cb437-40" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb437-41"><a href="#cb437-41" aria-hidden="true"></a> first</span> -<span id="cb437-42"><a href="#cb437-42" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb437-43"><a href="#cb437-43" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb437-44"><a href="#cb437-44" aria-hidden="true"></a> second</span> -<span id="cb437-45"><a href="#cb437-45" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb437-46"><a href="#cb437-46" aria-hidden="true"></a> third</span> -<span id="cb437-47"><a href="#cb437-47" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb437-48"><a href="#cb437-48" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb437-49"><a href="#cb437-49" aria-hidden="true"></a> },</span> -<span id="cb437-50"><a href="#cb437-50" aria-hidden="true"></a> olItemEnd = {.},</span> -<span id="cb437-51"><a href="#cb437-51" aria-hidden="true"></a> olEnd = {<span class="kw">\end</span>{<span class="ex">enumerate</span>}},</span> -<span id="cb437-52"><a href="#cb437-52" aria-hidden="true"></a> },</span> -<span id="cb437-53"><a href="#cb437-53" aria-hidden="true"></a>}</span> -<span id="cb437-54"><a href="#cb437-54" aria-hidden="true"></a>This is a loose list</span> -<span id="cb437-55"><a href="#cb437-55" aria-hidden="true"></a></span> -<span id="cb437-56"><a href="#cb437-56" aria-hidden="true"></a>1. item</span> -<span id="cb437-57"><a href="#cb437-57" aria-hidden="true"></a></span> -<span id="cb437-58"><a href="#cb437-58" aria-hidden="true"></a>2. item</span> -<span id="cb437-59"><a href="#cb437-59" aria-hidden="true"></a></span> -<span id="cb437-60"><a href="#cb437-60" aria-hidden="true"></a>3. item</span> -<span id="cb437-61"><a href="#cb437-61" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb437-62"><a href="#cb437-62" aria-hidden="true"></a></span> -<span id="cb437-63"><a href="#cb437-63" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb438"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb438-1"><a href="#cb438-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb440"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb440-1"><a href="#cb440-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb440-2"><a href="#cb440-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[tightLists, startNumber]{<span class="ex">markdown</span>}</span> +<span id="cb440-3"><a href="#cb440-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb440-4"><a href="#cb440-4" aria-hidden="true"></a></span> +<span id="cb440-5"><a href="#cb440-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb440-6"><a href="#cb440-6" aria-hidden="true"></a> renderers = {</span> +<span id="cb440-7"><a href="#cb440-7" aria-hidden="true"></a> interblockSeparator = {},</span> +<span id="cb440-8"><a href="#cb440-8" aria-hidden="true"></a> olBeginTight = { (},</span> +<span id="cb440-9"><a href="#cb440-9" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> +<span id="cb440-10"><a href="#cb440-10" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb440-11"><a href="#cb440-11" aria-hidden="true"></a> the first</span> +<span id="cb440-12"><a href="#cb440-12" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb440-13"><a href="#cb440-13" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb440-14"><a href="#cb440-14" aria-hidden="true"></a> , the second</span> +<span id="cb440-15"><a href="#cb440-15" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb440-16"><a href="#cb440-16" aria-hidden="true"></a> , and the third</span> +<span id="cb440-17"><a href="#cb440-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb440-18"><a href="#cb440-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb440-19"><a href="#cb440-19" aria-hidden="true"></a> },</span> +<span id="cb440-20"><a href="#cb440-20" aria-hidden="true"></a> olItemEnd = {},</span> +<span id="cb440-21"><a href="#cb440-21" aria-hidden="true"></a> olEndTight = {).},</span> +<span id="cb440-22"><a href="#cb440-22" aria-hidden="true"></a> },</span> +<span id="cb440-23"><a href="#cb440-23" aria-hidden="true"></a>}</span> +<span id="cb440-24"><a href="#cb440-24" aria-hidden="true"></a>This is a tight list</span> +<span id="cb440-25"><a href="#cb440-25" aria-hidden="true"></a></span> +<span id="cb440-26"><a href="#cb440-26" aria-hidden="true"></a>1. item</span> +<span id="cb440-27"><a href="#cb440-27" aria-hidden="true"></a>2. item</span> +<span id="cb440-28"><a href="#cb440-28" aria-hidden="true"></a>3. item</span> +<span id="cb440-29"><a href="#cb440-29" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb440-30"><a href="#cb440-30" aria-hidden="true"></a></span> +<span id="cb440-31"><a href="#cb440-31" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb440-32"><a href="#cb440-32" aria-hidden="true"></a> renderers = {</span> +<span id="cb440-33"><a href="#cb440-33" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> +<span id="cb440-34"><a href="#cb440-34" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb440-35"><a href="#cb440-35" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb440-36"><a href="#cb440-36" aria-hidden="true"></a> },</span> +<span id="cb440-37"><a href="#cb440-37" aria-hidden="true"></a> olBeginTight = {<span class="kw">\begin</span>{<span class="ex">enumerate</span>}},</span> +<span id="cb440-38"><a href="#cb440-38" aria-hidden="true"></a> olItemWithNumber = {<span class="co">%</span></span> +<span id="cb440-39"><a href="#cb440-39" aria-hidden="true"></a> <span class="fu">\item</span> This is the</span> +<span id="cb440-40"><a href="#cb440-40" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb440-41"><a href="#cb440-41" aria-hidden="true"></a> first</span> +<span id="cb440-42"><a href="#cb440-42" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb440-43"><a href="#cb440-43" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb440-44"><a href="#cb440-44" aria-hidden="true"></a> second</span> +<span id="cb440-45"><a href="#cb440-45" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb440-46"><a href="#cb440-46" aria-hidden="true"></a> third</span> +<span id="cb440-47"><a href="#cb440-47" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb440-48"><a href="#cb440-48" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb440-49"><a href="#cb440-49" aria-hidden="true"></a> },</span> +<span id="cb440-50"><a href="#cb440-50" aria-hidden="true"></a> olItemEnd = {.},</span> +<span id="cb440-51"><a href="#cb440-51" aria-hidden="true"></a> olEnd = {<span class="kw">\end</span>{<span class="ex">enumerate</span>}},</span> +<span id="cb440-52"><a href="#cb440-52" aria-hidden="true"></a> },</span> +<span id="cb440-53"><a href="#cb440-53" aria-hidden="true"></a>}</span> +<span id="cb440-54"><a href="#cb440-54" aria-hidden="true"></a>This is a loose list</span> +<span id="cb440-55"><a href="#cb440-55" aria-hidden="true"></a></span> +<span id="cb440-56"><a href="#cb440-56" aria-hidden="true"></a>1. item</span> +<span id="cb440-57"><a href="#cb440-57" aria-hidden="true"></a></span> +<span id="cb440-58"><a href="#cb440-58" aria-hidden="true"></a>2. item</span> +<span id="cb440-59"><a href="#cb440-59" aria-hidden="true"></a></span> +<span id="cb440-60"><a href="#cb440-60" aria-hidden="true"></a>3. item</span> +<span id="cb440-61"><a href="#cb440-61" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb440-62"><a href="#cb440-62" aria-hidden="true"></a></span> +<span id="cb440-63"><a href="#cb440-63" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb441"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb441-1"><a href="#cb441-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5504,72 +5547,72 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-41">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb439"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb439-1"><a href="#cb439-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb439-2"><a href="#cb439-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> -<span id="cb439-3"><a href="#cb439-3" aria-hidden="true"></a> [</span> -<span id="cb439-4"><a href="#cb439-4" aria-hidden="true"></a> tightLists = yes,</span> -<span id="cb439-5"><a href="#cb439-5" aria-hidden="true"></a> startNumber = yes,</span> -<span id="cb439-6"><a href="#cb439-6" aria-hidden="true"></a> ]</span> -<span id="cb439-7"><a href="#cb439-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb439-8"><a href="#cb439-8" aria-hidden="true"></a></span> -<span id="cb439-9"><a href="#cb439-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb439-10"><a href="#cb439-10" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span> -<span id="cb439-11"><a href="#cb439-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> -<span id="cb439-12"><a href="#cb439-12" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb439-13"><a href="#cb439-13" aria-hidden="true"></a> the first</span> -<span id="cb439-14"><a href="#cb439-14" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb439-15"><a href="#cb439-15" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb439-16"><a href="#cb439-16" aria-hidden="true"></a> , the second</span> -<span id="cb439-17"><a href="#cb439-17" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb439-18"><a href="#cb439-18" aria-hidden="true"></a> , and the third</span> -<span id="cb439-19"><a href="#cb439-19" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb439-20"><a href="#cb439-20" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb439-21"><a href="#cb439-21" aria-hidden="true"></a>}</span> -<span id="cb439-22"><a href="#cb439-22" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span> -<span id="cb439-23"><a href="#cb439-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span> -<span id="cb439-24"><a href="#cb439-24" aria-hidden="true"></a></span> -<span id="cb439-25"><a href="#cb439-25" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb439-26"><a href="#cb439-26" aria-hidden="true"></a>This is a tight list</span> -<span id="cb439-27"><a href="#cb439-27" aria-hidden="true"></a></span> -<span id="cb439-28"><a href="#cb439-28" aria-hidden="true"></a>1. item</span> -<span id="cb439-29"><a href="#cb439-29" aria-hidden="true"></a>2. item</span> -<span id="cb439-30"><a href="#cb439-30" aria-hidden="true"></a>3. item</span> -<span id="cb439-31"><a href="#cb439-31" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb439-32"><a href="#cb439-32" aria-hidden="true"></a></span> -<span id="cb439-33"><a href="#cb439-33" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb439-34"><a href="#cb439-34" aria-hidden="true"></a> :<span class="fu">\par</span></span> -<span id="cb439-35"><a href="#cb439-35" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb439-36"><a href="#cb439-36" aria-hidden="true"></a>}</span> -<span id="cb439-37"><a href="#cb439-37" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBegin</span>{<span class="fu">\startitemize</span>}</span> -<span id="cb439-38"><a href="#cb439-38" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> -<span id="cb439-39"><a href="#cb439-39" aria-hidden="true"></a> <span class="fu">\sym</span>{#1.}</span> -<span id="cb439-40"><a href="#cb439-40" aria-hidden="true"></a> This is the</span> -<span id="cb439-41"><a href="#cb439-41" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> -<span id="cb439-42"><a href="#cb439-42" aria-hidden="true"></a> first</span> -<span id="cb439-43"><a href="#cb439-43" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb439-44"><a href="#cb439-44" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> -<span id="cb439-45"><a href="#cb439-45" aria-hidden="true"></a> second</span> -<span id="cb439-46"><a href="#cb439-46" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb439-47"><a href="#cb439-47" aria-hidden="true"></a> third</span> -<span id="cb439-48"><a href="#cb439-48" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb439-49"><a href="#cb439-49" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb439-50"><a href="#cb439-50" aria-hidden="true"></a>}</span> -<span id="cb439-51"><a href="#cb439-51" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span> -<span id="cb439-52"><a href="#cb439-52" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEnd</span>{<span class="fu">\stopitemize</span>}</span> -<span id="cb439-53"><a href="#cb439-53" aria-hidden="true"></a></span> -<span id="cb439-54"><a href="#cb439-54" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb439-55"><a href="#cb439-55" aria-hidden="true"></a>This is a loose list</span> -<span id="cb439-56"><a href="#cb439-56" aria-hidden="true"></a></span> -<span id="cb439-57"><a href="#cb439-57" aria-hidden="true"></a>1. item</span> -<span id="cb439-58"><a href="#cb439-58" aria-hidden="true"></a></span> -<span id="cb439-59"><a href="#cb439-59" aria-hidden="true"></a>2. item</span> -<span id="cb439-60"><a href="#cb439-60" aria-hidden="true"></a></span> -<span id="cb439-61"><a href="#cb439-61" aria-hidden="true"></a>3. item</span> -<span id="cb439-62"><a href="#cb439-62" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb439-63"><a href="#cb439-63" aria-hidden="true"></a></span> -<span id="cb439-64"><a href="#cb439-64" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb440"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb440-1"><a href="#cb440-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb442"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb442-1"><a href="#cb442-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb442-2"><a href="#cb442-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> +<span id="cb442-3"><a href="#cb442-3" aria-hidden="true"></a> [</span> +<span id="cb442-4"><a href="#cb442-4" aria-hidden="true"></a> tightLists = yes,</span> +<span id="cb442-5"><a href="#cb442-5" aria-hidden="true"></a> startNumber = yes,</span> +<span id="cb442-6"><a href="#cb442-6" aria-hidden="true"></a> ]</span> +<span id="cb442-7"><a href="#cb442-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb442-8"><a href="#cb442-8" aria-hidden="true"></a></span> +<span id="cb442-9"><a href="#cb442-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb442-10"><a href="#cb442-10" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span> +<span id="cb442-11"><a href="#cb442-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> +<span id="cb442-12"><a href="#cb442-12" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb442-13"><a href="#cb442-13" aria-hidden="true"></a> the first</span> +<span id="cb442-14"><a href="#cb442-14" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb442-15"><a href="#cb442-15" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb442-16"><a href="#cb442-16" aria-hidden="true"></a> , the second</span> +<span id="cb442-17"><a href="#cb442-17" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb442-18"><a href="#cb442-18" aria-hidden="true"></a> , and the third</span> +<span id="cb442-19"><a href="#cb442-19" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb442-20"><a href="#cb442-20" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb442-21"><a href="#cb442-21" aria-hidden="true"></a>}</span> +<span id="cb442-22"><a href="#cb442-22" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span> +<span id="cb442-23"><a href="#cb442-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span> +<span id="cb442-24"><a href="#cb442-24" aria-hidden="true"></a></span> +<span id="cb442-25"><a href="#cb442-25" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb442-26"><a href="#cb442-26" aria-hidden="true"></a>This is a tight list</span> +<span id="cb442-27"><a href="#cb442-27" aria-hidden="true"></a></span> +<span id="cb442-28"><a href="#cb442-28" aria-hidden="true"></a>1. item</span> +<span id="cb442-29"><a href="#cb442-29" aria-hidden="true"></a>2. item</span> +<span id="cb442-30"><a href="#cb442-30" aria-hidden="true"></a>3. item</span> +<span id="cb442-31"><a href="#cb442-31" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb442-32"><a href="#cb442-32" aria-hidden="true"></a></span> +<span id="cb442-33"><a href="#cb442-33" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb442-34"><a href="#cb442-34" aria-hidden="true"></a> :<span class="fu">\par</span></span> +<span id="cb442-35"><a href="#cb442-35" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb442-36"><a href="#cb442-36" aria-hidden="true"></a>}</span> +<span id="cb442-37"><a href="#cb442-37" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlBegin</span>{<span class="fu">\startitemize</span>}</span> +<span id="cb442-38"><a href="#cb442-38" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span> +<span id="cb442-39"><a href="#cb442-39" aria-hidden="true"></a> <span class="fu">\sym</span>{#1.}</span> +<span id="cb442-40"><a href="#cb442-40" aria-hidden="true"></a> This is the</span> +<span id="cb442-41"><a href="#cb442-41" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span> +<span id="cb442-42"><a href="#cb442-42" aria-hidden="true"></a> first</span> +<span id="cb442-43"><a href="#cb442-43" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb442-44"><a href="#cb442-44" aria-hidden="true"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span> +<span id="cb442-45"><a href="#cb442-45" aria-hidden="true"></a> second</span> +<span id="cb442-46"><a href="#cb442-46" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb442-47"><a href="#cb442-47" aria-hidden="true"></a> third</span> +<span id="cb442-48"><a href="#cb442-48" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb442-49"><a href="#cb442-49" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb442-50"><a href="#cb442-50" aria-hidden="true"></a>}</span> +<span id="cb442-51"><a href="#cb442-51" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span> +<span id="cb442-52"><a href="#cb442-52" aria-hidden="true"></a><span class="fu">\def\markdownRendererOlEnd</span>{<span class="fu">\stopitemize</span>}</span> +<span id="cb442-53"><a href="#cb442-53" aria-hidden="true"></a></span> +<span id="cb442-54"><a href="#cb442-54" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb442-55"><a href="#cb442-55" aria-hidden="true"></a>This is a loose list</span> +<span id="cb442-56"><a href="#cb442-56" aria-hidden="true"></a></span> +<span id="cb442-57"><a href="#cb442-57" aria-hidden="true"></a>1. item</span> +<span id="cb442-58"><a href="#cb442-58" aria-hidden="true"></a></span> +<span id="cb442-59"><a href="#cb442-59" aria-hidden="true"></a>2. item</span> +<span id="cb442-60"><a href="#cb442-60" aria-hidden="true"></a></span> +<span id="cb442-61"><a href="#cb442-61" aria-hidden="true"></a>3. item</span> +<span id="cb442-62"><a href="#cb442-62" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb442-63"><a href="#cb442-63" aria-hidden="true"></a></span> +<span id="cb442-64"><a href="#cb442-64" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb443"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb443-1"><a href="#cb443-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight list (the first item, the second item, and the third item).</p> @@ -5592,86 +5635,86 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererDlEndTight</code> macro represents the end of a definition list that contains no item with several paragraphs of text (the list is tight). This macro will only be produced, when the <strong><code>tightLists</code></strong> option is disabled. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-27">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb441"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb441-1"><a href="#cb441-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb441-2"><a href="#cb441-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionDefinitionLists</span>{true}</span> -<span id="cb441-3"><a href="#cb441-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> -<span id="cb441-4"><a href="#cb441-4" aria-hidden="true"></a></span> -<span id="cb441-5"><a href="#cb441-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb441-6"><a href="#cb441-6" aria-hidden="true"></a> :<span class="co">%</span></span> -<span id="cb441-7"><a href="#cb441-7" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb441-8"><a href="#cb441-8" aria-hidden="true"></a>}</span> -<span id="cb441-9"><a href="#cb441-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{<span class="co">%</span></span> -<span id="cb441-10"><a href="#cb441-10" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> -<span id="cb441-11"><a href="#cb441-11" aria-hidden="true"></a> <span class="fu">\parindent</span>=0pt</span> -<span id="cb441-12"><a href="#cb441-12" aria-hidden="true"></a>}</span> -<span id="cb441-13"><a href="#cb441-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> -<span id="cb441-14"><a href="#cb441-14" aria-hidden="true"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span> -<span id="cb441-15"><a href="#cb441-15" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb441-16"><a href="#cb441-16" aria-hidden="true"></a> ,</span> -<span id="cb441-17"><a href="#cb441-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb441-18"><a href="#cb441-18" aria-hidden="true"></a> , and</span> -<span id="cb441-19"><a href="#cb441-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> -<span id="cb441-20"><a href="#cb441-20" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb441-21"><a href="#cb441-21" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb441-22"><a href="#cb441-22" aria-hidden="true"></a>}</span> -<span id="cb441-23"><a href="#cb441-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> -<span id="cb441-24"><a href="#cb441-24" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\par</span>--<span class="fu">\kern</span> 0.5em}</span> -<span id="cb441-25"><a href="#cb441-25" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEndTight</span>{<span class="fu">\endgroup</span>}</span> -<span id="cb441-26"><a href="#cb441-26" aria-hidden="true"></a></span> -<span id="cb441-27"><a href="#cb441-27" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb441-28"><a href="#cb441-28" aria-hidden="true"></a>This is a tight definition list</span> -<span id="cb441-29"><a href="#cb441-29" aria-hidden="true"></a></span> -<span id="cb441-30"><a href="#cb441-30" aria-hidden="true"></a>Coffee</span> -<span id="cb441-31"><a href="#cb441-31" aria-hidden="true"></a>: black hot drink</span> -<span id="cb441-32"><a href="#cb441-32" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb441-33"><a href="#cb441-33" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb441-34"><a href="#cb441-34" aria-hidden="true"></a></span> -<span id="cb441-35"><a href="#cb441-35" aria-hidden="true"></a>Milk</span> -<span id="cb441-36"><a href="#cb441-36" aria-hidden="true"></a>: white cold drink</span> -<span id="cb441-37"><a href="#cb441-37" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb441-38"><a href="#cb441-38" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb441-39"><a href="#cb441-39" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb441-40"><a href="#cb441-40" aria-hidden="true"></a></span> -<span id="cb441-41"><a href="#cb441-41" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb441-42"><a href="#cb441-42" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb441-43"><a href="#cb441-43" aria-hidden="true"></a>}</span> -<span id="cb441-44"><a href="#cb441-44" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span> -<span id="cb441-45"><a href="#cb441-45" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> -<span id="cb441-46"><a href="#cb441-46" aria-hidden="true"></a> . #1 is a</span> -<span id="cb441-47"><a href="#cb441-47" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb441-48"><a href="#cb441-48" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb441-49"><a href="#cb441-49" aria-hidden="true"></a> ,</span> -<span id="cb441-50"><a href="#cb441-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> -<span id="cb441-51"><a href="#cb441-51" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb441-52"><a href="#cb441-52" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb441-53"><a href="#cb441-53" aria-hidden="true"></a>}</span> -<span id="cb441-54"><a href="#cb441-54" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> -<span id="cb441-55"><a href="#cb441-55" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span> -<span id="cb441-56"><a href="#cb441-56" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span> -<span id="cb441-57"><a href="#cb441-57" aria-hidden="true"></a></span> -<span id="cb441-58"><a href="#cb441-58" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb441-59"><a href="#cb441-59" aria-hidden="true"></a>This is a loose definition list</span> -<span id="cb441-60"><a href="#cb441-60" aria-hidden="true"></a></span> -<span id="cb441-61"><a href="#cb441-61" aria-hidden="true"></a>Coffee</span> -<span id="cb441-62"><a href="#cb441-62" aria-hidden="true"></a></span> -<span id="cb441-63"><a href="#cb441-63" aria-hidden="true"></a>: black hot drink</span> -<span id="cb441-64"><a href="#cb441-64" aria-hidden="true"></a></span> -<span id="cb441-65"><a href="#cb441-65" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb441-66"><a href="#cb441-66" aria-hidden="true"></a></span> -<span id="cb441-67"><a href="#cb441-67" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb441-68"><a href="#cb441-68" aria-hidden="true"></a></span> -<span id="cb441-69"><a href="#cb441-69" aria-hidden="true"></a>Milk</span> -<span id="cb441-70"><a href="#cb441-70" aria-hidden="true"></a></span> -<span id="cb441-71"><a href="#cb441-71" aria-hidden="true"></a>: white cold drink</span> -<span id="cb441-72"><a href="#cb441-72" aria-hidden="true"></a></span> -<span id="cb441-73"><a href="#cb441-73" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb441-74"><a href="#cb441-74" aria-hidden="true"></a></span> -<span id="cb441-75"><a href="#cb441-75" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb441-76"><a href="#cb441-76" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb441-77"><a href="#cb441-77" aria-hidden="true"></a></span> -<span id="cb441-78"><a href="#cb441-78" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb442"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb442-1"><a href="#cb442-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb444"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb444-1"><a href="#cb444-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb444-2"><a href="#cb444-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionDefinitionLists</span>{true}</span> +<span id="cb444-3"><a href="#cb444-3" aria-hidden="true"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span> +<span id="cb444-4"><a href="#cb444-4" aria-hidden="true"></a></span> +<span id="cb444-5"><a href="#cb444-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb444-6"><a href="#cb444-6" aria-hidden="true"></a> :<span class="co">%</span></span> +<span id="cb444-7"><a href="#cb444-7" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb444-8"><a href="#cb444-8" aria-hidden="true"></a>}</span> +<span id="cb444-9"><a href="#cb444-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{<span class="co">%</span></span> +<span id="cb444-10"><a href="#cb444-10" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> +<span id="cb444-11"><a href="#cb444-11" aria-hidden="true"></a> <span class="fu">\parindent</span>=0pt</span> +<span id="cb444-12"><a href="#cb444-12" aria-hidden="true"></a>}</span> +<span id="cb444-13"><a href="#cb444-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> +<span id="cb444-14"><a href="#cb444-14" aria-hidden="true"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span> +<span id="cb444-15"><a href="#cb444-15" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb444-16"><a href="#cb444-16" aria-hidden="true"></a> ,</span> +<span id="cb444-17"><a href="#cb444-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb444-18"><a href="#cb444-18" aria-hidden="true"></a> , and</span> +<span id="cb444-19"><a href="#cb444-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> +<span id="cb444-20"><a href="#cb444-20" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb444-21"><a href="#cb444-21" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb444-22"><a href="#cb444-22" aria-hidden="true"></a>}</span> +<span id="cb444-23"><a href="#cb444-23" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> +<span id="cb444-24"><a href="#cb444-24" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\par</span>--<span class="fu">\kern</span> 0.5em}</span> +<span id="cb444-25"><a href="#cb444-25" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEndTight</span>{<span class="fu">\endgroup</span>}</span> +<span id="cb444-26"><a href="#cb444-26" aria-hidden="true"></a></span> +<span id="cb444-27"><a href="#cb444-27" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb444-28"><a href="#cb444-28" aria-hidden="true"></a>This is a tight definition list</span> +<span id="cb444-29"><a href="#cb444-29" aria-hidden="true"></a></span> +<span id="cb444-30"><a href="#cb444-30" aria-hidden="true"></a>Coffee</span> +<span id="cb444-31"><a href="#cb444-31" aria-hidden="true"></a>: black hot drink</span> +<span id="cb444-32"><a href="#cb444-32" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb444-33"><a href="#cb444-33" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb444-34"><a href="#cb444-34" aria-hidden="true"></a></span> +<span id="cb444-35"><a href="#cb444-35" aria-hidden="true"></a>Milk</span> +<span id="cb444-36"><a href="#cb444-36" aria-hidden="true"></a>: white cold drink</span> +<span id="cb444-37"><a href="#cb444-37" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb444-38"><a href="#cb444-38" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb444-39"><a href="#cb444-39" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb444-40"><a href="#cb444-40" aria-hidden="true"></a></span> +<span id="cb444-41"><a href="#cb444-41" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb444-42"><a href="#cb444-42" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb444-43"><a href="#cb444-43" aria-hidden="true"></a>}</span> +<span id="cb444-44"><a href="#cb444-44" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span> +<span id="cb444-45"><a href="#cb444-45" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> +<span id="cb444-46"><a href="#cb444-46" aria-hidden="true"></a> . #1 is a</span> +<span id="cb444-47"><a href="#cb444-47" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb444-48"><a href="#cb444-48" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb444-49"><a href="#cb444-49" aria-hidden="true"></a> ,</span> +<span id="cb444-50"><a href="#cb444-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> +<span id="cb444-51"><a href="#cb444-51" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb444-52"><a href="#cb444-52" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb444-53"><a href="#cb444-53" aria-hidden="true"></a>}</span> +<span id="cb444-54"><a href="#cb444-54" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> +<span id="cb444-55"><a href="#cb444-55" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span> +<span id="cb444-56"><a href="#cb444-56" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span> +<span id="cb444-57"><a href="#cb444-57" aria-hidden="true"></a></span> +<span id="cb444-58"><a href="#cb444-58" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb444-59"><a href="#cb444-59" aria-hidden="true"></a>This is a loose definition list</span> +<span id="cb444-60"><a href="#cb444-60" aria-hidden="true"></a></span> +<span id="cb444-61"><a href="#cb444-61" aria-hidden="true"></a>Coffee</span> +<span id="cb444-62"><a href="#cb444-62" aria-hidden="true"></a></span> +<span id="cb444-63"><a href="#cb444-63" aria-hidden="true"></a>: black hot drink</span> +<span id="cb444-64"><a href="#cb444-64" aria-hidden="true"></a></span> +<span id="cb444-65"><a href="#cb444-65" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb444-66"><a href="#cb444-66" aria-hidden="true"></a></span> +<span id="cb444-67"><a href="#cb444-67" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb444-68"><a href="#cb444-68" aria-hidden="true"></a></span> +<span id="cb444-69"><a href="#cb444-69" aria-hidden="true"></a>Milk</span> +<span id="cb444-70"><a href="#cb444-70" aria-hidden="true"></a></span> +<span id="cb444-71"><a href="#cb444-71" aria-hidden="true"></a>: white cold drink</span> +<span id="cb444-72"><a href="#cb444-72" aria-hidden="true"></a></span> +<span id="cb444-73"><a href="#cb444-73" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb444-74"><a href="#cb444-74" aria-hidden="true"></a></span> +<span id="cb444-75"><a href="#cb444-75" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb444-76"><a href="#cb444-76" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb444-77"><a href="#cb444-77" aria-hidden="true"></a></span> +<span id="cb444-78"><a href="#cb444-78" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb445"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb445-1"><a href="#cb445-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight definition list:</p> @@ -5689,90 +5732,90 @@ Thomas,Edison,1847</code></pre> </ul> <p>This is a loose definition list. Coffee is a black hot drink, prepared from roasted coffee beans, and one of the most traded agricultural commodities in the world. Milk is a white cold drink, nutrient-rich, and produced on an industrial scale.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-54"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-55"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb443"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb443-1"><a href="#cb443-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb443-2"><a href="#cb443-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[definitionLists, tightLists]{<span class="ex">markdown</span>}</span> -<span id="cb443-3"><a href="#cb443-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb443-4"><a href="#cb443-4" aria-hidden="true"></a></span> -<span id="cb443-5"><a href="#cb443-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb443-6"><a href="#cb443-6" aria-hidden="true"></a> renderers = {</span> -<span id="cb443-7"><a href="#cb443-7" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> -<span id="cb443-8"><a href="#cb443-8" aria-hidden="true"></a> :<span class="co">%</span></span> -<span id="cb443-9"><a href="#cb443-9" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb443-10"><a href="#cb443-10" aria-hidden="true"></a> },</span> -<span id="cb443-11"><a href="#cb443-11" aria-hidden="true"></a> dlBeginTight = {<span class="kw">\begin</span>{<span class="ex">description</span>}},</span> -<span id="cb443-12"><a href="#cb443-12" aria-hidden="true"></a> dlItem = {<span class="co">%</span></span> -<span id="cb443-13"><a href="#cb443-13" aria-hidden="true"></a> <span class="fu">\item</span>[#1]</span> -<span id="cb443-14"><a href="#cb443-14" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">itemize</span>}</span> -<span id="cb443-15"><a href="#cb443-15" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb443-16"><a href="#cb443-16" aria-hidden="true"></a> ,</span> -<span id="cb443-17"><a href="#cb443-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb443-18"><a href="#cb443-18" aria-hidden="true"></a> , and</span> -<span id="cb443-19"><a href="#cb443-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> -<span id="cb443-20"><a href="#cb443-20" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb443-21"><a href="#cb443-21" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb443-22"><a href="#cb443-22" aria-hidden="true"></a> },</span> -<span id="cb443-23"><a href="#cb443-23" aria-hidden="true"></a> dlItemEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span> -<span id="cb443-24"><a href="#cb443-24" aria-hidden="true"></a> dlDefinitionBegin = <span class="fu">\item</span>,</span> -<span id="cb443-25"><a href="#cb443-25" aria-hidden="true"></a> dlEndTight = {<span class="kw">\end</span>{<span class="ex">description</span>}},</span> -<span id="cb443-26"><a href="#cb443-26" aria-hidden="true"></a> },</span> -<span id="cb443-27"><a href="#cb443-27" aria-hidden="true"></a>}</span> -<span id="cb443-28"><a href="#cb443-28" aria-hidden="true"></a>This is a tight definition list</span> -<span id="cb443-29"><a href="#cb443-29" aria-hidden="true"></a></span> -<span id="cb443-30"><a href="#cb443-30" aria-hidden="true"></a>Coffee</span> -<span id="cb443-31"><a href="#cb443-31" aria-hidden="true"></a>: black hot drink</span> -<span id="cb443-32"><a href="#cb443-32" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb443-33"><a href="#cb443-33" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb443-34"><a href="#cb443-34" aria-hidden="true"></a></span> -<span id="cb443-35"><a href="#cb443-35" aria-hidden="true"></a>Milk</span> -<span id="cb443-36"><a href="#cb443-36" aria-hidden="true"></a>: white cold drink</span> -<span id="cb443-37"><a href="#cb443-37" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb443-38"><a href="#cb443-38" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb443-39"><a href="#cb443-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb443-40"><a href="#cb443-40" aria-hidden="true"></a></span> -<span id="cb443-41"><a href="#cb443-41" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb443-42"><a href="#cb443-42" aria-hidden="true"></a> renderers = {</span> -<span id="cb443-43"><a href="#cb443-43" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> -<span id="cb443-44"><a href="#cb443-44" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb443-45"><a href="#cb443-45" aria-hidden="true"></a> },</span> -<span id="cb443-46"><a href="#cb443-46" aria-hidden="true"></a> dlBegin = {},</span> -<span id="cb443-47"><a href="#cb443-47" aria-hidden="true"></a> dlItem = {<span class="co">%</span></span> -<span id="cb443-48"><a href="#cb443-48" aria-hidden="true"></a> . #1 is a</span> -<span id="cb443-49"><a href="#cb443-49" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb443-50"><a href="#cb443-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb443-51"><a href="#cb443-51" aria-hidden="true"></a> ,</span> -<span id="cb443-52"><a href="#cb443-52" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> -<span id="cb443-53"><a href="#cb443-53" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb443-54"><a href="#cb443-54" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb443-55"><a href="#cb443-55" aria-hidden="true"></a> },</span> -<span id="cb443-56"><a href="#cb443-56" aria-hidden="true"></a> dlItemEnd = {},</span> -<span id="cb443-57"><a href="#cb443-57" aria-hidden="true"></a> dlDefinitionEnd = {},</span> -<span id="cb443-58"><a href="#cb443-58" aria-hidden="true"></a> dlEnd = {.},</span> -<span id="cb443-59"><a href="#cb443-59" aria-hidden="true"></a> },</span> -<span id="cb443-60"><a href="#cb443-60" aria-hidden="true"></a>}</span> -<span id="cb443-61"><a href="#cb443-61" aria-hidden="true"></a>This is a loose definition list</span> -<span id="cb443-62"><a href="#cb443-62" aria-hidden="true"></a></span> -<span id="cb443-63"><a href="#cb443-63" aria-hidden="true"></a>Coffee</span> -<span id="cb443-64"><a href="#cb443-64" aria-hidden="true"></a></span> -<span id="cb443-65"><a href="#cb443-65" aria-hidden="true"></a>: black hot drink</span> -<span id="cb443-66"><a href="#cb443-66" aria-hidden="true"></a></span> -<span id="cb443-67"><a href="#cb443-67" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb443-68"><a href="#cb443-68" aria-hidden="true"></a></span> -<span id="cb443-69"><a href="#cb443-69" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb443-70"><a href="#cb443-70" aria-hidden="true"></a></span> -<span id="cb443-71"><a href="#cb443-71" aria-hidden="true"></a>Milk</span> -<span id="cb443-72"><a href="#cb443-72" aria-hidden="true"></a></span> -<span id="cb443-73"><a href="#cb443-73" aria-hidden="true"></a>: white cold drink</span> -<span id="cb443-74"><a href="#cb443-74" aria-hidden="true"></a></span> -<span id="cb443-75"><a href="#cb443-75" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb443-76"><a href="#cb443-76" aria-hidden="true"></a></span> -<span id="cb443-77"><a href="#cb443-77" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb443-78"><a href="#cb443-78" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb443-79"><a href="#cb443-79" aria-hidden="true"></a></span> -<span id="cb443-80"><a href="#cb443-80" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb444"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb444-1"><a href="#cb444-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb446"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb446-1"><a href="#cb446-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb446-2"><a href="#cb446-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[definitionLists, tightLists]{<span class="ex">markdown</span>}</span> +<span id="cb446-3"><a href="#cb446-3" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb446-4"><a href="#cb446-4" aria-hidden="true"></a></span> +<span id="cb446-5"><a href="#cb446-5" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb446-6"><a href="#cb446-6" aria-hidden="true"></a> renderers = {</span> +<span id="cb446-7"><a href="#cb446-7" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> +<span id="cb446-8"><a href="#cb446-8" aria-hidden="true"></a> :<span class="co">%</span></span> +<span id="cb446-9"><a href="#cb446-9" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb446-10"><a href="#cb446-10" aria-hidden="true"></a> },</span> +<span id="cb446-11"><a href="#cb446-11" aria-hidden="true"></a> dlBeginTight = {<span class="kw">\begin</span>{<span class="ex">description</span>}},</span> +<span id="cb446-12"><a href="#cb446-12" aria-hidden="true"></a> dlItem = {<span class="co">%</span></span> +<span id="cb446-13"><a href="#cb446-13" aria-hidden="true"></a> <span class="fu">\item</span>[#1]</span> +<span id="cb446-14"><a href="#cb446-14" aria-hidden="true"></a> <span class="kw">\begin</span>{<span class="ex">itemize</span>}</span> +<span id="cb446-15"><a href="#cb446-15" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb446-16"><a href="#cb446-16" aria-hidden="true"></a> ,</span> +<span id="cb446-17"><a href="#cb446-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb446-18"><a href="#cb446-18" aria-hidden="true"></a> , and</span> +<span id="cb446-19"><a href="#cb446-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> +<span id="cb446-20"><a href="#cb446-20" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb446-21"><a href="#cb446-21" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb446-22"><a href="#cb446-22" aria-hidden="true"></a> },</span> +<span id="cb446-23"><a href="#cb446-23" aria-hidden="true"></a> dlItemEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span> +<span id="cb446-24"><a href="#cb446-24" aria-hidden="true"></a> dlDefinitionBegin = <span class="fu">\item</span>,</span> +<span id="cb446-25"><a href="#cb446-25" aria-hidden="true"></a> dlEndTight = {<span class="kw">\end</span>{<span class="ex">description</span>}},</span> +<span id="cb446-26"><a href="#cb446-26" aria-hidden="true"></a> },</span> +<span id="cb446-27"><a href="#cb446-27" aria-hidden="true"></a>}</span> +<span id="cb446-28"><a href="#cb446-28" aria-hidden="true"></a>This is a tight definition list</span> +<span id="cb446-29"><a href="#cb446-29" aria-hidden="true"></a></span> +<span id="cb446-30"><a href="#cb446-30" aria-hidden="true"></a>Coffee</span> +<span id="cb446-31"><a href="#cb446-31" aria-hidden="true"></a>: black hot drink</span> +<span id="cb446-32"><a href="#cb446-32" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb446-33"><a href="#cb446-33" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb446-34"><a href="#cb446-34" aria-hidden="true"></a></span> +<span id="cb446-35"><a href="#cb446-35" aria-hidden="true"></a>Milk</span> +<span id="cb446-36"><a href="#cb446-36" aria-hidden="true"></a>: white cold drink</span> +<span id="cb446-37"><a href="#cb446-37" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb446-38"><a href="#cb446-38" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb446-39"><a href="#cb446-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb446-40"><a href="#cb446-40" aria-hidden="true"></a></span> +<span id="cb446-41"><a href="#cb446-41" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb446-42"><a href="#cb446-42" aria-hidden="true"></a> renderers = {</span> +<span id="cb446-43"><a href="#cb446-43" aria-hidden="true"></a> interblockSeparator = {<span class="co">%</span></span> +<span id="cb446-44"><a href="#cb446-44" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb446-45"><a href="#cb446-45" aria-hidden="true"></a> },</span> +<span id="cb446-46"><a href="#cb446-46" aria-hidden="true"></a> dlBegin = {},</span> +<span id="cb446-47"><a href="#cb446-47" aria-hidden="true"></a> dlItem = {<span class="co">%</span></span> +<span id="cb446-48"><a href="#cb446-48" aria-hidden="true"></a> . #1 is a</span> +<span id="cb446-49"><a href="#cb446-49" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb446-50"><a href="#cb446-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb446-51"><a href="#cb446-51" aria-hidden="true"></a> ,</span> +<span id="cb446-52"><a href="#cb446-52" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> +<span id="cb446-53"><a href="#cb446-53" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb446-54"><a href="#cb446-54" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb446-55"><a href="#cb446-55" aria-hidden="true"></a> },</span> +<span id="cb446-56"><a href="#cb446-56" aria-hidden="true"></a> dlItemEnd = {},</span> +<span id="cb446-57"><a href="#cb446-57" aria-hidden="true"></a> dlDefinitionEnd = {},</span> +<span id="cb446-58"><a href="#cb446-58" aria-hidden="true"></a> dlEnd = {.},</span> +<span id="cb446-59"><a href="#cb446-59" aria-hidden="true"></a> },</span> +<span id="cb446-60"><a href="#cb446-60" aria-hidden="true"></a>}</span> +<span id="cb446-61"><a href="#cb446-61" aria-hidden="true"></a>This is a loose definition list</span> +<span id="cb446-62"><a href="#cb446-62" aria-hidden="true"></a></span> +<span id="cb446-63"><a href="#cb446-63" aria-hidden="true"></a>Coffee</span> +<span id="cb446-64"><a href="#cb446-64" aria-hidden="true"></a></span> +<span id="cb446-65"><a href="#cb446-65" aria-hidden="true"></a>: black hot drink</span> +<span id="cb446-66"><a href="#cb446-66" aria-hidden="true"></a></span> +<span id="cb446-67"><a href="#cb446-67" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb446-68"><a href="#cb446-68" aria-hidden="true"></a></span> +<span id="cb446-69"><a href="#cb446-69" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb446-70"><a href="#cb446-70" aria-hidden="true"></a></span> +<span id="cb446-71"><a href="#cb446-71" aria-hidden="true"></a>Milk</span> +<span id="cb446-72"><a href="#cb446-72" aria-hidden="true"></a></span> +<span id="cb446-73"><a href="#cb446-73" aria-hidden="true"></a>: white cold drink</span> +<span id="cb446-74"><a href="#cb446-74" aria-hidden="true"></a></span> +<span id="cb446-75"><a href="#cb446-75" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb446-76"><a href="#cb446-76" aria-hidden="true"></a></span> +<span id="cb446-77"><a href="#cb446-77" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb446-78"><a href="#cb446-78" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb446-79"><a href="#cb446-79" aria-hidden="true"></a></span> +<span id="cb446-80"><a href="#cb446-80" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb447"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb447-1"><a href="#cb447-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight definition list:</p> @@ -5792,88 +5835,88 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-42">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb445"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb445-1"><a href="#cb445-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb445-2"><a href="#cb445-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> -<span id="cb445-3"><a href="#cb445-3" aria-hidden="true"></a> [</span> -<span id="cb445-4"><a href="#cb445-4" aria-hidden="true"></a> definitionLists = yes,</span> -<span id="cb445-5"><a href="#cb445-5" aria-hidden="true"></a> tightLists = yes,</span> -<span id="cb445-6"><a href="#cb445-6" aria-hidden="true"></a> ]</span> -<span id="cb445-7"><a href="#cb445-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb445-8"><a href="#cb445-8" aria-hidden="true"></a></span> -<span id="cb445-9"><a href="#cb445-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb445-10"><a href="#cb445-10" aria-hidden="true"></a> :<span class="co">%</span></span> -<span id="cb445-11"><a href="#cb445-11" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb445-12"><a href="#cb445-12" aria-hidden="true"></a>}</span> -<span id="cb445-13"><a href="#cb445-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{}</span> -<span id="cb445-14"><a href="#cb445-14" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> -<span id="cb445-15"><a href="#cb445-15" aria-hidden="true"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span> -<span id="cb445-16"><a href="#cb445-16" aria-hidden="true"></a> <span class="fu">\startitemize</span></span> -<span id="cb445-17"><a href="#cb445-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb445-18"><a href="#cb445-18" aria-hidden="true"></a> ,</span> -<span id="cb445-19"><a href="#cb445-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> -<span id="cb445-20"><a href="#cb445-20" aria-hidden="true"></a> , and</span> -<span id="cb445-21"><a href="#cb445-21" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> -<span id="cb445-22"><a href="#cb445-22" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb445-23"><a href="#cb445-23" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb445-24"><a href="#cb445-24" aria-hidden="true"></a>}</span> -<span id="cb445-25"><a href="#cb445-25" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{<span class="fu">\stopitemize</span>}</span> -<span id="cb445-26"><a href="#cb445-26" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\item</span>}</span> -<span id="cb445-27"><a href="#cb445-27" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEndTight</span>{}</span> -<span id="cb445-28"><a href="#cb445-28" aria-hidden="true"></a></span> -<span id="cb445-29"><a href="#cb445-29" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb445-30"><a href="#cb445-30" aria-hidden="true"></a>This is a tight definition list</span> -<span id="cb445-31"><a href="#cb445-31" aria-hidden="true"></a></span> -<span id="cb445-32"><a href="#cb445-32" aria-hidden="true"></a>Coffee</span> -<span id="cb445-33"><a href="#cb445-33" aria-hidden="true"></a>: black hot drink</span> -<span id="cb445-34"><a href="#cb445-34" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb445-35"><a href="#cb445-35" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb445-36"><a href="#cb445-36" aria-hidden="true"></a></span> -<span id="cb445-37"><a href="#cb445-37" aria-hidden="true"></a>Milk</span> -<span id="cb445-38"><a href="#cb445-38" aria-hidden="true"></a>: white cold drink</span> -<span id="cb445-39"><a href="#cb445-39" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb445-40"><a href="#cb445-40" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb445-41"><a href="#cb445-41" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb445-42"><a href="#cb445-42" aria-hidden="true"></a></span> -<span id="cb445-43"><a href="#cb445-43" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb445-44"><a href="#cb445-44" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> -<span id="cb445-45"><a href="#cb445-45" aria-hidden="true"></a>}</span> -<span id="cb445-46"><a href="#cb445-46" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span> -<span id="cb445-47"><a href="#cb445-47" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> -<span id="cb445-48"><a href="#cb445-48" aria-hidden="true"></a> . #1 is a</span> -<span id="cb445-49"><a href="#cb445-49" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb445-50"><a href="#cb445-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> -<span id="cb445-51"><a href="#cb445-51" aria-hidden="true"></a> ,</span> -<span id="cb445-52"><a href="#cb445-52" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> -<span id="cb445-53"><a href="#cb445-53" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb445-54"><a href="#cb445-54" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb445-55"><a href="#cb445-55" aria-hidden="true"></a>}</span> -<span id="cb445-56"><a href="#cb445-56" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> -<span id="cb445-57"><a href="#cb445-57" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span> -<span id="cb445-58"><a href="#cb445-58" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span> -<span id="cb445-59"><a href="#cb445-59" aria-hidden="true"></a></span> -<span id="cb445-60"><a href="#cb445-60" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb445-61"><a href="#cb445-61" aria-hidden="true"></a>This is a loose definition list</span> -<span id="cb445-62"><a href="#cb445-62" aria-hidden="true"></a></span> -<span id="cb445-63"><a href="#cb445-63" aria-hidden="true"></a>Coffee</span> -<span id="cb445-64"><a href="#cb445-64" aria-hidden="true"></a></span> -<span id="cb445-65"><a href="#cb445-65" aria-hidden="true"></a>: black hot drink</span> -<span id="cb445-66"><a href="#cb445-66" aria-hidden="true"></a></span> -<span id="cb445-67"><a href="#cb445-67" aria-hidden="true"></a>: prepared from roasted coffee beans</span> -<span id="cb445-68"><a href="#cb445-68" aria-hidden="true"></a></span> -<span id="cb445-69"><a href="#cb445-69" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> -<span id="cb445-70"><a href="#cb445-70" aria-hidden="true"></a></span> -<span id="cb445-71"><a href="#cb445-71" aria-hidden="true"></a>Milk</span> -<span id="cb445-72"><a href="#cb445-72" aria-hidden="true"></a></span> -<span id="cb445-73"><a href="#cb445-73" aria-hidden="true"></a>: white cold drink</span> -<span id="cb445-74"><a href="#cb445-74" aria-hidden="true"></a></span> -<span id="cb445-75"><a href="#cb445-75" aria-hidden="true"></a>: nutrient-rich</span> -<span id="cb445-76"><a href="#cb445-76" aria-hidden="true"></a></span> -<span id="cb445-77"><a href="#cb445-77" aria-hidden="true"></a>: produced on an industrial scale</span> -<span id="cb445-78"><a href="#cb445-78" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb445-79"><a href="#cb445-79" aria-hidden="true"></a></span> -<span id="cb445-80"><a href="#cb445-80" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb446"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb446-1"><a href="#cb446-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb448"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb448-1"><a href="#cb448-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb448-2"><a href="#cb448-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span></span> +<span id="cb448-3"><a href="#cb448-3" aria-hidden="true"></a> [</span> +<span id="cb448-4"><a href="#cb448-4" aria-hidden="true"></a> definitionLists = yes,</span> +<span id="cb448-5"><a href="#cb448-5" aria-hidden="true"></a> tightLists = yes,</span> +<span id="cb448-6"><a href="#cb448-6" aria-hidden="true"></a> ]</span> +<span id="cb448-7"><a href="#cb448-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb448-8"><a href="#cb448-8" aria-hidden="true"></a></span> +<span id="cb448-9"><a href="#cb448-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb448-10"><a href="#cb448-10" aria-hidden="true"></a> :<span class="co">%</span></span> +<span id="cb448-11"><a href="#cb448-11" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb448-12"><a href="#cb448-12" aria-hidden="true"></a>}</span> +<span id="cb448-13"><a href="#cb448-13" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{}</span> +<span id="cb448-14"><a href="#cb448-14" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> +<span id="cb448-15"><a href="#cb448-15" aria-hidden="true"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span> +<span id="cb448-16"><a href="#cb448-16" aria-hidden="true"></a> <span class="fu">\startitemize</span></span> +<span id="cb448-17"><a href="#cb448-17" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb448-18"><a href="#cb448-18" aria-hidden="true"></a> ,</span> +<span id="cb448-19"><a href="#cb448-19" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span> +<span id="cb448-20"><a href="#cb448-20" aria-hidden="true"></a> , and</span> +<span id="cb448-21"><a href="#cb448-21" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span> +<span id="cb448-22"><a href="#cb448-22" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb448-23"><a href="#cb448-23" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb448-24"><a href="#cb448-24" aria-hidden="true"></a>}</span> +<span id="cb448-25"><a href="#cb448-25" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{<span class="fu">\stopitemize</span>}</span> +<span id="cb448-26"><a href="#cb448-26" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\item</span>}</span> +<span id="cb448-27"><a href="#cb448-27" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEndTight</span>{}</span> +<span id="cb448-28"><a href="#cb448-28" aria-hidden="true"></a></span> +<span id="cb448-29"><a href="#cb448-29" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb448-30"><a href="#cb448-30" aria-hidden="true"></a>This is a tight definition list</span> +<span id="cb448-31"><a href="#cb448-31" aria-hidden="true"></a></span> +<span id="cb448-32"><a href="#cb448-32" aria-hidden="true"></a>Coffee</span> +<span id="cb448-33"><a href="#cb448-33" aria-hidden="true"></a>: black hot drink</span> +<span id="cb448-34"><a href="#cb448-34" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb448-35"><a href="#cb448-35" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb448-36"><a href="#cb448-36" aria-hidden="true"></a></span> +<span id="cb448-37"><a href="#cb448-37" aria-hidden="true"></a>Milk</span> +<span id="cb448-38"><a href="#cb448-38" aria-hidden="true"></a>: white cold drink</span> +<span id="cb448-39"><a href="#cb448-39" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb448-40"><a href="#cb448-40" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb448-41"><a href="#cb448-41" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb448-42"><a href="#cb448-42" aria-hidden="true"></a></span> +<span id="cb448-43"><a href="#cb448-43" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb448-44"><a href="#cb448-44" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span> +<span id="cb448-45"><a href="#cb448-45" aria-hidden="true"></a>}</span> +<span id="cb448-46"><a href="#cb448-46" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span> +<span id="cb448-47"><a href="#cb448-47" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span> +<span id="cb448-48"><a href="#cb448-48" aria-hidden="true"></a> . #1 is a</span> +<span id="cb448-49"><a href="#cb448-49" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb448-50"><a href="#cb448-50" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span> +<span id="cb448-51"><a href="#cb448-51" aria-hidden="true"></a> ,</span> +<span id="cb448-52"><a href="#cb448-52" aria-hidden="true"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span> +<span id="cb448-53"><a href="#cb448-53" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb448-54"><a href="#cb448-54" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb448-55"><a href="#cb448-55" aria-hidden="true"></a>}</span> +<span id="cb448-56"><a href="#cb448-56" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span> +<span id="cb448-57"><a href="#cb448-57" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span> +<span id="cb448-58"><a href="#cb448-58" aria-hidden="true"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span> +<span id="cb448-59"><a href="#cb448-59" aria-hidden="true"></a></span> +<span id="cb448-60"><a href="#cb448-60" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb448-61"><a href="#cb448-61" aria-hidden="true"></a>This is a loose definition list</span> +<span id="cb448-62"><a href="#cb448-62" aria-hidden="true"></a></span> +<span id="cb448-63"><a href="#cb448-63" aria-hidden="true"></a>Coffee</span> +<span id="cb448-64"><a href="#cb448-64" aria-hidden="true"></a></span> +<span id="cb448-65"><a href="#cb448-65" aria-hidden="true"></a>: black hot drink</span> +<span id="cb448-66"><a href="#cb448-66" aria-hidden="true"></a></span> +<span id="cb448-67"><a href="#cb448-67" aria-hidden="true"></a>: prepared from roasted coffee beans</span> +<span id="cb448-68"><a href="#cb448-68" aria-hidden="true"></a></span> +<span id="cb448-69"><a href="#cb448-69" aria-hidden="true"></a>: one of the most traded agricultural commodities in the world</span> +<span id="cb448-70"><a href="#cb448-70" aria-hidden="true"></a></span> +<span id="cb448-71"><a href="#cb448-71" aria-hidden="true"></a>Milk</span> +<span id="cb448-72"><a href="#cb448-72" aria-hidden="true"></a></span> +<span id="cb448-73"><a href="#cb448-73" aria-hidden="true"></a>: white cold drink</span> +<span id="cb448-74"><a href="#cb448-74" aria-hidden="true"></a></span> +<span id="cb448-75"><a href="#cb448-75" aria-hidden="true"></a>: nutrient-rich</span> +<span id="cb448-76"><a href="#cb448-76" aria-hidden="true"></a></span> +<span id="cb448-77"><a href="#cb448-77" aria-hidden="true"></a>: produced on an industrial scale</span> +<span id="cb448-78"><a href="#cb448-78" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb448-79"><a href="#cb448-79" aria-hidden="true"></a></span> +<span id="cb448-80"><a href="#cb448-80" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb449"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb449-1"><a href="#cb449-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a tight definition list:</p> @@ -5895,41 +5938,41 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererEmphasis</code> macro represents an emphasized span of text. The macro receives a single argument that corresponds to the emphasized span of text.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-28">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb447"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb447-1"><a href="#cb447-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb447-2"><a href="#cb447-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{{<span class="fu">\it</span>#1}}</span> -<span id="cb447-3"><a href="#cb447-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{{<span class="fu">\bf</span>#1}}</span> -<span id="cb447-4"><a href="#cb447-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb447-5"><a href="#cb447-5" aria-hidden="true"></a>This is *emphasis*.</span> -<span id="cb447-6"><a href="#cb447-6" aria-hidden="true"></a></span> -<span id="cb447-7"><a href="#cb447-7" aria-hidden="true"></a>This is **strong emphasis**.</span> -<span id="cb447-8"><a href="#cb447-8" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb447-9"><a href="#cb447-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb450"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb450-1"><a href="#cb450-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb450-2"><a href="#cb450-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{{<span class="fu">\it</span>#1}}</span> +<span id="cb450-3"><a href="#cb450-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{{<span class="fu">\bf</span>#1}}</span> +<span id="cb450-4"><a href="#cb450-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb450-5"><a href="#cb450-5" aria-hidden="true"></a>This is *emphasis*.</span> +<span id="cb450-6"><a href="#cb450-6" aria-hidden="true"></a></span> +<span id="cb450-7"><a href="#cb450-7" aria-hidden="true"></a>This is **strong emphasis**.</span> +<span id="cb450-8"><a href="#cb450-8" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb450-9"><a href="#cb450-9" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb448"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb448-1"><a href="#cb448-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb451"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb451-1"><a href="#cb451-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasis</em>.</p> <p>This is <strong>strong emphasis</strong>.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-55"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-56"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb449"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb449-1"><a href="#cb449-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb449-2"><a href="#cb449-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb449-3"><a href="#cb449-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb449-4"><a href="#cb449-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb449-5"><a href="#cb449-5" aria-hidden="true"></a> emphasis = {<span class="fu">\emph</span>{#1}},</span> -<span id="cb449-6"><a href="#cb449-6" aria-hidden="true"></a> strongEmphasis = {<span class="fu">\textbf</span>{#1}},</span> -<span id="cb449-7"><a href="#cb449-7" aria-hidden="true"></a> },</span> -<span id="cb449-8"><a href="#cb449-8" aria-hidden="true"></a>}</span> -<span id="cb449-9"><a href="#cb449-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb449-10"><a href="#cb449-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb449-11"><a href="#cb449-11" aria-hidden="true"></a>This is *emphasis*.</span> -<span id="cb449-12"><a href="#cb449-12" aria-hidden="true"></a></span> -<span id="cb449-13"><a href="#cb449-13" aria-hidden="true"></a>This is **strong emphasis**.</span> -<span id="cb449-14"><a href="#cb449-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb449-15"><a href="#cb449-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb450"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb450-1"><a href="#cb450-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb452"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb452-1"><a href="#cb452-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb452-2"><a href="#cb452-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb452-3"><a href="#cb452-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb452-4"><a href="#cb452-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb452-5"><a href="#cb452-5" aria-hidden="true"></a> emphasis = {<span class="fu">\emph</span>{#1}},</span> +<span id="cb452-6"><a href="#cb452-6" aria-hidden="true"></a> strongEmphasis = {<span class="fu">\textbf</span>{#1}},</span> +<span id="cb452-7"><a href="#cb452-7" aria-hidden="true"></a> },</span> +<span id="cb452-8"><a href="#cb452-8" aria-hidden="true"></a>}</span> +<span id="cb452-9"><a href="#cb452-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb452-10"><a href="#cb452-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb452-11"><a href="#cb452-11" aria-hidden="true"></a>This is *emphasis*.</span> +<span id="cb452-12"><a href="#cb452-12" aria-hidden="true"></a></span> +<span id="cb452-13"><a href="#cb452-13" aria-hidden="true"></a>This is **strong emphasis**.</span> +<span id="cb452-14"><a href="#cb452-14" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb452-15"><a href="#cb452-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb453"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb453-1"><a href="#cb453-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasis</em>.</p> @@ -5937,18 +5980,18 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-43">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb451"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb451-1"><a href="#cb451-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb451-2"><a href="#cb451-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{<span class="fu">\emph</span>{#1}}</span> -<span id="cb451-3"><a href="#cb451-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{<span class="fu">\bold</span>{#1}}</span> -<span id="cb451-4"><a href="#cb451-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb451-5"><a href="#cb451-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb451-6"><a href="#cb451-6" aria-hidden="true"></a>This is *emphasis*.</span> -<span id="cb451-7"><a href="#cb451-7" aria-hidden="true"></a></span> -<span id="cb451-8"><a href="#cb451-8" aria-hidden="true"></a>This is **strong emphasis**.</span> -<span id="cb451-9"><a href="#cb451-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb451-10"><a href="#cb451-10" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb454"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb454-1"><a href="#cb454-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb454-2"><a href="#cb454-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{<span class="fu">\emph</span>{#1}}</span> +<span id="cb454-3"><a href="#cb454-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{<span class="fu">\bold</span>{#1}}</span> +<span id="cb454-4"><a href="#cb454-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb454-5"><a href="#cb454-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb454-6"><a href="#cb454-6" aria-hidden="true"></a>This is *emphasis*.</span> +<span id="cb454-7"><a href="#cb454-7" aria-hidden="true"></a></span> +<span id="cb454-8"><a href="#cb454-8" aria-hidden="true"></a>This is **strong emphasis**.</span> +<span id="cb454-9"><a href="#cb454-9" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb454-10"><a href="#cb454-10" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb452"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb452-1"><a href="#cb452-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb455"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb455-1"><a href="#cb455-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <em>emphasis</em>.</p> @@ -5960,29 +6003,29 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererBlockQuoteEnd</code> macro represents the end of a block quote. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-29">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb453"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb453-1"><a href="#cb453-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb453-2"><a href="#cb453-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="co">%</span></span> -<span id="cb453-3"><a href="#cb453-3" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> -<span id="cb453-4"><a href="#cb453-4" aria-hidden="true"></a> <span class="fu">\vskip\parindent</span></span> -<span id="cb453-5"><a href="#cb453-5" aria-hidden="true"></a> <span class="fu">\leftskip</span>=2<span class="fu">\parindent</span></span> -<span id="cb453-6"><a href="#cb453-6" aria-hidden="true"></a> <span class="fu">\parindent</span>=0pt</span> -<span id="cb453-7"><a href="#cb453-7" aria-hidden="true"></a>}</span> -<span id="cb453-8"><a href="#cb453-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="co">%</span></span> -<span id="cb453-9"><a href="#cb453-9" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb453-10"><a href="#cb453-10" aria-hidden="true"></a> <span class="fu">\vskip\parindent</span></span> -<span id="cb453-11"><a href="#cb453-11" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> -<span id="cb453-12"><a href="#cb453-12" aria-hidden="true"></a>}</span> -<span id="cb453-13"><a href="#cb453-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb453-14"><a href="#cb453-14" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> -<span id="cb453-15"><a href="#cb453-15" aria-hidden="true"></a></span> -<span id="cb453-16"><a href="#cb453-16" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> -<span id="cb453-17"><a href="#cb453-17" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> -<span id="cb453-18"><a href="#cb453-18" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> -<span id="cb453-19"><a href="#cb453-19" aria-hidden="true"></a>> stars [...]</span> -<span id="cb453-20"><a href="#cb453-20" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb453-21"><a href="#cb453-21" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb454"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb454-1"><a href="#cb454-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb456"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb456-1"><a href="#cb456-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb456-2"><a href="#cb456-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="co">%</span></span> +<span id="cb456-3"><a href="#cb456-3" aria-hidden="true"></a> <span class="fu">\begingroup</span></span> +<span id="cb456-4"><a href="#cb456-4" aria-hidden="true"></a> <span class="fu">\vskip\parindent</span></span> +<span id="cb456-5"><a href="#cb456-5" aria-hidden="true"></a> <span class="fu">\leftskip</span>=2<span class="fu">\parindent</span></span> +<span id="cb456-6"><a href="#cb456-6" aria-hidden="true"></a> <span class="fu">\parindent</span>=0pt</span> +<span id="cb456-7"><a href="#cb456-7" aria-hidden="true"></a>}</span> +<span id="cb456-8"><a href="#cb456-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="co">%</span></span> +<span id="cb456-9"><a href="#cb456-9" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb456-10"><a href="#cb456-10" aria-hidden="true"></a> <span class="fu">\vskip\parindent</span></span> +<span id="cb456-11"><a href="#cb456-11" aria-hidden="true"></a> <span class="fu">\endgroup</span></span> +<span id="cb456-12"><a href="#cb456-12" aria-hidden="true"></a>}</span> +<span id="cb456-13"><a href="#cb456-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb456-14"><a href="#cb456-14" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> +<span id="cb456-15"><a href="#cb456-15" aria-hidden="true"></a></span> +<span id="cb456-16"><a href="#cb456-16" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> +<span id="cb456-17"><a href="#cb456-17" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> +<span id="cb456-18"><a href="#cb456-18" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> +<span id="cb456-19"><a href="#cb456-19" aria-hidden="true"></a>> stars [...]</span> +<span id="cb456-20"><a href="#cb456-20" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb456-21"><a href="#cb456-21" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb457"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb457-1"><a href="#cb457-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>A quote from William Shakespeare’s King Lear:</p> @@ -5990,28 +6033,28 @@ Thomas,Edison,1847</code></pre> <p>This is the excellent foppery of the world that when we are sick in fortune—often the surfeit of our own behavior—we make guilty of our disasters the sun, the moon, and the stars […]</p> </blockquote> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-56"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-57"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb455"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb455-1"><a href="#cb455-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb455-2"><a href="#cb455-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb455-3"><a href="#cb455-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb455-4"><a href="#cb455-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb455-5"><a href="#cb455-5" aria-hidden="true"></a> blockQuoteBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span> -<span id="cb455-6"><a href="#cb455-6" aria-hidden="true"></a> blockQuoteEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span> -<span id="cb455-7"><a href="#cb455-7" aria-hidden="true"></a> },</span> -<span id="cb455-8"><a href="#cb455-8" aria-hidden="true"></a>}</span> -<span id="cb455-9"><a href="#cb455-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb455-10"><a href="#cb455-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb455-11"><a href="#cb455-11" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> -<span id="cb455-12"><a href="#cb455-12" aria-hidden="true"></a></span> -<span id="cb455-13"><a href="#cb455-13" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> -<span id="cb455-14"><a href="#cb455-14" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> -<span id="cb455-15"><a href="#cb455-15" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> -<span id="cb455-16"><a href="#cb455-16" aria-hidden="true"></a>> stars [...]</span> -<span id="cb455-17"><a href="#cb455-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb455-18"><a href="#cb455-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb456"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb456-1"><a href="#cb456-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb458"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb458-1"><a href="#cb458-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb458-2"><a href="#cb458-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb458-3"><a href="#cb458-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb458-4"><a href="#cb458-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb458-5"><a href="#cb458-5" aria-hidden="true"></a> blockQuoteBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span> +<span id="cb458-6"><a href="#cb458-6" aria-hidden="true"></a> blockQuoteEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span> +<span id="cb458-7"><a href="#cb458-7" aria-hidden="true"></a> },</span> +<span id="cb458-8"><a href="#cb458-8" aria-hidden="true"></a>}</span> +<span id="cb458-9"><a href="#cb458-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb458-10"><a href="#cb458-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb458-11"><a href="#cb458-11" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> +<span id="cb458-12"><a href="#cb458-12" aria-hidden="true"></a></span> +<span id="cb458-13"><a href="#cb458-13" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> +<span id="cb458-14"><a href="#cb458-14" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> +<span id="cb458-15"><a href="#cb458-15" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> +<span id="cb458-16"><a href="#cb458-16" aria-hidden="true"></a>> stars [...]</span> +<span id="cb458-17"><a href="#cb458-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb458-18"><a href="#cb458-18" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb459"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb459-1"><a href="#cb459-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>A quote from William Shakespeare’s King Lear:</p> @@ -6021,21 +6064,21 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-44">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb457"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb457-1"><a href="#cb457-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb457-2"><a href="#cb457-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="fu">\startquotation</span>}</span> -<span id="cb457-3"><a href="#cb457-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="fu">\stopquotation</span>}</span> -<span id="cb457-4"><a href="#cb457-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb457-5"><a href="#cb457-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb457-6"><a href="#cb457-6" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> -<span id="cb457-7"><a href="#cb457-7" aria-hidden="true"></a></span> -<span id="cb457-8"><a href="#cb457-8" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> -<span id="cb457-9"><a href="#cb457-9" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> -<span id="cb457-10"><a href="#cb457-10" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> -<span id="cb457-11"><a href="#cb457-11" aria-hidden="true"></a>> stars [...]</span> -<span id="cb457-12"><a href="#cb457-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb457-13"><a href="#cb457-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb460"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb460-1"><a href="#cb460-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb460-2"><a href="#cb460-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="fu">\startquotation</span>}</span> +<span id="cb460-3"><a href="#cb460-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="fu">\stopquotation</span>}</span> +<span id="cb460-4"><a href="#cb460-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb460-5"><a href="#cb460-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb460-6"><a href="#cb460-6" aria-hidden="true"></a>A quote from William Shakespeare's King Lear:</span> +<span id="cb460-7"><a href="#cb460-7" aria-hidden="true"></a></span> +<span id="cb460-8"><a href="#cb460-8" aria-hidden="true"></a>> This is the excellent foppery of the world that when we are</span> +<span id="cb460-9"><a href="#cb460-9" aria-hidden="true"></a>> sick in fortune---often the surfeit of our own behavior---we</span> +<span id="cb460-10"><a href="#cb460-10" aria-hidden="true"></a>> make guilty of our disasters the sun, the moon, and the</span> +<span id="cb460-11"><a href="#cb460-11" aria-hidden="true"></a>> stars [...]</span> +<span id="cb460-12"><a href="#cb460-12" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb460-13"><a href="#cb460-13" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb458"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb458-1"><a href="#cb458-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb461"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb461-1"><a href="#cb461-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>A quote from William Shakespeare’s King Lear:</p> @@ -6046,73 +6089,73 @@ Thomas,Edison,1847</code></pre> <h4 data-number="2.3.1.17" id="code-block-renderers"><span class="header-section-number">2.3.1.17</span> Code Block Renderers</h4> <p>The <code>\markdownRendererInputVerbatim</code> macro represents a code block. The macro receives a single argument that corresponds to the filename of a file contaning the code block contents.</p> <p>The <code>\markdownRendererInputFencedCode</code> macro represents a fenced code block. This macro will only be produced, when the <strong><code>fencedCode</code></strong> option is enabled. The macro receives two arguments that correspond to the filename of a file contaning the code block contents and to the code fence infostring.</p> -<h5 class="unnumbered" data-number="" id="latex-example-57"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-58"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb459"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb459-1"><a href="#cb459-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb459-2"><a href="#cb459-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span> -<span id="cb459-3"><a href="#cb459-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[hyphens]{<span class="ex">url</span>}</span> -<span id="cb459-4"><a href="#cb459-4" aria-hidden="true"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span> -<span id="cb459-5"><a href="#cb459-5" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb459-6"><a href="#cb459-6" aria-hidden="true"></a> renderers = {</span> -<span id="cb459-7"><a href="#cb459-7" aria-hidden="true"></a> interblockSeparator = {</span> -<span id="cb459-8"><a href="#cb459-8" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb459-9"><a href="#cb459-9" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb459-10"><a href="#cb459-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb459-11"><a href="#cb459-11" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> -<span id="cb459-12"><a href="#cb459-12" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb459-13"><a href="#cb459-13" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb459-14"><a href="#cb459-14" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb459-15"><a href="#cb459-15" aria-hidden="true"></a> }<span class="co">%</span></span> -<span id="cb459-16"><a href="#cb459-16" aria-hidden="true"></a> },</span> -<span id="cb459-17"><a href="#cb459-17" aria-hidden="true"></a> inputVerbatim = {</span> -<span id="cb459-18"><a href="#cb459-18" aria-hidden="true"></a> is contained in file <span class="fu">\url</span>{#1}:<span class="co">%</span></span> -<span id="cb459-19"><a href="#cb459-19" aria-hidden="true"></a> <span class="fu">\verbatiminput</span>{#1}<span class="co">%</span></span> -<span id="cb459-20"><a href="#cb459-20" aria-hidden="true"></a> },</span> -<span id="cb459-21"><a href="#cb459-21" aria-hidden="true"></a> inputFencedCode = {</span> -<span id="cb459-22"><a href="#cb459-22" aria-hidden="true"></a> in #2 <span class="fu">\markdownRendererInputVerbatim</span>{#1}<span class="co">%</span></span> -<span id="cb459-23"><a href="#cb459-23" aria-hidden="true"></a> },</span> -<span id="cb459-24"><a href="#cb459-24" aria-hidden="true"></a> },</span> -<span id="cb459-25"><a href="#cb459-25" aria-hidden="true"></a>}</span> -<span id="cb459-26"><a href="#cb459-26" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb459-27"><a href="#cb459-27" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb459-28"><a href="#cb459-28" aria-hidden="true"></a>The following code</span> -<span id="cb459-29"><a href="#cb459-29" aria-hidden="true"></a></span> -<span id="cb459-30"><a href="#cb459-30" aria-hidden="true"></a> def foo(bar):</span> -<span id="cb459-31"><a href="#cb459-31" aria-hidden="true"></a> if len(bar) <= 1:</span> -<span id="cb459-32"><a href="#cb459-32" aria-hidden="true"></a> return bar[0]</span> -<span id="cb459-33"><a href="#cb459-33" aria-hidden="true"></a> elif len(bar) == 2:</span> -<span id="cb459-34"><a href="#cb459-34" aria-hidden="true"></a> return sorted(bar)</span> -<span id="cb459-35"><a href="#cb459-35" aria-hidden="true"></a> else:</span> -<span id="cb459-36"><a href="#cb459-36" aria-hidden="true"></a> baz = len(bar) // 2</span> -<span id="cb459-37"><a href="#cb459-37" aria-hidden="true"></a> return foo(bar[baz:], bar[:baz])</span> -<span id="cb459-38"><a href="#cb459-38" aria-hidden="true"></a></span> -<span id="cb459-39"><a href="#cb459-39" aria-hidden="true"></a>The following code</span> -<span id="cb459-40"><a href="#cb459-40" aria-hidden="true"></a></span> -<span id="cb459-41"><a href="#cb459-41" aria-hidden="true"></a>~~~ Python</span> -<span id="cb459-42"><a href="#cb459-42" aria-hidden="true"></a>>>> foo([4, 2, 1, 3])</span> -<span id="cb459-43"><a href="#cb459-43" aria-hidden="true"></a>[1, 2, 3, 4]</span> -<span id="cb459-44"><a href="#cb459-44" aria-hidden="true"></a>~~~~~~~~~~</span> -<span id="cb459-45"><a href="#cb459-45" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb459-46"><a href="#cb459-46" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb460"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb460-1"><a href="#cb460-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb462"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb462-1"><a href="#cb462-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb462-2"><a href="#cb462-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span> +<span id="cb462-3"><a href="#cb462-3" aria-hidden="true"></a><span class="bu">\usepackage</span>[hyphens]{<span class="ex">url</span>}</span> +<span id="cb462-4"><a href="#cb462-4" aria-hidden="true"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span> +<span id="cb462-5"><a href="#cb462-5" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb462-6"><a href="#cb462-6" aria-hidden="true"></a> renderers = {</span> +<span id="cb462-7"><a href="#cb462-7" aria-hidden="true"></a> interblockSeparator = {</span> +<span id="cb462-8"><a href="#cb462-8" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb462-9"><a href="#cb462-9" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb462-10"><a href="#cb462-10" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb462-11"><a href="#cb462-11" aria-hidden="true"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span> +<span id="cb462-12"><a href="#cb462-12" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb462-13"><a href="#cb462-13" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb462-14"><a href="#cb462-14" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb462-15"><a href="#cb462-15" aria-hidden="true"></a> }<span class="co">%</span></span> +<span id="cb462-16"><a href="#cb462-16" aria-hidden="true"></a> },</span> +<span id="cb462-17"><a href="#cb462-17" aria-hidden="true"></a> inputVerbatim = {</span> +<span id="cb462-18"><a href="#cb462-18" aria-hidden="true"></a> is contained in file <span class="fu">\url</span>{#1}:<span class="co">%</span></span> +<span id="cb462-19"><a href="#cb462-19" aria-hidden="true"></a> <span class="fu">\verbatiminput</span>{#1}<span class="co">%</span></span> +<span id="cb462-20"><a href="#cb462-20" aria-hidden="true"></a> },</span> +<span id="cb462-21"><a href="#cb462-21" aria-hidden="true"></a> inputFencedCode = {</span> +<span id="cb462-22"><a href="#cb462-22" aria-hidden="true"></a> in #2 <span class="fu">\markdownRendererInputVerbatim</span>{#1}<span class="co">%</span></span> +<span id="cb462-23"><a href="#cb462-23" aria-hidden="true"></a> },</span> +<span id="cb462-24"><a href="#cb462-24" aria-hidden="true"></a> },</span> +<span id="cb462-25"><a href="#cb462-25" aria-hidden="true"></a>}</span> +<span id="cb462-26"><a href="#cb462-26" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb462-27"><a href="#cb462-27" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb462-28"><a href="#cb462-28" aria-hidden="true"></a>The following code</span> +<span id="cb462-29"><a href="#cb462-29" aria-hidden="true"></a></span> +<span id="cb462-30"><a href="#cb462-30" aria-hidden="true"></a> def foo(bar):</span> +<span id="cb462-31"><a href="#cb462-31" aria-hidden="true"></a> if len(bar) <= 1:</span> +<span id="cb462-32"><a href="#cb462-32" aria-hidden="true"></a> return bar[0]</span> +<span id="cb462-33"><a href="#cb462-33" aria-hidden="true"></a> elif len(bar) == 2:</span> +<span id="cb462-34"><a href="#cb462-34" aria-hidden="true"></a> return sorted(bar)</span> +<span id="cb462-35"><a href="#cb462-35" aria-hidden="true"></a> else:</span> +<span id="cb462-36"><a href="#cb462-36" aria-hidden="true"></a> baz = len(bar) // 2</span> +<span id="cb462-37"><a href="#cb462-37" aria-hidden="true"></a> return foo(bar[baz:], bar[:baz])</span> +<span id="cb462-38"><a href="#cb462-38" aria-hidden="true"></a></span> +<span id="cb462-39"><a href="#cb462-39" aria-hidden="true"></a>The following code</span> +<span id="cb462-40"><a href="#cb462-40" aria-hidden="true"></a></span> +<span id="cb462-41"><a href="#cb462-41" aria-hidden="true"></a>~~~ Python</span> +<span id="cb462-42"><a href="#cb462-42" aria-hidden="true"></a>>>> foo([4, 2, 1, 3])</span> +<span id="cb462-43"><a href="#cb462-43" aria-hidden="true"></a>[1, 2, 3, 4]</span> +<span id="cb462-44"><a href="#cb462-44" aria-hidden="true"></a>~~~~~~~~~~</span> +<span id="cb462-45"><a href="#cb462-45" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb462-46"><a href="#cb462-46" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb463"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb463-1"><a href="#cb463-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text except for the filename, which may differ:</p> <blockquote> <p>The following code is contained in file <code>./_markdown_document/882453149edcf288976647f6fe147ada.verbatim</code>:</p> -<div class="sourceCode" id="cb461"><pre class="sourceCode py"><code class="sourceCode python"><span id="cb461-1"><a href="#cb461-1" aria-hidden="true"></a><span class="kw">def</span> foo(bar):</span> -<span id="cb461-2"><a href="#cb461-2" aria-hidden="true"></a> <span class="cf">if</span> <span class="bu">len</span>(bar) <span class="op"><=</span> <span class="dv">1</span>:</span> -<span id="cb461-3"><a href="#cb461-3" aria-hidden="true"></a> <span class="cf">return</span> bar[:<span class="dv">1</span>]</span> -<span id="cb461-4"><a href="#cb461-4" aria-hidden="true"></a> <span class="cf">elif</span> <span class="bu">len</span>(bar) <span class="op">==</span> <span class="dv">2</span>:</span> -<span id="cb461-5"><a href="#cb461-5" aria-hidden="true"></a> <span class="cf">return</span> <span class="bu">sorted</span>(bar)</span> -<span id="cb461-6"><a href="#cb461-6" aria-hidden="true"></a> <span class="cf">else</span>:</span> -<span id="cb461-7"><a href="#cb461-7" aria-hidden="true"></a> baz <span class="op">=</span> bar[<span class="bu">len</span>(bar) <span class="op">//</span> <span class="dv">2</span>]</span> -<span id="cb461-8"><a href="#cb461-8" aria-hidden="true"></a> <span class="cf">return</span> (</span> -<span id="cb461-9"><a href="#cb461-9" aria-hidden="true"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op"><</span> baz]) <span class="op">+</span> [baz] <span class="op">+</span></span> -<span id="cb461-10"><a href="#cb461-10" aria-hidden="true"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">></span> baz])</span> -<span id="cb461-11"><a href="#cb461-11" aria-hidden="true"></a> )</span></code></pre></div> +<div class="sourceCode" id="cb464"><pre class="sourceCode py"><code class="sourceCode python"><span id="cb464-1"><a href="#cb464-1" aria-hidden="true"></a><span class="kw">def</span> foo(bar):</span> +<span id="cb464-2"><a href="#cb464-2" aria-hidden="true"></a> <span class="cf">if</span> <span class="bu">len</span>(bar) <span class="op"><=</span> <span class="dv">1</span>:</span> +<span id="cb464-3"><a href="#cb464-3" aria-hidden="true"></a> <span class="cf">return</span> bar[:<span class="dv">1</span>]</span> +<span id="cb464-4"><a href="#cb464-4" aria-hidden="true"></a> <span class="cf">elif</span> <span class="bu">len</span>(bar) <span class="op">==</span> <span class="dv">2</span>:</span> +<span id="cb464-5"><a href="#cb464-5" aria-hidden="true"></a> <span class="cf">return</span> <span class="bu">sorted</span>(bar)</span> +<span id="cb464-6"><a href="#cb464-6" aria-hidden="true"></a> <span class="cf">else</span>:</span> +<span id="cb464-7"><a href="#cb464-7" aria-hidden="true"></a> baz <span class="op">=</span> bar[<span class="bu">len</span>(bar) <span class="op">//</span> <span class="dv">2</span>]</span> +<span id="cb464-8"><a href="#cb464-8" aria-hidden="true"></a> <span class="cf">return</span> (</span> +<span id="cb464-9"><a href="#cb464-9" aria-hidden="true"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op"><</span> baz]) <span class="op">+</span> [baz] <span class="op">+</span></span> +<span id="cb464-10"><a href="#cb464-10" aria-hidden="true"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">></span> baz])</span> +<span id="cb464-11"><a href="#cb464-11" aria-hidden="true"></a> )</span></code></pre></div> <p>The following code in Python contained in file <code>./_markdown_document/cf2a96e2120cef5b1fae5fea36fcc27b.verbatim</code>:</p> -<div class="sourceCode" id="cb462"><pre class="sourceCode py"><code class="sourceCode python"><span id="cb462-1"><a href="#cb462-1" aria-hidden="true"></a><span class="op">>>></span> foo([<span class="dv">4</span>, <span class="dv">2</span>, <span class="dv">1</span>, <span class="dv">3</span>])</span> -<span id="cb462-2"><a href="#cb462-2" aria-hidden="true"></a>[<span class="dv">1</span>, <span class="dv">2</span>, <span class="dv">3</span>, <span class="dv">4</span>]</span></code></pre></div> +<div class="sourceCode" id="cb465"><pre class="sourceCode py"><code class="sourceCode python"><span id="cb465-1"><a href="#cb465-1" aria-hidden="true"></a><span class="op">>>></span> foo([<span class="dv">4</span>, <span class="dv">2</span>, <span class="dv">1</span>, <span class="dv">3</span>])</span> +<span id="cb465-2"><a href="#cb465-2" aria-hidden="true"></a>[<span class="dv">1</span>, <span class="dv">2</span>, <span class="dv">3</span>, <span class="dv">4</span>]</span></code></pre></div> </blockquote> <h4 data-number="2.3.1.18" id="yamlmetadatarenderers"><span class="header-section-number">2.3.1.18</span> YAML Metadata Renderers</h4> <p>The <code>\markdownRendererJekyllDataBegin</code> macro represents the beginning of a <abbr>yaml</abbr> document. This macro will only be produced when the <strong><code>jekyllData</code></strong> option is enabled. The macro receives no arguments.</p> @@ -6127,72 +6170,72 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererJekyllDataEmpty</code> macro represents an empty scalar value in a <abbr>yaml</abbr> document. This macro will only be produced when the <strong><code>jekyllData</code></strong> option is enabled. The macro receives one argument: the scalar key in the parent structure, cast to a string following <abbr>yaml</abbr> serialization rules.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-30">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb463"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb463-1"><a href="#cb463-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb463-2"><a href="#cb463-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> -<span id="cb463-3"><a href="#cb463-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span> -<span id="cb463-4"><a href="#cb463-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span> -<span id="cb463-5"><a href="#cb463-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb463-6"><a href="#cb463-6" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb463-7"><a href="#cb463-7" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb463-8"><a href="#cb463-8" aria-hidden="true"></a>---</span> -<span id="cb463-9"><a href="#cb463-9" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb463-10"><a href="#cb463-10" aria-hidden="true"></a>age: 99</span> -<span id="cb463-11"><a href="#cb463-11" aria-hidden="true"></a>---</span> -<span id="cb463-12"><a href="#cb463-12" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb463-13"><a href="#cb463-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb466"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb466-1"><a href="#cb466-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb466-2"><a href="#cb466-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> +<span id="cb466-3"><a href="#cb466-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span> +<span id="cb466-4"><a href="#cb466-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span> +<span id="cb466-5"><a href="#cb466-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb466-6"><a href="#cb466-6" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb466-7"><a href="#cb466-7" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb466-8"><a href="#cb466-8" aria-hidden="true"></a>---</span> +<span id="cb466-9"><a href="#cb466-9" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb466-10"><a href="#cb466-10" aria-hidden="true"></a>age: 99</span> +<span id="cb466-11"><a href="#cb466-11" aria-hidden="true"></a>---</span> +<span id="cb466-12"><a href="#cb466-12" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb466-13"><a href="#cb466-13" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb464"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb464-1"><a href="#cb464-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb467"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb467-1"><a href="#cb467-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-58"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-59"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb465"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb465-1"><a href="#cb465-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb465-2"><a href="#cb465-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb465-3"><a href="#cb465-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb465-4"><a href="#cb465-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb465-5"><a href="#cb465-5" aria-hidden="true"></a> jekyllDataString = {<span class="fu">\gdef\name</span>{#2}},</span> -<span id="cb465-6"><a href="#cb465-6" aria-hidden="true"></a> jekyllDataNumber = {<span class="fu">\gdef\age</span>{#2}},</span> -<span id="cb465-7"><a href="#cb465-7" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> -<span id="cb465-8"><a href="#cb465-8" aria-hidden="true"></a> }</span> -<span id="cb465-9"><a href="#cb465-9" aria-hidden="true"></a>}</span> -<span id="cb465-10"><a href="#cb465-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb465-11"><a href="#cb465-11" aria-hidden="true"></a></span> -<span id="cb465-12"><a href="#cb465-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb465-13"><a href="#cb465-13" aria-hidden="true"></a>---</span> -<span id="cb465-14"><a href="#cb465-14" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb465-15"><a href="#cb465-15" aria-hidden="true"></a>age: 99</span> -<span id="cb465-16"><a href="#cb465-16" aria-hidden="true"></a>---</span> -<span id="cb465-17"><a href="#cb465-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb465-18"><a href="#cb465-18" aria-hidden="true"></a></span> -<span id="cb465-19"><a href="#cb465-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb466"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb466-1"><a href="#cb466-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb468"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb468-1"><a href="#cb468-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb468-2"><a href="#cb468-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb468-3"><a href="#cb468-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb468-4"><a href="#cb468-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb468-5"><a href="#cb468-5" aria-hidden="true"></a> jekyllDataString = {<span class="fu">\gdef\name</span>{#2}},</span> +<span id="cb468-6"><a href="#cb468-6" aria-hidden="true"></a> jekyllDataNumber = {<span class="fu">\gdef\age</span>{#2}},</span> +<span id="cb468-7"><a href="#cb468-7" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> +<span id="cb468-8"><a href="#cb468-8" aria-hidden="true"></a> }</span> +<span id="cb468-9"><a href="#cb468-9" aria-hidden="true"></a>}</span> +<span id="cb468-10"><a href="#cb468-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb468-11"><a href="#cb468-11" aria-hidden="true"></a></span> +<span id="cb468-12"><a href="#cb468-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb468-13"><a href="#cb468-13" aria-hidden="true"></a>---</span> +<span id="cb468-14"><a href="#cb468-14" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb468-15"><a href="#cb468-15" aria-hidden="true"></a>age: 99</span> +<span id="cb468-16"><a href="#cb468-16" aria-hidden="true"></a>---</span> +<span id="cb468-17"><a href="#cb468-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb468-18"><a href="#cb468-18" aria-hidden="true"></a></span> +<span id="cb468-19"><a href="#cb468-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb469"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb469-1"><a href="#cb469-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-45">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb467"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb467-1"><a href="#cb467-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb467-2"><a href="#cb467-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> -<span id="cb467-3"><a href="#cb467-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span> -<span id="cb467-4"><a href="#cb467-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span> -<span id="cb467-5"><a href="#cb467-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb467-6"><a href="#cb467-6" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb467-7"><a href="#cb467-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb467-8"><a href="#cb467-8" aria-hidden="true"></a></span> -<span id="cb467-9"><a href="#cb467-9" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb467-10"><a href="#cb467-10" aria-hidden="true"></a>---</span> -<span id="cb467-11"><a href="#cb467-11" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb467-12"><a href="#cb467-12" aria-hidden="true"></a>age: 99</span> -<span id="cb467-13"><a href="#cb467-13" aria-hidden="true"></a>---</span> -<span id="cb467-14"><a href="#cb467-14" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb467-15"><a href="#cb467-15" aria-hidden="true"></a></span> -<span id="cb467-16"><a href="#cb467-16" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb468"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb468-1"><a href="#cb468-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb470"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb470-1"><a href="#cb470-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb470-2"><a href="#cb470-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> +<span id="cb470-3"><a href="#cb470-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span> +<span id="cb470-4"><a href="#cb470-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span> +<span id="cb470-5"><a href="#cb470-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb470-6"><a href="#cb470-6" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb470-7"><a href="#cb470-7" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb470-8"><a href="#cb470-8" aria-hidden="true"></a></span> +<span id="cb470-9"><a href="#cb470-9" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb470-10"><a href="#cb470-10" aria-hidden="true"></a>---</span> +<span id="cb470-11"><a href="#cb470-11" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb470-12"><a href="#cb470-12" aria-hidden="true"></a>age: 99</span> +<span id="cb470-13"><a href="#cb470-13" aria-hidden="true"></a>---</span> +<span id="cb470-14"><a href="#cb470-14" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb470-15"><a href="#cb470-15" aria-hidden="true"></a></span> +<span id="cb470-16"><a href="#cb470-16" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb471"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb471-1"><a href="#cb471-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> @@ -6206,79 +6249,79 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererHeadingSix</code> macro represents a sixth level heading. The macro receives a single argument that corresponds to the heading text.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-31">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb469"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb469-1"><a href="#cb469-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb469-2"><a href="#cb469-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb469-3"><a href="#cb469-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span> -<span id="cb469-4"><a href="#cb469-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span> -<span id="cb469-5"><a href="#cb469-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span> -<span id="cb469-6"><a href="#cb469-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span> -<span id="cb469-7"><a href="#cb469-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span> -<span id="cb469-8"><a href="#cb469-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span> -<span id="cb469-9"><a href="#cb469-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb469-10"><a href="#cb469-10" aria-hidden="true"></a>######</span> -<span id="cb469-11"><a href="#cb469-11" aria-hidden="true"></a>#####</span> -<span id="cb469-12"><a href="#cb469-12" aria-hidden="true"></a>#####</span> -<span id="cb469-13"><a href="#cb469-13" aria-hidden="true"></a>###</span> -<span id="cb469-14"><a href="#cb469-14" aria-hidden="true"></a>######</span> -<span id="cb469-15"><a href="#cb469-15" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb469-16"><a href="#cb469-16" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb470"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb470-1"><a href="#cb470-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb472"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb472-1"><a href="#cb472-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb472-2"><a href="#cb472-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb472-3"><a href="#cb472-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span> +<span id="cb472-4"><a href="#cb472-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span> +<span id="cb472-5"><a href="#cb472-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span> +<span id="cb472-6"><a href="#cb472-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span> +<span id="cb472-7"><a href="#cb472-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span> +<span id="cb472-8"><a href="#cb472-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span> +<span id="cb472-9"><a href="#cb472-9" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb472-10"><a href="#cb472-10" aria-hidden="true"></a>######</span> +<span id="cb472-11"><a href="#cb472-11" aria-hidden="true"></a>#####</span> +<span id="cb472-12"><a href="#cb472-12" aria-hidden="true"></a>#####</span> +<span id="cb472-13"><a href="#cb472-13" aria-hidden="true"></a>###</span> +<span id="cb472-14"><a href="#cb472-14" aria-hidden="true"></a>######</span> +<span id="cb472-15"><a href="#cb472-15" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb472-16"><a href="#cb472-16" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb473"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb473-1"><a href="#cb473-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>65536</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-59"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-60"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb471"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb471-1"><a href="#cb471-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb471-2"><a href="#cb471-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb471-3"><a href="#cb471-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb471-4"><a href="#cb471-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb471-5"><a href="#cb471-5" aria-hidden="true"></a> interblockSeparator = {},</span> -<span id="cb471-6"><a href="#cb471-6" aria-hidden="true"></a> headingOne = 1,</span> -<span id="cb471-7"><a href="#cb471-7" aria-hidden="true"></a> headingTwo = 2,</span> -<span id="cb471-8"><a href="#cb471-8" aria-hidden="true"></a> headingThree = 3,</span> -<span id="cb471-9"><a href="#cb471-9" aria-hidden="true"></a> headingFour = 4,</span> -<span id="cb471-10"><a href="#cb471-10" aria-hidden="true"></a> headingFive = 5,</span> -<span id="cb471-11"><a href="#cb471-11" aria-hidden="true"></a> headingSix = 6,</span> -<span id="cb471-12"><a href="#cb471-12" aria-hidden="true"></a> },</span> -<span id="cb471-13"><a href="#cb471-13" aria-hidden="true"></a>}</span> -<span id="cb471-14"><a href="#cb471-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb471-15"><a href="#cb471-15" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb471-16"><a href="#cb471-16" aria-hidden="true"></a>######</span> -<span id="cb471-17"><a href="#cb471-17" aria-hidden="true"></a>#####</span> -<span id="cb471-18"><a href="#cb471-18" aria-hidden="true"></a>#####</span> -<span id="cb471-19"><a href="#cb471-19" aria-hidden="true"></a>###</span> -<span id="cb471-20"><a href="#cb471-20" aria-hidden="true"></a>######</span> -<span id="cb471-21"><a href="#cb471-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb471-22"><a href="#cb471-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb472"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb472-1"><a href="#cb472-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb474"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb474-1"><a href="#cb474-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb474-2"><a href="#cb474-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb474-3"><a href="#cb474-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb474-4"><a href="#cb474-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb474-5"><a href="#cb474-5" aria-hidden="true"></a> interblockSeparator = {},</span> +<span id="cb474-6"><a href="#cb474-6" aria-hidden="true"></a> headingOne = 1,</span> +<span id="cb474-7"><a href="#cb474-7" aria-hidden="true"></a> headingTwo = 2,</span> +<span id="cb474-8"><a href="#cb474-8" aria-hidden="true"></a> headingThree = 3,</span> +<span id="cb474-9"><a href="#cb474-9" aria-hidden="true"></a> headingFour = 4,</span> +<span id="cb474-10"><a href="#cb474-10" aria-hidden="true"></a> headingFive = 5,</span> +<span id="cb474-11"><a href="#cb474-11" aria-hidden="true"></a> headingSix = 6,</span> +<span id="cb474-12"><a href="#cb474-12" aria-hidden="true"></a> },</span> +<span id="cb474-13"><a href="#cb474-13" aria-hidden="true"></a>}</span> +<span id="cb474-14"><a href="#cb474-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb474-15"><a href="#cb474-15" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb474-16"><a href="#cb474-16" aria-hidden="true"></a>######</span> +<span id="cb474-17"><a href="#cb474-17" aria-hidden="true"></a>#####</span> +<span id="cb474-18"><a href="#cb474-18" aria-hidden="true"></a>#####</span> +<span id="cb474-19"><a href="#cb474-19" aria-hidden="true"></a>###</span> +<span id="cb474-20"><a href="#cb474-20" aria-hidden="true"></a>######</span> +<span id="cb474-21"><a href="#cb474-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb474-22"><a href="#cb474-22" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb475"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb475-1"><a href="#cb475-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>65536</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-46">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb473"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb473-1"><a href="#cb473-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb473-2"><a href="#cb473-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> -<span id="cb473-3"><a href="#cb473-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span> -<span id="cb473-4"><a href="#cb473-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span> -<span id="cb473-5"><a href="#cb473-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span> -<span id="cb473-6"><a href="#cb473-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span> -<span id="cb473-7"><a href="#cb473-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span> -<span id="cb473-8"><a href="#cb473-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span> -<span id="cb473-9"><a href="#cb473-9" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb473-10"><a href="#cb473-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb473-11"><a href="#cb473-11" aria-hidden="true"></a>######</span> -<span id="cb473-12"><a href="#cb473-12" aria-hidden="true"></a>#####</span> -<span id="cb473-13"><a href="#cb473-13" aria-hidden="true"></a>#####</span> -<span id="cb473-14"><a href="#cb473-14" aria-hidden="true"></a>###</span> -<span id="cb473-15"><a href="#cb473-15" aria-hidden="true"></a>######</span> -<span id="cb473-16"><a href="#cb473-16" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb473-17"><a href="#cb473-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb474"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb474-1"><a href="#cb474-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb476"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb476-1"><a href="#cb476-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb476-2"><a href="#cb476-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span> +<span id="cb476-3"><a href="#cb476-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span> +<span id="cb476-4"><a href="#cb476-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span> +<span id="cb476-5"><a href="#cb476-5" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span> +<span id="cb476-6"><a href="#cb476-6" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span> +<span id="cb476-7"><a href="#cb476-7" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span> +<span id="cb476-8"><a href="#cb476-8" aria-hidden="true"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span> +<span id="cb476-9"><a href="#cb476-9" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb476-10"><a href="#cb476-10" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb476-11"><a href="#cb476-11" aria-hidden="true"></a>######</span> +<span id="cb476-12"><a href="#cb476-12" aria-hidden="true"></a>#####</span> +<span id="cb476-13"><a href="#cb476-13" aria-hidden="true"></a>#####</span> +<span id="cb476-14"><a href="#cb476-14" aria-hidden="true"></a>###</span> +<span id="cb476-15"><a href="#cb476-15" aria-hidden="true"></a>######</span> +<span id="cb476-16"><a href="#cb476-16" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb476-17"><a href="#cb476-17" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb477"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb477-1"><a href="#cb477-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>65536</p> @@ -6287,44 +6330,44 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererHorizontalRule</code> macro represents a horizontal rule. The macro receives no arguments.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-32">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb475"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb475-1"><a href="#cb475-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb475-2"><a href="#cb475-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererHorizontalRule</span>{<span class="fu">\vfil\break</span>}</span> -<span id="cb475-3"><a href="#cb475-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb475-4"><a href="#cb475-4" aria-hidden="true"></a>This is the first page.</span> -<span id="cb475-5"><a href="#cb475-5" aria-hidden="true"></a></span> -<span id="cb475-6"><a href="#cb475-6" aria-hidden="true"></a>***</span> -<span id="cb475-7"><a href="#cb475-7" aria-hidden="true"></a></span> -<span id="cb475-8"><a href="#cb475-8" aria-hidden="true"></a>This is the second page.</span> -<span id="cb475-9"><a href="#cb475-9" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb475-10"><a href="#cb475-10" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb478"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb478-1"><a href="#cb478-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb478-2"><a href="#cb478-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererHorizontalRule</span>{<span class="fu">\vfil\break</span>}</span> +<span id="cb478-3"><a href="#cb478-3" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb478-4"><a href="#cb478-4" aria-hidden="true"></a>This is the first page.</span> +<span id="cb478-5"><a href="#cb478-5" aria-hidden="true"></a></span> +<span id="cb478-6"><a href="#cb478-6" aria-hidden="true"></a>***</span> +<span id="cb478-7"><a href="#cb478-7" aria-hidden="true"></a></span> +<span id="cb478-8"><a href="#cb478-8" aria-hidden="true"></a>This is the second page.</span> +<span id="cb478-9"><a href="#cb478-9" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb478-10"><a href="#cb478-10" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb476"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb476-1"><a href="#cb476-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb479"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb479-1"><a href="#cb479-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is the first page.</p> <hr /> <p>This is the second page.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-60"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-61"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb477"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb477-1"><a href="#cb477-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb477-2"><a href="#cb477-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb477-3"><a href="#cb477-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb477-4"><a href="#cb477-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb477-5"><a href="#cb477-5" aria-hidden="true"></a> horizontalRule = <span class="fu">\newpage</span>,</span> -<span id="cb477-6"><a href="#cb477-6" aria-hidden="true"></a> },</span> -<span id="cb477-7"><a href="#cb477-7" aria-hidden="true"></a>}</span> -<span id="cb477-8"><a href="#cb477-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb477-9"><a href="#cb477-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb477-10"><a href="#cb477-10" aria-hidden="true"></a>This is the first page.</span> -<span id="cb477-11"><a href="#cb477-11" aria-hidden="true"></a></span> -<span id="cb477-12"><a href="#cb477-12" aria-hidden="true"></a>***</span> -<span id="cb477-13"><a href="#cb477-13" aria-hidden="true"></a></span> -<span id="cb477-14"><a href="#cb477-14" aria-hidden="true"></a>This is the second page.</span> -<span id="cb477-15"><a href="#cb477-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb477-16"><a href="#cb477-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb478"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb478-1"><a href="#cb478-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb480"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb480-1"><a href="#cb480-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb480-2"><a href="#cb480-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb480-3"><a href="#cb480-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb480-4"><a href="#cb480-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb480-5"><a href="#cb480-5" aria-hidden="true"></a> horizontalRule = <span class="fu">\newpage</span>,</span> +<span id="cb480-6"><a href="#cb480-6" aria-hidden="true"></a> },</span> +<span id="cb480-7"><a href="#cb480-7" aria-hidden="true"></a>}</span> +<span id="cb480-8"><a href="#cb480-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb480-9"><a href="#cb480-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb480-10"><a href="#cb480-10" aria-hidden="true"></a>This is the first page.</span> +<span id="cb480-11"><a href="#cb480-11" aria-hidden="true"></a></span> +<span id="cb480-12"><a href="#cb480-12" aria-hidden="true"></a>***</span> +<span id="cb480-13"><a href="#cb480-13" aria-hidden="true"></a></span> +<span id="cb480-14"><a href="#cb480-14" aria-hidden="true"></a>This is the second page.</span> +<span id="cb480-15"><a href="#cb480-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb480-16"><a href="#cb480-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb481"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb481-1"><a href="#cb481-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is the first page.</p> @@ -6333,19 +6376,19 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-47">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb479"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb479-1"><a href="#cb479-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb479-2"><a href="#cb479-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererHorizontalRule</span>{<span class="fu">\page</span>[yes]}</span> -<span id="cb479-3"><a href="#cb479-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb479-4"><a href="#cb479-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb479-5"><a href="#cb479-5" aria-hidden="true"></a>This is the first page.</span> -<span id="cb479-6"><a href="#cb479-6" aria-hidden="true"></a></span> -<span id="cb479-7"><a href="#cb479-7" aria-hidden="true"></a>***</span> -<span id="cb479-8"><a href="#cb479-8" aria-hidden="true"></a></span> -<span id="cb479-9"><a href="#cb479-9" aria-hidden="true"></a>This is the second page.</span> -<span id="cb479-10"><a href="#cb479-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb479-11"><a href="#cb479-11" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb482"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb482-1"><a href="#cb482-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb482-2"><a href="#cb482-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererHorizontalRule</span>{<span class="fu">\page</span>[yes]}</span> +<span id="cb482-3"><a href="#cb482-3" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb482-4"><a href="#cb482-4" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb482-5"><a href="#cb482-5" aria-hidden="true"></a>This is the first page.</span> +<span id="cb482-6"><a href="#cb482-6" aria-hidden="true"></a></span> +<span id="cb482-7"><a href="#cb482-7" aria-hidden="true"></a>***</span> +<span id="cb482-8"><a href="#cb482-8" aria-hidden="true"></a></span> +<span id="cb482-9"><a href="#cb482-9" aria-hidden="true"></a>This is the second page.</span> +<span id="cb482-10"><a href="#cb482-10" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb482-11"><a href="#cb482-11" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb480"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb480-1"><a href="#cb480-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb483"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb483-1"><a href="#cb483-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is the first page.</p> @@ -6356,163 +6399,163 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererFootnote</code> macro represents a footnote. This macro will only be produced, when the <strong><code>footnotes</code></strong> option is enabled. The macro receives a single argument that corresponds to the footnote text.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-33">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb481"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb481-1"><a href="#cb481-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb481-2"><a href="#cb481-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFootnotes</span>{true}</span> -<span id="cb481-3"><a href="#cb481-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererFootnote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span> -<span id="cb481-4"><a href="#cb481-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb481-5"><a href="#cb481-5" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> -<span id="cb481-6"><a href="#cb481-6" aria-hidden="true"></a></span> -<span id="cb481-7"><a href="#cb481-7" aria-hidden="true"></a> [^1]: this is a footnote</span> -<span id="cb481-8"><a href="#cb481-8" aria-hidden="true"></a></span> -<span id="cb481-9"><a href="#cb481-9" aria-hidden="true"></a> [^2]: this is some other footnote</span> -<span id="cb481-10"><a href="#cb481-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb481-11"><a href="#cb481-11" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb484"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb484-1"><a href="#cb484-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb484-2"><a href="#cb484-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionFootnotes</span>{true}</span> +<span id="cb484-3"><a href="#cb484-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererFootnote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span> +<span id="cb484-4"><a href="#cb484-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb484-5"><a href="#cb484-5" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> +<span id="cb484-6"><a href="#cb484-6" aria-hidden="true"></a></span> +<span id="cb484-7"><a href="#cb484-7" aria-hidden="true"></a> [^1]: this is a footnote</span> +<span id="cb484-8"><a href="#cb484-8" aria-hidden="true"></a></span> +<span id="cb484-9"><a href="#cb484-9" aria-hidden="true"></a> [^2]: this is some other footnote</span> +<span id="cb484-10"><a href="#cb484-10" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb484-11"><a href="#cb484-11" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb482"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb482-1"><a href="#cb482-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb485"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb485-1"><a href="#cb485-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is some text (and this is a footnote) and this is some other text (and this is some other footnote).</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-61"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-62"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb483"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb483-1"><a href="#cb483-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb483-2"><a href="#cb483-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[footnotes]{<span class="ex">markdown</span>}</span> -<span id="cb483-3"><a href="#cb483-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb483-4"><a href="#cb483-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb483-5"><a href="#cb483-5" aria-hidden="true"></a> footnote = { (and <span class="fu">\MakeLowercase</span>{#1})},</span> -<span id="cb483-6"><a href="#cb483-6" aria-hidden="true"></a> },</span> -<span id="cb483-7"><a href="#cb483-7" aria-hidden="true"></a>}</span> -<span id="cb483-8"><a href="#cb483-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb483-9"><a href="#cb483-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb483-10"><a href="#cb483-10" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> -<span id="cb483-11"><a href="#cb483-11" aria-hidden="true"></a></span> -<span id="cb483-12"><a href="#cb483-12" aria-hidden="true"></a> [^1]: this is a footnote</span> -<span id="cb483-13"><a href="#cb483-13" aria-hidden="true"></a></span> -<span id="cb483-14"><a href="#cb483-14" aria-hidden="true"></a> [^2]: this is some other footnote</span> -<span id="cb483-15"><a href="#cb483-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb483-16"><a href="#cb483-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb484"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb484-1"><a href="#cb484-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb486"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb486-1"><a href="#cb486-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb486-2"><a href="#cb486-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[footnotes]{<span class="ex">markdown</span>}</span> +<span id="cb486-3"><a href="#cb486-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb486-4"><a href="#cb486-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb486-5"><a href="#cb486-5" aria-hidden="true"></a> footnote = { (and <span class="fu">\MakeLowercase</span>{#1})},</span> +<span id="cb486-6"><a href="#cb486-6" aria-hidden="true"></a> },</span> +<span id="cb486-7"><a href="#cb486-7" aria-hidden="true"></a>}</span> +<span id="cb486-8"><a href="#cb486-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb486-9"><a href="#cb486-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb486-10"><a href="#cb486-10" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> +<span id="cb486-11"><a href="#cb486-11" aria-hidden="true"></a></span> +<span id="cb486-12"><a href="#cb486-12" aria-hidden="true"></a> [^1]: this is a footnote</span> +<span id="cb486-13"><a href="#cb486-13" aria-hidden="true"></a></span> +<span id="cb486-14"><a href="#cb486-14" aria-hidden="true"></a> [^2]: this is some other footnote</span> +<span id="cb486-15"><a href="#cb486-15" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb486-16"><a href="#cb486-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb487"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb487-1"><a href="#cb487-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is some text (and this is a footnote) and this is some other text (and this is some other footnote).</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-48">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb485"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb485-1"><a href="#cb485-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb485-2"><a href="#cb485-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[footnotes = yes]</span> -<span id="cb485-3"><a href="#cb485-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererFootnote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span> -<span id="cb485-4"><a href="#cb485-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb485-5"><a href="#cb485-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb485-6"><a href="#cb485-6" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> -<span id="cb485-7"><a href="#cb485-7" aria-hidden="true"></a></span> -<span id="cb485-8"><a href="#cb485-8" aria-hidden="true"></a> [^1]: this is a footnote</span> -<span id="cb485-9"><a href="#cb485-9" aria-hidden="true"></a></span> -<span id="cb485-10"><a href="#cb485-10" aria-hidden="true"></a> [^2]: this is some other footnote</span> -<span id="cb485-11"><a href="#cb485-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb485-12"><a href="#cb485-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb488"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb488-1"><a href="#cb488-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb488-2"><a href="#cb488-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[footnotes = yes]</span> +<span id="cb488-3"><a href="#cb488-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererFootnote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span> +<span id="cb488-4"><a href="#cb488-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb488-5"><a href="#cb488-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb488-6"><a href="#cb488-6" aria-hidden="true"></a>This is some text[^1] and this is some other text[^2].</span> +<span id="cb488-7"><a href="#cb488-7" aria-hidden="true"></a></span> +<span id="cb488-8"><a href="#cb488-8" aria-hidden="true"></a> [^1]: this is a footnote</span> +<span id="cb488-9"><a href="#cb488-9" aria-hidden="true"></a></span> +<span id="cb488-10"><a href="#cb488-10" aria-hidden="true"></a> [^2]: this is some other footnote</span> +<span id="cb488-11"><a href="#cb488-11" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb488-12"><a href="#cb488-12" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb486"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb486-1"><a href="#cb486-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb489"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb489-1"><a href="#cb489-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is some text (and this is a footnote) and this is some other text (and this is some other footnote).</p> </blockquote> <h4 data-number="2.3.1.22" id="parenthesized-citations-renderer"><span class="header-section-number">2.3.1.22</span> Parenthesized Citations Renderer</h4> <p>The <code>\markdownRendererCite</code> macro represents a string of one or more parenthetical citations. This macro will only be produced, when the <strong><code>citations</code></strong> option is enabled. The macro receives the parameter <code>{</code>⟨<em>number of citations</em>⟩<code>}</code> followed by ⟨<em>suppress author</em>⟩ <code>{</code>⟨<em>prenote</em>⟩<code>}{</code>⟨<em>postnote</em>⟩<code>}{</code>⟨<em>name</em>⟩<code>}</code> repeated ⟨<em>number of citations</em>⟩ times. The ⟨<em>suppress author</em>⟩ parameter is either the token <code>-</code>, when the author’s name is to be suppressed, or <code>+</code> otherwise.</p> -<h5 class="unnumbered" data-number="" id="latex-example-62"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-63"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb487"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb487-1"><a href="#cb487-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb487-2"><a href="#cb487-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span> -<span id="cb487-3"><a href="#cb487-3" aria-hidden="true"></a><span class="fu">\newcount\citationsCounter</span></span> -<span id="cb487-4"><a href="#cb487-4" aria-hidden="true"></a><span class="fu">\newcount\citationsTotal</span></span> -<span id="cb487-5"><a href="#cb487-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> -<span id="cb487-6"><a href="#cb487-6" aria-hidden="true"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb487-7"><a href="#cb487-7" aria-hidden="true"></a> a parenthesized citation <span class="fu">\emph</span>{#4}</span> -<span id="cb487-8"><a href="#cb487-8" aria-hidden="true"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span> -<span id="cb487-9"><a href="#cb487-9" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span> -<span id="cb487-10"><a href="#cb487-10" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> -<span id="cb487-11"><a href="#cb487-11" aria-hidden="true"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> -<span id="cb487-12"><a href="#cb487-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb487-13"><a href="#cb487-13" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb487-14"><a href="#cb487-14" aria-hidden="true"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span> -<span id="cb487-15"><a href="#cb487-15" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> -<span id="cb487-16"><a href="#cb487-16" aria-hidden="true"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> -<span id="cb487-17"><a href="#cb487-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb487-18"><a href="#cb487-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb487-19"><a href="#cb487-19" aria-hidden="true"></a> <span class="fu">\ifnum\citationsCounter</span>><span class="fu">\citationsTotal\relax</span></span> -<span id="cb487-20"><a href="#cb487-20" aria-hidden="true"></a> .<span class="co">%</span></span> -<span id="cb487-21"><a href="#cb487-21" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> -<span id="cb487-22"><a href="#cb487-22" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb487-23"><a href="#cb487-23" aria-hidden="true"></a> , and</span> -<span id="cb487-24"><a href="#cb487-24" aria-hidden="true"></a> <span class="fu">\fi\citations</span>}</span> -<span id="cb487-25"><a href="#cb487-25" aria-hidden="true"></a><span class="fu">\makeatother</span></span> -<span id="cb487-26"><a href="#cb487-26" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb487-27"><a href="#cb487-27" aria-hidden="true"></a> renderers = {</span> -<span id="cb487-28"><a href="#cb487-28" aria-hidden="true"></a> cite = {<span class="co">%</span></span> -<span id="cb487-29"><a href="#cb487-29" aria-hidden="true"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span> -<span id="cb487-30"><a href="#cb487-30" aria-hidden="true"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span> -<span id="cb487-31"><a href="#cb487-31" aria-hidden="true"></a> This is</span> -<span id="cb487-32"><a href="#cb487-32" aria-hidden="true"></a> <span class="fu">\expandafter\citations</span></span> -<span id="cb487-33"><a href="#cb487-33" aria-hidden="true"></a> },</span> -<span id="cb487-34"><a href="#cb487-34" aria-hidden="true"></a> },</span> -<span id="cb487-35"><a href="#cb487-35" aria-hidden="true"></a>}</span> -<span id="cb487-36"><a href="#cb487-36" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb487-37"><a href="#cb487-37" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb487-38"><a href="#cb487-38" aria-hidden="true"></a>[see @abrahams90, pp. 12; @eijkhout91, pp. 34]</span> -<span id="cb487-39"><a href="#cb487-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb487-40"><a href="#cb487-40" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb488"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb488-1"><a href="#cb488-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb490"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb490-1"><a href="#cb490-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb490-2"><a href="#cb490-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span> +<span id="cb490-3"><a href="#cb490-3" aria-hidden="true"></a><span class="fu">\newcount\citationsCounter</span></span> +<span id="cb490-4"><a href="#cb490-4" aria-hidden="true"></a><span class="fu">\newcount\citationsTotal</span></span> +<span id="cb490-5"><a href="#cb490-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> +<span id="cb490-6"><a href="#cb490-6" aria-hidden="true"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb490-7"><a href="#cb490-7" aria-hidden="true"></a> a parenthesized citation <span class="fu">\emph</span>{#4}</span> +<span id="cb490-8"><a href="#cb490-8" aria-hidden="true"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span> +<span id="cb490-9"><a href="#cb490-9" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span> +<span id="cb490-10"><a href="#cb490-10" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> +<span id="cb490-11"><a href="#cb490-11" aria-hidden="true"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> +<span id="cb490-12"><a href="#cb490-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb490-13"><a href="#cb490-13" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb490-14"><a href="#cb490-14" aria-hidden="true"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span> +<span id="cb490-15"><a href="#cb490-15" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> +<span id="cb490-16"><a href="#cb490-16" aria-hidden="true"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> +<span id="cb490-17"><a href="#cb490-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb490-18"><a href="#cb490-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb490-19"><a href="#cb490-19" aria-hidden="true"></a> <span class="fu">\ifnum\citationsCounter</span>><span class="fu">\citationsTotal\relax</span></span> +<span id="cb490-20"><a href="#cb490-20" aria-hidden="true"></a> .<span class="co">%</span></span> +<span id="cb490-21"><a href="#cb490-21" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> +<span id="cb490-22"><a href="#cb490-22" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb490-23"><a href="#cb490-23" aria-hidden="true"></a> , and</span> +<span id="cb490-24"><a href="#cb490-24" aria-hidden="true"></a> <span class="fu">\fi\citations</span>}</span> +<span id="cb490-25"><a href="#cb490-25" aria-hidden="true"></a><span class="fu">\makeatother</span></span> +<span id="cb490-26"><a href="#cb490-26" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb490-27"><a href="#cb490-27" aria-hidden="true"></a> renderers = {</span> +<span id="cb490-28"><a href="#cb490-28" aria-hidden="true"></a> cite = {<span class="co">%</span></span> +<span id="cb490-29"><a href="#cb490-29" aria-hidden="true"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span> +<span id="cb490-30"><a href="#cb490-30" aria-hidden="true"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span> +<span id="cb490-31"><a href="#cb490-31" aria-hidden="true"></a> This is</span> +<span id="cb490-32"><a href="#cb490-32" aria-hidden="true"></a> <span class="fu">\expandafter\citations</span></span> +<span id="cb490-33"><a href="#cb490-33" aria-hidden="true"></a> },</span> +<span id="cb490-34"><a href="#cb490-34" aria-hidden="true"></a> },</span> +<span id="cb490-35"><a href="#cb490-35" aria-hidden="true"></a>}</span> +<span id="cb490-36"><a href="#cb490-36" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb490-37"><a href="#cb490-37" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb490-38"><a href="#cb490-38" aria-hidden="true"></a>[see @abrahams90, pp. 12; @eijkhout91, pp. 34]</span> +<span id="cb490-39"><a href="#cb490-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb490-40"><a href="#cb490-40" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb491"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb491-1"><a href="#cb491-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a parenthesized citation <em>abrahams90</em> with a prefix see and a postfix <em>pp. 12</em>, and a citation <em>eijkhout91</em> with a postfix <em>pp. 34</em>.</p> </blockquote> <h4 data-number="2.3.1.23" id="text-citations-renderer"><span class="header-section-number">2.3.1.23</span> Text Citations Renderer</h4> <p>The <code>\markdownRendererTextCite</code> macro represents a string of one or more text citations. This macro will only be produced, when the <strong><code>citations</code></strong> option is enabled. The macro receives parameters in the same format as the <code>\markdownRendererCite</code> macro.</p> -<h5 class="unnumbered" data-number="" id="latex-example-63"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-64"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb489"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb489-1"><a href="#cb489-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb489-2"><a href="#cb489-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span> -<span id="cb489-3"><a href="#cb489-3" aria-hidden="true"></a><span class="fu">\newcount\citationsCounter</span></span> -<span id="cb489-4"><a href="#cb489-4" aria-hidden="true"></a><span class="fu">\newcount\citationsTotal</span></span> -<span id="cb489-5"><a href="#cb489-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> -<span id="cb489-6"><a href="#cb489-6" aria-hidden="true"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span> -<span id="cb489-7"><a href="#cb489-7" aria-hidden="true"></a> a text citation <span class="fu">\emph</span>{#4}</span> -<span id="cb489-8"><a href="#cb489-8" aria-hidden="true"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span> -<span id="cb489-9"><a href="#cb489-9" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span> -<span id="cb489-10"><a href="#cb489-10" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> -<span id="cb489-11"><a href="#cb489-11" aria-hidden="true"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> -<span id="cb489-12"><a href="#cb489-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb489-13"><a href="#cb489-13" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb489-14"><a href="#cb489-14" aria-hidden="true"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span> -<span id="cb489-15"><a href="#cb489-15" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> -<span id="cb489-16"><a href="#cb489-16" aria-hidden="true"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> -<span id="cb489-17"><a href="#cb489-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb489-18"><a href="#cb489-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb489-19"><a href="#cb489-19" aria-hidden="true"></a> <span class="fu">\ifnum\citationsCounter</span>><span class="fu">\citationsTotal\relax</span></span> -<span id="cb489-20"><a href="#cb489-20" aria-hidden="true"></a> .<span class="co">%</span></span> -<span id="cb489-21"><a href="#cb489-21" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> -<span id="cb489-22"><a href="#cb489-22" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb489-23"><a href="#cb489-23" aria-hidden="true"></a> , and</span> -<span id="cb489-24"><a href="#cb489-24" aria-hidden="true"></a> <span class="fu">\fi\citations</span>}</span> -<span id="cb489-25"><a href="#cb489-25" aria-hidden="true"></a><span class="fu">\makeatother</span></span> -<span id="cb489-26"><a href="#cb489-26" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb489-27"><a href="#cb489-27" aria-hidden="true"></a> renderers = {</span> -<span id="cb489-28"><a href="#cb489-28" aria-hidden="true"></a> textCite = {<span class="co">%</span></span> -<span id="cb489-29"><a href="#cb489-29" aria-hidden="true"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span> -<span id="cb489-30"><a href="#cb489-30" aria-hidden="true"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span> -<span id="cb489-31"><a href="#cb489-31" aria-hidden="true"></a> This is</span> -<span id="cb489-32"><a href="#cb489-32" aria-hidden="true"></a> <span class="fu">\expandafter\citations</span></span> -<span id="cb489-33"><a href="#cb489-33" aria-hidden="true"></a> },</span> -<span id="cb489-34"><a href="#cb489-34" aria-hidden="true"></a> },</span> -<span id="cb489-35"><a href="#cb489-35" aria-hidden="true"></a>}</span> -<span id="cb489-36"><a href="#cb489-36" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb489-37"><a href="#cb489-37" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb489-38"><a href="#cb489-38" aria-hidden="true"></a>@abrahams90 [pp. 12; also @eijkhout91]</span> -<span id="cb489-39"><a href="#cb489-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb489-40"><a href="#cb489-40" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb490"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb490-1"><a href="#cb490-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb492"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb492-1"><a href="#cb492-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb492-2"><a href="#cb492-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span> +<span id="cb492-3"><a href="#cb492-3" aria-hidden="true"></a><span class="fu">\newcount\citationsCounter</span></span> +<span id="cb492-4"><a href="#cb492-4" aria-hidden="true"></a><span class="fu">\newcount\citationsTotal</span></span> +<span id="cb492-5"><a href="#cb492-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> +<span id="cb492-6"><a href="#cb492-6" aria-hidden="true"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span> +<span id="cb492-7"><a href="#cb492-7" aria-hidden="true"></a> a text citation <span class="fu">\emph</span>{#4}</span> +<span id="cb492-8"><a href="#cb492-8" aria-hidden="true"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span> +<span id="cb492-9"><a href="#cb492-9" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span> +<span id="cb492-10"><a href="#cb492-10" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> +<span id="cb492-11"><a href="#cb492-11" aria-hidden="true"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> +<span id="cb492-12"><a href="#cb492-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb492-13"><a href="#cb492-13" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb492-14"><a href="#cb492-14" aria-hidden="true"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span> +<span id="cb492-15"><a href="#cb492-15" aria-hidden="true"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span> +<span id="cb492-16"><a href="#cb492-16" aria-hidden="true"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span> +<span id="cb492-17"><a href="#cb492-17" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb492-18"><a href="#cb492-18" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb492-19"><a href="#cb492-19" aria-hidden="true"></a> <span class="fu">\ifnum\citationsCounter</span>><span class="fu">\citationsTotal\relax</span></span> +<span id="cb492-20"><a href="#cb492-20" aria-hidden="true"></a> .<span class="co">%</span></span> +<span id="cb492-21"><a href="#cb492-21" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> +<span id="cb492-22"><a href="#cb492-22" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb492-23"><a href="#cb492-23" aria-hidden="true"></a> , and</span> +<span id="cb492-24"><a href="#cb492-24" aria-hidden="true"></a> <span class="fu">\fi\citations</span>}</span> +<span id="cb492-25"><a href="#cb492-25" aria-hidden="true"></a><span class="fu">\makeatother</span></span> +<span id="cb492-26"><a href="#cb492-26" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb492-27"><a href="#cb492-27" aria-hidden="true"></a> renderers = {</span> +<span id="cb492-28"><a href="#cb492-28" aria-hidden="true"></a> textCite = {<span class="co">%</span></span> +<span id="cb492-29"><a href="#cb492-29" aria-hidden="true"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span> +<span id="cb492-30"><a href="#cb492-30" aria-hidden="true"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span> +<span id="cb492-31"><a href="#cb492-31" aria-hidden="true"></a> This is</span> +<span id="cb492-32"><a href="#cb492-32" aria-hidden="true"></a> <span class="fu">\expandafter\citations</span></span> +<span id="cb492-33"><a href="#cb492-33" aria-hidden="true"></a> },</span> +<span id="cb492-34"><a href="#cb492-34" aria-hidden="true"></a> },</span> +<span id="cb492-35"><a href="#cb492-35" aria-hidden="true"></a>}</span> +<span id="cb492-36"><a href="#cb492-36" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb492-37"><a href="#cb492-37" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb492-38"><a href="#cb492-38" aria-hidden="true"></a>@abrahams90 [pp. 12; also @eijkhout91]</span> +<span id="cb492-39"><a href="#cb492-39" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb492-40"><a href="#cb492-40" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb493"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb493-1"><a href="#cb493-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a text citation <em>abrahams90</em> with a postfix <em>pp. 12</em>, and a citation <em>eijkhout91</em> with a prefix <em>also</em>.</p> @@ -6525,67 +6568,67 @@ Thomas,Edison,1847</code></pre> <li><code>c</code> – The corresponding column is centered.</li> <li><code>r</code> – The corresponding column is right-aligned.</li> </ul> -<h5 class="unnumbered" data-number="" id="latex-example-64"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-65"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb491"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb491-1"><a href="#cb491-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb491-2"><a href="#cb491-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span> -<span id="cb491-3"><a href="#cb491-3" aria-hidden="true"></a><span class="fu">\newcount\rowCounter</span></span> -<span id="cb491-4"><a href="#cb491-4" aria-hidden="true"></a><span class="fu">\newcount\columnCounter</span></span> -<span id="cb491-5"><a href="#cb491-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> -<span id="cb491-6"><a href="#cb491-6" aria-hidden="true"></a><span class="fu">\def\processRow</span>#1{<span class="co">%</span></span> -<span id="cb491-7"><a href="#cb491-7" aria-hidden="true"></a> <span class="fu">\columnCounter</span>=1<span class="co">%</span></span> -<span id="cb491-8"><a href="#cb491-8" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span> -<span id="cb491-9"><a href="#cb491-9" aria-hidden="true"></a> As for the alignment,</span> -<span id="cb491-10"><a href="#cb491-10" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb491-11"><a href="#cb491-11" aria-hidden="true"></a> In row <span class="fu">\the\rowCounter</span>,</span> -<span id="cb491-12"><a href="#cb491-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb491-13"><a href="#cb491-13" aria-hidden="true"></a> <span class="fu">\processColumn</span>#1</span> -<span id="cb491-14"><a href="#cb491-14" aria-hidden="true"></a> <span class="fu">\advance\rowCounter</span> by 1<span class="fu">\relax</span></span> -<span id="cb491-15"><a href="#cb491-15" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>><span class="fu">\rowTotal\relax</span></span> -<span id="cb491-16"><a href="#cb491-16" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> -<span id="cb491-17"><a href="#cb491-17" aria-hidden="true"></a> <span class="fu">\fi\processRow</span>}<span class="co">%</span></span> -<span id="cb491-18"><a href="#cb491-18" aria-hidden="true"></a><span class="fu">\def\processColumn</span>#1{<span class="co">%</span></span> -<span id="cb491-19"><a href="#cb491-19" aria-hidden="true"></a> column number <span class="fu">\the\columnCounter</span>{}</span> -<span id="cb491-20"><a href="#cb491-20" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span> -<span id="cb491-21"><a href="#cb491-21" aria-hidden="true"></a> <span class="fu">\if</span>#1d{}has default alignment<span class="fu">\fi</span></span> -<span id="cb491-22"><a href="#cb491-22" aria-hidden="true"></a> <span class="fu">\if</span>#1l{}is left-aligned<span class="fu">\fi</span></span> -<span id="cb491-23"><a href="#cb491-23" aria-hidden="true"></a> <span class="fu">\if</span>#1c{}is centered<span class="fu">\fi</span></span> -<span id="cb491-24"><a href="#cb491-24" aria-hidden="true"></a> <span class="fu">\if</span>#1r{}is right-aligned<span class="fu">\fi</span></span> -<span id="cb491-25"><a href="#cb491-25" aria-hidden="true"></a> <span class="fu">\else</span></span> -<span id="cb491-26"><a href="#cb491-26" aria-hidden="true"></a> says <span class="fu">\emph</span>{#1}<span class="co">%</span></span> -<span id="cb491-27"><a href="#cb491-27" aria-hidden="true"></a> <span class="fu">\fi</span></span> -<span id="cb491-28"><a href="#cb491-28" aria-hidden="true"></a> <span class="fu">\advance\columnCounter</span> by 1<span class="fu">\relax</span></span> -<span id="cb491-29"><a href="#cb491-29" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span><<span class="fu">\columnTotal\relax</span>, <span class="fu">\fi</span></span> -<span id="cb491-30"><a href="#cb491-30" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span>=<span class="fu">\columnTotal\relax</span>, and <span class="fu">\fi</span></span> -<span id="cb491-31"><a href="#cb491-31" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span>><span class="fu">\columnTotal\relax</span></span> -<span id="cb491-32"><a href="#cb491-32" aria-hidden="true"></a> .<span class="fu">\expandafter\@gobble</span></span> -<span id="cb491-33"><a href="#cb491-33" aria-hidden="true"></a> <span class="fu">\fi\processColumn</span>}<span class="co">%</span></span> -<span id="cb491-34"><a href="#cb491-34" aria-hidden="true"></a><span class="fu">\makeatother</span></span> -<span id="cb491-35"><a href="#cb491-35" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb491-36"><a href="#cb491-36" aria-hidden="true"></a> renderers = {</span> -<span id="cb491-37"><a href="#cb491-37" aria-hidden="true"></a> table = {<span class="co">%</span></span> -<span id="cb491-38"><a href="#cb491-38" aria-hidden="true"></a> This is a table with caption <span class="fu">\emph</span>{#1} that is #3 colums wide</span> -<span id="cb491-39"><a href="#cb491-39" aria-hidden="true"></a> and #2 rows long.</span> -<span id="cb491-40"><a href="#cb491-40" aria-hidden="true"></a> <span class="fu">\rowCounter</span>=0<span class="co">%</span></span> -<span id="cb491-41"><a href="#cb491-41" aria-hidden="true"></a> <span class="fu">\def\rowTotal</span>{#2}<span class="co">%</span></span> -<span id="cb491-42"><a href="#cb491-42" aria-hidden="true"></a> <span class="fu">\def\columnTotal</span>{#3}<span class="co">%</span></span> -<span id="cb491-43"><a href="#cb491-43" aria-hidden="true"></a> <span class="fu">\processRow</span></span> -<span id="cb491-44"><a href="#cb491-44" aria-hidden="true"></a> },</span> -<span id="cb491-45"><a href="#cb491-45" aria-hidden="true"></a> },</span> -<span id="cb491-46"><a href="#cb491-46" aria-hidden="true"></a>}</span> -<span id="cb491-47"><a href="#cb491-47" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb491-48"><a href="#cb491-48" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb491-49"><a href="#cb491-49" aria-hidden="true"></a>| Right | Left | Default | Center |</span> -<span id="cb491-50"><a href="#cb491-50" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> -<span id="cb491-51"><a href="#cb491-51" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> -<span id="cb491-52"><a href="#cb491-52" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> -<span id="cb491-53"><a href="#cb491-53" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> -<span id="cb491-54"><a href="#cb491-54" aria-hidden="true"></a></span> -<span id="cb491-55"><a href="#cb491-55" aria-hidden="true"></a> : Demonstration of pipe table syntax</span> -<span id="cb491-56"><a href="#cb491-56" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb491-57"><a href="#cb491-57" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb492"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb492-1"><a href="#cb492-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb494"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb494-1"><a href="#cb494-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb494-2"><a href="#cb494-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span> +<span id="cb494-3"><a href="#cb494-3" aria-hidden="true"></a><span class="fu">\newcount\rowCounter</span></span> +<span id="cb494-4"><a href="#cb494-4" aria-hidden="true"></a><span class="fu">\newcount\columnCounter</span></span> +<span id="cb494-5"><a href="#cb494-5" aria-hidden="true"></a><span class="fu">\makeatletter</span></span> +<span id="cb494-6"><a href="#cb494-6" aria-hidden="true"></a><span class="fu">\def\processRow</span>#1{<span class="co">%</span></span> +<span id="cb494-7"><a href="#cb494-7" aria-hidden="true"></a> <span class="fu">\columnCounter</span>=1<span class="co">%</span></span> +<span id="cb494-8"><a href="#cb494-8" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span> +<span id="cb494-9"><a href="#cb494-9" aria-hidden="true"></a> As for the alignment,</span> +<span id="cb494-10"><a href="#cb494-10" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb494-11"><a href="#cb494-11" aria-hidden="true"></a> In row <span class="fu">\the\rowCounter</span>,</span> +<span id="cb494-12"><a href="#cb494-12" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb494-13"><a href="#cb494-13" aria-hidden="true"></a> <span class="fu">\processColumn</span>#1</span> +<span id="cb494-14"><a href="#cb494-14" aria-hidden="true"></a> <span class="fu">\advance\rowCounter</span> by 1<span class="fu">\relax</span></span> +<span id="cb494-15"><a href="#cb494-15" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>><span class="fu">\rowTotal\relax</span></span> +<span id="cb494-16"><a href="#cb494-16" aria-hidden="true"></a> <span class="fu">\expandafter\@gobble</span></span> +<span id="cb494-17"><a href="#cb494-17" aria-hidden="true"></a> <span class="fu">\fi\processRow</span>}<span class="co">%</span></span> +<span id="cb494-18"><a href="#cb494-18" aria-hidden="true"></a><span class="fu">\def\processColumn</span>#1{<span class="co">%</span></span> +<span id="cb494-19"><a href="#cb494-19" aria-hidden="true"></a> column number <span class="fu">\the\columnCounter</span>{}</span> +<span id="cb494-20"><a href="#cb494-20" aria-hidden="true"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span> +<span id="cb494-21"><a href="#cb494-21" aria-hidden="true"></a> <span class="fu">\if</span>#1d{}has default alignment<span class="fu">\fi</span></span> +<span id="cb494-22"><a href="#cb494-22" aria-hidden="true"></a> <span class="fu">\if</span>#1l{}is left-aligned<span class="fu">\fi</span></span> +<span id="cb494-23"><a href="#cb494-23" aria-hidden="true"></a> <span class="fu">\if</span>#1c{}is centered<span class="fu">\fi</span></span> +<span id="cb494-24"><a href="#cb494-24" aria-hidden="true"></a> <span class="fu">\if</span>#1r{}is right-aligned<span class="fu">\fi</span></span> +<span id="cb494-25"><a href="#cb494-25" aria-hidden="true"></a> <span class="fu">\else</span></span> +<span id="cb494-26"><a href="#cb494-26" aria-hidden="true"></a> says <span class="fu">\emph</span>{#1}<span class="co">%</span></span> +<span id="cb494-27"><a href="#cb494-27" aria-hidden="true"></a> <span class="fu">\fi</span></span> +<span id="cb494-28"><a href="#cb494-28" aria-hidden="true"></a> <span class="fu">\advance\columnCounter</span> by 1<span class="fu">\relax</span></span> +<span id="cb494-29"><a href="#cb494-29" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span><<span class="fu">\columnTotal\relax</span>, <span class="fu">\fi</span></span> +<span id="cb494-30"><a href="#cb494-30" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span>=<span class="fu">\columnTotal\relax</span>, and <span class="fu">\fi</span></span> +<span id="cb494-31"><a href="#cb494-31" aria-hidden="true"></a> <span class="fu">\ifnum\columnCounter</span>><span class="fu">\columnTotal\relax</span></span> +<span id="cb494-32"><a href="#cb494-32" aria-hidden="true"></a> .<span class="fu">\expandafter\@gobble</span></span> +<span id="cb494-33"><a href="#cb494-33" aria-hidden="true"></a> <span class="fu">\fi\processColumn</span>}<span class="co">%</span></span> +<span id="cb494-34"><a href="#cb494-34" aria-hidden="true"></a><span class="fu">\makeatother</span></span> +<span id="cb494-35"><a href="#cb494-35" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb494-36"><a href="#cb494-36" aria-hidden="true"></a> renderers = {</span> +<span id="cb494-37"><a href="#cb494-37" aria-hidden="true"></a> table = {<span class="co">%</span></span> +<span id="cb494-38"><a href="#cb494-38" aria-hidden="true"></a> This is a table with caption <span class="fu">\emph</span>{#1} that is #3 colums wide</span> +<span id="cb494-39"><a href="#cb494-39" aria-hidden="true"></a> and #2 rows long.</span> +<span id="cb494-40"><a href="#cb494-40" aria-hidden="true"></a> <span class="fu">\rowCounter</span>=0<span class="co">%</span></span> +<span id="cb494-41"><a href="#cb494-41" aria-hidden="true"></a> <span class="fu">\def\rowTotal</span>{#2}<span class="co">%</span></span> +<span id="cb494-42"><a href="#cb494-42" aria-hidden="true"></a> <span class="fu">\def\columnTotal</span>{#3}<span class="co">%</span></span> +<span id="cb494-43"><a href="#cb494-43" aria-hidden="true"></a> <span class="fu">\processRow</span></span> +<span id="cb494-44"><a href="#cb494-44" aria-hidden="true"></a> },</span> +<span id="cb494-45"><a href="#cb494-45" aria-hidden="true"></a> },</span> +<span id="cb494-46"><a href="#cb494-46" aria-hidden="true"></a>}</span> +<span id="cb494-47"><a href="#cb494-47" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb494-48"><a href="#cb494-48" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb494-49"><a href="#cb494-49" aria-hidden="true"></a>| Right | Left | Default | Center |</span> +<span id="cb494-50"><a href="#cb494-50" aria-hidden="true"></a>|------:|:-----|---------|:------:|</span> +<span id="cb494-51"><a href="#cb494-51" aria-hidden="true"></a>| 12 | 12 | 12 | 12 |</span> +<span id="cb494-52"><a href="#cb494-52" aria-hidden="true"></a>| 123 | 123 | 123 | 123 |</span> +<span id="cb494-53"><a href="#cb494-53" aria-hidden="true"></a>| 1 | 1 | 1 | 1 |</span> +<span id="cb494-54"><a href="#cb494-54" aria-hidden="true"></a></span> +<span id="cb494-55"><a href="#cb494-55" aria-hidden="true"></a> : Demonstration of pipe table syntax</span> +<span id="cb494-56"><a href="#cb494-56" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb494-57"><a href="#cb494-57" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb495"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb495-1"><a href="#cb495-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is a table with caption <em>Demonstration of pipe table syntax</em> that is 4 colums wide and 4 rows long. As for the alignment, column number 1 is right-aligned, column number 2 is left-aligned, column number 3 has default alignment, and column number 4 is centered. In row 1, column number 1 says <em>Right</em>, column number 2 says <em>Left</em>, column number 3 says <em>Default</em>, and column number 4 says <em>Center</em>. In row 2, column number 1 says <em>12</em>, column number 2 says <em>12</em>, column number 3 says <em>12</em>, and column number 4 says <em>12</em>. In row 3, column number 1 says <em>123</em>, column number 2 says <em>123</em>, column number 3 says <em>123</em>, and column number 4 says <em>123</em>. In row 4, column number 1 says <em>1</em>, column number 2 says <em>1</em>, column number 3 says <em>1</em>, and column number 4 says <em>1</em>.</p> @@ -6593,36 +6636,36 @@ Thomas,Edison,1847</code></pre> <h4 data-number="2.3.1.25" id="html-comment-renderers"><span class="header-section-number">2.3.1.25</span> HTML Comment Renderers</h4> <p>The <code>\markdownRendererInlineHtmlComment</code> macro represents the contents of an inline <abbr>HTML</abbr> comment. This macro will only be produced, when the <strong><code>html</code></strong> option is enabled. The macro receives a single argument that corresponds to the contents of the <abbr>HTML</abbr> comment.</p> <p>The <code>\markdownRendererBlockHtmlCommentBegin</code> and <code>\markdownRendererBlockHtmlCommentEnd</code> macros represent the beginning and the end of a block <abbr>HTML</abbr> comment. The macros receive no arguments.</p> -<h5 class="unnumbered" data-number="" id="latex-example-65"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-66"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb493"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb493-1"><a href="#cb493-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb493-2"><a href="#cb493-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span> -<span id="cb493-3"><a href="#cb493-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span> -<span id="cb493-4"><a href="#cb493-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb493-5"><a href="#cb493-5" aria-hidden="true"></a> renderers = {</span> -<span id="cb493-6"><a href="#cb493-6" aria-hidden="true"></a> inlineHtmlComment = {<span class="fu">\marginnote</span>{#1}},</span> -<span id="cb493-7"><a href="#cb493-7" aria-hidden="true"></a> blockHtmlCommentBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span> -<span id="cb493-8"><a href="#cb493-8" aria-hidden="true"></a> blockHtmlCommentEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span> -<span id="cb493-9"><a href="#cb493-9" aria-hidden="true"></a> },</span> -<span id="cb493-10"><a href="#cb493-10" aria-hidden="true"></a>}</span> -<span id="cb493-11"><a href="#cb493-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb493-12"><a href="#cb493-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb493-13"><a href="#cb493-13" aria-hidden="true"></a>A useful use of inline HTML comments are side notes.</span> -<span id="cb493-14"><a href="#cb493-14" aria-hidden="true"></a><!-- Side notes are displayed in the horizontal margins next to the relevant</span> -<span id="cb493-15"><a href="#cb493-15" aria-hidden="true"></a>passages, which makes them *easier for the reader to find* than footnotes. --></span> -<span id="cb493-16"><a href="#cb493-16" aria-hidden="true"></a></span> -<span id="cb493-17"><a href="#cb493-17" aria-hidden="true"></a>We can render block HTML comments as blockquotes:</span> -<span id="cb493-18"><a href="#cb493-18" aria-hidden="true"></a></span> -<span id="cb493-19"><a href="#cb493-19" aria-hidden="true"></a><!--</span> -<span id="cb493-20"><a href="#cb493-20" aria-hidden="true"></a>Here is a block HTML comment with a code example that a programmer might understand:</span> -<span id="cb493-21"><a href="#cb493-21" aria-hidden="true"></a></span> -<span id="cb493-22"><a href="#cb493-22" aria-hidden="true"></a> foo = bar + baz - 42</span> -<span id="cb493-23"><a href="#cb493-23" aria-hidden="true"></a>--></span> -<span id="cb493-24"><a href="#cb493-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb493-25"><a href="#cb493-25" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb494"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb494-1"><a href="#cb494-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> -<span id="cb494-2"><a href="#cb494-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb496"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb496-1"><a href="#cb496-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb496-2"><a href="#cb496-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span> +<span id="cb496-3"><a href="#cb496-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span> +<span id="cb496-4"><a href="#cb496-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb496-5"><a href="#cb496-5" aria-hidden="true"></a> renderers = {</span> +<span id="cb496-6"><a href="#cb496-6" aria-hidden="true"></a> inlineHtmlComment = {<span class="fu">\marginnote</span>{#1}},</span> +<span id="cb496-7"><a href="#cb496-7" aria-hidden="true"></a> blockHtmlCommentBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span> +<span id="cb496-8"><a href="#cb496-8" aria-hidden="true"></a> blockHtmlCommentEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span> +<span id="cb496-9"><a href="#cb496-9" aria-hidden="true"></a> },</span> +<span id="cb496-10"><a href="#cb496-10" aria-hidden="true"></a>}</span> +<span id="cb496-11"><a href="#cb496-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb496-12"><a href="#cb496-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb496-13"><a href="#cb496-13" aria-hidden="true"></a>A useful use of inline HTML comments are side notes.</span> +<span id="cb496-14"><a href="#cb496-14" aria-hidden="true"></a><!-- Side notes are displayed in the horizontal margins next to the relevant</span> +<span id="cb496-15"><a href="#cb496-15" aria-hidden="true"></a>passages, which makes them *easier for the reader to find* than footnotes. --></span> +<span id="cb496-16"><a href="#cb496-16" aria-hidden="true"></a></span> +<span id="cb496-17"><a href="#cb496-17" aria-hidden="true"></a>We can render block HTML comments as blockquotes:</span> +<span id="cb496-18"><a href="#cb496-18" aria-hidden="true"></a></span> +<span id="cb496-19"><a href="#cb496-19" aria-hidden="true"></a><!--</span> +<span id="cb496-20"><a href="#cb496-20" aria-hidden="true"></a>Here is a block HTML comment with a code example that a programmer might understand:</span> +<span id="cb496-21"><a href="#cb496-21" aria-hidden="true"></a></span> +<span id="cb496-22"><a href="#cb496-22" aria-hidden="true"></a> foo = bar + baz - 42</span> +<span id="cb496-23"><a href="#cb496-23" aria-hidden="true"></a>--></span> +<span id="cb496-24"><a href="#cb496-24" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb496-25"><a href="#cb496-25" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb497"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb497-1"><a href="#cb497-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> +<span id="cb497-2"><a href="#cb497-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following body text:</p> <blockquote> <p>A useful use of HTML comments are side notes.</p> @@ -6639,28 +6682,28 @@ Thomas,Edison,1847</code></pre> <h4 data-number="2.3.1.26" id="html-tag-and-element-renderers"><span class="header-section-number">2.3.1.26</span> HTML Tag and Element Renderers</h4> <p>The <code>\markdownRendererInlineHtmlTag</code> macro represents an opening, closing, or empty inline <abbr>HTML</abbr> tag. This macro will only be produced, when the <strong><code>html</code></strong> option is enabled. The macro receives a single argument that corresponds to the contents of the <abbr>HTML</abbr> tag.</p> <p>The <code>\markdownRendererInputBlockHtmlElement</code> macro represents a block <abbr>HTML</abbr> element. This macro will only be produced, when the <strong><code>html</code></strong> option is enabled. The macro receives a single argument that filename of a file containing the contents of the <abbr>HTML</abbr> element.</p> -<h5 class="unnumbered" data-number="" id="latex-example-66"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-67"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb496"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb496-1"><a href="#cb496-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb496-2"><a href="#cb496-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span> -<span id="cb496-3"><a href="#cb496-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span> -<span id="cb496-4"><a href="#cb496-4" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span> -<span id="cb496-5"><a href="#cb496-5" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb496-6"><a href="#cb496-6" aria-hidden="true"></a> renderers = {</span> -<span id="cb496-7"><a href="#cb496-7" aria-hidden="true"></a> inlineHtmlTag = {<span class="fu">\textbf</span>{#1}},</span> -<span id="cb496-8"><a href="#cb496-8" aria-hidden="true"></a> inputBlockHtmlElement = {<span class="fu">\verbatiminput</span>{#1}},</span> -<span id="cb496-9"><a href="#cb496-9" aria-hidden="true"></a> },</span> -<span id="cb496-10"><a href="#cb496-10" aria-hidden="true"></a>}</span> -<span id="cb496-11"><a href="#cb496-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb496-12"><a href="#cb496-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb496-13"><a href="#cb496-13" aria-hidden="true"></a><b>_Hello,_ world!</b><br/></span> -<span id="cb496-14"><a href="#cb496-14" aria-hidden="true"></a></span> -<span id="cb496-15"><a href="#cb496-15" aria-hidden="true"></a><div>_Hello,_ world!</div></span> -<span id="cb496-16"><a href="#cb496-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb496-17"><a href="#cb496-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb497"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb497-1"><a href="#cb497-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> -<span id="cb497-2"><a href="#cb497-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb499"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb499-1"><a href="#cb499-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb499-2"><a href="#cb499-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span> +<span id="cb499-3"><a href="#cb499-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span> +<span id="cb499-4"><a href="#cb499-4" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span> +<span id="cb499-5"><a href="#cb499-5" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb499-6"><a href="#cb499-6" aria-hidden="true"></a> renderers = {</span> +<span id="cb499-7"><a href="#cb499-7" aria-hidden="true"></a> inlineHtmlTag = {<span class="fu">\textbf</span>{#1}},</span> +<span id="cb499-8"><a href="#cb499-8" aria-hidden="true"></a> inputBlockHtmlElement = {<span class="fu">\verbatiminput</span>{#1}},</span> +<span id="cb499-9"><a href="#cb499-9" aria-hidden="true"></a> },</span> +<span id="cb499-10"><a href="#cb499-10" aria-hidden="true"></a>}</span> +<span id="cb499-11"><a href="#cb499-11" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb499-12"><a href="#cb499-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb499-13"><a href="#cb499-13" aria-hidden="true"></a><b>_Hello,_ world!</b><br/></span> +<span id="cb499-14"><a href="#cb499-14" aria-hidden="true"></a></span> +<span id="cb499-15"><a href="#cb499-15" aria-hidden="true"></a><div>_Hello,_ world!</div></span> +<span id="cb499-16"><a href="#cb499-16" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb499-17"><a href="#cb499-17" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb500"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb500-1"><a href="#cb500-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span> +<span id="cb500-2"><a href="#cb500-2" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following body text:</p> <blockquote> <p><strong><b></strong>_Hello,_ world!<strong></b><br/></strong></p> @@ -6671,42 +6714,42 @@ Thomas,Edison,1847</code></pre> <p><code>\markdownRendererAttributeIdentifier</code> represents the ⟨<em>identifier</em>⟩ of a markdown element (<code>id="</code>⟨<em>identifier</em>⟩<code>"</code> in HTML and <code>#</code>⟨<em>identifier</em>⟩ in Markdown’s <strong><code>headerAttributes</code></strong> syntax extension). The macro receives a single attribute that corresponds to the ⟨<em>identifier</em>⟩.</p> <p><code>\markdownRendererAttributeClassName</code> represents the ⟨<em>class name</em>⟩ of a markdown element (<code>class="</code>⟨<em>class name</em>⟩ …<code>"</code> in HTML and <code>.</code>⟨<em>class name</em>⟩ in Markdown’s <strong><code>headerAttributes</code></strong> syntax extension). The macro receives a single attribute that corresponds to the .</p> <p><code>\markdownRendererAttributeKeyValue</code> represents a HTML attribute in the form ⟨<em>key</em>⟩<code>=</code>⟨<em>value</em>⟩ that is neither an identifier nor a class name. The macro receives two attributes that correspond to the ⟨<em>key</em>⟩ and the ⟨<em>value</em>⟩, respectively.</p> -<h5 class="unnumbered" data-number="" id="latex-example-67"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-68"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb499"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb499-1"><a href="#cb499-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb499-2"><a href="#cb499-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes, underscores=false]{<span class="ex">markdown</span>}</span> -<span id="cb499-3"><a href="#cb499-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb499-4"><a href="#cb499-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb499-5"><a href="#cb499-5" aria-hidden="true"></a> attributeIdentifier = {<span class="co">%</span></span> -<span id="cb499-6"><a href="#cb499-6" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-7"><a href="#cb499-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(Identifier: #1)}</span> -<span id="cb499-8"><a href="#cb499-8" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-9"><a href="#cb499-9" aria-hidden="true"></a> },</span> -<span id="cb499-10"><a href="#cb499-10" aria-hidden="true"></a> attributeClassName = {<span class="co">%</span></span> -<span id="cb499-11"><a href="#cb499-11" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-12"><a href="#cb499-12" aria-hidden="true"></a> <span class="fu">\emph</span>{(Class name: #1)}</span> -<span id="cb499-13"><a href="#cb499-13" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-14"><a href="#cb499-14" aria-hidden="true"></a> },</span> -<span id="cb499-15"><a href="#cb499-15" aria-hidden="true"></a> attributeKeyValue = {<span class="co">%</span></span> -<span id="cb499-16"><a href="#cb499-16" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-17"><a href="#cb499-17" aria-hidden="true"></a> <span class="fu">\emph</span>{(Key: #1, Value: #2)}</span> -<span id="cb499-18"><a href="#cb499-18" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb499-19"><a href="#cb499-19" aria-hidden="true"></a> },</span> -<span id="cb499-20"><a href="#cb499-20" aria-hidden="true"></a> },</span> -<span id="cb499-21"><a href="#cb499-21" aria-hidden="true"></a>}</span> -<span id="cb499-22"><a href="#cb499-22" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb499-23"><a href="#cb499-23" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb499-24"><a href="#cb499-24" aria-hidden="true"></a></span> -<span id="cb499-25"><a href="#cb499-25" aria-hidden="true"></a># First top-level heading {jane=doe}</span> -<span id="cb499-26"><a href="#cb499-26" aria-hidden="true"></a></span> -<span id="cb499-27"><a href="#cb499-27" aria-hidden="true"></a>## A subheading {#identifier}</span> -<span id="cb499-28"><a href="#cb499-28" aria-hidden="true"></a></span> -<span id="cb499-29"><a href="#cb499-29" aria-hidden="true"></a># Second top-level heading {.class_name}</span> -<span id="cb499-30"><a href="#cb499-30" aria-hidden="true"></a></span> -<span id="cb499-31"><a href="#cb499-31" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb499-32"><a href="#cb499-32" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb500"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb500-1"><a href="#cb500-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb502"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb502-1"><a href="#cb502-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb502-2"><a href="#cb502-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes, underscores=false]{<span class="ex">markdown</span>}</span> +<span id="cb502-3"><a href="#cb502-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb502-4"><a href="#cb502-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb502-5"><a href="#cb502-5" aria-hidden="true"></a> attributeIdentifier = {<span class="co">%</span></span> +<span id="cb502-6"><a href="#cb502-6" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-7"><a href="#cb502-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(Identifier: #1)}</span> +<span id="cb502-8"><a href="#cb502-8" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-9"><a href="#cb502-9" aria-hidden="true"></a> },</span> +<span id="cb502-10"><a href="#cb502-10" aria-hidden="true"></a> attributeClassName = {<span class="co">%</span></span> +<span id="cb502-11"><a href="#cb502-11" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-12"><a href="#cb502-12" aria-hidden="true"></a> <span class="fu">\emph</span>{(Class name: #1)}</span> +<span id="cb502-13"><a href="#cb502-13" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-14"><a href="#cb502-14" aria-hidden="true"></a> },</span> +<span id="cb502-15"><a href="#cb502-15" aria-hidden="true"></a> attributeKeyValue = {<span class="co">%</span></span> +<span id="cb502-16"><a href="#cb502-16" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-17"><a href="#cb502-17" aria-hidden="true"></a> <span class="fu">\emph</span>{(Key: #1, Value: #2)}</span> +<span id="cb502-18"><a href="#cb502-18" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb502-19"><a href="#cb502-19" aria-hidden="true"></a> },</span> +<span id="cb502-20"><a href="#cb502-20" aria-hidden="true"></a> },</span> +<span id="cb502-21"><a href="#cb502-21" aria-hidden="true"></a>}</span> +<span id="cb502-22"><a href="#cb502-22" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb502-23"><a href="#cb502-23" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb502-24"><a href="#cb502-24" aria-hidden="true"></a></span> +<span id="cb502-25"><a href="#cb502-25" aria-hidden="true"></a># First top-level heading {jane=doe}</span> +<span id="cb502-26"><a href="#cb502-26" aria-hidden="true"></a></span> +<span id="cb502-27"><a href="#cb502-27" aria-hidden="true"></a>## A subheading {#identifier}</span> +<span id="cb502-28"><a href="#cb502-28" aria-hidden="true"></a></span> +<span id="cb502-29"><a href="#cb502-29" aria-hidden="true"></a># Second top-level heading {.class_name}</span> +<span id="cb502-30"><a href="#cb502-30" aria-hidden="true"></a></span> +<span id="cb502-31"><a href="#cb502-31" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb502-32"><a href="#cb502-32" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb503"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb503-1"><a href="#cb503-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="first-top-level-heading">First top-level heading</h1> @@ -6719,37 +6762,37 @@ Thomas,Edison,1847</code></pre> <h4 data-number="2.3.1.28" id="header-attribute-context-renderers"><span class="header-section-number">2.3.1.28</span> Header Attribute Context Renderers</h4> <p>The following macros are only produced, when the <strong><code>headerAttributes</code></strong> option is enabled.</p> <p>The <code>\markdownRendererHeaderAttributeContextBegin</code> and <code>\markdownRendererHeaderAttributeContextEnd</code> macros represent the beginning and the end of a section in which the attributes of a heading apply. The macros receive no arguments.</p> -<h5 class="unnumbered" data-number="" id="latex-example-68"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-69"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb501"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb501-1"><a href="#cb501-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb501-2"><a href="#cb501-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span> -<span id="cb501-3"><a href="#cb501-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb501-4"><a href="#cb501-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb501-5"><a href="#cb501-5" aria-hidden="true"></a> headerAttributeContextBegin = {<span class="co">%</span></span> -<span id="cb501-6"><a href="#cb501-6" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb501-7"><a href="#cb501-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a header attribute context)}</span> -<span id="cb501-8"><a href="#cb501-8" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb501-9"><a href="#cb501-9" aria-hidden="true"></a> },</span> -<span id="cb501-10"><a href="#cb501-10" aria-hidden="true"></a> headerAttributeContextBegin = {<span class="co">%</span></span> -<span id="cb501-11"><a href="#cb501-11" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb501-12"><a href="#cb501-12" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a header attribute context)}</span> -<span id="cb501-13"><a href="#cb501-13" aria-hidden="true"></a> <span class="fu">\par</span></span> -<span id="cb501-14"><a href="#cb501-14" aria-hidden="true"></a> },</span> -<span id="cb501-15"><a href="#cb501-15" aria-hidden="true"></a> },</span> -<span id="cb501-16"><a href="#cb501-16" aria-hidden="true"></a>}</span> -<span id="cb501-17"><a href="#cb501-17" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb501-18"><a href="#cb501-18" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb501-19"><a href="#cb501-19" aria-hidden="true"></a></span> -<span id="cb501-20"><a href="#cb501-20" aria-hidden="true"></a># First top-level heading</span> -<span id="cb501-21"><a href="#cb501-21" aria-hidden="true"></a></span> -<span id="cb501-22"><a href="#cb501-22" aria-hidden="true"></a>## A subheading {#identifier}</span> -<span id="cb501-23"><a href="#cb501-23" aria-hidden="true"></a></span> -<span id="cb501-24"><a href="#cb501-24" aria-hidden="true"></a># Second top-level heading {.class_name}</span> -<span id="cb501-25"><a href="#cb501-25" aria-hidden="true"></a></span> -<span id="cb501-26"><a href="#cb501-26" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb501-27"><a href="#cb501-27" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb502"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb502-1"><a href="#cb502-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb504"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb504-1"><a href="#cb504-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb504-2"><a href="#cb504-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span> +<span id="cb504-3"><a href="#cb504-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb504-4"><a href="#cb504-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb504-5"><a href="#cb504-5" aria-hidden="true"></a> headerAttributeContextBegin = {<span class="co">%</span></span> +<span id="cb504-6"><a href="#cb504-6" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb504-7"><a href="#cb504-7" aria-hidden="true"></a> <span class="fu">\emph</span>{(The beginning of a header attribute context)}</span> +<span id="cb504-8"><a href="#cb504-8" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb504-9"><a href="#cb504-9" aria-hidden="true"></a> },</span> +<span id="cb504-10"><a href="#cb504-10" aria-hidden="true"></a> headerAttributeContextBegin = {<span class="co">%</span></span> +<span id="cb504-11"><a href="#cb504-11" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb504-12"><a href="#cb504-12" aria-hidden="true"></a> <span class="fu">\emph</span>{(The end of a header attribute context)}</span> +<span id="cb504-13"><a href="#cb504-13" aria-hidden="true"></a> <span class="fu">\par</span></span> +<span id="cb504-14"><a href="#cb504-14" aria-hidden="true"></a> },</span> +<span id="cb504-15"><a href="#cb504-15" aria-hidden="true"></a> },</span> +<span id="cb504-16"><a href="#cb504-16" aria-hidden="true"></a>}</span> +<span id="cb504-17"><a href="#cb504-17" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb504-18"><a href="#cb504-18" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb504-19"><a href="#cb504-19" aria-hidden="true"></a></span> +<span id="cb504-20"><a href="#cb504-20" aria-hidden="true"></a># First top-level heading</span> +<span id="cb504-21"><a href="#cb504-21" aria-hidden="true"></a></span> +<span id="cb504-22"><a href="#cb504-22" aria-hidden="true"></a>## A subheading {#identifier}</span> +<span id="cb504-23"><a href="#cb504-23" aria-hidden="true"></a></span> +<span id="cb504-24"><a href="#cb504-24" aria-hidden="true"></a># Second top-level heading {.class_name}</span> +<span id="cb504-25"><a href="#cb504-25" aria-hidden="true"></a></span> +<span id="cb504-26"><a href="#cb504-26" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb504-27"><a href="#cb504-27" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb505"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb505-1"><a href="#cb505-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <h1 id="first-top-level-heading-1">First top-level heading</h1> @@ -6764,53 +6807,53 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererStrikeThrough</code> macro represents a strike-through span of text. The macro receives a single argument that corresponds to the striked-out span of text. This macro will only be produced, when the <strong><code>strikeThrough</code></strong> option is enabled.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-34">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb503"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb503-1"><a href="#cb503-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb503-2"><a href="#cb503-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span> -<span id="cb503-3"><a href="#cb503-3" aria-hidden="true"></a><span class="fu">\input</span> soulutf8.sty</span> -<span id="cb503-4"><a href="#cb503-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span> -<span id="cb503-5"><a href="#cb503-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb503-6"><a href="#cb503-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb503-7"><a href="#cb503-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb503-8"><a href="#cb503-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb506"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb506-1"><a href="#cb506-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb506-2"><a href="#cb506-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span> +<span id="cb506-3"><a href="#cb506-3" aria-hidden="true"></a><span class="fu">\input</span> soulutf8.sty</span> +<span id="cb506-4"><a href="#cb506-4" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span> +<span id="cb506-5"><a href="#cb506-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb506-6"><a href="#cb506-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb506-7"><a href="#cb506-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb506-8"><a href="#cb506-8" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb504"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb504-1"><a href="#cb504-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb507"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb507-1"><a href="#cb507-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-69"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-70"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb505"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb505-1"><a href="#cb505-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb505-2"><a href="#cb505-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span> -<span id="cb505-3"><a href="#cb505-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span> -<span id="cb505-4"><a href="#cb505-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb505-5"><a href="#cb505-5" aria-hidden="true"></a> renderers = {</span> -<span id="cb505-6"><a href="#cb505-6" aria-hidden="true"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span> -<span id="cb505-7"><a href="#cb505-7" aria-hidden="true"></a> },</span> -<span id="cb505-8"><a href="#cb505-8" aria-hidden="true"></a>}</span> -<span id="cb505-9"><a href="#cb505-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb505-10"><a href="#cb505-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb505-11"><a href="#cb505-11" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb505-12"><a href="#cb505-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb505-13"><a href="#cb505-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb508"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb508-1"><a href="#cb508-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb508-2"><a href="#cb508-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span> +<span id="cb508-3"><a href="#cb508-3" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span> +<span id="cb508-4"><a href="#cb508-4" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb508-5"><a href="#cb508-5" aria-hidden="true"></a> renderers = {</span> +<span id="cb508-6"><a href="#cb508-6" aria-hidden="true"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span> +<span id="cb508-7"><a href="#cb508-7" aria-hidden="true"></a> },</span> +<span id="cb508-8"><a href="#cb508-8" aria-hidden="true"></a>}</span> +<span id="cb508-9"><a href="#cb508-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb508-10"><a href="#cb508-10" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb508-11"><a href="#cb508-11" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb508-12"><a href="#cb508-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb508-13"><a href="#cb508-13" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb506"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb506-1"><a href="#cb506-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb509"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb509-1"><a href="#cb509-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-49">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb507"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb507-1"><a href="#cb507-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb507-2"><a href="#cb507-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span> -<span id="cb507-3"><a href="#cb507-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span> -<span id="cb507-4"><a href="#cb507-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb507-5"><a href="#cb507-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb507-6"><a href="#cb507-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> -<span id="cb507-7"><a href="#cb507-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb507-8"><a href="#cb507-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb510"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb510-1"><a href="#cb510-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb510-2"><a href="#cb510-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span> +<span id="cb510-3"><a href="#cb510-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span> +<span id="cb510-4"><a href="#cb510-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb510-5"><a href="#cb510-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb510-6"><a href="#cb510-6" aria-hidden="true"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span> +<span id="cb510-7"><a href="#cb510-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb510-8"><a href="#cb510-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb508"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb508-1"><a href="#cb508-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb511"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb511-1"><a href="#cb511-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>This is <del>a lunar roving vehicle</del> strike-through text.</p> @@ -6819,51 +6862,51 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererSuperscript</code> macro represents a superscript span of text. The macro receives a single argument that corresponds to the superscript span of text. This macro will only be produced, when the <strong><code>superscripts</code></strong> option is enabled.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-35">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb509"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb509-1"><a href="#cb509-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb509-2"><a href="#cb509-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSuperscripts</span>{true}</span> -<span id="cb509-3"><a href="#cb509-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span> -<span id="cb509-4"><a href="#cb509-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb509-5"><a href="#cb509-5" aria-hidden="true"></a>2^10^ is 1024.</span> -<span id="cb509-6"><a href="#cb509-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb509-7"><a href="#cb509-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb512"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb512-1"><a href="#cb512-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb512-2"><a href="#cb512-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSuperscripts</span>{true}</span> +<span id="cb512-3"><a href="#cb512-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span> +<span id="cb512-4"><a href="#cb512-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb512-5"><a href="#cb512-5" aria-hidden="true"></a>2^10^ is 1024.</span> +<span id="cb512-6"><a href="#cb512-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb512-7"><a href="#cb512-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb510"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb510-1"><a href="#cb510-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb513"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb513-1"><a href="#cb513-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>2 taken to the power of 10 is 1024.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-70"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-71"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb511"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb511-1"><a href="#cb511-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb511-2"><a href="#cb511-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span> -<span id="cb511-3"><a href="#cb511-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb511-4"><a href="#cb511-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb511-5"><a href="#cb511-5" aria-hidden="true"></a> superscript = { taken to the power of #1},</span> -<span id="cb511-6"><a href="#cb511-6" aria-hidden="true"></a> },</span> -<span id="cb511-7"><a href="#cb511-7" aria-hidden="true"></a>}</span> -<span id="cb511-8"><a href="#cb511-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb511-9"><a href="#cb511-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb511-10"><a href="#cb511-10" aria-hidden="true"></a>2^10^ is 1024.</span> -<span id="cb511-11"><a href="#cb511-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb511-12"><a href="#cb511-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb514"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb514-1"><a href="#cb514-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb514-2"><a href="#cb514-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span> +<span id="cb514-3"><a href="#cb514-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb514-4"><a href="#cb514-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb514-5"><a href="#cb514-5" aria-hidden="true"></a> superscript = { taken to the power of #1},</span> +<span id="cb514-6"><a href="#cb514-6" aria-hidden="true"></a> },</span> +<span id="cb514-7"><a href="#cb514-7" aria-hidden="true"></a>}</span> +<span id="cb514-8"><a href="#cb514-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb514-9"><a href="#cb514-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb514-10"><a href="#cb514-10" aria-hidden="true"></a>2^10^ is 1024.</span> +<span id="cb514-11"><a href="#cb514-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb514-12"><a href="#cb514-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb512"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb512-1"><a href="#cb512-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb515"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb515-1"><a href="#cb515-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>2 taken to the power of 10 is 1024.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-50">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb513"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb513-1"><a href="#cb513-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb513-2"><a href="#cb513-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span> -<span id="cb513-3"><a href="#cb513-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span> -<span id="cb513-4"><a href="#cb513-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb513-5"><a href="#cb513-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb513-6"><a href="#cb513-6" aria-hidden="true"></a>2^10^ is 1024.</span> -<span id="cb513-7"><a href="#cb513-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb513-8"><a href="#cb513-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb516"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb516-1"><a href="#cb516-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb516-2"><a href="#cb516-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span> +<span id="cb516-3"><a href="#cb516-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span> +<span id="cb516-4"><a href="#cb516-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb516-5"><a href="#cb516-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb516-6"><a href="#cb516-6" aria-hidden="true"></a>2^10^ is 1024.</span> +<span id="cb516-7"><a href="#cb516-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb516-8"><a href="#cb516-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb514"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb514-1"><a href="#cb514-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb517"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb517-1"><a href="#cb517-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>2 taken to the power of 10 is 1024.</p> @@ -6872,51 +6915,51 @@ Thomas,Edison,1847</code></pre> <p>The <code>\markdownRendererSubscript</code> macro represents a subscript span of text. The macro receives a single argument that corresponds to the subscript span of text. This macro will only be produced, when the <strong><code>subscripts</code></strong> option is enabled.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-36">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb515"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb515-1"><a href="#cb515-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb515-2"><a href="#cb515-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSubscripts</span>{true}</span> -<span id="cb515-3"><a href="#cb515-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span> -<span id="cb515-4"><a href="#cb515-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb515-5"><a href="#cb515-5" aria-hidden="true"></a>H~2~O is a liquid.</span> -<span id="cb515-6"><a href="#cb515-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb515-7"><a href="#cb515-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<div class="sourceCode" id="cb518"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb518-1"><a href="#cb518-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb518-2"><a href="#cb518-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionSubscripts</span>{true}</span> +<span id="cb518-3"><a href="#cb518-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span> +<span id="cb518-4"><a href="#cb518-4" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb518-5"><a href="#cb518-5" aria-hidden="true"></a>H~2~O is a liquid.</span> +<span id="cb518-6"><a href="#cb518-6" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb518-7"><a href="#cb518-7" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb516"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb516-1"><a href="#cb516-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb519"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb519-1"><a href="#cb519-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>H (2 moles) and O is liquid.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-71"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-72"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb517"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb517-1"><a href="#cb517-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb517-2"><a href="#cb517-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span> -<span id="cb517-3"><a href="#cb517-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb517-4"><a href="#cb517-4" aria-hidden="true"></a> renderers = {</span> -<span id="cb517-5"><a href="#cb517-5" aria-hidden="true"></a> subscript = { (#1 moles) and },</span> -<span id="cb517-6"><a href="#cb517-6" aria-hidden="true"></a> },</span> -<span id="cb517-7"><a href="#cb517-7" aria-hidden="true"></a>}</span> -<span id="cb517-8"><a href="#cb517-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb517-9"><a href="#cb517-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb517-10"><a href="#cb517-10" aria-hidden="true"></a>H~2~O is a liquid.</span> -<span id="cb517-11"><a href="#cb517-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb517-12"><a href="#cb517-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<div class="sourceCode" id="cb520"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb520-1"><a href="#cb520-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb520-2"><a href="#cb520-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span> +<span id="cb520-3"><a href="#cb520-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb520-4"><a href="#cb520-4" aria-hidden="true"></a> renderers = {</span> +<span id="cb520-5"><a href="#cb520-5" aria-hidden="true"></a> subscript = { (#1 moles) and },</span> +<span id="cb520-6"><a href="#cb520-6" aria-hidden="true"></a> },</span> +<span id="cb520-7"><a href="#cb520-7" aria-hidden="true"></a>}</span> +<span id="cb520-8"><a href="#cb520-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb520-9"><a href="#cb520-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb520-10"><a href="#cb520-10" aria-hidden="true"></a>H~2~O is a liquid.</span> +<span id="cb520-11"><a href="#cb520-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb520-12"><a href="#cb520-12" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb518"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb518-1"><a href="#cb518-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb521"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb521-1"><a href="#cb521-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>H (2 moles) and O is liquid.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-51">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb519"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb519-1"><a href="#cb519-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb519-2"><a href="#cb519-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span> -<span id="cb519-3"><a href="#cb519-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span> -<span id="cb519-4"><a href="#cb519-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb519-5"><a href="#cb519-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb519-6"><a href="#cb519-6" aria-hidden="true"></a>H~2~O is a liquid.</span> -<span id="cb519-7"><a href="#cb519-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb519-8"><a href="#cb519-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<div class="sourceCode" id="cb522"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb522-1"><a href="#cb522-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb522-2"><a href="#cb522-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span> +<span id="cb522-3"><a href="#cb522-3" aria-hidden="true"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span> +<span id="cb522-4"><a href="#cb522-4" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb522-5"><a href="#cb522-5" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb522-6"><a href="#cb522-6" aria-hidden="true"></a>H~2~O is a liquid.</span> +<span id="cb522-7"><a href="#cb522-7" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb522-8"><a href="#cb522-8" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> <p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb520"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb520-1"><a href="#cb520-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb523"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb523-1"><a href="#cb523-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>H (2 moles) and O is liquid.</p> @@ -6925,52 +6968,52 @@ Thomas,Edison,1847</code></pre> <p>By default, token renderers point to package-defined <span class="tex">T<sub>e</sub>X</span> macros, further referred to as <em>prototypes</em>, which provide useful default definitions.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-37">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb521"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb521-1"><a href="#cb521-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb521-2"><a href="#cb521-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span> -<span id="cb521-3"><a href="#cb521-3" aria-hidden="true"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span> -<span id="cb521-4"><a href="#cb521-4" aria-hidden="true"></a>}</span> -<span id="cb521-5"><a href="#cb521-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb521-6"><a href="#cb521-6" aria-hidden="true"></a>~</span> -<span id="cb521-7"><a href="#cb521-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb521-8"><a href="#cb521-8" aria-hidden="true"></a></span> -<span id="cb521-9"><a href="#cb521-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span> -<span id="cb521-10"><a href="#cb521-10" aria-hidden="true"></a> User-defined token renderers take precedence.<span class="co">%</span></span> -<span id="cb521-11"><a href="#cb521-11" aria-hidden="true"></a>}</span> -<span id="cb521-12"><a href="#cb521-12" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb521-13"><a href="#cb521-13" aria-hidden="true"></a>~</span> -<span id="cb521-14"><a href="#cb521-14" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb521-15"><a href="#cb521-15" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb522"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb522-1"><a href="#cb522-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb524"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb524-1"><a href="#cb524-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb524-2"><a href="#cb524-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span> +<span id="cb524-3"><a href="#cb524-3" aria-hidden="true"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span> +<span id="cb524-4"><a href="#cb524-4" aria-hidden="true"></a>}</span> +<span id="cb524-5"><a href="#cb524-5" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb524-6"><a href="#cb524-6" aria-hidden="true"></a>~</span> +<span id="cb524-7"><a href="#cb524-7" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb524-8"><a href="#cb524-8" aria-hidden="true"></a></span> +<span id="cb524-9"><a href="#cb524-9" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span> +<span id="cb524-10"><a href="#cb524-10" aria-hidden="true"></a> User-defined token renderers take precedence.<span class="co">%</span></span> +<span id="cb524-11"><a href="#cb524-11" aria-hidden="true"></a>}</span> +<span id="cb524-12"><a href="#cb524-12" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb524-13"><a href="#cb524-13" aria-hidden="true"></a>~</span> +<span id="cb524-14"><a href="#cb524-14" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb524-15"><a href="#cb524-15" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb525"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb525-1"><a href="#cb525-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Packages can specify token renderer prototypes.</p> <p>User-defined token renderers take precedence.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-72"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<h5 class="unnumbered" data-number="" id="latex-example-73"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb523"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb523-1"><a href="#cb523-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb523-2"><a href="#cb523-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> -<span id="cb523-3"><a href="#cb523-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb523-4"><a href="#cb523-4" aria-hidden="true"></a> rendererPrototypes = {</span> -<span id="cb523-5"><a href="#cb523-5" aria-hidden="true"></a> tilde = {Packages can specify token renderer prototypes.},</span> -<span id="cb523-6"><a href="#cb523-6" aria-hidden="true"></a> },</span> -<span id="cb523-7"><a href="#cb523-7" aria-hidden="true"></a>}</span> -<span id="cb523-8"><a href="#cb523-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb523-9"><a href="#cb523-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb523-10"><a href="#cb523-10" aria-hidden="true"></a>~</span> -<span id="cb523-11"><a href="#cb523-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb523-12"><a href="#cb523-12" aria-hidden="true"></a></span> -<span id="cb523-13"><a href="#cb523-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> -<span id="cb523-14"><a href="#cb523-14" aria-hidden="true"></a> renderers = {</span> -<span id="cb523-15"><a href="#cb523-15" aria-hidden="true"></a> tilde = {User-defined token renderers take precedence.},</span> -<span id="cb523-16"><a href="#cb523-16" aria-hidden="true"></a> },</span> -<span id="cb523-17"><a href="#cb523-17" aria-hidden="true"></a>}</span> -<span id="cb523-18"><a href="#cb523-18" aria-hidden="true"></a>~</span> -<span id="cb523-19"><a href="#cb523-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> -<span id="cb523-20"><a href="#cb523-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb524"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb524-1"><a href="#cb524-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb526"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb526-1"><a href="#cb526-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb526-2"><a href="#cb526-2" aria-hidden="true"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span> +<span id="cb526-3"><a href="#cb526-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb526-4"><a href="#cb526-4" aria-hidden="true"></a> rendererPrototypes = {</span> +<span id="cb526-5"><a href="#cb526-5" aria-hidden="true"></a> tilde = {Packages can specify token renderer prototypes.},</span> +<span id="cb526-6"><a href="#cb526-6" aria-hidden="true"></a> },</span> +<span id="cb526-7"><a href="#cb526-7" aria-hidden="true"></a>}</span> +<span id="cb526-8"><a href="#cb526-8" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb526-9"><a href="#cb526-9" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb526-10"><a href="#cb526-10" aria-hidden="true"></a>~</span> +<span id="cb526-11"><a href="#cb526-11" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb526-12"><a href="#cb526-12" aria-hidden="true"></a></span> +<span id="cb526-13"><a href="#cb526-13" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown*</span>}{</span> +<span id="cb526-14"><a href="#cb526-14" aria-hidden="true"></a> renderers = {</span> +<span id="cb526-15"><a href="#cb526-15" aria-hidden="true"></a> tilde = {User-defined token renderers take precedence.},</span> +<span id="cb526-16"><a href="#cb526-16" aria-hidden="true"></a> },</span> +<span id="cb526-17"><a href="#cb526-17" aria-hidden="true"></a>}</span> +<span id="cb526-18"><a href="#cb526-18" aria-hidden="true"></a>~</span> +<span id="cb526-19"><a href="#cb526-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown*</span>}</span> +<span id="cb526-20"><a href="#cb526-20" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb527"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb527-1"><a href="#cb527-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Packages can specify token renderer prototypes.</p> @@ -6978,24 +7021,24 @@ Thomas,Edison,1847</code></pre> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-52">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb525"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb525-1"><a href="#cb525-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb525-2"><a href="#cb525-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span> -<span id="cb525-3"><a href="#cb525-3" aria-hidden="true"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span> -<span id="cb525-4"><a href="#cb525-4" aria-hidden="true"></a>}</span> -<span id="cb525-5"><a href="#cb525-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb525-6"><a href="#cb525-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb525-7"><a href="#cb525-7" aria-hidden="true"></a>~</span> -<span id="cb525-8"><a href="#cb525-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb525-9"><a href="#cb525-9" aria-hidden="true"></a></span> -<span id="cb525-10"><a href="#cb525-10" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span> -<span id="cb525-11"><a href="#cb525-11" aria-hidden="true"></a> User-defined token renderers take precedence.<span class="co">%</span></span> -<span id="cb525-12"><a href="#cb525-12" aria-hidden="true"></a>}</span> -<span id="cb525-13"><a href="#cb525-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb525-14"><a href="#cb525-14" aria-hidden="true"></a>~</span> -<span id="cb525-15"><a href="#cb525-15" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb525-16"><a href="#cb525-16" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb526"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb526-1"><a href="#cb526-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb528"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb528-1"><a href="#cb528-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb528-2"><a href="#cb528-2" aria-hidden="true"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span> +<span id="cb528-3"><a href="#cb528-3" aria-hidden="true"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span> +<span id="cb528-4"><a href="#cb528-4" aria-hidden="true"></a>}</span> +<span id="cb528-5"><a href="#cb528-5" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb528-6"><a href="#cb528-6" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb528-7"><a href="#cb528-7" aria-hidden="true"></a>~</span> +<span id="cb528-8"><a href="#cb528-8" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb528-9"><a href="#cb528-9" aria-hidden="true"></a></span> +<span id="cb528-10"><a href="#cb528-10" aria-hidden="true"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span> +<span id="cb528-11"><a href="#cb528-11" aria-hidden="true"></a> User-defined token renderers take precedence.<span class="co">%</span></span> +<span id="cb528-12"><a href="#cb528-12" aria-hidden="true"></a>}</span> +<span id="cb528-13"><a href="#cb528-13" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb528-14"><a href="#cb528-14" aria-hidden="true"></a>~</span> +<span id="cb528-15"><a href="#cb528-15" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb528-16"><a href="#cb528-16" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb529"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb529-1"><a href="#cb529-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Packages can specify token renderer prototypes.</p> @@ -7005,86 +7048,86 @@ Thomas,Edison,1847</code></pre> <p>By default, the renderer prototypes for YAML metadata provide a high-level interface that can be programmed using the <code>markdown/jekyllData</code> key–values from the l3keys module of the 3 kernel.</p> <h5 class="unnumbered" data-number="" id="plain-tex-example-38">Plain <span class="tex">T<sub>e</sub>X</span> Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb527"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb527-1"><a href="#cb527-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> -<span id="cb527-2"><a href="#cb527-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> -<span id="cb527-3"><a href="#cb527-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> -<span id="cb527-4"><a href="#cb527-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> -<span id="cb527-5"><a href="#cb527-5" aria-hidden="true"></a> { markdown/jekyllData }</span> -<span id="cb527-6"><a href="#cb527-6" aria-hidden="true"></a> {</span> -<span id="cb527-7"><a href="#cb527-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> -<span id="cb527-8"><a href="#cb527-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> -<span id="cb527-9"><a href="#cb527-9" aria-hidden="true"></a> }</span> -<span id="cb527-10"><a href="#cb527-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> -<span id="cb527-11"><a href="#cb527-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb527-12"><a href="#cb527-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb527-13"><a href="#cb527-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> -<span id="cb527-14"><a href="#cb527-14" aria-hidden="true"></a>---</span> -<span id="cb527-15"><a href="#cb527-15" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb527-16"><a href="#cb527-16" aria-hidden="true"></a>age: 99</span> -<span id="cb527-17"><a href="#cb527-17" aria-hidden="true"></a>---</span> -<span id="cb527-18"><a href="#cb527-18" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> -<span id="cb527-19"><a href="#cb527-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb528"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb528-1"><a href="#cb528-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb530"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb530-1"><a href="#cb530-1" aria-hidden="true"></a><span class="fu">\input</span> markdown</span> +<span id="cb530-2"><a href="#cb530-2" aria-hidden="true"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span> +<span id="cb530-3"><a href="#cb530-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> +<span id="cb530-4"><a href="#cb530-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> +<span id="cb530-5"><a href="#cb530-5" aria-hidden="true"></a> { markdown/jekyllData }</span> +<span id="cb530-6"><a href="#cb530-6" aria-hidden="true"></a> {</span> +<span id="cb530-7"><a href="#cb530-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> +<span id="cb530-8"><a href="#cb530-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> +<span id="cb530-9"><a href="#cb530-9" aria-hidden="true"></a> }</span> +<span id="cb530-10"><a href="#cb530-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> +<span id="cb530-11"><a href="#cb530-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb530-12"><a href="#cb530-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb530-13"><a href="#cb530-13" aria-hidden="true"></a><span class="fu">\markdownBegin</span></span> +<span id="cb530-14"><a href="#cb530-14" aria-hidden="true"></a>---</span> +<span id="cb530-15"><a href="#cb530-15" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb530-16"><a href="#cb530-16" aria-hidden="true"></a>age: 99</span> +<span id="cb530-17"><a href="#cb530-17" aria-hidden="true"></a>---</span> +<span id="cb530-18"><a href="#cb530-18" aria-hidden="true"></a><span class="fu">\markdownEnd</span></span> +<span id="cb530-19"><a href="#cb530-19" aria-hidden="true"></a><span class="fu">\bye</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb531"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb531-1"><a href="#cb531-1" aria-hidden="true"></a><span class="ex">luatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> -<h5 class="unnumbered" data-number="" id="latex-example-73"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> -<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb529"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb529-1"><a href="#cb529-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> -<span id="cb529-2"><a href="#cb529-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> -<span id="cb529-3"><a href="#cb529-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> -<span id="cb529-4"><a href="#cb529-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> -<span id="cb529-5"><a href="#cb529-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> -<span id="cb529-6"><a href="#cb529-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> -<span id="cb529-7"><a href="#cb529-7" aria-hidden="true"></a> },</span> -<span id="cb529-8"><a href="#cb529-8" aria-hidden="true"></a> renderers = {</span> -<span id="cb529-9"><a href="#cb529-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> -<span id="cb529-10"><a href="#cb529-10" aria-hidden="true"></a> }</span> -<span id="cb529-11"><a href="#cb529-11" aria-hidden="true"></a>}</span> -<span id="cb529-12"><a href="#cb529-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> -<span id="cb529-13"><a href="#cb529-13" aria-hidden="true"></a></span> -<span id="cb529-14"><a href="#cb529-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> -<span id="cb529-15"><a href="#cb529-15" aria-hidden="true"></a>---</span> -<span id="cb529-16"><a href="#cb529-16" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb529-17"><a href="#cb529-17" aria-hidden="true"></a>age: 99</span> -<span id="cb529-18"><a href="#cb529-18" aria-hidden="true"></a>---</span> -<span id="cb529-19"><a href="#cb529-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> -<span id="cb529-20"><a href="#cb529-20" aria-hidden="true"></a></span> -<span id="cb529-21"><a href="#cb529-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb530"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb530-1"><a href="#cb530-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> +<h5 class="unnumbered" data-number="" id="latex-example-74"><span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5> +<p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> +<div class="sourceCode" id="cb532"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb532-1"><a href="#cb532-1" aria-hidden="true"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span> +<span id="cb532-2"><a href="#cb532-2" aria-hidden="true"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span> +<span id="cb532-3"><a href="#cb532-3" aria-hidden="true"></a><span class="fu">\markdownSetup</span>{</span> +<span id="cb532-4"><a href="#cb532-4" aria-hidden="true"></a> jekyllDataRenderers = {</span> +<span id="cb532-5"><a href="#cb532-5" aria-hidden="true"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span> +<span id="cb532-6"><a href="#cb532-6" aria-hidden="true"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span> +<span id="cb532-7"><a href="#cb532-7" aria-hidden="true"></a> },</span> +<span id="cb532-8"><a href="#cb532-8" aria-hidden="true"></a> renderers = {</span> +<span id="cb532-9"><a href="#cb532-9" aria-hidden="true"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span> +<span id="cb532-10"><a href="#cb532-10" aria-hidden="true"></a> }</span> +<span id="cb532-11"><a href="#cb532-11" aria-hidden="true"></a>}</span> +<span id="cb532-12"><a href="#cb532-12" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span> +<span id="cb532-13"><a href="#cb532-13" aria-hidden="true"></a></span> +<span id="cb532-14"><a href="#cb532-14" aria-hidden="true"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span> +<span id="cb532-15"><a href="#cb532-15" aria-hidden="true"></a>---</span> +<span id="cb532-16"><a href="#cb532-16" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb532-17"><a href="#cb532-17" aria-hidden="true"></a>age: 99</span> +<span id="cb532-18"><a href="#cb532-18" aria-hidden="true"></a>---</span> +<span id="cb532-19"><a href="#cb532-19" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span> +<span id="cb532-20"><a href="#cb532-20" aria-hidden="true"></a></span> +<span id="cb532-21"><a href="#cb532-21" aria-hidden="true"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb533"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb533-1"><a href="#cb533-1" aria-hidden="true"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> </blockquote> <h5 class="unnumbered" data-number="" id="context-example-53">Con<span class="tex">T<sub>e</sub>X</span>t Example</h5> <p>Using a text editor, create a text document named <code>document.tex</code> with the following content:</p> -<div class="sourceCode" id="cb531"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb531-1"><a href="#cb531-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> -<span id="cb531-2"><a href="#cb531-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> -<span id="cb531-3"><a href="#cb531-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> -<span id="cb531-4"><a href="#cb531-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> -<span id="cb531-5"><a href="#cb531-5" aria-hidden="true"></a> { markdown/jekyllData }</span> -<span id="cb531-6"><a href="#cb531-6" aria-hidden="true"></a> {</span> -<span id="cb531-7"><a href="#cb531-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> -<span id="cb531-8"><a href="#cb531-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> -<span id="cb531-9"><a href="#cb531-9" aria-hidden="true"></a> }</span> -<span id="cb531-10"><a href="#cb531-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> -<span id="cb531-11"><a href="#cb531-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> -<span id="cb531-12"><a href="#cb531-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> -<span id="cb531-13"><a href="#cb531-13" aria-hidden="true"></a><span class="fu">\starttext</span></span> -<span id="cb531-14"><a href="#cb531-14" aria-hidden="true"></a></span> -<span id="cb531-15"><a href="#cb531-15" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> -<span id="cb531-16"><a href="#cb531-16" aria-hidden="true"></a>---</span> -<span id="cb531-17"><a href="#cb531-17" aria-hidden="true"></a>name: Jane Doe</span> -<span id="cb531-18"><a href="#cb531-18" aria-hidden="true"></a>age: 99</span> -<span id="cb531-19"><a href="#cb531-19" aria-hidden="true"></a>---</span> -<span id="cb531-20"><a href="#cb531-20" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> -<span id="cb531-21"><a href="#cb531-21" aria-hidden="true"></a></span> -<span id="cb531-22"><a href="#cb531-22" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> -<p>Next, invoke LuaTeX from the terminal:</p> -<div class="sourceCode" id="cb532"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb532-1"><a href="#cb532-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> +<div class="sourceCode" id="cb534"><pre class="sourceCode tex"><code class="sourceCode latex"><span id="cb534-1"><a href="#cb534-1" aria-hidden="true"></a><span class="fu">\usemodule</span>[t][markdown]</span> +<span id="cb534-2"><a href="#cb534-2" aria-hidden="true"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span> +<span id="cb534-3"><a href="#cb534-3" aria-hidden="true"></a><span class="fu">\ExplSyntaxOn</span></span> +<span id="cb534-4"><a href="#cb534-4" aria-hidden="true"></a><span class="fu">\keys</span>_define:nn</span> +<span id="cb534-5"><a href="#cb534-5" aria-hidden="true"></a> { markdown/jekyllData }</span> +<span id="cb534-6"><a href="#cb534-6" aria-hidden="true"></a> {</span> +<span id="cb534-7"><a href="#cb534-7" aria-hidden="true"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span> +<span id="cb534-8"><a href="#cb534-8" aria-hidden="true"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span> +<span id="cb534-9"><a href="#cb534-9" aria-hidden="true"></a> }</span> +<span id="cb534-10"><a href="#cb534-10" aria-hidden="true"></a><span class="fu">\ExplSyntaxOff</span></span> +<span id="cb534-11"><a href="#cb534-11" aria-hidden="true"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span> +<span id="cb534-12"><a href="#cb534-12" aria-hidden="true"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span> +<span id="cb534-13"><a href="#cb534-13" aria-hidden="true"></a><span class="fu">\starttext</span></span> +<span id="cb534-14"><a href="#cb534-14" aria-hidden="true"></a></span> +<span id="cb534-15"><a href="#cb534-15" aria-hidden="true"></a><span class="fu">\startmarkdown</span></span> +<span id="cb534-16"><a href="#cb534-16" aria-hidden="true"></a>---</span> +<span id="cb534-17"><a href="#cb534-17" aria-hidden="true"></a>name: Jane Doe</span> +<span id="cb534-18"><a href="#cb534-18" aria-hidden="true"></a>age: 99</span> +<span id="cb534-19"><a href="#cb534-19" aria-hidden="true"></a>---</span> +<span id="cb534-20"><a href="#cb534-20" aria-hidden="true"></a><span class="fu">\stopmarkdown</span></span> +<span id="cb534-21"><a href="#cb534-21" aria-hidden="true"></a></span> +<span id="cb534-22"><a href="#cb534-22" aria-hidden="true"></a><span class="fu">\stoptext</span></span></code></pre></div> +<p>Next, invoke LuaTeX from the terminal:</p> +<div class="sourceCode" id="cb535"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb535-1"><a href="#cb535-1" aria-hidden="true"></a><span class="ex">context</span> document.tex</span></code></pre></div> <p>A PDF document named <code>document.pdf</code> should be produced and contain the following text:</p> <blockquote> <p>Jane Doe is 99 years old.</p> diff --git a/macros/generic/markdown/markdown.pdf b/macros/generic/markdown/markdown.pdf Binary files differindex 16469cf1fa..b3ab782400 100644 --- a/macros/generic/markdown/markdown.pdf +++ b/macros/generic/markdown/markdown.pdf diff --git a/macros/generic/simplekv/README b/macros/generic/simplekv/README index 1172bd96a6..429e2f88d2 100644 --- a/macros/generic/simplekv/README +++ b/macros/generic/simplekv/README @@ -3,9 +3,9 @@ ___________________________________ L'extension simplekv - v0.2 + v0.2a - 27 avril 2020 + 1er octobre 2022 ___________________________________ Authors : Christian Tellechea diff --git a/macros/generic/simplekv/simplekv-fr.pdf b/macros/generic/simplekv/simplekv-fr.pdf Binary files differindex 950d64baa1..8ef85109e1 100644 --- a/macros/generic/simplekv/simplekv-fr.pdf +++ b/macros/generic/simplekv/simplekv-fr.pdf diff --git a/macros/generic/simplekv/simplekv-fr.tex b/macros/generic/simplekv/simplekv-fr.tex index e23a0ae078..70290c7fb7 100644 --- a/macros/generic/simplekv/simplekv-fr.tex +++ b/macros/generic/simplekv/simplekv-fr.tex @@ -1,15 +1,14 @@ -% !TeX encoding = ISO-8859-1 -% Ceci est la documentation du package "hlist" +% !TeX TS-program = lualatex +% !TeX encoding = UTF-8 +% Ceci est la documentation du package "simplekv" % -% Fichier compil avec pdflatex \documentclass[french,a4paper,10pt]{article} -\usepackage[latin1]{inputenc} -\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} \usepackage[margin=2cm]{geometry} \usepackage[bottom]{footmisc} -\usepackage{libertine,boites,tikz,enumitem,MnSymbol,babel,xspace,listings,simplekv} -\usepackage[scaled=0.8]{luximono} -\frenchbsetup{og=,fg=} +\usepackage{libertine,boites,tikz,enumitem,babel,xspace,listings,simplekv,hyperref} +\usepackage[scaled=0.8]{GoMono} +\frenchbsetup{og=«,fg=»} \def\eTeX{\hbox{$\varepsilon$-\TeX}} \def\SKV{\texttt{\skvname}\xspace} \makeatletter @@ -103,7 +102,7 @@ \catcode`\<13 \catcode`\>13 \def<{\begingroup$\langle$\itshape}\def>{\/$\rangle$\endgroup}% \@ifstar\@sverb\@verb} \endgroup -\def\longfrhlstdate@i#1/#2/#3\@nil{\number#3\relax\space \ifcase#2 \or janvier\or fvrier\or mars\or avril\or mai\or juin\or juillet\or aout\or septembre\or octobre\or novembre\or dcembre\fi\space#1} +\def\longfrhlstdate@i#1/#2/#3\@nil{\number#3\relax\space \ifcase#2 \or janvier\or février\or mars\or avril\or mai\or juin\or juillet\or aout\or septembre\or octobre\or novembre\or décembre\fi\space#1} \edef\longfrhlstdate{\expandafter\longfrhlstdate@i\skvdate\@nil} \def\<#1>{$\langle$\textit{#1}$\rangle$} \makeatother @@ -126,58 +125,62 @@ \endgroup \vskip2cm \leftskip=.2\linewidth \rightskip=.2\linewidth \small - Cette petite extension est une implmentation d'un systme dit \<cls>/\<valeurs> pour \TeX{} ou \LaTeX. Elle comporte juste l'essentiel, aucune fioriture inutile n'a t code et aucune extension tierce n'est ncessaire son fonctionnement. + Cette petite extension est une implémentation d'un système dit à «\<clés>/\<valeurs>» pour \TeX{} ou \LaTeX. Elle comporte juste l'essentiel, aucune fioriture inutile n'a été codée et aucune extension tierce n'est nécessaire à son fonctionnement. \end{titlepage} -\section{Cls, valeurs} -Lorsqu'une macro doit recevoir des paramtres dont le nombre n'est pas fixe ou connu, il est commode de procder par \<cls> et \<valeurs>. +Cette petite extension se veut minimaliste. Trop sans doute puisqu'on ne la juge pas au niveau d'autres, jugées plus « \href{https://tex.stackexchange.com/questions/560014/}{sérieuses}\footnote{C'est ainsi que Joseph Wright, qu'il ne faut prier pour me savonner la planche, la qualifie. C'est que sur TeX.stackexchange, on est entre-soi, c'est-à-dire entre experts raisonnables qui savent de quoi ils parlent. On fait mine de s'étonner et on réprimande, tel un enfant qui ne sait pas ce qu'il fait, un utilisateur qui vient s'enquérir du fonctionnement de simplekv ! Ce genre de sous-package est mal vu et indésirable là bas, il faut vite faire rentrer dans le rang la brebis égarée.}.» + +Quoiqu'il en soit, simplekv a le mérite d'exister et se veut à l'opposé des usines à gaz que l'on peut trouver dans cet exercices de style. Elle est écrite en \TeX{}, fonctionne donc sous tous les moteurs et ne requiert aucun package. + +\section{Clés, valeurs} +Lorsqu'une macro doit recevoir des paramètres dont le nombre n'est pas fixe ou connu, il est commode de procéder par \<clés> et \<valeurs>. \medskip -Voici brivement les dfinitions et les limitations des structures mises disposition : +Voici brièvement les définitions et les limitations des structures mises à disposition : \begin{itemize} - \item une \<cl> est un mot dsignant un paramtre; il est form de prfrence avec des caractres de code de catgorie 11 (lettres), 12 (autres caractres sauf la virgule et le signe \verb|=|) et 10 (l'espace). On peut cependant y mettre des caractres ayant d'autres codes de catgorie, dans la limitation de ce qui est admis dans la primitive \verb|\detokenize|; une \<cl>, mme si cela revt peu de signification, peut tre vide; - \item la syntaxe pour assigner une \<valeur> une \<cl> est : \hbox{\<cl>=\<valeur>}; - \item les espaces qui prcdent et qui suivent la \<cl> et la \<valeur> sont ignors, mais \emph{pas ceux} qui se trouvent l'intrieur de la \<cl> ou de la \<valeur>; + \item une \<clé> est un mot désignant un paramètre; il est formé de préférence avec des caractères de code de catégorie 11 (lettres), 12 (autres caractères sauf la virgule et le signe \verb|=|) et 10 (l'espace). On peut cependant y mettre des caractères ayant d'autres codes de catégorie, dans la limitation de ce qui est admis dans la primitive \verb|\detokenize|; une \<clé>, même si cela revêt peu de signification, peut être vide; + \item la syntaxe pour assigner une \<valeur> à une \<clé> est : \hbox{\<clé>=\<valeur>}; + \item les espaces qui précèdent et qui suivent la \<clé> et la \<valeur> sont ignorés, mais \emph{pas ceux} qui se trouvent à l'intérieur de la \<clé> ou de la \<valeur>; \item une \<valeur> est un \<code> arbitraire; - \item si une \<valeur> est entoure d'accolades, ces dernires seront retires : \verb|<cl>=<valeur>| est donc quivalent \verb|<cl>={<valeur>}|; - \item lorsqu'une valeur est entoure de \emph{plusieurs} imbrications d'accolades, seul le niveau externe est retir et donc \verb|<cl>={{<valeur>}}| est compris comme \verb|<cl>={<valeur>}|; - \item lorsque plusieurs couples de \<cls>/\<valeurs> doivent tre spcifis, ils sont spars les uns des autres par des virgules; - \item une virgule ne peut figurer dans une \<valeur> que si la virgule est dans un niveau d'accolades; par exemple, \verb|foo=1,5| n'est pas valide car la \<valeur> s'tend jusqu'au 1. Il faudrait crire \verb|foo={1,5}| pour spcifier une valeur de \verb|1,5|; - \item les \<valeurs> sont stockes \emph{telles qu'elles sont lues} ; en particulier, aucun dveloppement n'est effectu; - \item les dfinitions sont \emph{locales} : par consquent, toute \<cl> dfinie ou modifie dans un groupe est restaure son tat antrieur la sortie du groupe; - \item des \<cl>/\<valeurs> destines une mme macro ou un mme usage doivent tre regroupes dans un ensemble dont on choisit le nom. Un tel ensemble est appel \<trousseau>. + \item si une \<valeur> est entourée d'accolades, ces dernières seront retirées : \verb|<clé>=<valeur>| est donc équivalent à \verb|<clé>={<valeur>}|; + \item lorsqu'une valeur est entourée de \emph{plusieurs} imbrications d'accolades, seul le niveau externe est retiré et donc \verb|<clé>={{<valeur>}}| est compris comme \verb|<clé>={<valeur>}|; (un bug antérieur à la version 0.2a faisait que ce dernier point n'était pas vrai) + \item lorsque plusieurs couples de \<clés>/\<valeurs> doivent être spécifiés, ils sont séparés les uns des autres par des virgules; + \item une virgule ne peut figurer dans une \<valeur> que si la virgule est entre accolades; par exemple, \verb|foo=1,5| n'est pas valide car la \<valeur> s'étend jusqu'au 1. Il faudrait écrire \verb|foo={1,5}| pour spécifier une valeur de \verb|1,5|; + \item les \<valeurs> sont stockées \emph{telles qu'elles sont lues} ; en particulier, aucun développement n'est effectué; + \item les définitions sont \emph{locales} : par conséquent, toute \<clé> définie ou modifiée dans un groupe est restaurée à son état antérieur à la sortie du groupe; + \item des \<clé>/\<valeurs> destinées à une même macro ou à un même usage doivent être regroupées dans un ensemble dont on choisit le nom. Un tel ensemble est appelé \<trousseau>. \end{itemize} -\section{Commandes mises disposition} +\section{Commandes mises à disposition} -\paragraph{Les macro \texttt{\char`\\setKV} et \texttt{\char`\\setKVdefault}} -Ces commandes dfinissent des \<cls> et leur assignent des \<valeurs> dans un \<trousseau>. La seule diffrence entre les deux macros est que \verb|\setKVdefault|, en plus d'assigner les \<valeurs> aux \<cls>, les sauvegarde en vue d'une restauration ultrieure avec \verb|\restoreKV|. +\paragraph{Les macros \texttt{\char`\\setKV} et \texttt{\char`\\setKVdefault}} +Ces commandes définissent des \<clés> et leur assignent des \<valeurs> dans un \<trousseau>. La seule différence entre les deux macros est que \verb|\setKVdefault|, en plus d'assigner les \<valeurs> aux \<clés>, les sauvegarde en vue d'une restauration ultérieure avec \verb|\restoreKV|. -On crit -\code|\setKV[<trousseau>]{<cl 1>=<valeur 1>,<cl 2>=<valeur 2>,...,<cl n>=<valeur n>}| +On écrit +\code|\setKV[<trousseau>]{<clé 1>=<valeur 1>,<clé 2>=<valeur 2>,...,<clé n>=<valeur n>}| Il faut noter que \begin{itemize} - \item l'argument entre accolades contenant les \<cls> et les \<valeurs> ne devrait pas tre vide, sauf vouloir dfinir une \<cl> boolenne vide gale \texttt{true}; - \item lors de la lecture des \<cls>/\<valeurs>, la virgule et le signe gal ont leurs catcodes rendus gaux 12; - \item le nom du \<trousseau>, bien qu'entre crochet, est \emph{obligatoire}, mais il peut tre vide bien que cela ne soit pas conseill; - \item si une mme \<cl> figure plusieurs fois, la \<valeur> retenue sera celle de la dernire assignation; - \item les \<valeurs> peuvent tre boolennes auquel cas, elles \emph{doivent} tre \texttt{true} ou \texttt{false} en caractres de catcode 11; - \item si une \<valeur> est omise, elle est comprise comme tant \texttt{true}. Ainsi, crire + \item l'argument entre accolades contenant les \<clés> et les \<valeurs> ne devrait pas être vide, sauf à vouloir définir une \<clé> booléenne vide égale à \texttt{true}; + \item lors de la lecture des \<clés>/\<valeurs>, la virgule et le signe égal doivent avoir un catcode de 12 sans quoi ils ne seront pas compris comme frontières entre \<clés> et \<valeurs> et ne joueront pas leur rôle; + \item le nom du \<trousseau>, bien qu'entre crochet, est \emph{obligatoire}, mais il peut être vide bien que cela ne soit pas conseillé; + \item si une même \<clé> figure plusieurs fois, la \<valeur> retenue sera celle de la dernière assignation; + \item les \<valeurs> peuvent être booléennes auquel cas, elles \emph{doivent} être «\texttt{true}» ou «\texttt{false}» en caractères de catcode 11; + \item si une \<valeur> est omise, elle est comprise comme étant «\texttt{true}». Ainsi, écrire \code|\setKV[foo]{mon bool}| - est quivalent + est équivalent à \code|\setKV[foo]{mon bool = true}| \end{itemize} \paragraph{La macro \texttt{\char`\\useKV}} -Cette macro purement dveloppable renvoie la \<valeur> pralablement associe une \<cl> dans un \<trousseau>: - \code|\useKV[<trousseau>]{<cl>}| +Cette macro purement développable renvoie la \<valeur> préalablement associée à une \<clé> dans un \<trousseau>: + \code|\useKV[<trousseau>]{<clé>}| Il faut noter que \begin{itemize} - \item si la \<cl> n'a pas t dfinie, une erreur sera mise; - \item si la \<cl> est boolenne, le texte \texttt{true} ou \texttt{false} sera renvoy; - \item il faut 2 dveloppements \verb|\useKV[<trousseau>]{<cl>}| pour donner la \<valeur> associe la \<cl>. + \item si la \<clé> n'a pas été définie, une erreur sera émise (un bug faisait que ce n'était pas le cas avant la version 0.2a); + \item si la \<clé> est booléenne, le texte «\texttt{true}» ou «\texttt{false}» sera renvoyé; + \item il faut 2 développements à \verb|\useKV[<trousseau>]{<clé>}| pour donner la \<valeur> associée à la \<clé>. \end{itemize} \exemple|\setKV[foo]{nombre = 5 , lettres= AB \textit{CD} , mon bool} @@ -187,66 +190,66 @@ a) \useKV[foo]{nombre}.\qquad b) \useKV[foo]{lettres}.\qquad c) \useKV[foo]{ a) \useKV[foo]{nombre}.\qquad b) \useKV[foo]{lettres}.\qquad c) \useKV[foo]{mon bool}.| \paragraph{La macro \texttt{\char`\\restoreKV}} -La macro \verb|\restoreKV[<trousseau>]| rinitialise toutes les \<cls> du \<trousseau> aux \<valeurs> qui ont t dfinies lors de l'excution \verb|\setKVdefault|. La macro \verb|\useKVdefault[<trousseau>]| lui est quivalente. +La macro \verb|\restoreKV[<trousseau>]| réinitialise toutes les \<clés> du \<trousseau> aux \<valeurs> qui ont été définies lors de l'exécution \verb|\setKVdefault|. La macro \verb|\useKVdefault[<trousseau>]| lui est équivalente. \paragraph{La macro \texttt{\char`\\ifboolKV}} -Cette macro permet, selon la valeur d'une \<cl boolenne>, d'excuter un des deux \<codes> donns. La syntaxe est - \code|\ifboolKV[<trousseau>]{<cl>}{<code si "true">}{<code si "false>}| +Cette macro permet, selon la valeur d'une \<clé booléenne>, d'exécuter un des deux \<codes> donnés. La syntaxe est + \code|\ifboolKV[<trousseau>]{<clé>}{<code si "true">}{<code si "false>}| -La macro est purement dveloppable, elle ncessite 2 dveloppements pour donner l'un des deux codes, et exige que la \<cl> soit boolenne sans quoi un message d'erreur est mis. +La macro est purement développable, elle nécessite 2 développements pour donner l'un des deux codes, et exige que la \<clé> soit booléenne sans quoi un message d'erreur est émis. \paragraph{La macro \texttt{\char`\\showKV}} -Cette commande crit dans le fichier \texttt{log} la \<valeur> assigne une \<cl> d'un \<trousseau>: - \code|\showKV[<trousseau>]{<cl>}| +Cette commande écrit dans le fichier \texttt{log} la \<valeur> assignée à une \<clé> d'un \<trousseau>: + \code|\showKV[<trousseau>]{<clé>}| -Si la \<cl> n'est pas dfinie, \texttt{not defined} est affich dans le fichier log. +Si la \<clé> n'est pas définie, «\texttt{not defined}» est affiché dans le fichier log. \section{Code} -En plus d'une \<valeur>, un \<code> arbitraire peut tre assign n'importe quelle \<cl>. Pour ce faire, on crit -\begin{center} \verb|\defKV[<trousseau>]{<cl 1>=<code 1>,<cl 2>=<code 2>,...,<cl n>=<code n>}| +En plus d'une \<valeur>, un \<code> arbitraire peut être assigné à n'importe quelle \<clé>. Pour ce faire, on écrit +\begin{center} \verb|\defKV[<trousseau>]{<clé 1>=<code 1>,<clé 2>=<code 2>,...,<clé n>=<code n>}| \end{center} -Chaque \<code> peut contenir \verb|#1| qui reprsente la \<valeur> de la \<cl>. Ce \<code> est excut lorsque une \<valeur> est assigne la \<cl> avec \verb|\setKV|, \verb|\setKVdefault| ou \verb|\restoreKV|. +Chaque \<code> peut contenir \verb|#1| qui représente la \<valeur> de la \<clé>. Ce \<code> est exécuté lorsque une \<valeur> est assignée à la \<clé> avec \verb|\setKV|, \verb|\setKVdefault| ou \verb|\restoreKV|. \bigbreak -Ainsi dclarer +Ainsi déclarer \code|\defKV[x]{ mykey = \def\foo{\textbf{#1}}| -va dfinir une macro \verb|\foo| ds que la \<cl> \texttt{mykey} va tre dfinie (ou redfinie) et donc, si l'on crit +va définir une macro \verb|\foo| dès que la \<clé> «\texttt{mykey}» va être définie (ou redéfinie) et donc, si l'on écrit \code|\setKV[x]{ mykey = bonjour }| -le code qui est excut en coulisses est - \code|\long\def\foo{\textbf{bonjour}}| +le code qui est exécuté en coulisses est + \code|\def\foo{\textbf{bonjour}}| \exemple|\defKV[x]{ mykey = \def\foo{\textbf{#1}} } -\setKV[x]{ mykey = bonjour }% dfinition +\setKV[x]{ mykey = bonjour }% définition 1) \meaning\foo\par 2) \useKV[x]{ mykey } -\setKV[x]{ mykey = hello }% redfinition +\setKV[x]{ mykey = hello }% redéfinition 3) \meaning\foo\par 4) \useKV[x]{ mykey }| -La macro \verb|\testboolKV| permet de tester, par exemple dans un \<code>, si son argument est true ou false +La macro \verb|\testboolKV| permet de tester, par exemple dans un \<code>, si son argument est «true» ou «false» \code|\testboolKV{<argument>}{<code si true>}{<code si false>}| -La macro est purement dveloppable, elle ncessite 2 dveloppements pour donner l'un des deux codes, et exige que l'\<argument> soit boolen sans quoi un message d'erreur est mis. +La macro est purement développable, elle nécessite 2 développements pour donner l'un des deux codes, et exige que l'\<argument> soit booléen sans quoi un message d'erreur est émis. -\exemple|\defKV[x]{ x = \def\test{\testboolKV{#1}{test positif}{test ngatif}}} +\exemple|\defKV[x]{ x = \def\test{\testboolKV{#1}{test positif}{test négatif}}} \setKV[x]{ x = true} 1) \test \setKV[x]{ x= false} 2) \test| -Toute autre valeur que \verb|true| ou \verb|false| gnrera un message d'erreur. +Toute autre valeur que «\verb|true|» ou «\verb|false|» génèrera un message d'erreur. \section{Un exemple d'utilisation} -Voici comment on pourrait programmer une macro qui affiche un cadre sur une ligne, grce la macro \verb|\fbox| et l'environnement \verb|center| de \LaTeX. Pour cela les \<cls> suivantes seront utilises: +Voici comment on pourrait programmer une macro qui affiche un cadre sur une ligne, grâce à la macro \verb|\fbox| et l'environnement \verb|center| de \LaTeX. Pour cela les \<clés> suivantes seront utilisées: \begin{itemize} - \item le boolen \texttt{inline} qui affichera le cadre dans le texte s'il est vrai et sur une ligne ddi s'il est faux; - \item \texttt{sep} qui est une dimension mesurant la distance entre le texte et le cadre (par dfaut \texttt{3pt}); - \item \texttt{width} qui est la largeur des traits du cadre (par dfaut \texttt{0.5pt}); - \item \texttt{style} qui contient le code excut avant le texte. + \item le booléen \texttt{inline} qui affichera le cadre dans le texte s'il est vrai et sur une ligne dédié s'il est faux; + \item \texttt{sep} qui est une dimension mesurant la distance entre le texte et le cadre (par défaut \texttt{3pt}); + \item \texttt{width} qui est la largeur des traits du cadre (par défaut \texttt{0.5pt}); + \item \texttt{style} qui contient le code exécuté avant le texte. \end{itemize} -Une premire faon de faire, sans recours \verb|\defKV|; +Une première façon de faire, sans recours à \verb|\defKV|; \exemple|\setKVdefault[frame]{ sep = 3pt, line width = 0.5pt, @@ -254,7 +257,7 @@ Une premire faon de faire, sans recours \verb|\defKV|; inline } \newcommand\frametxt[2][]{% - \restoreKV[frame]% revenir au valeurs par dfaut + \restoreKV[frame]% revenir au valeurs par défaut \setKV[frame]{#1}% lit les arguments optionnels \fboxsep = \useKV[frame]{sep} \fboxrule= \useKV[frame]{line width} @@ -266,12 +269,12 @@ Une premire faon de faire, sans recours \verb|\defKV|; {} {\end{center}}% } -Un essai en ligne par dfaut \frametxt{essai} puis un autre \frametxt[sep=5pt,line width=2pt]{essai} +Un essai en ligne par défaut \frametxt{essai} puis un autre \frametxt[sep=5pt,line width=2pt]{essai} et un dernier \frametxt[sep=1pt,style=\itshape]{essai}. -Un essai hors ligne : \frametxt[inline = false, style=\bfseries\color{red}]{essai centr}| +Un essai hors ligne : \frametxt[inline = false, style=\bfseries\color{red}]{essai centré}| -Dans l'exemple repris ci-dessous et grce \verb|\defKV|, on stocke tous les paramtres lors de leur assignation. Il y a bien moins de verbosit dans le code de \verb|frametxt| ce qui le rend plus lger et plus lisible. +Dans l'exemple repris ci-dessous et grâce à \verb|\defKV|, on stocke tous les paramètres lors de leur assignation. Il y a bien moins de verbosité dans le code de \verb|frametxt| ce qui le rend plus léger et plus lisible. \exemple|\defKV[frame]{% sep = {\fboxsep = #1 }, @@ -288,17 +291,16 @@ Dans l'exemple repris ci-dessous et grce \verb|\defKV|, on stocke tous les pa inline } \newcommand\frametxt[2][]{% - \restoreKV[frame]% revenir au valeurs par dfaut + \restoreKV[frame]% revenir au valeurs par défaut \setKV[frame]{#1}% lit les arguments optionnels \hookpre \fbox{\fstyle #2}% \hookpost } -Un essai en ligne par dfaut \frametxt{essai} puis un autre \frametxt[sep=5pt,line width=2pt]{essai} +Un essai en ligne par défaut \frametxt{essai} puis un autre \frametxt[sep=5pt,line width=2pt]{essai} et un dernier \frametxt[sep=1pt,style=\itshape]{essai}. -Un essai hors ligne : \frametxt[inline = false, style=\bfseries\color{red}]{essai centr}| - +Un essai hors ligne : \frametxt[inline = false, style=\bfseries\color{red}]{essai centré}| \section{Le code} Le code ci-dessous est l'exact verbatim du fichier \verb|simplekv.tex| : @@ -320,7 +322,7 @@ Le code ci-dessous est l'exact verbatim du fichier \verb|simplekv.tex| : numbers=left, numberstyle=\tiny\ttfamily\color{black}, breaklines=true, - prebreak={\hbox{$\rhookswarrow$}}, + prebreak={\hbox{$\hookleftarrow$}}, breakindent=3em, breakautoindent=true, xleftmargin=1em, diff --git a/macros/generic/simplekv/simplekv.tex b/macros/generic/simplekv/simplekv.tex index b1e2d3b59b..3f7422478a 100644 --- a/macros/generic/simplekv/simplekv.tex +++ b/macros/generic/simplekv/simplekv.tex @@ -1,15 +1,12 @@ -% !TeX encoding = ISO-8859-1 -% Ce fichier contient le code comment de l'extension "simplekv" -% -% IMPORTANT : pour que les commentaires s'affichent correctement, -% ouvrir ce fichier avec l'encodage ISO-8859-1 +% !TeX encoding = UTF-8 +% Ce fichier contient le code commenté de l'extension "simplekv" % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % \def\skvname {simplekv} % -\def\skvver {0.2} % +\def\skvver {0.2a} % % % -\def\skvdate {2020/04/27} % +\def\skvdate {2022/10/01} % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % @@ -30,16 +27,16 @@ % email: unbonpetit@netc.fr % Commentaires, suggestions et signalement de bugs bienvenus ! % Comments, bug reports and suggestions are welcome. -% Copyright: Christian Tellechea 2017-2020 +% Copyright: Christian Tellechea 2017-2022 % -------------------------------------------------------------------- -% L'extension simplekv est compose des 5 fichiers suivants : +% L'extension simplekv est composée des 5 fichiers suivants : % - code : simplekv (.tex et .sty) -% - manuel en franais : simplekv-fr (.tex et .pdf) +% - manuel en français : simplekv-fr (.tex et .pdf) % - fichier lisezmoi : README % -------------------------------------------------------------------- %########################################## -%################ Pralable ############### +%################ Préalable ############### %########################################## \csname skvloadonce\endcsname \let\skvloadonce\endinput @@ -55,68 +52,58 @@ \def\X#1{\catcode\number`#1=\number\catcode`#1\relax} \expandafter\xdef\csname skv_restorecatcode\endcsname{\X\,\X\=\X\_} \endgroup -\catcode`\_11 -\chardef\skv_other12 -\catcode`\,\skv_other\catcode`\=\skv_other +\catcode`\_ = 11 \catcode`\, = 12 \catcode`\= = 12 %########################################## %############ Macros auxilaires ########### %########################################## \chardef\skv_stop 0 \long\def\skv_first#1#2{#1} \long\def\skv_second#1#2{#2} +\long\def\skv_antefi#1\fi{\fi#1} \long\def\skv_gob#1{} \long\def\skv_exe#1{#1} -\expandafter\def\expandafter\skv_gobspace\space{}% pour garder la compatibilit -\long\def\skv_earg#1#2{\expandafter\skv_earg_i\expandafter{#2}{#1}}\let\skv_exparg\skv_earg +\expandafter\def\expandafter\skv_gobspace\space{}% pour garder la compatibilité \long\def\skv_eearg#1#2{\expandafter\expandafter\expandafter\skv_earg_i\expandafter\expandafter\expandafter{#2}{#1}} \long\def\skv_earg_i#1#2{#2{#1}} -\long\def\skv_expafter#1#2{\expandafter\skv_expafter_i\expandafter{#2}{#1}}% {<a>}{<b>} devient <a><*b> -\long\def\skv_expafter_i#1#2{#2#1} \def\skv_ifcsname#1{\ifcsname#1\endcsname\expandafter\skv_first\else\expandafter\skv_second\fi} -\long\def\skv_ifx#1{\ifx#1\expandafter\skv_first\else\expandafter\skv_second\fi} \long\def\skv_ifempty#1{\skv_ifempty_i#1\_nil\_nil\skv_second\skv_first\__nil}% \long\def\skv_ifempty_i#1#2\_nil#3#4#5\__nil{#4} \def\skv_stripsp#1{% -\long\def\skv_stripsp##1##2{\expanded{\skv_stripsp_i\_marksp##2\__nil\_marksp#1\_marksp\_nil{##1}}}% -\long\def\skv_stripsp_i##1\_marksp#1##2\_marksp##3\_nil{\skv_stripsp_ii##3##1##2\__nil#1\__nil\_nil}% -\long\def\skv_stripsp_ii##1#1\__nil##2\_nil{\skv_stripsp_iii##1##2\_nil}% -\long\def\skv_stripsp_iii##1##2\__nil##3\_nil##4{\unexpanded{##4{##2}}}% + \long\def\skv_stripsp##1##2{\expanded{\skv_stripsp_i\_marksp##2\__nil\_marksp#1\_marksp\_nil{##1}}}% + \long\def\skv_stripsp_i##1\_marksp#1##2\_marksp##3\_nil{\skv_stripsp_ii##3##1##2\__nil#1\__nil\_nil}% + \long\def\skv_stripsp_ii##1#1\__nil##2\_nil{\skv_stripsp_iii##1##2\_nil}% + \long\def\skv_stripsp_iii##1##2\__nil##3\_nil##4{\unexpanded{##4{##2}}}% }\skv_stripsp{ } %########################################## -%########## Macros de dfinition ########## +%########## Macros de définition ########## %########################################## -\def\setKVdefault{\let\skv_find_kv_i\skv_find_kv_nocode\skv_readKV\skv_exe} -\def\setKV {\let\skv_find_kv_i\skv_find_kv_nocode\skv_readKV\skv_gob} -\def\defKV {\let\skv_find_kv_i\skv_find_kv_code \skv_readKV\skv_gob} -\def\skv_readKV{% - \edef\skv_restorecatcode{\catcode44=\the\catcode44 \relax\catcode61=\the\catcode61 \relax}% - \catcode44\skv_other\catcode61\skv_other - \skv_readKV_i -} -\long\def\skv_readKV_i#1[#2]#3{% - #1{\expandafter\def\csname skv_[#2]\endcsname{#3}}% excute (si \defKV) ou pas +\def\setKVdefault{\let\skv_find_kv_ii\skv_find_kv_nocode\skv_readKV\skv_exe} +\def\setKV {\let\skv_find_kv_ii\skv_find_kv_nocode\skv_readKV\skv_gob} +\def\defKV {\let\skv_find_kv_ii\skv_find_kv_code \skv_readKV\skv_gob} +\long\def\skv_readKV#1[#2]#3{% + #1{\expandafter\def\csname skv_[#2]\endcsname{#3}}% exécute (si \defKVdefault) ou pas \def\skv_setname{#2}% - \skv_readKV_ii#3,\__,% - \skv_restorecatcode + \skv_readKV_i#3,\__,% } -\long\def\skv_readKV_ii#1,{\skv_readKV_iii\skv_find_kv#1=true=\_nil\skv_find_kv\__\__nil}% si #1=\__ ne rien faire sinon \skv_find_kv#1=true=\_nil -\long\def\skv_readKV_iii#1\skv_find_kv\__#2\__nil{#1} - -\long\def\skv_find_kv#1=#2=#3\_nil{% +\long\def\skv_readKV_i#1,{\skv_readKV_ii\skv_find_kv#1=true=\_nil\skv_find_kv\__\__nil}% si #1=\__ ne rien faire sinon \skv_find_kv#1=true=\_nil +\long\def\skv_readKV_ii#1\skv_find_kv\__#2\__nil{#1} +\long\def\skv_find_kv#1={% \edef\__key{_[\skv_setname]_\skv_stripsp\detokenize{#1}}% - \skv_stripsp\skv_find_kv_i{#2}% - \skv_readKV_ii + \skv_find_kv_i{}% +} +\long\def\skv_find_kv_i#1=#2\_nil{% + \expandafter\skv_stripsp\expandafter\skv_find_kv_ii\expandafter{\skv_gob#1}% + \skv_readKV_i } \long\def\skv_find_kv_nocode#1{% - \expandafter\def\csname skv\__key\endcsname{#1}%\__val% stocker la cl - \ifcsname skvcode\__key\endcsname% si le code correspondant existe - \csname skvcode\__key\endcsname{#1}% excute le code + \expandafter\def\csname skv\__key\endcsname{#1}% stocker la valeur + \ifcsname skvcode\__key\endcsname + \skv_antefi\csname skvcode\__key\endcsname{#1}% \fi } -\long\def\skv_find_kv_code#1{% - \expandafter\def\csname skvcode\__key\endcsname##1{#1}% +\long\def\skv_find_kv_code{% + \expandafter\def\csname skvcode\__key\endcsname##1% } - \def\restoreKV[#1]{% \skv_ifcsname{skv_[#1]} {\skv_eearg{\setKV[#1]}{\csname skv_[#1]\endcsname}} @@ -126,17 +113,18 @@ %########################################## %############## Macro \useKV ############## %########################################## -\def\useKV[#1]#2{\expanded{\skv_stripsp{\useKV_i[#1]}{#2}}} -\def\useKV_i[#1]#2{\expandafter\useKV_ii\csname skv_[#1]_#2\endcsname{#2}} -\def\useKV_ii#1#2{% - \ifdefined#1\unexpanded\expandafter{#1}% - \else \errmessage{Key "#2" not defined}% +\def\useKV[#1]{\romannumeral\skv_stripsp{\useKV_i[#1]}} +\def\useKV_i[#1]#2{% + \ifcsname skv_[#1]_#2\endcsname + \expandafter\expandafter\expandafter\skv_stop\csname skv_[#1]_#2\expandafter\endcsname + \else + \skv_stop\errmessage{Key "#2" not defined in group of keys "#1"}% \fi } %########################################## %############# Macros de test ############# %########################################## -\def\ifboolKV[#1]#2{\romannumeral\skv_stripsp{\ifboolKV_i[#1]}{#2}} +\def\ifboolKV[#1]{\romannumeral\skv_stripsp{\ifboolKV_i[#1]}} \def\ifboolKV_i[#1]#2{% \skv_ifempty{#2} {\skv_stop\errmessage{Empty argument is not a valid boolean}\skv_second @@ -155,14 +143,12 @@ {\skv_stop\errmessage{Value "#1" is not a valid boolean}\skv_second}% }% } - \def\testboolKV#1{\romannumeral\skv_stripsp{\testboolKV_i}{#1}}% macro publique qui teste si #1 est <true> ou <false>, erreur sinon \def\testboolKV_i#1{% \skv_ifempty{#1} {\skv_stop\errmessage{Empty argument is not a valid boolean}\skv_second} {\skv_stripsp{\ifboolKV_ii}{#1}}% } - \def\skv_ifargtrue#1{\skv_ifargtrue_i#1true\_nil} \def\skv_ifargtrue_i#1true#2\_nil{\skv_ifempty{#1}{\skv_ifargtrue_ii#2\_nil}\skv_second} \def\skv_ifargtrue_ii#1true#2\_nil{\skv_ifempty{#1#2}} @@ -172,7 +158,7 @@ %########################################## %############# Macro \showKV ############## %########################################## -\def\showKV[#1]#2{\expanded{\skv_stripsp{\showKV_i[#1]}{#2}}} +\def\showKV[#1]#2{\skv_stripsp{\showKV_i[#1]}{#2}} \def\showKV_i[#1]#2{% \immediate\write-1 {% ^^JKey\space\space[#1]#2=% @@ -197,9 +183,15 @@ Versions : _____________________________________________________________________________ | Version | Date | Changements | |-----------------------------------------------------------------------------| -| 0.1 | 08/08/2017 | Premire version | +| 0.1 | 08/08/2017 | Première version | |-----------------------------------------------------------------------------| -| 0.2 | 27/04/2020 | - Un <code> peut tre assign une <cl> | +| 0.2 | 27/04/2020 | - Un <code> peut être assigné à une <clé> | | | | - Correction de bugs | | | | - Optimisations | +|-----------------------------------------------------------------------------| +| 0.2a | 01/10/2022 | - vieux bug corrigé : \useKV envoie désormais une | +| | | erreur si une clé n'est pas définie | +| | | - la valeur n'est dépouillée que d'une accolade (et | +| | | non pas de 2 comme auparavant) | +| | | - quelques petits nettoyages, code en UTF8 | |-----------------------------------------------------------------------------|
\ No newline at end of file diff --git a/macros/latex/contrib/dijkstra/README b/macros/latex/contrib/dijkstra/README index f49d8f82cf..8b431e72fd 100644 --- a/macros/latex/contrib/dijkstra/README +++ b/macros/latex/contrib/dijkstra/README @@ -3,9 +3,9 @@ ___________________________________ L'extension dijkstra - v0.12 + v0.13 - 25 juin 2020 + 1er octobre 2022 ___________________________________ Authors : Christian Tellechea diff --git a/macros/latex/contrib/dijkstra/dijkstra-fr.pdf b/macros/latex/contrib/dijkstra/dijkstra-fr.pdf Binary files differindex 84308d0026..f2df774faa 100644 --- a/macros/latex/contrib/dijkstra/dijkstra-fr.pdf +++ b/macros/latex/contrib/dijkstra/dijkstra-fr.pdf diff --git a/macros/latex/contrib/dijkstra/dijkstra-fr.tex b/macros/latex/contrib/dijkstra/dijkstra-fr.tex index ec76559db9..8b408e11b8 100644 --- a/macros/latex/contrib/dijkstra/dijkstra-fr.tex +++ b/macros/latex/contrib/dijkstra/dijkstra-fr.tex @@ -1,16 +1,14 @@ -% !TeX encoding = ISO-8859-1 +% !TeX TS-program = lualatex +% !TeX encoding = UTF-8 % Ceci est la documentation du package "dijkstra" % -% Fichier compil avec pdflatex \documentclass[french,a4paper,10pt]{article} -\usepackage[latin1]{inputenc} -\usepackage[T1]{fontenc} \usepackage[margin=1cm]{geometry} \usepackage[bottom]{footmisc} -\usepackage{libertine,boites,tikz,enumitem,MnSymbol,babel,xspace,listings,dijkstra} +\usepackage{libertine,boites,tikz,enumitem,babel,xspace,listings,dijkstra} \usetikzlibrary{arrows.meta} -\usepackage[scaled=0.85]{luximono} -\frenchbsetup{og=,fg=} +\usepackage[scaled=0.8]{GoMono} +\frenchbsetup{og=«,fg=»} \def\DIJK{\texttt{\dijkname}\xspace} \makeatletter \def\code{\expandafter\code@i\string} @@ -101,7 +99,7 @@ \catcode`\<13 \catcode`\>13 \def<{\begingroup$\langle$\itshape}\def>{$\rangle$\endgroup}% \@ifstar\@sverb\@verb} \endgroup -\def\longfrdijkdate@i#1/#2/#3\@nil{\number#3\relax\space \ifcase#2 \or janvier\or fvrier\or mars\or avril\or mai\or juin\or juillet\or aout\or septembre\or octobre\or novembre\or dcembre\fi\space#1} +\def\longfrdijkdate@i#1/#2/#3\@nil{\number#3\relax\space \ifcase#2 \or janvier\or février\or mars\or avril\or mai\or juin\or juillet\or aout\or septembre\or octobre\or novembre\or décembre\fi\space#1} \edef\longfrdijkdate{\expandafter\longfrdijkdate@i\dijkdate\@nil} \makeatother \begingroup @@ -111,7 +109,7 @@ \hbox to .25\linewidth{% \color{teal}\bfseries\ttfamily \detokenize{#1}=$\langle$\detokenize{#2}$\rangle$\hss}\kern2.5em - (\textit{Dfaut} : {\color{teal}\ttfamily + (\textit{Défaut} : {\color{teal}\ttfamily \skv_eearg\skv_ifempty{\useKV[\dijkname]{#1}} {$\langle$vide$\rangle$} {"\detokenize\expandafter\expandafter\expandafter{\useKV[\dijkname]{#1}}"}})% @@ -136,12 +134,12 @@ \endgroup \vskip2cm \leftskip=.2\linewidth \rightskip=.2\linewidth \small - Cette petite extension met en \oe uvre l'algorithme de Dijkstra pour des graphes pondrs, orients ou non : le tableau de recherche du plus court chemin peut tre affich, la distance minimale entre deux sommets et le chemin correspondant sont stocks dans des macros. + Cette petite extension met en \oe uvre l'algorithme de Dijkstra pour des graphes pondérés, orientés ou non : le tableau de recherche du plus court chemin peut être affiché, la distance minimale entre deux sommets et le chemin correspondant sont stockés dans des macros. \end{titlepage} \parindent0pt \section{Un exemple} -Dans le graphe \emph{non orient} suivant, quel est le plus court chemin pour aller de A F ? +Dans le graphe \emph{non orienté} suivant, quel est le plus court chemin pour aller de A à F ? \begin{center} \begin{tikzpicture}[scale=1.75] @@ -169,7 +167,7 @@ Dans le graphe \emph{non orient} suivant, quel est le plus court chemin pour al \end{center} \paragraph{Lire le graphe} -Pour trouver le plus court chemin pour aller de A F, il faut d'abord lire le graphe. Comme il est frquent que les graphes soient peu peupls, j'ai pris le parti de dfinir un graphe par une liste d'adjacence. Ainsi, la macro \verb|\readgraph|, qui va lire le graphe, admet comme argument obligatoire une liste d'adjacence : +Pour trouver le plus court chemin pour aller de A à F, il faut d'abord lire le graphe. Comme il est fréquent que les graphes soient peu peuplés, j'ai pris le parti de définir un graphe par une liste d'adjacence. Ainsi, la macro \verb|\readgraph|, qui va lire le graphe, admet comme argument obligatoire une liste d'adjacence : \code/\readgraph{ A [B=7, D=15], @@ -179,11 +177,11 @@ Pour trouver le plus court chemin pour aller de A F, il faut d'abord lire le g E [F=14] }/ -Les espaces sont ignors de part et d'autre des noms des sommets, des crochets (ouvrants et fermants), des signes \verb/=/ et des virgules. Ainsi, ce n'est que dans les noms des sommets que les espaces ne sont pas ignors : par exemple, le sommet \verb|A 1| est distinct du sommet \verb*|A1|. +Les espaces sont ignorés de part et d'autre des noms des sommets, des crochets (ouvrants et fermants), des signes «\verb/=/» et des virgules. Ainsi, ce n'est que dans les noms des sommets que les espaces ne sont pas ignorés : par exemple, le sommet «\verb|A 1|» est distinct du sommet «\verb*|A1|». \paragraph{Conditions sur les distances} -Les distances entre sommets \emph{doivent} tre positives, c'est une limitation intrinsque l'algorithme de Dijkstra pour qu'il fonctionne sans erreur. La mthode de programmation utilise dans cette extension exige de plus que ces distances soient des nombres \emph{entiers}.\medbreak -Une fois que le graphe a t lu, celui-ci est rendu \emph{non orient} en interne et donc en coulisses, la liste d'adjacence devient +Les distances entre sommets \emph{doivent} être positives, c'est une limitation intrinsèque à l'algorithme de Dijkstra pour qu'il fonctionne sans erreur. La méthode de programmation utilisée dans cette extension exige de plus que ces distances soient des nombres \emph{entiers}.\medbreak +Une fois que le graphe a été lu, celui-ci est rendu \emph{non orienté} en interne et donc en coulisses, la liste d'adjacence devient \code/A [B=7, D=15], B [A=7, C=12, E=4, F=16], @@ -192,10 +190,10 @@ D [A=15, C=5, E=2], E [D=2, B=4, F=14], F [B=16, C=3, E=14]/ -Par consquent, la liste d'adjacence entre par l'utilisateur ne doit pas contenir d'incohrence. Si l'on spcifie la distance entre un sommet A et un sommet B par \verb|A[B=<x>,...]| on peut s'conomiser la peine de spcifier cette mme distance entre B et A puisque c'est fait par l'extension \DIJK automatiquement. En revanche, une erreur sera mise si dans la liste d'adjacence, on trouve \verb|A[B=<x>,...]| puis \verb|B[A=<y>,...]| o \verb-<y>- et \verb-<x>- sont diffrents. +Par conséquent, la liste d'adjacence entrée par l'utilisateur ne doit pas contenir d'incohérence. Si l'on spécifie la distance entre un sommet A et un sommet B par \verb|A[B=<x>,...]| on peut s'économiser la peine de spécifier cette même distance entre B et A puisque c'est fait par l'extension \DIJK automatiquement. En revanche, une erreur sera émise si dans la liste d'adjacence, on trouve \verb|A[B=<x>,...]| puis \verb|B[A=<y>,...]| où \verb-<y>- et \verb-<x>- sont différents. \paragraph{Lancer l'algorithme} -Une fois que le graphe est lu par la macro \verb|\readgraph|, on lance l'algorithme avec \verb|\dijkstra{<A>}{<B>}| o \verb-<A>- et \verb-<B>- sont deux sommets du graphe. La distance minimale entre ces deux sommets est stocke dans la macro \verb|\dijkdist| et le chemin correspondant dans \verb|\dijkpath|. +Une fois que le graphe est lu par la macro \verb|\readgraph|, on lance l'algorithme avec \verb|\dijkstra{<A>}{<B>}| où \verb-<A>- et \verb-<B>- sont deux sommets du graphe. La distance minimale entre ces deux sommets est stockée dans la macro \verb|\dijkdist| et le chemin correspondant dans \verb|\dijkpath|. \exemple|\readgraph{ A [B=7, D=15], @@ -207,10 +205,10 @@ Tableau : \dijkstra{A}{F}\par Distance A-F = \dijkdist\par Chemin = \dijkpath| -Dans le tableau, les colonnes sont disposes dans le \emph{mme ordre} que celui des sommets dans la liste d'adjacence lue par \verb|\readgraph|. +Dans le tableau, les colonnes sont disposées dans le \emph{même ordre} que celui des sommets dans la liste d'adjacence lue par \verb|\readgraph|. -\section{Graphe orient} -Pour spcifier \verb|\readgraph| que la liste d'adjacence est celle d'un graphe \emph{orient}, la macro doit tre suivie d'une toile. +\section{Graphe orienté} +Pour spécifier à \verb|\readgraph| que la liste d'adjacence est celle d'un graphe \emph{orienté}, la macro doit être suivie d'une étoile. \begin{center} \begin{tikzpicture}[scale=1.75] @@ -258,46 +256,46 @@ Tableau : \dijkstra{A}{H}\par Distance A-H = \dijkdist\par Chemin = \dijkpath| -\section{Paramtres} -\paragraph{Paramtres de \texttt{\char`\\ dijkstra}} -Des \verb|<paramtres>| peuvent tre passs la macro \verb|\dijkstra| dans son argument optionnel qui prend la forme d'une liste de \verb|<cl>=<valeur>|. +\section{Paramètres} +\paragraph{Paramètres de \texttt{\char`\\ dijkstra}} +Des \verb|<paramètres>| peuvent être passés à la macro \verb|\dijkstra| dans son argument optionnel qui prend la forme d'une liste de \verb|<clé>=<valeur>|. -On peut galement rgler des \verb|<paramtres>| pour toutes les excutions de la macro \verb|\dijkstra| venir avec +On peut également régler des \verb|<paramètres>| pour toutes les exécutions de la macro \verb|\dijkstra| à venir avec \begin{center} - \verb|\setdijk{<paramtres>}| + \verb|\setdijk{<paramètres>}| \end{center} -mais aussi modifier des \verb|<paramtres>| \emph{par dfaut} avec +mais aussi modifier des \verb|<paramètres>| \emph{par défaut} avec \begin{center} - \verb|\setdijkdefault{<paramtres>}| + \verb|\setdijkdefault{<paramètres>}| \end{center} -Pour rinitialiser toutes les \verb|<cls>| leur \verb|<valeur>| par dfaut, il faut excuter la macro \verb|\initdijk|.\medbreak +Pour réinitialiser toutes les \verb|<clés>| à leur \verb|<valeur>| par défaut, il faut exécuter la macro \verb|\initdijk|.\medbreak -Voici toutes les \verb|<cls>|, leur \verb|<valeur>| par dfaut et leur description. +Voici toutes les \verb|<clés>|, leur \verb|<valeur>| par défaut et leur description. -\cleval{show-tab}{boolen} -Lorsque cette \verb|<cl>| est \verb|true|, le tableau est affich par la macro \verb|\dijkstra|. Il ne l'est pas dans le cas contraire. +\cleval{show-tab}{booléen} +Lorsque cette \verb|<clé>| est \verb|true|, le tableau est affiché par la macro \verb|\dijkstra|. Il ne l'est pas dans le cas contraire. \cleval{v-position}{texte} -Ce paramtre est plac dans l'argument optionnel de \verb|\begin{tabular}[<v-position>]| pour spcifier la position que doit avoir le tableau par rapport la ligne de base. +Ce paramètre est placé dans l'argument optionnel de \verb|\begin{tabular}[<v-position>]| pour spécifier la position que doit avoir le tableau par rapport à la ligne de base. \cleval{pre-tab}{code} -Ce \verb|<code>| arbitraire est excut juste avant le \verb|\begin{tabular}|. +Ce \verb|<code>| arbitraire est exécuté juste avant le \verb|\begin{tabular}|. \cleval{post-tab}{code} -Ce \verb|<code>| arbitraire est excut juste aprs le \verb|\end{tabular}|. +Ce \verb|<code>| arbitraire est exécuté juste après le \verb|\end{tabular}|. \cleval{col-type}{code} Ce \verb|<code>| est le descripteur des colonnes contenant les sommets. \cleval{infinity-code}{code} -Ce \verb|<code>| est excut pour exprimer une distance infinie dans le tableau et dans la macro \verb|\dijkdist|. +Ce \verb|<code>| est exécuté pour exprimer une distance infinie dans le tableau et dans la macro \verb|\dijkdist|. \cleval{norevisit-code}{code} -Ce \verb|<code>| est excut dans le tableau pour exprimer qu'un sommet a dj t fix. +Ce \verb|<code>| est exécuté dans le tableau pour exprimer qu'un sommet a déjà été fixé. -\cleval{h-rules}{boolen} -Lorsque ce boolen est \verb|true|, les rglures horizontales entre les tapes sont traces dans le tableau. +\cleval{h-rules}{booléen} +Lorsque ce booléen est \verb|true|, les réglures horizontales entre les étapes sont tracées dans le tableau. \exemple|\readgraph{ A [B=7, D=15], @@ -309,14 +307,14 @@ Tableau : \dijkstra[h-rules=true, v-position=b]{A}{F}| -\cleval{show-lastcol}{boolen} -Lorsque ce boolen est \verb|true|, une colonne supplmentaire est affiche dans le tableau; cette colonne correspond au sommet fix. +\cleval{show-lastcol}{booléen} +Lorsque ce booléen est \verb|true|, une colonne supplémentaire est affichée dans le tableau; cette colonne correspond au sommet fixé. \cleval{lastcol-type}{code} -Ce \verb|<code>| est le descripteur de la colonne correspondant au sommets fixs. +Ce \verb|<code>| est le descripteur de la colonne correspondant au sommets fixés. \cleval{lastcol-label}{code} -Ce \verb|<code>| contient le nom de la colonne correspondant aux sommets fixs. +Ce \verb|<code>| contient le nom de la colonne correspondant aux sommets fixés. \exemple|\readgraph{ A [B=7, D=15], @@ -328,7 +326,7 @@ Tableau : \dijkstra[show-lastcol]{A}{F}| \cleval{nopath-string}{code} -Ce \verb|<code>| est plac dans la macro \verb|\dijkpath| dans le cas o aucun chemin n'a pu tre trouv, comme cela peut tre le cas si le graphe est non connexe. +Ce \verb|<code>| est placé dans la macro \verb|\dijkpath| dans le cas où aucun chemin n'a pu être trouvé, comme cela peut être le cas si le graphe est non connexe. \exemple|\readgraph{ A [B=2], @@ -339,17 +337,17 @@ Chemin = \dijkpath\par Distance A-E= \dijkdist| \cleval{path-sep}{code} -Ce \verb|<code>| est insr entre chaque sommet dans la macro \verb|\dijkpath|. +Ce \verb|<code>| est inséré entre chaque sommet dans la macro \verb|\dijkpath|. \paragraph{Formatage distance/sommet} -Lorsqu'un sommet a un prdcesseur, la macro \verb|\formatnodewithprev| se charge d'afficher la distance et le sommet. Cette macro prend deux arguments (la \verb|<distance>| et le \verb|<sommet>|) et sa dfinition par dfaut est +Lorsqu'un sommet a un prédécesseur, la macro \verb|\formatnodewithprev| se charge d'afficher la distance et le sommet. Cette macro prend deux arguments (la \verb|<distance>| et le \verb|<sommet>|) et sa définition par défaut est \code|\newcommand*\formatnodewithprev[2]% {% #1=distance, #2=nom du noeud de provenance $#1_{\mathrm{#2}}$% }| -ce qui a pour effet de mettre le sommet de provenance en indice de la distance. On peut redfinir cette macro pour choisir une autre mise en forme comme ci-dessous o le sommet est plac entre parenthses. +ce qui a pour effet de mettre le sommet de provenance en indice de la distance. On peut redéfinir cette macro pour choisir une autre mise en forme comme ci-dessous où le sommet est placé entre parenthèses. \exemple|\renewcommand*\formatnodewithprev[2]% {% @@ -363,21 +361,21 @@ ce qui a pour effet de mettre le sommet de provenance en indice de la distance. E [F=14]} Tableau : \dijkstra{A}{F}| -\paragraph{Mise en vidence du sommet fix} -Le premier sommet fix est celui de dpart et sa distance est toujours 0. +\paragraph{Mise en évidence du sommet fixé} +Le premier sommet fixé est celui de départ et sa distance est toujours 0. -La macro \verb|\highlightfistnode| prend comme argument la distance (qui est 0) et le traite pour effectuer sa mise en forme. Sa dfinition par dfaut, qui compose cette distance en gras, est : +La macro \verb|\highlightfistnode| prend comme argument la distance (qui est 0) et le traite pour effectuer sa mise en forme. Sa définition par défaut, qui compose cette distance en gras, est : \code|\newcommand*\highlightfirstnode[1]{$\mathbf{#1}$}| -Les autres sommets, lorsqu'ils sont fixs, apparaissent dans le tableau avec leur distance et leur nom et sont traits par la macro \verb|\highlightnode| qui rend deux arguments. Sa dfinition permet une mise en forme similaire ce que fait \verb|\formatnodewithprev|, sauf que la distance et le sommet sont en gras: +Les autres sommets, lorsqu'ils sont fixés, apparaissent dans le tableau avec leur distance et leur nom et sont traités par la macro \verb|\highlightnode| qui rend deux arguments. Sa définition permet une mise en forme similaire à ce que fait \verb|\formatnodewithprev|, sauf que la distance et le sommet sont en gras: \code|\newcommand*\highlightnode[2]% {% #1=distance, #2=nom du noeud de provenance $\mathbf{#1}_{\mathrm{\mathbf{#2}}}$% }| -Pour obtenir d'autre effets, on peut redfinir ces macros. L'exemple donn n'est pas raliste tant les effets sont incohrents, c'est simplement un aperu de ce qu'il est possible de faire : +Pour obtenir d'autre effets, on peut redéfinir ces macros. L'exemple donné n'est pas réaliste tant les effets sont incohérents, c'est simplement un aperçu de ce qu'il est possible de faire : \exemple|\renewcommand*\highlightfirstnode[1]% {% @@ -417,7 +415,7 @@ Le code ci-dessous est l'exact verbatim du fichier \verb|dijkstra.sty| : numbers=left, numberstyle=\tiny\ttfamily\color{black}, breaklines=true, - prebreak={\hbox{$\rhookswarrow$}}, + prebreak={\hbox{$\hookleftarrow$}}, breakindent=3em, breakautoindent=true, xleftmargin=1em, diff --git a/macros/latex/contrib/dijkstra/dijkstra.sty b/macros/latex/contrib/dijkstra/dijkstra.sty index b8c673449e..92252c6b81 100644 --- a/macros/latex/contrib/dijkstra/dijkstra.sty +++ b/macros/latex/contrib/dijkstra/dijkstra.sty @@ -1,12 +1,12 @@ -% !TeX encoding = ISO-8859-1 +% !TeX encoding = UTF-8 % Ce fichier contient le code de l'extension "dijkstra" % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % \def\dijkname {dijkstra} % -\def\dijkver {0.12} % +\def\dijkver {0.13} % % % -\def\dijkdate {2020/06/25} % +\def\dijkdate {2022/10/01} % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % @@ -24,14 +24,14 @@ % This work has the LPPL maintenance status `maintained'. % % The Current Maintainer of this work is Christian Tellechea -% Copyright : Christian Tellechea 2017-2020 +% Copyright : Christian Tellechea 2017-2022 % email: unbonpetit@netc.fr % Commentaires, suggestions et signalement de bugs bienvenus ! % Comments, bug reports and suggestions are welcome. % -------------------------------------------------------------------- -% L'extension dijkstra est compose des 4 fichiers suivants : +% L'extension dijkstra est composée des 4 fichiers suivants : % - code : dijkstra.sty -% - manuel en franais : dijkstra-fr.tex & dijkstra-fr.pdf +% - manuel en français : dijkstra-fr.tex & dijkstra-fr.pdf % - fichier lisezmoi : README % -------------------------------------------------------------------- % @@ -52,14 +52,23 @@ \def\dijk_quark{\dijk_quark} \def\dijk_cscmd#1#2{\expandafter#1\csname#2\endcsname} \def\dijk_gobarg#1{} +\long\def\dijk_first#1#2{#1} +\long\def\dijk_second#1#2{#2} +\long\def\dijk_earg#1#2{\expandafter\dijk_earg_i\expandafter{#2}{#1}}\let\dijk_exparg\dijk_earg +\long\def\dijk_eearg#1#2{\expandafter\expandafter\expandafter\dijk_earg_i\expandafter\expandafter\expandafter{#2}{#1}} +\long\def\dijk_earg_i#1#2{#2{#1}} +\long\def\dijk_ifx#1{\ifx#1\expandafter\dijk_first\else\expandafter\dijk_second\fi} +\long\def\dijk_ifempty#1{\dijk_ifempty_i#1\_nil\_nil\dijk_second\dijk_first\__nil}% +\long\def\dijk_ifempty_i#1#2\_nil#3#4#5\__nil{#4} +\def\dijk_ifcsname#1{\ifcsname#1\endcsname\expandafter\skv_first\else\expandafter\skv_second\fi} \def\dijk_addtomacro#1#2{\expandafter\def\expandafter#1\expandafter{#1#2}} -\def\dijk_eaddtomacro#1#2{\skv_exparg{\dijk_addtomacro#1}{#2}} -\def\dijk_eeaddtomacro#1#2{\skv_eearg{\dijk_addtomacro#1}{#2}} -\long\def\dijk_exptwoargs#1#2#3{\skv_exparg{\skv_exparg{#1}{#2}}{#3}} -\def\dijk_ifnum#1{\ifnum#1\expandafter\skv_first\else\expandafter\skv_second\fi} +\def\dijk_eaddtomacro#1#2{\dijk_exparg{\dijk_addtomacro#1}{#2}} +\def\dijk_eeaddtomacro#1#2{\dijk_eearg{\dijk_addtomacro#1}{#2}} +\long\def\dijk_exptwoargs#1#2#3{\dijk_exparg{\dijk_exparg{#1}{#2}}{#3}} +\def\dijk_ifnum#1{\ifnum#1\expandafter\dijk_first\else\expandafter\dijk_second\fi} \def\dijk_swapargs#1#2#3{#1{#3}{#2}} -\def\dijk_ifstar#1#2{\def\dijk_ifstar_i{\skv_ifx{*\dijk_nxttok}{\skv_first{#1}}{#2}}\futurelet\dijk_nxttok\dijk_ifstar_i} -\def\dijk_ifopt#1#2{\def\dijk_ifopt_i{\skv_ifx{[\dijk_nxttok}{#1}{#2}}\futurelet\dijk_nxttok\dijk_ifopt_i} +\def\dijk_ifstar#1#2{\def\dijk_ifstar_i{\dijk_ifx{*\dijk_nxttok}{\dijk_first{#1}}{#2}}\futurelet\dijk_nxttok\dijk_ifstar_i} +\def\dijk_ifopt#1#2{\def\dijk_ifopt_i{\dijk_ifx{[\dijk_nxttok}{#1}{#2}}\futurelet\dijk_nxttok\dijk_ifopt_i} \def\dijk_stripsp#1% {% \long\def\dijk_stripsp##1{\expanded{\dijk_stripsp_i\_marksp##1\__nil\_marksp#1\_marksp\_nil}}% @@ -69,7 +78,6 @@ } \dijk_stripsp{ } - \def\dijk_foreach#1\in#2#3% {% \global\advance\dijk_nest1 @@ -82,18 +90,18 @@ \def\dijk_foreach_i#1#2,% {% \def#1{#2}% - \skv_ifx{\dijk_quark#1} + \dijk_ifx{\dijk_quark#1} {% } {% - \skv_ifx{#1\empty}{}{\csname dijk_loopcode_\number\dijk_nest\endcsname}% + \dijk_ifx{#1\empty}{}{\csname dijk_loopcode_\number\dijk_nest\endcsname}% \dijk_foreach_i#1% }% }% \def\dijk_ifinst#1#2% {% #2 est-il dans #1 ? - \def\dijk_ifinst_i##1#2##2\_nil{\dijk_swapargs{\skv_ifempty{##2}}}% + \def\dijk_ifinst_i##1#2##2\_nil{\dijk_swapargs{\dijk_ifempty{##2}}}% \dijk_ifinst_i#1#2\_nil } @@ -105,8 +113,8 @@ \def\readgraph_a#1% {% \let\dijk_initlistofnodes\empty% liste des sommets - \let\dijk_graph\empty% argument #1 o l'on va enlever les espaces - \dijk_sanitizegraph#1,\dijk_quark[],% enlever tous les espaces indsirables et valuer les nombres dans l'argument #1 + \let\dijk_graph\empty% argument #1 où l'on va enlever les espaces + \dijk_sanitizegraph#1,\dijk_quark[],% enlever tous les espaces indésirables et évaluer les nombres dans l'argument #1 \expandafter\readgraph_b\dijk_graph,\dijk_quark[],% } @@ -117,12 +125,12 @@ \def\dijk_sanitizegraph_i#1[#2],% {% - \skv_ifx{\dijk_quark#1} + \dijk_ifx{\dijk_quark#1} {% \dijk_removelastcommainmacro\dijk_graph } {% - \skv_eearg{\def\dijk_childnodes}{\dijk_stripsp{#1}[}% + \dijk_eearg{\def\dijk_childnodes}{\dijk_stripsp{#1}[}% \dijk_foreach\dijk_temp\in{#2}{\expandafter\dijk_sanitizegraph_ii\dijk_temp\_nil}% \dijk_removelastcommainmacro\dijk_childnodes \dijk_eaddtomacro\dijk_graph{\dijk_childnodes],}% @@ -148,11 +156,11 @@ \def\readgraph_b#1#2[#3]#4,% {% - \skv_ifx{\dijk_quark#1} + \dijk_ifx{\dijk_quark#1} {% - \skv_exparg{\dijk_foreach\dijk_tempnodename\in}{\dijk_initlistofnodes} + \dijk_exparg{\dijk_foreach\dijk_tempnodename\in}{\dijk_initlistofnodes} {% pour chaque sommet - \skv_eearg{\dijk_foreach\dijk_tempnodechild\in}{\csname dijknode\dijk_tempnodename\endcsname} + \dijk_eearg{\dijk_foreach\dijk_tempnodechild\in}{\csname dijknode\dijk_tempnodename\endcsname} {% pour chaque enfant \expandafter\readgraph_c\dijk_tempnodechild\_nil\dijk_currentnodechildname\dijk_currentnodechilddist% capturer nom et distance de l'enfant \dijk_exptwoargs\dijk_ifinst\dijk_initlistofnodes{\dijk_currentnodechildname,}% si l'enfant n'est pas dans la liste des sommets @@ -162,11 +170,11 @@ \dijk_eaddtomacro\dijk_initlistofnodes{\dijk_currentnodechildname,}% l'y mettre \dijk_cscmd\let{dijknode\dijk_currentnodechildname}\empty% et initialiser la liste de ses enfants }% - \unless\ifdijk_oriented% si graphe non orient, ajouter les distances inverses - \skv_exparg{\skv_eearg\dijk_ifinst{\csname dijknode\dijk_currentnodechildname\endcsname}}{\dijk_tempnodename=}% si le parent est dans dj un des enfants de l'enfant + \unless\ifdijk_oriented% si graphe non orienté, ajouter les distances inverses + \dijk_exparg{\dijk_eearg\dijk_ifinst{\csname dijknode\dijk_currentnodechildname\endcsname}}{\dijk_tempnodename=}% si le parent est dans déjà un des enfants de l'enfant {% \expandafter\def\expandafter\readgraph_d\expandafter########\expandafter1\dijk_tempnodename=########2,########3\_nil{% - \unless\ifnum########2=\dijk_currentnodechilddist\relax% si distance diffrente : erreur, c'est pas normal + \unless\ifnum########2=\dijk_currentnodechilddist\relax% si distance différente : erreur, c'est pas normal \errmessage{Distance "\dijk_tempnodename=########2" incorrecte dans \dijk_currentnodechildname{} comprise comme "\dijk_tempnodename=\dijk_currentnodechilddist"}% \dijk_cscmd\edef{dijknode\dijk_currentnodechildname}{########1\dijk_tempnodename=\dijk_currentnodechilddist,########3}% \fi @@ -180,11 +188,11 @@ }% }% \dijk_cnt0 - \skv_exparg{\dijk_foreach\dijk_tempnodename\in}{\dijk_initlistofnodes} + \dijk_exparg{\dijk_foreach\dijk_tempnodename\in}{\dijk_initlistofnodes} {% pour chaque sommet, construire la liste de ses enfants \advance\dijk_cnt1 \dijk_cscmd\let{listofchilds_\dijk_tempnodename}\empty - \skv_eearg{\dijk_foreach\dijk_tempnodechild\in}{\csname dijknode\dijk_tempnodename\endcsname} + \dijk_eearg{\dijk_foreach\dijk_tempnodechild\in}{\csname dijknode\dijk_tempnodename\endcsname} {% \expandafter\readgraph_c\dijk_tempnodechild\_nil\dijk_currentnodechildname\dijk_currentnodechilddist \expandafter\dijk_eaddtomacro\csname listofchilds_\dijk_tempnodename\endcsname{\dijk_currentnodechildname,}% @@ -212,10 +220,10 @@ } \def\dijk_removenode#1% -{% enlve le sommet #1 de la liste des sommets non vus - \skv_exparg{\dijk_ifinst}{\expandafter,\dijk_nodestoexplore}{,#1,} +{% enlève le sommet #1 de la liste des sommets non vus + \dijk_exparg{\dijk_ifinst}{\expandafter,\dijk_nodestoexplore}{,#1,} {% - \def\dijk_removenode_i##1,#1,##2\_nil{\skv_exparg{\def\dijk_nodestoexplore}{\dijk_gobarg##1,##2}}% + \def\dijk_removenode_i##1,#1,##2\_nil{\dijk_exparg{\def\dijk_nodestoexplore}{\dijk_gobarg##1,##2}}% \expandafter\dijk_removenode_i\expandafter,\dijk_nodestoexplore\_nil } {% @@ -227,14 +235,14 @@ \dijk_ifopt{\dijkstra_i}{\dijkstra_i[]}% } \def\dijkstra_i[#1]#2#3% -{% #1=sommet dpart #2=sommet arrive +{% #1=sommet départ #2=sommet arrivée \begingroup - \skv_ifempty{#1}{}{\setdijk{#1}}% + \dijk_ifempty{#1}{}{\setdijk{#1}}% \let\dijk_listofnodes\dijk_initlistofnodes \let\dijk_nodestoexplore\dijk_initlistofnodes \dijk_cnt0 - \skv_eearg{\def\dijk_currentnode}{\dijk_stripsp{#2}}% - \skv_eearg{\def\dijk_endnode}{\dijk_stripsp{#3}}% + \dijk_eearg{\def\dijk_currentnode}{\dijk_stripsp{#2}}% + \dijk_eearg{\def\dijk_endnode}{\dijk_stripsp{#3}}% \edef\dijk_tab {% \noexpand\dijk_pre_tab @@ -247,23 +255,23 @@ \noexpand\hline }% \def\dijk_autoamp{\def\dijk_autoamp{\dijk_addtomacro\dijk_tab&}}% - \skv_exparg{\dijk_foreach\dijk_tempnodename\in}\dijk_listofnodes + \dijk_exparg{\dijk_foreach\dijk_tempnodename\in}\dijk_listofnodes {% pour tous le sommets du graphe - \dijk_autoamp% ajouter "&", sauf la premire fois - \dijk_cscmd\let{dist_\dijk_tempnodename}\dijk_maxint% toutes les distances +inf - \dijk_cscmd\let{prev_\dijk_tempnodename}\dijk_quark% tous les prdecesseurs <quark> + \dijk_autoamp% ajouter "&", sauf la première fois + \dijk_cscmd\let{dist_\dijk_tempnodename}\dijk_maxint% toutes les distances à +inf + \dijk_cscmd\let{prev_\dijk_tempnodename}\dijk_quark% tous les prédecesseurs à <quark> \dijk_eaddtomacro\dijk_tab{\dijk_tempnodename}% peupler 1re ligne du tableau }% \ifboolKV[\dijkname]{show-lastcol} {\dijk_eaddtomacro\dijk_tab{\expandafter&\dijk_lastcol_label}} {}% \dijk_addtomacro\dijk_tab{\\\hline}% - \dijk_cscmd\def{dist_\dijk_currentnode}{0}% distance sommet de dpart = 0 + \dijk_cscmd\def{dist_\dijk_currentnode}{0}% distance sommet de départ = 0 \dijk_whilenotempty\dijk_nodestoexplore {% \dijk_findmindist\dijk_currentnode% retourne \dijk_currentnode : le sommet enfant ayant la distance la plus faible - \skv_ifx{\dijk_quark\dijk_currentnode} - {% si le sommet n'est pas trouv (graphe non connexe) + \dijk_ifx{\dijk_quark\dijk_currentnode} + {% si le sommet n'est pas trouvé (graphe non connexe) \global\let\dijkdist\dijk_infinity_code \let\dijk_nodestoexplore\empty% sortir de la boucle } @@ -272,13 +280,13 @@ \unless\ifx\dijk_nodestoexplore\empty \dijk_addstep \fi - \skv_ifx{\dijk_currentnode\dijk_endnode} + \dijk_ifx{\dijk_currentnode\dijk_endnode} {% si le sommet de sortie est atteint \let\dijk_nodestoexplore\empty% sortir de la boucle } {% sinon - \skv_exparg\dijk_removenode\dijk_currentnode% enlever ce sommet du graphe explorer - \skv_eearg{\dijk_foreach\dijk_temp\in}{\csname listofchilds_\dijk_currentnode\endcsname} + \dijk_exparg\dijk_removenode\dijk_currentnode% enlever ce sommet du graphe à explorer + \dijk_eearg{\dijk_foreach\dijk_temp\in}{\csname listofchilds_\dijk_currentnode\endcsname} {% \dijk_exptwoargs\dijk_ifinst\dijk_nodestoexplore{\dijk_temp,} {\dijk_exptwoargs\dijk_updatedist\dijk_currentnode\dijk_temp}% @@ -293,9 +301,9 @@ {\dijk_addtomacro\dijk_tab\hline}% \dijk_addtomacro\dijk_tab{\end{tabular}}% \dijk_eaddtomacro\dijk_tab{\dijk_post_tab}% - \skv_ifx{\dijk_quark\dijk_currentnode} + \dijk_ifx{\dijk_quark\dijk_currentnode} {\global\let\dijkpath\dijk_nopath_string} - {\skv_exparg\dijk_createpath\dijk_currentnode}% calculer le chemin sauf s'il est impossible trouver + {\dijk_exparg\dijk_createpath\dijk_currentnode}% calculer le chemin sauf s'il est impossible à trouver \ifboolKV[\dijkname]{show-tab}\dijk_tab{}% afficher le tableau \endgroup } @@ -307,21 +315,21 @@ } \def\dijk_createpathi#1% {% #1=sommet en cours - \skv_eearg{\def\dijk_temp}{\csname prev_#1\endcsname}% - \skv_ifx{\dijk_quark\dijk_temp} + \dijk_eearg{\def\dijk_temp}{\csname prev_#1\endcsname}% + \dijk_ifx{\dijk_quark\dijk_temp} {% } {% \xdef\dijkpath{\dijk_temp\dijk_path_sep\dijkpath}% - \skv_exparg\dijk_createpathi\dijk_temp + \dijk_exparg\dijk_createpathi\dijk_temp }% } \def\dijk_findmindist#1% -{% trouve dans "sommets explorer" celui ayant la distance mini +{% trouve dans "sommets à explorer" celui ayant la distance mini \let\dijk_mindist\dijk_maxint \let#1\dijk_quark - \skv_exparg{\dijk_foreach\dijk_currentnodechildname\in}\dijk_nodestoexplore + \dijk_exparg{\dijk_foreach\dijk_currentnodechildname\in}\dijk_nodestoexplore {% \ifnum\csname dist_\dijk_currentnodechildname\endcsname<\dijk_mindist\relax \expandafter\let\expandafter\dijk_mindist\csname dist_\dijk_currentnodechildname\endcsname @@ -331,8 +339,8 @@ } \def\dijk_whilenotempty#1#2% -{% tant que la macro #1 n'est pas \ifx-vide, excuter #2 - \skv_ifx{#1\empty}{}{#2\dijk_whilenotempty#1{#2}}% +{% tant que la macro #1 n'est pas \ifx-vide, exécuter #2 + \dijk_ifx{#1\empty}{}{#2\dijk_whilenotempty#1{#2}}% } \def\dijk_updatedist#1#2% @@ -348,7 +356,7 @@ \def\dijk_addstep {% \def\dijk_autoamp{\def\dijk_autoamp{\dijk_addtomacro\dijk_tab&}}% - \skv_exparg{\dijk_foreach\dijk_temp\in}\dijk_listofnodes + \dijk_exparg{\dijk_foreach\dijk_temp\in}\dijk_listofnodes {% \dijk_autoamp \dijk_exptwoargs\dijk_ifinst\dijk_nodestoexplore\dijk_temp @@ -356,9 +364,9 @@ \ifnum\csname dist_\dijk_temp\endcsname=\dijk_maxint\relax \dijk_eaddtomacro\dijk_tab{\dijk_infinity_code}% \else - \skv_ifx{\dijk_temp\dijk_currentnode}% si c'est le sommet fix, le mettre en valeur + \dijk_ifx{\dijk_temp\dijk_currentnode}% si c'est le sommet fixé, le mettre en valeur {% - \skv_ifcsname{distwithprev_\dijk_temp} + \dijk_ifcsname{distwithprev_\dijk_temp} {% \dijk_eeaddtomacro\dijk_tab{\expandafter\expandafter\expandafter\dijk_highlightnode \csname distwithprev_\dijk_temp\endcsname}% forme \dijk_highlightnode\formatnodewithprev{<dist>}{<sommet>} @@ -375,11 +383,11 @@ \fi }% {% - \dijk_eaddtomacro\dijk_tab{\dijk_no_revisit_code}% sommet dj fix + \dijk_eaddtomacro\dijk_tab{\dijk_no_revisit_code}% sommet déjà fixé }% }% \ifboolKV[\dijkname]{show-lastcol} - {\dijk_eaddtomacro\dijk_tab{\expandafter&\detokenize\expandafter{\dijk_currentnode}}}% ajout du sommet fix + {\dijk_eaddtomacro\dijk_tab{\expandafter&\detokenize\expandafter{\dijk_currentnode}}}% ajout du sommet fixé {}% \dijk_addtomacro\dijk_tab{\\}% \ifboolKV[\dijkname]{h-rules} @@ -406,10 +414,10 @@ \def\initdijk{\restoreKV[\dijkname]} -% Macros permettant de modifier les <valeurs> des <cls> +% Macros permettant de modifier les <valeurs> des <clés> \def\setdijk#{\setKV[\dijkname]} -% ... ainsi que les <valeurs> par dfaut +% ... ainsi que les <valeurs> par défaut \def\setdijkdefault#{\setKVdefault[\dijkname]} \newcommand*\formatnodewithprev[2]% @@ -431,16 +439,16 @@ show-tab = true,% afficher le tableau v-position = c,% argument optionnel de \begin{tabular}[<arg>] pre-tab = {},% juste avant le \begin{tabular} - post-tab = {},% juste aprs le \end{tabular} + post-tab = {},% juste après le \end{tabular} col-type = c,% colonnes de type "c" pour les colonnes de distances infinity-code = $\infty$,% pour distance infinie - norevisit-code = ---,% pour les sommets pralablement fixs - h-rules = false,% pas de filets entre les lignes des tapes - show-lastcol = false,% si vrai : mettre en plus la colonne "sommet fix" - lastcol-type = c|,% dernire colonne + norevisit-code = ---,% pour les sommets préalablement fixés + h-rules = false,% pas de filets entre les lignes des étapes + show-lastcol = false,% si vrai : mettre en plus la colonne "sommet fixé" + lastcol-type = c|,% dernière colonne lastcol-label = sommet fix\'e, nopath-string = Pas de chemin possible,% si chemin impossible - path-sep = -,% sparateur entre sommets dans le chemin + path-sep = -,% séparateur entre sommets dans le chemin } \endinput @@ -449,14 +457,18 @@ Versions : _____________________________________________________________________________ | Version | Date | Changements | |---------+------------+------------------------------------------------------| -| 0.1 | 06/09/2017 | Premire version | +| 0.1 | 06/09/2017 | Première version | |---------+------------+------------------------------------------------------| -| 0.11 | 09/09/2017 | - retrait d'un \show, laiss par oubli aprs les | -| | | phases de dbogage | +| 0.11 | 09/09/2017 | - retrait d'un \show, laissé par oubli après les | +| | | phases de débogage | | | | - petit nettoyage du code | |---------+------------+------------------------------------------------------| | 0.12 | 25/06/2020 | - bugfix : le package est rendu compatible avec la | | | | version 0.2 de simplekv | -| | | - bugfix : mauvaise gestion est espaces dans la macro| +| | | - bugfix : mauvaise gestion des espaces dans la macro| | | | \dijk_sanitizegraph | +|---------+------------+------------------------------------------------------| +| 0.13 | 01/10/2022 | - le package est rendu compatible avec la version | +| | | 0.2a de simplekv | +| | | - code en UFT8 | |---------+------------+------------------------------------------------------|
\ No newline at end of file diff --git a/macros/latex/contrib/flexipage/README.txt b/macros/latex/contrib/flexipage/README.txt index 92a9499b93..64936e8a48 100644 --- a/macros/latex/contrib/flexipage/README.txt +++ b/macros/latex/contrib/flexipage/README.txt @@ -2,6 +2,7 @@ LaTeX package flexipage Copyright (c) Anton Vrba, 2022 ------------------------------------------------------------------- Version: + 2022/10/01 1.01 added the option: extrafirstfoot 2022/07/09 1.00 Initial release Licence: This work may be distributed and/or modified under the conditions @@ -14,7 +15,8 @@ Abstract: The package flexipage allows easy page layout if marginalia is required. Mid document changes are possible such as: new marginal width, full width text, and landscape text without marginal. - Partners well with the package sidenotesplus. The package also - aids the layout for book printing, adding binding corrections - and adding page bleed, if required by the printers + The first page textheight can be reduced to allow for more + footerheight. Partners well with the package sidenotesplus. The + package also aids the layout for book printing, adding binding + corrections and adding page bleed, if required by the printers -------------------------------------------------------------------
\ No newline at end of file diff --git a/macros/latex/contrib/flexipage/flexipage.dtx b/macros/latex/contrib/flexipage/flexipage.dtx index 2188b2790f..0315c1c102 100644 --- a/macros/latex/contrib/flexipage/flexipage.dtx +++ b/macros/latex/contrib/flexipage/flexipage.dtx @@ -26,7 +26,8 @@ %<package>\NeedsTeXFormat{LaTeX2e}[2020/10/01] %<package>\ProvidesPackage{flexipage} %<*package> - [2022/07/09 1.00 Easy page geometry] +% [2022/07/09 1.00 Easy page geometry] + [2022/10/01 1.01 First Page different footer] %</package> % %<*driver> @@ -190,6 +191,7 @@ % % headsep = , % inherits from class % % headheight = , % inherits from class % % footskip= , % inherits from class +% % extrafirstfoot= , % 0pt, first page extra footer, reduces textheight % % show , % a switch to show frames around the printable areas. % % fancyhdrOff , % Do not use the fancyhdr package % % NoFixMargin % a possible future requirement @@ -201,7 +203,11 @@ % \paragraph{Known Issue:} If using the option |show| and the package \textsf{xcolor} % is loaded later with options, an error will occur. The reason % is that when option |show| is specified the package \textsf{eso-pic} is loaded -% whch in turns loads \textsf{xcolor} without options. +% which in turns loads \textsf{xcolor} without options. Remedy, load \textsf{xcolor} +% with options before loading \textsf{flexipage} +% +% If the option |extrafirstfoot| is used, and |show| is used then the frames for the +% first page do not show the effect of |extrafirstfoot|. % % \paragraph{Marginalia Position Issue:} When doing mid document changes to |\textwidth| % and |\marginparwidth| then |\marginpar{content}| renders the marginalia to the correct @@ -312,6 +318,8 @@ \newlength{\flx@printarea} \newlength{\flx@outerbleed} \newlength{\flx@innerbleed} +\newlength{\flx@extrafirstfoot} +\setlength{\flx@extrafirstfoot} {0pt} \setlength{\flx@binding} {9pt} \setlength{\flx@inner} {36pt} \setlength{\flx@outer} {36pt} @@ -359,6 +367,7 @@ headsep .code:n = \setlength{\headsep}{#1}, headheight .code:n = \setlength{\headheight}{#1}, footskip .code:n = \setlength{\footskip}{#1}, + extrafirstfoot .code:n = \setlength{\flx@extrafirstfoot}{#1}, fancyhdrOff .code:n = \Use@fancyhdrfalse, a4paper .code:n = \flx@setpapersize[210][297]{mm}, a5paper .code:n = \flx@setpapersize[148][210]{mm}, @@ -423,14 +432,21 @@ \setlength{\flx@temp}{\paperheight - \flx@top % - \headheight - \headsep -\footskip - \flx@bot - 2\flx@outerbleed} - \setlength{\textheight}{\flx@temp} + \setlength{\flx@textheigt}{\flx@temp} + \setlength{\textheight}{\flx@textheigt-\flx@extrafirstfoot} +%****************************************************************** } % \end{macrocode} % \end{macro} % % \begin{macrocode} \flx@setpagevertical -\setlength{\flx@textheigt}{\textheight} +\AddToHook{shipout/firstpage}{% +\global\textheight=\flx@textheigt +} + + + \newlength{\flx@linewidth} % \end{macrocode} % diff --git a/macros/latex/contrib/flexipage/flexipage.pdf b/macros/latex/contrib/flexipage/flexipage.pdf Binary files differindex 50018e6bfd..290f8f7b16 100644 --- a/macros/latex/contrib/flexipage/flexipage.pdf +++ b/macros/latex/contrib/flexipage/flexipage.pdf diff --git a/macros/latex/contrib/iexec/LICENSE.txt b/macros/latex/contrib/iexec/LICENSE.txt new file mode 100644 index 0000000000..bd949ffdab --- /dev/null +++ b/macros/latex/contrib/iexec/LICENSE.txt @@ -0,0 +1,21 @@ +(The MIT License) + +Copyright (c) 2021-2022 Yegor Bugayenko + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the 'Software'), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/macros/latex/contrib/iexec/README.md b/macros/latex/contrib/iexec/README.md index b147ac146c..018bf2a764 100644 --- a/macros/latex/contrib/iexec/README.md +++ b/macros/latex/contrib/iexec/README.md @@ -1,4 +1,5 @@ -[![make](https://github.com/yegor256/iexec/actions/workflows/latexmk.yml/badge.svg)](https://github.com/yegor256/iexec/actions/workflows/latexmk.yml) +[![l3build](https://github.com/yegor256/iexec/actions/workflows/l3build.yml/badge.svg)](https://github.com/yegor256/iexec/actions/workflows/l3build.yml) +[![CTAN](https://img.shields.io/ctan/v/iexec)](https://ctan.org/pkg/iexec) [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/iexec/blob/master/LICENSE.txt) This LaTeX package helps you execute commands from the document and then input @@ -18,7 +19,7 @@ Today is \iexec{date +\%e-\%b-\%Y | tr -d '\\n'}. ``` The full example and all commands are available in the -[`iexec.tex`](https://github.com/yegor256/exec/blob/master/iexec.tex) file. +[`iexec.pdf`](https://ftp.agdsn.de/pub/mirrors/latex/dante/macros/latex/contrib/iexec/iexec.pdf) file. If you want to contribute yourself, make a fork, then create a branch, then run `make` in the root directory. diff --git a/macros/latex/contrib/iexec/iexec.dtx b/macros/latex/contrib/iexec/iexec.dtx new file mode 100644 index 0000000000..fb38432b0e --- /dev/null +++ b/macros/latex/contrib/iexec/iexec.dtx @@ -0,0 +1,284 @@ +% \iffalse meta-comment +% (The MIT License) +% +% Copyright (c) 2021-2022 Yegor Bugayenko +% +% Permission is hereby granted, free of charge, to any person obtaining a copy +% of this software and associated documentation files (the 'Software'), to deal +% in the Software without restriction, including without limitation the rights +% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +% copies of the Software, and to permit persons to whom the Software is +% furnished to do so, subject to the following conditions: +% +% The above copyright notice and this permission notice shall be included in all +% copies or substantial portions of the Software. +% +% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +% SOFTWARE. +% \fi + +% \CheckSum{0} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} + +% \GetFileInfo{iexec.dtx} +% \DoNotIndex{\endgroup,\begingroup,\let,\else,\fi,\newcommand,\newenvironment} + +% \iffalse +%<*driver> +\ProvidesFile{iexec.dtx} +%</driver> +%<package>\NeedsTeXFormat{LaTeX2e} +%<package>\ProvidesPackage{iexec} +%<*package> +[01.10.2022 0.6.1 Inputable Shell Executions] +%</package> +%<*driver> +\documentclass{ltxdoc} +\usepackage[tt=false, type1=true]{libertine} +\usepackage{iexec} +\usepackage{href-ul} +\raggedbottom +\setlength{\parindent}{0pt} +\setlength{\columnsep}{32pt} +\setlength{\parskip}{6pt} +\PageIndex +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\begin{document} + \DocInput{iexec.dtx} + \PrintChanges + \PrintIndex +\end{document} +%</driver> +% \fi + +% \title{|iexec|: \LaTeX{} Package \\ for Inputable Shell Executions\thanks{The sources are in GitHub at \href{https://github.com/yegor256/iexec}{yegor256/iexec}}} +% \author{Yegor Bugayenko \\ \texttt{yegor256@gmail.com}} +% \date{\filedate, \fileversion} +% +% \maketitle +% +% \section{Introduction} +% +% This package helps you execute shell commands right from the +% document and then put their output to the document: +% +% \begin{multicols}{2} +% \setlength{\parskip}{0pt} +% \small +% \raggedcolumns +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage{iexec} +\begin{document} +Today is + \iexec{date +\%e-\%b-\%Y} +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi +% +% \columnbreak +% +% Today is \iexec{date +\%e-\%b-\%Y} +% \end{multicols} + +% \begin{macro}{\iexec} +% The only command provided by this package is |\iexec| \oarg{options} \marg{cmd}. +% Its only mandatory argument \meta{cmd} is the command to be executed +% through the terminal shell (bash, or whatever is set as the default one +% on your user console). +% \end{macro} + +% You have to run |pdflatex| (or just |latex|) +% with the |--shell-escape| flag +% in order to let |shellesc| (the package we use) +% to execute your shell command. + +% \section{Options} + +% \begin{macro}{quiet} +% If you don't want the output to be visible, +% use |\phantom\{\iexec{...}}|. +% Otherwise, you can use |quiet| option: +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage{iexec} +\begin{document} +I just want to delete some file: +\iexec[quiet]{rm -f foo.txt} +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi +% \end{macro} +% In this case, whatever the shell command produces will not be included +% into the document. + +% \begin{macro}{stdout} +% The output of your code is saved into the file provided as the +% second optional argument of |\iexec| (the default value is |iexec.tmp|): +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage{iexec} +\begin{document} +Today is \iexec[stdout=date.txt]{date +\%e-\%b-\%Y | tr -d '\\n'}. +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi +% The tailing part of the command here removes all ends-of-line. +% \end{macro} + +% \begin{macro}{trace} +% The file specified will be deleted right after its usage. If you don't +% want this to happen, use |trace| package option: all files will remain +% in the directory where they were created. +% It's possible to turn tracing on globbaly, for the entire document, using +% |trace| option of the package: +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage[trace]{iexec} +\begin{document} +This file won't be deleted: \iexec[stdout=me.txt]{whoami}. +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi +% \end{macro} + +% \StopEventually{} + +% \section{Implementation} + +% \changes{v0.2.0}{2021/07/10}{Initial version} +% \changes{v0.4.0}{2021/08/01}{Runtime verification for --shell-escape option} +% \changes{v0.4.1}{2021/08/08}{Options trace, stdout, and quiet added} +% \changes{v0.5.0}{2022/01/08}{Major bug fixes} + +% \iffalse +\RequirePackage{shellesc} +\RequirePackage{pgfkeys} +\RequirePackage{xkeyval} +\makeatletter\newif\ifiexec@trace +\DeclareOptionX{trace}{\iexec@tracetrue} +\ProcessOptionsX\relax\makeatother +\makeatletter\pgfkeys{ + /iexec/.is family, + /iexec, + stdout/.estore in = \iexec@stdout, + stdout/.default = iexec.tmp, + trace/.estore in = \iexec@traceit, + quiet/.estore in = \iexec@quiet, + stdout +}\makeatother +% \fi + +% \begin{macro}{\iexec} +% It is implemented with the help of |\ShellEscape| from |shellesc| package: +% \begin{macrocode} +\makeatletter\newcommand\iexec[2][]{% + \begingroup + \pgfqkeys{/iexec}{#1}% +% \end{macrocode} +% First, we verify that |latex| is running with |--shell-escape| option, since without +% it nothing will work; so, it's better to throw an error earlier than later: +% \begin{macrocode} + \ifdefined\pdfshellescape\ifnum\pdfshellescape=1\else% + \PackageError{iexec}{You must run latex with + --shell-escape option}{}% + \fi\fi% + \begingroup% +% \end{macrocode} +% Then, we define a few special chars in order to escape them in the shell +% (the full +% list of them is in \href{https://ctan.mirror.norbert-ruehl.de/info/macros2e/macros2e.pdf}{macros2e}): +% \begin{macrocode} + \let\%\@percentchar% + \let\\\@backslashchar% + \let\{\@charlb% + \let\}\@charrb% +% \end{macrocode} +% Then, we execute it: +% \begin{macrocode} + \ShellEscape{#2 > \iexec@stdout}% +% \end{macrocode} +% Then, a message is printed to TeX log: +% \begin{macrocode} + \message{^^Jiexec: [#2 > \iexec@stdout]^^J}% + \endgroup% +% \end{macrocode} +% Then, include the produced output into the current document: +% \begin{macrocode} + \ifdefined\iexec@quiet + \message{^^Jiexec: Due to 'quiet' we didn't read + the content of '\iexec@stdout'^^J}% + \else% + \input{\iexec@stdout}% + \message{^^Jiexec: The content of '\iexec@stdout' + was included into the document^^J}% + \fi% +% \end{macrocode} +% Finally, delete the file or leave it untouched: +% \begin{macrocode} + \ifiexec@trace% + \message{^^Jiexec: Due to package option 'trace', + the file '\iexec@stdout' was not deleted^^J}% + \else% + \ifdefined\iexec@traceit% + \message{^^Jiexec: Due to 'trace' option, + the file '\iexec@stdout' was not deleted^^J}% + \else% + \ShellEscape{rm \iexec@stdout}% + \message{^^Jiexec: The file '\iexec@stdout' was deleted^^J}% + \fi% + \fi% + \endgroup +}\makeatother +% \end{macrocode} +% \end{macro} + +% \Finale + +%\clearpage +% +%\PrintChanges +%\clearpage +%\PrintIndex diff --git a/macros/latex/contrib/iexec/iexec.ins b/macros/latex/contrib/iexec/iexec.ins new file mode 100644 index 0000000000..36172278a6 --- /dev/null +++ b/macros/latex/contrib/iexec/iexec.ins @@ -0,0 +1,55 @@ +%% (The MIT License) +%% +%% Copyright (c) 2021-2022 Yegor Bugayenko +%% +%% Permission is hereby granted, free of charge, to any person obtaining a copy +%% of this software and associated documentation files (the 'Software'), to deal +%% in the Software without restriction, including without limitation the rights +%% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +%% copies of the Software, and to permit persons to whom the Software is +%% furnished to do so, subject to the following conditions: +%% +%% The above copyright notice and this permission notice shall be included in all +%% copies or substantial portions of the Software. +%% +%% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +%% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +%% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +%% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +%% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +%% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +%% SOFTWARE. + +\input docstrip.tex +\keepsilent +\usedir{macros/latex/contrib/iexec} +\preamble +(The MIT License) + +Copyright (c) 2021-2022 Yegor Bugayenko + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the 'Software'), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +\endpreamble +\generate{\file{iexec.sty}{\from{iexec.dtx}{package}}} +\obeyspaces +\Msg{*** To finish the installation you have to move the ".sty"} +\Msg{*** file into a directory searched by TeX. To produce the} +\Msg{*** documentation run the file ".dtx" through LaTeX. If any} +\Msg{*** questions, submit a new GitHub issue.} +\endbatchfile diff --git a/macros/latex/contrib/iexec/iexec.pdf b/macros/latex/contrib/iexec/iexec.pdf Binary files differindex 2b9c52cd38..74233b4810 100644 --- a/macros/latex/contrib/iexec/iexec.pdf +++ b/macros/latex/contrib/iexec/iexec.pdf diff --git a/macros/latex/contrib/iexec/iexec.sty b/macros/latex/contrib/iexec/iexec.sty deleted file mode 100644 index e4cd6a5780..0000000000 --- a/macros/latex/contrib/iexec/iexec.sty +++ /dev/null @@ -1,77 +0,0 @@ -% (The MIT License) -% -% Copyright (c) 2021-2022 Yegor Bugayenko -% -% Permission is hereby granted, free of charge, to any person obtaining a copy -% of this software and associated documentation files (the 'Software'), to deal -% in the Software without restriction, including without limitation the rights -% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -% copies of the Software, and to permit persons to whom the Software is -% furnished to do so, subject to the following conditions: -% -% The above copyright notice and this permission notice shall be included in all -% copies or substantial portions of the Software. -% -% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -% SOFTWARE. - -\NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{iexec}[2022/01/09 0.5.1 Inputable Shell Executions] - -\RequirePackage{shellesc} -\RequirePackage{pgfkeys} -\RequirePackage{xkeyval} - -\makeatletter\newif\ifiexec@trace -\DeclareOptionX{trace}{\iexec@tracetrue} -\ProcessOptionsX\relax\makeatother - -\makeatletter\pgfkeys{ - /iexec/.is family, - /iexec, - stdout/.estore in = \iexec@stdout, - stdout/.default = iexec.tmp, - trace/.estore in = \iexec@traceit, - quiet/.estore in = \iexec@quiet, - stdout -}\makeatother - -\makeatletter\newcommand\iexec[2][]{% - \begingroup - \pgfqkeys{/iexec}{#1}% - \ifnum\pdfshellescape=1\else% - \PackageError{iexec}{You must run latex with --shell-escape option}{}% - \fi% - \begingroup% - \let\%\@percentchar% - \let\\\@backslashchar% - \let\{\@charlb% - \let\}\@charrb% - \ShellEscape{#2 > \iexec@stdout}% - \message{^^Jiexec: [#2 > \iexec@stdout]^^J}% - \endgroup% - \ifdefined\iexec@quiet - \message{^^Jiexec: Due to 'quiet' we didn't read the content of '\iexec@stdout'^^J}% - \else% - \input{\iexec@stdout}% - \message{^^Jiexec: The content of '\iexec@stdout' was included into the document^^J}% - \fi% - \ifiexec@trace% - \message{^^Jiexec: Due to package option 'trace', the file '\iexec@stdout' was not deleted^^J}% - \else% - \ifdefined\iexec@traceit% - \message{^^Jiexec: Due to 'trace' option, the file '\iexec@stdout' was not deleted^^J}% - \else% - \ShellEscape{rm \iexec@stdout}% - \message{^^Jiexec: The file '\iexec@stdout' was deleted^^J}% - \fi% - \fi% - \endgroup -}\makeatother - -\endinput diff --git a/macros/latex/contrib/iexec/iexec.tex b/macros/latex/contrib/iexec/iexec.tex deleted file mode 100644 index 2af507e7b3..0000000000 --- a/macros/latex/contrib/iexec/iexec.tex +++ /dev/null @@ -1,89 +0,0 @@ -% (The MIT License) -% -% Copyright (c) 2021-2022 Yegor Bugayenko -% -% Permission is hereby granted, free of charge, to any person obtaining a copy -% of this software and associated documentation files (the 'Software'), to deal -% in the Software without restriction, including without limitation the rights -% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -% copies of the Software, and to permit persons to whom the Software is -% furnished to do so, subject to the following conditions: -% -% The above copyright notice and this permission notice shall be included in all -% copies or substantial portions of the Software. -% -% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -% SOFTWARE. - -\documentclass[12pt]{article} -\usepackage[trace]{iexec} -\usepackage[tt=false,type1=true]{libertine} -\usepackage{multicol} -\usepackage{ffcode} -\title{\ff{iexec}: \LaTeX{} Package \\ for Inputable Shell Executions} -\author{Yegor Bugayenko} -\date{0.5.1 2022/01/09} -\begin{document} -\pagenumbering{gobble} -\raggedbottom -\setlength{\parindent}{0pt} -\setlength{\columnsep}{32pt} -\setlength{\parskip}{6pt} -\maketitle - -This package helps you execute shell commands right from the -document and then put their output to the document: - -\begin{multicols}{2} -\setlength{\parskip}{0pt} -\scriptsize -\raggedcolumns -\begin{ffcode} -\documentclass{article} -\usepackage{iexec} -\begin{document} -Today is \iexec{date +\%e-\%b-\%Y} -\end{document} -\end{ffcode} - -\columnbreak - -Today is \iexec{date +\%e-\%b-\%Y | tr -d '\\n'} -\end{multicols} - -You have to run \ff{pdflatex} (or just \ff{latex}) with the \ff{--shell-escape} flag -in order to let \ff{shellesc} (the package we use) to run shell. - -If you don't want the output to be visible, -use \ff{\char`\\phantom\char`\{\char`\\iexec\char`\{...\char`\}\char`\}}. - -The output of your code is saved into the file provided as the -second optional argument of \ff{\char`\\iexec} (the default value is \ff{iexec.tmp}): - -\begin{ffcode} -Today is \iexec[stdout=date.txt]{date +\%e-\%b-\%Y | tr -d '\\n'}. -\end{ffcode} - -The tailing part of the command here removes all ends-of-line. - -The file specified will be deleted right after its usage. If you don't -want this to happen, use \ff{trace} package option: all files will remain -in the directory. - -There are a few options you can provide for the \ff{\char`\\iexec} command: - -\begin{itemize} - \item \ff{trace}: to prevent the deletion of the file; - \item \ff{stdout=...}: to set the name of the file where the standard output of the command will be saved; - \item \ff{quiet}: to prevent including of the content into the document. -\end{itemize} - -More details about this package you can find -in the \ff{yegor256/iexec} GitHub repository. - -\end{document}
\ No newline at end of file diff --git a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.pdf b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.pdf Binary files differindex 9ad760140f..fb6a67967d 100644 --- a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.pdf +++ b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.pdf diff --git a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex index d653c2ac21..237021230d 100644 --- a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex +++ b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex @@ -21,9 +21,6 @@ %fancy \fancyhf{} \renewcommand{\headrulewidth}{0pt} -%\lhead{\sffamily \small [ProfLycee]} -%\chead{\entete{\classe{} - \annee}} -%\rhead{\sffamily \small - \thepage{} -} \lfoot{\sffamily \small [ProfLycee]} \cfoot{\sffamily \small - \thepage{} -} \rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}} @@ -60,8 +57,8 @@ \setlength{\parindent}{0pt} \definecolor{LightGray}{gray}{0.9} -\def\PLversion{1.2.6} -\def\PLdate{22 Septembre 2022} +\def\PLversion{1.2.7} +\def\PLdate{1\ier{} Octobre 2022} \tcbset{vignettes/.style={% nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,% @@ -235,6 +232,8 @@ Une commande pour, en \TikZ, créer un pixelart avec correction éventuelle. Une commande pour, en \TikZ, créer un SudoMaths non forcément $9\times9$. +Des commandes pour effectuer des calculs de probas (lois binomiale, exponentielle, de Poisson, normale). + \vspace{1.5cm} \hfill{}\textit{Merci à Anne pour ses retours et sa relecture !} @@ -1536,13 +1535,13 @@ Peu d'options pour ces commandes : \end{codecles} \begin{codetex}[listing only] -\liencapytale{abcd-12345} #lien simple, en sf +\liencapytale{abcd-12345} %lien simple, en sf -\liencapytale[~]{abcd-12345} #lien avec ~ à la fin, en sf +\liencapytale[~]{abcd-12345} %lien avec ~ à la fin, en sf -\liencapytale*{abcd-12345} #lien simple, en tt +\liencapytale*{abcd-12345} %lien simple, en tt -\liencapytale*[~]{abcd-12345} #lien avec ~ à la fin, en tt +\liencapytale*[~]{abcd-12345} %lien avec ~ à la fin, en tt \end{codetex} \begin{codesortie} @@ -3127,7 +3126,7 @@ Cette commande permet de rajouter le point moyen du nuage, calculé par la comma \item \Cle{couleur}, couleur du point moyen ; \hfill~défaut \Cle{red} \item \Cle{style} parmi \Cle{o} (rond) ou \Cle{x} (croix) ou \Cle{+} (plus) ; \hfill~défaut \Cle{o} \item \Cle{xg}, abscisse du point moyen, récupérable via \ctex{PLRegLin} ; \hfill~défaut \Cle{\textbackslash{}LXmoy} - \item \Cle{xy}, abscisse du point moyen, récupérable via \ctex{PLRegLin} ; \hfill~défaut \Cle{\textbackslash{}LYmoy} + \item \Cle{yg}, ordonnée du point moyen, récupérable via \ctex{PLRegLin} ; \hfill~défaut \Cle{\textbackslash{}LYmoy} \item \Cle{nom}, label du point moyen ; \hfill~défaut \Cle{G} \item \Cle{pos} qui est la position du label par rapport au point ; \hfill~défaut \Cle{above} \item \Cle{decal} qui est l'éloignement de la position du label par rapport au point ; \hfill~défaut \Cle{0pt} @@ -3368,6 +3367,193 @@ Sachant que la hauteur par défaut est de 1, il est -- a priori -- intéressant \newpage +\section{Calculs de probabilités}\label{calcprobas} + +\subsection{Introduction} + +\begin{codeidee} +L'idée est de proposer des commandes permettant de calculer des probabilités avec des lois classiques : + +\begin{itemize} + \item binomiale ; + \item normale ; + \item exponentielle ; + \item de Poisson +\end{itemize} +\end{codeidee} + +\begin{codeinfo} +Les commandes sont de deux natures : + +\begin{itemize} + \item des commandes pour calculer, grâce au package \ctex{xintexpr} ; + \item des commandes pour formater le résultat de \ctex{xintexpr}, grâce à \ctex{siunitx}. +\end{itemize} + +De ce fait, les options de \ctex{siunitx} de l'utilisateur affecterons les formatage du résultat, la commande va \og forcer \fg{} les arrondis et l'écriture scientifique. +\end{codeinfo} + +\subsection{Calculs \og simples \fg} + +\begin{codetex}[listing only] +%loi binomiale B(n,p) +\calcPbinomP{n}{p}{k} %P(X=k) +\calcPbinomC{n}{p}{a}{b} %P(a<=X<=b) +%loi de Poisson P (l) +\calcPpoissP{l}{k} %P(X=k) +\calcPpoissC{l}{a}{b} %P(a<=X<=b) +%loi normale N(m,s) +\calcPnormC{m}{s}{a}{b} %P(a<=X<=b) +%loi exponentielle E(l) +\calcPexpoC{l}{a}{b} %P(a<=X<=b) +\end{codetex} + +\begin{codecles} +Les probabilités calculables sont donc -- comme pour beaucoup de modèles de calculatrices -- les probabilités \textbf{P}onctuelles ($P(X=k)$) et \textbf{C}umulées ($P(a\leqslant X\leqslant b)$). + +\smallskip + +Pour les probabilités cumulées, on peut utiliser \ctex{*} comme borne ($a$ ou $b$), pour les probabilités du type $P(X\leqslant b)$ et $P(X \geqslant a)$. +\end{codecles} + +\begin{codetex}[listing only] +% X -> B(5,0.4) +$P(X=3) \approx \calcPbinomP{5}{0.4}{3}$. +$P(X\leqslant1) \approx \calcPbinomC{5}{0.4}{*}{1}$. +% X -> B(100,0.02) +$P(X=10) \approx \calcPbinomP{100}{0.02}{10}$. +$P(15\leqslant X\leqslant25) \approx \calcPbinomC{100}{0.02}{15}{25}$. +% Y -> P(5) +$P(Y=3) \approx \calcPpoissP{5}{3}$. +$P(Y\geqslant2) \approx \calcPpoissC{5}{2}{*}$. +% X -> N(0,1) +$P(X\leqslant1) \approx \calcPnormC{0}{1}{*}{1}$. +$P(-1,96\leqslant Z\leqslant1,96) \approx \calcPnormC{0}{1}{-1.96}{1.96}$. +% X -> N(550,30) +$P(Y\geqslant600) \approx \calcPnormC{550}{30}{600}{*}$. +$P(500\leqslant Y\leqslant600) \approx \calcPnormC{550}{30}{500}{600}$. +% Z -> E(0.001) +$P(Z\geqslant400) \approx \calcPexpoC{0.001}{400}{*}$. +$P(300\leqslant Z\leqslant750) \approx \calcPexpoC{0.001}{300}{750}$. +\end{codetex} + +\begin{codesortie} +$\bullet~~~~X \hookrightarrow \mathcal{B}(5\,;\,0,4)$ :\\ +$P(X=3) \approx \calcPbinomP{5}{0.4}{3}$.\\ +$P(X\leqslant1) \approx \calcPbinomC{5}{0.4}{*}{1}$. + +\medskip + +$\bullet~~~~X \hookrightarrow \mathcal{B}(100\,;\,0,02)$ :\\ +$P(X=10) \approx \calcPbinomP{100}{0.02}{10}$.\\ +$P(15\leqslant X\leqslant25) \approx \calcPbinomC{100}{0.02}{15}{25}$. + +\medskip + +$\bullet~~~~Y \hookrightarrow \mathcal{P}_5$ :\\ +$P(Y=3) \approx \calcPpoissP{5}{3}$.\\ +$P(Y\geqslant2) \approx \calcPpoissC{5}{2}{*}$. + +\medskip + +$\bullet~~~~X \hookrightarrow \mathcal{N}(0\,;\,1)$ :\\ +$P(X\leqslant1) \approx \calcPnormC{0}{1}{*}{1}$.\\ +$P(-1,96\leqslant Z\leqslant1,96) \approx \calcPnormC{0}{1}{-1.96}{1.96}$. + +\medskip + +$\bullet~~~~Y \hookrightarrow \mathcal{N}(550\,;\,30)$ :\\ +$P(Y\geqslant600) \approx \calcPnormC{550}{30}{600}{*}$.\\ +$P(500\leqslant Y\leqslant600) \approx \calcPnormC{550}{30}{500}{600}$. + +\medskip + +$\bullet~~~~Z \hookrightarrow \mathcal{E}_{0,001}$ :\\ +$P(Z\geqslant400) \approx \calcPexpoC{0.001}{400}{*}$.\\ +$P(300\leqslant Z\leqslant750) \approx \calcPexpoC{0.001}{300}{750}$. +\end{codesortie} + +\subsection{Complément avec sortie \og formaté \fg} + +\begin{codeidee} +L'idée est ensuite de formater le résultat obtenu par \ctex{xintexpr}, pour un affichage homogène. + +\smallskip + +L'utilisateur peut donc utiliser \og sa \fg{} méthode pour formater les résultats obtenus par \ctex{xintexpr} ! +\end{codeidee} + +\begin{codetex}[listing only] +%avec un formatage manuel +\num[exponent-mode=scientific]{\calcPbinomP{100}{0.02}{10}} +\end{codetex} + +\begin{codesortie} +$\bullet~~~~X \hookrightarrow \mathcal{B}(100\,;\,0,02)$ : + +$P(X=10) \approx \num[exponent-mode=scientific]{\calcPbinomP{100}{0.02}{10}}$. +\end{codesortie} + +\begin{codeidee} +Le package \ctex{ProfLycee} propose -- en complément -- des commandes pour formater, grâce à \ctex{siunitx}, le résultat. + +Les commandes sont dans ce cas préfixées par \ctex{num} au lieu de \ctex{calc} : + +\begin{itemize} + \item formatage sous forme décimale \textit{pure} : $0,00\ldots$ ; + \item formatage sous forme scientifique : $n,\ldots\times10^{\ldots}$. +\end{itemize} +\end{codeidee} + +\begin{codetex}[listing only] +%loi binomiale B(n,p) +\numPbinomP(*)[prec]{n}{p}{k} %P(X=k) +\numPbinomC(*)[prec]{n}{p}{a}{b} %P(a<=X<=b) +%loi de Poisson P (l) +\numPpoissP(*)[prec]{l}{k} %P(X=k) +\numPpoissC(*)[prec]{l}{a}{b} %P(a<=X<=b) +%loi normale N(m,s) +\numPnormC(*)[prec]{m}{s}{a}{b} %P(a<=X<=b) +%loi exponentielle E(l) +\numPexpoC(*)[prec]{l}{a}{b} %P(a<=X<=b) +\end{codetex} + +\begin{codecles} +Quelques précisions sur les commandes précédentes : + +\begin{itemize} + \item la version étoilée \Cle{*} des commandes formate le résultat en mode scientifique ; + \item l'argument optionnel (par défaut \Cle{3}) correspond à quant à lui à l'arrondi. +\end{itemize} +\end{codecles} + +\begin{codetex}[listing only] +% X -> N(550,30) +$P(Y\geqslant600) \approx \numPnormC[4]{550}{30}{600}{*}$. +$P(500\leqslant Y\leqslant600) \approx \numPnormC[4]{550}{30}{500}{600}$. +% X -> B(100,0.02) +$P(X=10) \approx \numPbinomP[7]{100}{0.02}{10} \approx \numPbinomP*[7]{100}{0.02}{10}$. +$P(15\leqslant X\leqslant25) \approx \numPbinomC[10]{100}{0.02}{15}{25} \approx \numPbinomC*[10]{100}{0.02}{15}{25}$. +\end{codetex} + +\begin{codesortie} +$\bullet~~~~Y \hookrightarrow \mathcal{N}(550\,;\,30)$ : + +$P(Y\geqslant600) \approx \numPnormC[4]{550}{30}{600}{*}$. + +$P(500\leqslant Y\leqslant600) \approx \numPnormC[4]{550}{30}{500}{600}$. + +\medskip + +$\bullet~~~~X \hookrightarrow \mathcal{B}(100\,;\,0,02)$ : + +$P(X=10) \approx \numPbinomP[7]{100}{0.02}{10} \approx \numPbinomP*[7]{100}{0.02}{10}$. + +$P(15\leqslant X\leqslant25) \approx \numPbinomC[10]{100}{0.02}{15}{25} \approx \numPbinomC*[10]{100}{0.02}{15}{25}$. +\end{codesortie} + +\newpage + \section{Conversions binaire/hexadécimal/décimal} \subsection{Idée} @@ -4129,6 +4315,8 @@ La grille, créée en \TikZ, est portée par le rectangle de \og coins \fg{} $(0 \section{Historique} +{\small \bverb|v1.2.7|~:~~~~Ajout de commandes pour des calculs de probabilités (page \pageref{calcprobas}) + {\small \bverb|v1.2.6|~:~~~~Ajout d'un environnement pour des SudoMaths (page \pageref{sudomaths}) {\small \bverb|v1.2.5|~:~~~~Ajout de commandes pour des boîtes à moustaches (page \pageref{boiteamoustaches}) diff --git a/macros/latex/contrib/proflycee/tex/ProfLycee.sty b/macros/latex/contrib/proflycee/tex/ProfLycee.sty index 7fdd37b256..708ef7b813 100644 --- a/macros/latex/contrib/proflycee/tex/ProfLycee.sty +++ b/macros/latex/contrib/proflycee/tex/ProfLycee.sty @@ -3,7 +3,8 @@ % or later, see http://www.latex-project.org/lppl.txtf \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{ProfLycee}[2022/09/22 v1.2.6 - Aide pour l'utilisation de LaTeX en lycee] +\ProvidesPackage{ProfLycee}[2022/10/01 v1.2.7 - Aide pour l'utilisation de LaTeX en lycee] +% 1.2.7 Calculs de probas pour des lois classiques % 1.2.6 Ajout d'un environnement tikz pour des sudomaths personnalisés % 1.2.5 Ajout d'une commande pour des boites à moustaches, en tikz % 1.2.4 Correction de quelques bugs mineurs, et mise à jour de la doc @@ -2179,4 +2180,154 @@ \end{tikzpicture} } +%================LOISPROBAS============ OK !! +%calculs "simples" +\newcommand\calcPbinomP[3]{%npk + \xintFloatToDecimal{\xintfloateval{binomial(#1,#3)*#2^#3*(1-#2)^(#1-#3)}} +} +\newcommand\calcPbinomC[4]{%npab + \def\BorneInf{#3}\def\BorneSup{#4} + \ifthenelse{\equal{#3}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#4}{*}}% + {\def\BorneSup{#4}} + {} + \xintFloatToDecimal{\xintfloateval{add(binomial(#1,i)*#2^i*(1-#2)^(#1-i), i=\BorneInf..\BorneSup)}} +} +\newcommand\calcPpoissP[2]{%lk + \xintFloatToDecimal{\xintfloateval{exp(-#1)*#1^#2/factorial(#2)}} +} +\newcommand\calcPpoissC[3]{%lab + \def\BorneInf{#2}\def\BorneSup{#3} + \ifthenelse{\equal{#2}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#3}{*}}% + {\def\BorneSup{10*#1}} + {} + \xintFloatToDecimal{\xintfloateval{add(exp(-#1)*#1^i/factorial(i), i=\BorneInf..\BorneSup)}} +} +%utiles idée de https://tex.stackexchange.com/questions/355574/im-searching-for-a-table-with-cdf-of-standard-normal-distribution +\xintdeffloatvar a_1,a_2,a_3,a_4,a_5,a_6 := +0.0705230784,0.0422820123,0.0092705272,0.0001520143,0.0002765672,0.0000430638; +\xintdeffloatvar rac2inv := sqrt(2)/2 ; +\xintdeffloatfunc erfc(x) := % uniquement pour x positif +((((((a_6*x+a_5)*x+a_4)*x+a_3)*x+a_2)*x+a_1)*x+1)**-16 ; % fin de définition de erfc(x) +\xintdeffloatfunc Phi(z) := (z>=0)?{1 - 0.5 * erfc(rac2inv * z)}{0.5 * erfc(-rac2inv * z)}; + +\newcommand\calcPnormC[4]{%msab + %def des bornes de l'intervalle suivant l'absence de a ou de b... + \def\BorneInf{#3}\def\BorneSup{#4} + \ifthenelse{\equal{#3}{*}}% + {\def\BorneInf{#4-10*#2}} + {} + \ifthenelse{\equal{#4}{*}}% + {\def\BorneSup{#3+10*#2}} + {} + \xintFloatToDecimal{\xintfloateval{Phi((\BorneSup-#1)/#2)-Phi((\BorneInf-#1)/#2)}} +} +%calculs "simples" fiabilite +\newcommand\calcPexpoC[3]{%lab + \def\BorneInf{#2}\def\BorneSup{#3} + \ifthenelse{\equal{#2}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#3}{*}}% + {\def\BorneSup{100/#1}} + {} + \xintFloatToDecimal{\xintfloateval{exp(-#1*\BorneInf)-exp(-#1*\BorneSup)}} +} + +%calculs formatés +\NewDocumentCommand{\numPbinomP}{ s O{3} m m m }{%*=sci,2=prec,3=n,4=p,5=k + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(binomial(#3,#5)*#4^#5*(1-#4)^(#3-#5),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintfloateval{round(binomial(#3,#5)*#4^#5*(1-#4)^(#3-#5),#2)}}} + } +} + +\NewDocumentCommand{\numPbinomC}{ s O{3} m m m m }{%*=sci,2=prec,3=n,4=p,5=a,6=b + \def\BorneInf{#5}\def\BorneSup{#6} + \ifthenelse{\equal{#5}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#6}{*}}% + {\def\BorneSup{#3}} + {} + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(add(binomial(#3,i)*#4^i*(1-#4)^(#3-i), i=\BorneInf..\BorneSup),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintfloateval{round(add(binomial(#3,i)*#4^i*(1-#4)^(#3-i), i=\BorneInf..\BorneSup),#2)}}} + } +} + +\NewDocumentCommand{\numPpoissP}{ s O{3} m m }{%*=sci,2=prec,3=lbda,4=k + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(exp(-#3)*#3^#4/factorial(#4),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintfloateval{round(exp(-#3)*#3^#4/factorial(#4),#2)}}} + } +} + +\NewDocumentCommand{\numPpoissC}{ s O{3} m m m }{%*=ing,2=prec,3=lbda,4=a,5=b + \def\BorneInf{#4}\def\BorneSup{#5} + \ifthenelse{\equal{#4}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#5}{*}}% + {\def\BorneSup{10*#3}} + {} + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(add(exp(-#3)*#3^i/factorial(i), i=\BorneInf..\BorneSup),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintfloateval{round(add(exp(-#3)*#3^i/factorial(i), i=\BorneInf..\BorneSup),#2)}}} + } +} + +\NewDocumentCommand{\numPnormC}{ s O{3} m m m m }{% + %*=ing,2=prec,3=mu,4=sigma,5=a,6=b + %def des bornes de l'intervalle suivant l'absence de a ou de b... + \def\BorneInf{#5}\def\BorneSup{#6} + \ifthenelse{\equal{#5}{*}}% + {\def\BorneInf{#6-10*#4}} + {} + \ifthenelse{\equal{#6}{*}}% + {\def\BorneSup{#5+10*#4}} + {} + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(Phi((\BorneSup-#3)/#4)-Phi((\BorneInf-#3)/#4),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintfloateval{round(Phi((\BorneSup-#3)/#4)-Phi((\BorneInf-#3)/#4),#2)}}} + } +} + +\NewDocumentCommand{\numPexpoC}{ s O{3} m m m }{%*=ing,2=prec,3=lbda,4=a,5=b + \def\BorneInf{#4}\def\BorneSup{#5} + \ifthenelse{\equal{#4}{*}}% + {\def\BorneInf{0}} + {} + \ifthenelse{\equal{#5}{*}}% + {\def\BorneSup{100/#3}} + {} + \IfBooleanTF{#1}% + {% + \num[exponent-mode=scientific]{\xintFloatToDecimal{\xintfloateval{round(exp(-#3*\BorneInf)-exp(-#3*\BorneSup),#2)}}} + }% + {% + \num[minimum-decimal-digits=#2]{\xintFloatToDecimal{\xintFloatToDecimal{\xintfloateval{round(exp(-#3*\BorneInf)-exp(-#3*\BorneSup),#2)}}}} + } +} + \endinput
\ No newline at end of file diff --git a/macros/latex/contrib/teubner/README b/macros/latex/contrib/teubner/README index 097e845f1d..065a7a3c92 100644 --- a/macros/latex/contrib/teubner/README +++ b/macros/latex/contrib/teubner/README @@ -1,6 +1,6 @@ -This accompanies the teubner bundle version 6.x dated November 2020 or later. +This accompanies the teubner bundle version 5.x dated November 2020 or later. -Copyright 2010-2020 Claudio Beccari +Copyright 2010-2022 Claudio Beccari The bundle contains the files @@ -16,15 +16,16 @@ version. The bundle has the status of author maintained. -The main purpose of this bundle is to provide classical philologists with -some means for typesetting their documents that usually contain very -specific mark up. -This version allows the typesetter to use both "italic" shapes: the +The main purpose of this bundle is to provide Hellenists and classical +philologists with some means for typesetting their documents that usually +contain very specific mark up. +This version allows the typesetter to use both Greek "italic" shapes: the Olga-like and the Lipsian-like ones; it complies with the LICR (LaTeX Internal Character Representation) of the Greek glyphs that avoid the kerning problems that arise with the ligature mechanism embedded in the LGR encoded default CBfonts; it is compatible with the use of different -vector Latin Type 1 fonts; contains new designs for the horizontally stretchable markers, et cetera. +vector Latin Type 1 fonts; contains new designs for the horizontally +stretchable markers, et cetera. Running pdflatex on the .dtx file produces both the documentation and extracts the byproduct files teubner.sty, teubnertx.sty, teubner.pdf. @@ -38,10 +39,10 @@ files if using the TX or the PX fonts; with other Type 1 fonts the necessary .fd files require manual intervention, which simply means giving a suitable command from within another open file that loads teubner. -Please, be sure to work with a 2010 updated collection of the CBfonts; +Please, be sure to work with an updated collection of the CBfonts; with a *2020* updated version of the TeX system; with a babel version 3.9g or later; with the language description file greek.ldf version 1.9b -or later; teubner version 6.2 and later patches the modifications of +or later; teubner version 5.2 and later patches the modifications of greek.ldf 1.10 so as cope with the ancient Greek numbering system. The teubner package works also with previous versions of the above pieces of software, but with limited performances. diff --git a/macros/latex/contrib/teubner/teubner-doc.pdf b/macros/latex/contrib/teubner/teubner-doc.pdf Binary files differindex 99117e0e59..1facc3adc6 100644 --- a/macros/latex/contrib/teubner/teubner-doc.pdf +++ b/macros/latex/contrib/teubner/teubner-doc.pdf diff --git a/macros/latex/contrib/teubner/teubner-doc.tex b/macros/latex/contrib/teubner/teubner-doc.tex index a0928ce0c1..aed4713fcf 100644 --- a/macros/latex/contrib/teubner/teubner-doc.tex +++ b/macros/latex/contrib/teubner/teubner-doc.tex @@ -46,7 +46,7 @@ An extension for Greek philology\\ User manual} \author{Claudio Beccari\thanks{\texttt{claudio dot beccari at gmail dot com}}} -\date{August 2022}% <---- this is the date of the teubenr-doc document! +\date{October 2022}% <---- this is the date of the teubenr-doc document! \def\comando#1{\expandafter\texttt\expandafter{\string#1}} \def\cs#1{\texttt{\char92#1}} \def\ARG#1{\texttt{\char123}\meta{#1}\texttt{\char125}} diff --git a/macros/latex/contrib/teubner/teubner.dtx b/macros/latex/contrib/teubner/teubner.dtx index 04a2072d5d..6a3e029252 100644 --- a/macros/latex/contrib/teubner/teubner.dtx +++ b/macros/latex/contrib/teubner/teubner.dtx @@ -43,7 +43,7 @@ See the end of the file. %<package>\ProvidesPackage{teubner}[% %<tbtx>\ProvidesPackage{teubnertx}[% %<*driver,package,tbtx> -2022/08/27 v.5.7 +2022/10/01 v.5.7.1 %<package>Extensions for Greek philology] %<tbtx>Access to the LGR encoded Greek fonts that match the TX fonts] %</driver,package,tbtx> @@ -84,7 +84,7 @@ See the end of the file. %</driver> % \fi % -% \CheckSum{4189} +% \CheckSum{4190} % \begin{multicols}{2}\tableofcontents\end{multicols} % % @@ -2257,7 +2257,7 @@ Type X <return> to exit.}% {\metricsfont>}}% litterae certe addendae \providecommand\LLadd{} \RenewDocumentCommand{\LLadd}{O{0pt}m O{0pt}}{% - {\metricsfont<\kern-0.3ex<}{\kern-#1\relax#2\kern-#3}% + {\metricsfont<\kern-0.3ex<\kern-0.3ex}{\kern-#1\relax#2\kern-#3}% {\metricsfont>\kern-0.3ex>}% }% litterae certe addendae \DeclareRobustCommand{\ladd}[1]{{\metricsfont\kern.15ex[\negthinspace}% diff --git a/macros/latex/contrib/teubner/teubner.pdf b/macros/latex/contrib/teubner/teubner.pdf Binary files differindex 362ca69f6a..ab9ec25648 100644 --- a/macros/latex/contrib/teubner/teubner.pdf +++ b/macros/latex/contrib/teubner/teubner.pdf diff --git a/macros/latex/contrib/teubner/teubner.txt b/macros/latex/contrib/teubner/teubner.txt index 1c088910a2..5bbd82c191 100644 --- a/macros/latex/contrib/teubner/teubner.txt +++ b/macros/latex/contrib/teubner/teubner.txt @@ -1,5 +1,5 @@ - THE TEUBNER PACKAGE VERSION 5.7 OF AUGUST 2022 + THE TEUBNER PACKAGE VERSION 5.7 OF OCTOBER 2022 EXTENSION FOR PHILOLOGICAL TYPESETTING @@ -26,7 +26,7 @@ documentation file teubner.pdf, the byproduct files teubner.sty, by running pdflatex on the source file teubner-doc.tex source file. These two .pdf files are already contained in the bundle. -File teubner-doc.pdf is the documentation file that shows what can be +File teubner-doc.pdf is the documentation file that shows what can be done with this extension package and displays several examples. Versiosn 5.2 and later of the teubner package is compliant with the Greek @@ -45,7 +45,7 @@ transform Arabic numerals into the classical Milesian and Attic number representations. From version 5.0 the teubner package has been patched in order to re-establish the above number transformations; some other improvements have been added that are transparent to the end user, since -they deal with the package internal workings. But these improvements +they deal with the package internal workings. But these improvements require a recent installation of the TeX system, because they use interfaces to the new LaTeX 3 language; the minimum date of the LaTeX kernel should not be earlier than January 2020. @@ -53,19 +53,19 @@ kernel should not be earlier than January 2020. Some time ago Antonis Tsolomitis uploaded the package txfontsb which adds the possibility of using nice TX compatible Greek fonts when using the TX latin fonts so as to let the users typeset their documents in -mixed script. The upright shape resembles the traditional Didot one, +mixed script. The upright shape resembles the traditional Didot one, and the italic shape resembles the Lipsian one; they come in both the medium and the bold series and match the TX latin fonts pretty well. -They probably match also the newer newtxtext fonts by Michael Sharpe, +They probably match also the newer newtx text fonts by Michael Sharpe, but since the latter have different font family names, the automatically produced .fd files for adapting the LGR encoded fonts to the TX fonts -are not suited for the newtxtext fonts; in order to have matching .fd +are not suited for the newtx text fonts; in order to have matching .fd files it is necessary to proceed in the same way as with any other font collection different from the TX one; the procedure is described in the teubner-doc.pdf document. Although Tsolomitis' fonts satisfy very well the everyday typesetting -necessities of the Greek users and blend well also with the TX math +needs of the Greek users and blend well also with the TX math fonts, they do not satisfy the requirements of the teubner package. This is why the processing of the teubner.dtx file generates also the file teubnertx.sty that is being input at begin document time when the user @@ -75,7 +75,7 @@ In order to use this extension package with LaTeX you have to install it. May be the very installation of your (recent) TeX system distribution already provided for this task; may be your TeX system is configured to load missing packages on the fly. In any case you can check and possibly -run your Package Manager (with MiKTeX follow the path: +run your Package Manager: with MiKTeX follow the path: Programs|MiKTeX Settings|Packages; with TeXlive and MacTeX (if their installation configuration was not the default complete one) run tlmgr. @@ -99,10 +99,10 @@ teubner.pdf file that you get by running pdflatex directly on teubner.dtx. For what concerns fonts, they should already be installed with a recent TeX system distribution; this means that there are already all the files TeX-the-program needs in order to do its work; there is one -point, though, that requires full attention; the default basic TeX +point, though, that requires full attention; the default *basic* TeX system installation loads only the PostScript fonts in size 10pt; all other sizes are obtained by reducing or enlarging that single size. -A complete TeX system installation does not exhibit this limitation. +A *complete* TeX system installation does not exhibit this limitation. There are also non standard scalable Type 1 fonts, such for example, the Fourier ones, that come only in one size, the 10pt one; for these fonts it is not strictly necessary to do the same with the sizes of the |