From 9296cf13088500c7f4dca0a89181802ce13debdc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?V=C3=ADt=20Novotn=C3=BD?= Date: Thu, 31 Mar 2022 18:56:21 +0200 Subject: [PATCH] Describe the role of directory `contributions/` in README.md --- README.md | 12 ++++++++++-- contributions/README.md | 8 ++++++++ 2 files changed, 18 insertions(+), 2 deletions(-) create mode 100644 contributions/README.md diff --git a/README.md b/README.md index 38661d1c3..8460bb5c8 100644 --- a/README.md +++ b/README.md @@ -245,8 +245,8 @@ Acknowledgements [option-slice]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#slice "Markdown Package User Manual" [option-table-captions]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#option-tablecaptions "Markdown Package User Manual" -Contributing ------------- +Contributing to the Development of Markdown +------------------------------------------- Apart from the example markdown documents, tests, and continuous integration, which are placed in the `examples/`, `tests/`, and `.github/` directories, @@ -282,6 +282,14 @@ reproduced by running the `docker build` command on `Dockerfile` (`docker build [literate programming]: https://en.wikipedia.org/wiki/Literate_programming "Literate programming" [ltxdockit]: https://ctan.org/pkg/ltxdockit "ltxdockit – Documentation support" +Contributed Software +-------------------- + +Links to contributed third-party software for the Markdown package are +available in the `contributions/` directory. The intention is to show +interesting tools for the Markdown package and to give them wider exposure +without taking responsibility for their development or maintenance. + Citing Markdown --------------- diff --git a/contributions/README.md b/contributions/README.md new file mode 100644 index 000000000..3ae37599d --- /dev/null +++ b/contributions/README.md @@ -0,0 +1,8 @@ +This directory contains Git submodules with external repositories that have +been contributed to the Markdown package: + +- [book-templates][]: Open-source Markdown LaTeX themes for typesetting books and marketing colaterals +- [pandoc-to-markdown][]: A proof-of-concept that shows how Pandoc can be integrated with the Markdown package, so that we can typeset and style any document format understood by Pandoc directly from TeX + + [book-templates]: https://github.com/xvrabcov/md-templates + [pandoc-to-markdown]: https://github.com/drehak/pandoc-to-markdown