summaryrefslogtreecommitdiff
path: root/macros/generic/markdown/markdown.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-08-08 03:01:03 +0000
committerNorbert Preining <norbert@preining.info>2021-08-08 03:01:03 +0000
commited204b296810be74994f70f76b7f5b849f6e9ecb (patch)
treef39bb9d2abbf54d1fa1a585d245a0942c77e2f05 /macros/generic/markdown/markdown.md
parent5991e0faa2ab9a1b9bdb72d6399cff4444b02f35 (diff)
CTAN sync 202108080301
Diffstat (limited to 'macros/generic/markdown/markdown.md')
-rw-r--r--macros/generic/markdown/markdown.md17
1 files changed, 14 insertions, 3 deletions
diff --git a/macros/generic/markdown/markdown.md b/macros/generic/markdown/markdown.md
index 443a64fd6e..dcded9f944 100644
--- a/macros/generic/markdown/markdown.md
+++ b/macros/generic/markdown/markdown.md
@@ -68,7 +68,10 @@ This should produce the following files:
* `markdown.lua`, the Lua module,
* `markdown-cli.lua`, the Lua command-line interface,
* `markdown.tex`, the plain \TeX{} macro package,
- * `markdown.sty`, the \LaTeX{} package, and
+ * `markdown.sty`, the \LaTeX{} package,
+ * `markdownthemewitiko_dot.sty`, the `witiko/dot` \LaTeX{} theme,
+ * `markdownthemewitiko_graphicx_http.sty`, the `witiko/graphicx/http` \LaTeX{} theme,
+ * `markdownthemewitiko_tilde.sty`, the `witiko/tilde` \LaTeX{} theme, and
* `t-markdown.tex`, the \Hologo{ConTeXt} module.
### Local Installation
@@ -81,6 +84,9 @@ placed:
* `<TEXMF>/scripts/markdown/markdown-cli.lua`
* `<TEXMF>/tex/generic/markdown/markdown.tex`
* `<TEXMF>/tex/latex/markdown/markdown.sty`
+ * `<TEXMF>/tex/latex/markdown/markdownthemewitiko_dot.sty`
+ * `<TEXMF>/tex/latex/markdown/markdownthemewitiko_graphicx_http.sty`
+ * `<TEXMF>/tex/latex/markdown/markdownthemewitiko_tilde.sty`
* `<TEXMF>/tex/context/third/markdown/t-markdown.tex`
where `<TEXMF>` corresponds to a root of your \TeX{} distribution, such as
@@ -94,6 +100,11 @@ Alternatively, you can also store the above files in the same folder as your
\TeX{} document and distribute them together. This way your document can be
portably typeset on legacy \TeX{} distributions.
+Since Markdown version 2.10.0, the file `markdown.tex` must be placed in
+a directory named `markdown` due to [issue #74][issue-74].
+
+ [issue-74]: https://github.com/witiko/markdown/issues/74 (Does not compile if user names own document markdown.tex)
+
First Document
--------------
@@ -118,8 +129,8 @@ Using a text editor, create a text document named `hello.lua` with the
following content:
``` lua
#!/usr/bin/env texlua
-local kpse = require("kpse")
-kpse.set_program_name("luatex")
+local ran_ok, kpse = pcall(require, "kpse")
+if ran_ok then kpse.set_program_name("luatex") end
local markdown = require("markdown")
local convert = markdown.new()
print(convert("Hello *world*!"))