This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --75mDAxQSwGByemw0VL8XYQVeCtlysHXSi
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable

Hello,

is there a virtual package for viewing MD documents
(as the virtual package pdf-viewer is for PDF documents) ?

Thanks in advance,
Jerome

--
Jerome BENOIT | calculus+at-rezozer^dot*net https://qa.debian.org/[email protected]
AE28 AE15 710D FF1D 87E5 A762 3F92 19A6 7F36 C68B


--75mDAxQSwGByemw0VL8XYQVeCtlysHXSi--

-----BEGIN PGP SIGNATURE-----

wsN5BAABCAAjFiEEriiuFXEN/x2H5adiP5IZpn82xosFAmHuczIFAwAAAAAACgkQP5IZpn82xouW ch//RN7Ue3r2W7xzACktgimj4hyLMS3s/Dnu+lh++8MeINJZhbDhHivun0cFcpscGBkdGxU48Wve 6/61nkSe08cqQswrtSYW9hUMOdNad0mHCRy01LiHxTI1uToKxWBi4QdYl6AFujDijXcxGa+DKGSY WY59c3q8KTDZHIJtWkxyrViCJn+opxnCCGUKmgUFIP4X+IstnLcoJ8NhClcWjV1/bLMg8dtSkbWU TPPKmWAgDpKbpnzFpKjJICmFmcCZ7cLvmFwjLLOg1W8dYRfDvJJldTEimds26wnVe0wP9s3BF1fU IVbSBEFYo7RVSeoShcxi1RPvLjfa/Jp25Slic0ShhfXayZwLjII8xWfTDh4dnZT2PoWI8YRy69vA phhH7aAU+EslWWZ/Foi/kbZZl0ynrHFuo76UPxKa6afsWu3/vJkCAm06WlaiPXjTKq2mvyj71WNC +P30vVCUnwaPSMzU4uz9DPX/KcwCY/aXJ8EZ0dajzht9gkgUarb8Ebfq2TNwf2cORmMkArAqzukh WOyjbcqhZrp1/g7N5q5+OzJclrR1DRsn8IiTMtW00hvNulnfgsbDAyoiU/gLDp+xqqWXksPRNxhF ytmN8HgcLy5L6vsggWDlVPOFsWuob4FHVrx3I2iC//ScNf6qzK4qDl6DPj/JA2jittWcbBQd9k/D

On Mon, Jan 24, 2022 at 10:36:50AM +0100, Jerome BENOIT wrote:

is there a virtual package for viewing MD documents

Do you mean Markdown? Are there specialized viewers for it at all?

--
WBR, wRAR

-----BEGIN PGP SIGNATURE-----

iQJhBAABCgBLFiEEolIP6gqGcKZh3YxVM2L3AxpJkuEFAmHueL4tFIAAAAAAFQAP cGthLWFkZHJlc3NAZ251cGcub3Jnd3JhckBkZWJpYW4ub3JnAAoJEDNi9wMaSZLh OQIP/0FHVkfFtJIkkzCHm+yPMZ2d/qEXU/2LFD1T3mCPOSh9TDoVjOdO422RjPuV B4RTCmIt1lOXG2KZKzYx6ou21DuOgRYP4NEKlydmCMD6PFZ+vrTgLQiup7t091Wh PWj4PUqB8qPfxdPxiaOWj4Nx3rQopY+9X85/LIDXiCId/+/Q2f8alxsG5I16LCUB s8QnV+xPjmSWRXE03IIpHL6KRmZyDA7zs+32bZdnQpQqjCNLsU2gONMMb7uV/O3/ ynQ1Ojv/iLUUI7+lGwmjvN+j4H1mSU+QsXkCNazTy7txD5/tC+4rbqv6ec3FCUO7 WtJBOewn2SHxMmyYb7q3lcjUTwnDS5AIIZFrL6mi3z/9SoDE7i5qzhDU3wukT53W zz+tBgMJklkgAUhgr6YVAxZgCx7uxsZinEda+9mfx1CIlcVMqETGyR7scWScCvJ1 Qi5NqpgLrNCZ26te6nhjHwXIBDty/zS6XpI5M1bUgsVv8h4gobvfmkChHaHDxXgH 5RAGAVNG9pvRxiZkTQasbHD1TBHSOvP1lcV12V6HUIBCoWBzSJqdn7ehglMVqftO aeqxlBFnYDXcARNpGdYBINGyBgAPOb0/o7B3u5Pg/FKYXNEAHz42+PSXkHFzljGC 0QxrTtNuUAYPNB0SwNNtJMv52QUH53SRcNXeRvj38EsODs5T
=kkTP
-----END PGP SIGNATURE-----

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Andrey Rahmatullin <[email protected]> writes:

On Mon, Jan 24, 2022 at 10:36:50AM +0100, Jerome BENOIT wrote:

is there a virtual package for viewing MD documents

Do you mean Markdown? Are there specialized viewers for it at all?

The only one I know is https://metacpan.org/pod/sdview, but that's not
packaged in Debian (yet).

- ilmari

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Hi Jerome,

Quoting Jerome BENOIT (2022-01-24 10:36:50)

is there a virtual package for viewing MD documents
(as the virtual package pdf-viewer is for PDF documents) ?

I assume that by MD you mean markdown...

No, Debian has no general virtual "markdown-viewer" package.

Unlike PDF and DjVu, Markdown is by design sloppy which has lead to a multitude of "flavors", so I suspect it is unlikely that we can find any common baseline that such virtual package should promise to provide.

Possibly it would make sense to define a
"commonmark-github-flavored-viewer" since that is a reasonably popular
flavor?

Here are some markdown viewers/editors currently in Debian:

* grip
* formiko
* mdp
* pampi
* ghostwriter
* kookbook
* retext

Why do you ask? Because you are looking for markdown viewers or because
you are packaging one and want to declare it as such, or...?

- Jonas

--
* Jonas Smedegaard - idealist & Internet-arkitekt
* Tlf.: +45 40843136 Website: http://dr.jones.dk/

[x] quote me freely [ ] ask before reusing [ ] keep private --==============423226082671813121=MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Description: signature
Content-Type: application/pgp-signature; name="signature.asc"; charset="us-ascii"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEn+Ppw2aRpp/1PMaELHwxRsGgASEFAmHuiR0ACgkQLHwxRsGg ASEbVg//djiHBpLn3ykHzCk/XYIvgxDpUTXuaSbzxtlxbH3QvsE7afogtzDvlfg3 mlMRIGPjyj2BgsSVYZHzzzgVzBB+UzL1b+Qp9VGTwu1B16vxG8oC86UNCqysrPCu vDYxISS2aFWcP9ufkdY9CUhYqs+OkxotgNbQIMBfWO2prEgTw6w/jZPxvITAvO6Q Om8aZIeyi8V/mp50NDgupxh8NnFtn7Nc2rmyB8kA9m47TUJKqxzhLivjadXGLe9K 9HjSI2iudFHJZyKz7addLLIFg0s4NeQ22pMZmdIoCkuexDCReoKUqWLdTlUt60Ft 0VRS9E9QZwP6j7PUoqVr3G6DDHfzFqZFTnfcmsP4RRg7TAYGqg/tl4VH9oFpDi2s 7K00pTv43WHhMDbhEUeAWfa/J29j7CDysbSu0aOLKZt+QZwMP2/oZAMB2JF49ZpK g6Tq1oupx5uBxBwk+ZHGniN4sKALYIlCbT5NeONusLvVwlxhLJAicRORWTUov/GG cbVv9cmxz7J8DAFNh

This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --nMAgJ1xnV0bYvv4Lm9Q74w0W6BC45nFeY
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable

Hello All, thanks for your replies.

On 24/01/2022 12:10, Jonas Smedegaard wrote:

Hi Jerome,

Quoting Jerome BENOIT (2022-01-24 10:36:50)

is there a virtual package for viewing MD documents
(as the virtual package pdf-viewer is for PDF documents) ?

I assume that by MD you mean markdown...

indeed

No, Debian has no general virtual "markdown-viewer" package.

Unlike PDF and DjVu, Markdown is by design sloppy which has lead to a multitude of "flavors", so I suspect it is unlikely that we can find any common baseline that such virtual package should promise to provide.

Possibly it would make sense to define a
"commonmark-github-flavored-viewer" since that is a reasonably popular flavor?

Here are some markdown viewers/editors currently in Debian:

* grip
* formiko
* mdp
* pampi
* ghostwriter
* kookbook
* retext

Why do you ask? Because you are looking for markdown viewers or because
you are packaging one and want to declare it as such, or...?

I am asking because a software that I am currently packaging has its documents in MarDown (GitHub flavour, I guess).

So my understanding now is that there is no point to look for a generic MD viewer.

Therefore I am now considering to convert them in PDF and/or HTML documents.

Cheers,
Jerome

- Jonas

--
Jerome BENOIT | calculus+at-rezozer^dot*net https://qa.debian.org/[email protected]
AE28 AE15 710D FF1D 87E5 A762 3F92 19A6 7F36 C68B


--nMAgJ1xnV0bYvv4Lm9Q74w0W6BC45nFeY--

-----BEGIN PGP SIGNATURE-----

wsN5BAABCAAjFiEEriiuFXEN/x2H5adiP5IZpn82xosFAmHukaAFAwAAAAAACgkQP5IZpn82xouP Fx/7BKqw5j6Cd6BKE9ZoWmwGouLKwDLT65O959kabBsmlg6P10r4cr4wbww4MlFCoLWqPy6xfIp9 aWCGesTUxvzb2Y/G1rGYEsC25Cpa2BRmG3oa0ho8Y3PfldEn9OOJBz06a/Ld18UK7d9+uK0Ch8jY ebs60AaVVhXIctqXkbQNprVBnVXFXZYHMbBUuRjlRKJwmnLfhaQd1iHpLs1SLhdzt3SKeLDnnW/H 4qe1fcK+I8IBrmgXjElfbwOTZIuDVsLHW4uXomQYvD3U88egJwW69eNlavceQsfn+U5qCjefCN5T gIcQ79T+43nXpQ6R+nQhOUtlUXdxwILOiTId3nFmRjtj0Bhge7uXkf7PLT5njqQqyVv9KZKxwg2m Dg2x7Y0+jelyn2VP4i8TOtqOxcYp3KFaR4qq4uHnI+83nylKPhkXpO8cnjoHWNAopQHIIhzz75tu NVCyAt8FWeTwo6ZQfc/hSAQpSq58FRmVLXgjn5les9RF71ftxxjHUKpSRljnlSeSyhygUFMhOujl Nn53ixKWKjT/EpurLaxJah00/RITytX/Jhed+l1UFdKDecjjZqe+CvxScOh7GnmiDI2xcRD7V+Jt 2bRhEJOUIGF1j3yKrev7+g85eF/OSNtCqoalKg2lXeOS8Q1olLzDiWQQZKw87K+LK1HjGJYpC6py

On Mon, Jan 24, 2022 at 12:46:40PM +0100, Jerome BENOIT wrote:

I am asking because a software that I am currently packaging has its documents
in MarDown (GitHub flavour, I guess).

You can likely read those with `less`.
Alternatively, software is likely to ship a build script for e.g. HTML in
which case you should use it (see https://www.debian.org/doc/debian-policy/ch-docs.html#preferred-documentation-formats).

--
WBR, wRAR

-----BEGIN PGP SIGNATURE-----

iQJhBAABCgBLFiEEolIP6gqGcKZh3YxVM2L3AxpJkuEFAmHulrYtFIAAAAAAFQAP cGthLWFkZHJlc3NAZ251cGcub3Jnd3JhckBkZWJpYW4ub3JnAAoJEDNi9wMaSZLh 3YMQAIh34jpPsltfS2juWTvC4um5aLcBF4QpDNjPCviYaucCO6F2hol0d6gjm6Hu rlHM7ew+djLnX49698Zbh4vJtk59duQkiiaAWfRkuhyTz5GqwEs7bYgvgmulYADr 7wxqSAeWsrvJ/aNwY+LQTpO7BCX9kxSsKmwh5weox9f2M7y0csm6oi00gxpN+NgQ KJCfO/wmsgLj6an8YosJmrioCg7QKH8XJlzTrj6K6i71ckxSjat3YK/lk6dtOEz3 YoNItP0GJ/PhFo529AlzI/WYZzbeBu3eeECnHFlqne+064IknP30BceIgianJb1G +ZiSUMmAgPR+ddRzp1rPpisVWks4xi8xRjjS/Wif4FA/Yp0hT08WGZX/uU6cyvsl 8JXvX81h1z6BUjf5pp89MMstNV/4dTbgSuSSiV1PhxCZhCnM4oinyb2Cf8LuqFo2 9Z80AiWrab+dVXghoCxJcsWWjnqheZd0Z+sv1HAX4YsxKoSrvca57V+vD03UxmoJ 62t8T2Wh44o8cNriuJ3VG3cG3Yd8d3XyUXE0T9mD+by7uAGt4F5/KfiF1pcOQwBV NEiQ2TCODiuhUG0dTxr8mXy7yls45IegNgx+hBYhdW4/P5ADMGoQ0t4qmzyhOmKH PlrZws+0IWHhRMS1sf48QMgdae//tlWI/DnQPAA4osgcHl5R
=O/jm
-----END PGP SIGNATURE-----

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Quoting Jerome BENOIT (2022-01-24 12:46:40)

On 24/01/2022 12:10, Jonas Smedegaard wrote:

Quoting Jerome BENOIT (2022-01-24 10:36:50)

is there a virtual package for viewing MD documents
(as the virtual package pdf-viewer is for PDF documents) ?

[...]

Why do you ask? Because you are looking for markdown viewers or
because you are packaging one and want to declare it as such, or...?

I am asking because a software that I am currently packaging has its documents in MarDown (GitHub flavour, I guess).

So my understanding now is that there is no point to look for a
generic MD viewer.

Therefore I am now considering to convert them in PDF and/or HTML
documents.

It is quite common nowadays for software projects to ship at least core documentation in (github- or Gitlab-flavored) Markdown (or CommonMark, a non-sloppy spec'ed slight subset of Markdown).

As others replying here have indicated, the easiest is to ship such
files as-is, assuming that the reader is geeky enough to read it raw.

Personally I am of the opinion that more ideally such documentation
should be treated as a source format with two targets - html and
plaintext - and that both those target formats should be generated
during package build and installed with the binary package(s).

For Github-flavored Markdown I recommend to render both target formats
using the command-line tool cmark-gfm. Here is an example of that: https://salsa.debian.org/debian/doctest/-/commit/d9b848b

For most other flavors of Markdown I recommend to render using pandoc.
Here is an example of that: https://salsa.debian.org/js-team/twitter-bootstrap3/-/commit/f138bf1

For Gitlab-flavored Markdown there are currently no parser in Debian,
but depending on the actual markup used you might get away with pandoc +
a filter (but may then give up on rendering as plaintext). Here is an
example of that:
https://salsa.debian.org/matrix-team/olm/-/commit/094396d

Feel free to reach out if you need help juggling Markdown or using
pandoc. I am no expert, but am interested, and am in touch with the
author if all else fails ;-)


- Jonas

--
* Jonas Smedegaard - idealist & Internet-arkitekt
* Tlf.: +45 40843136 Website: http://dr.jones.dk/

[x] quote me freely [ ] ask before reusing [ ] keep private --==============P23906159631008059=MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Description: signature
Content-Type: application/pgp-signature; name="signature.asc"; charset="us-ascii"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEn+Ppw2aRpp/1PMaELHwxRsGgASEFAmHupaMACgkQLHwxRsGg ASGmOg//dVp1RaBstSTp6t2F8KMfy5d3EDHC5Kl/S8IpwyYK2VR9nawXOaOk0rM0 Ye15DqjJtL/Hc3nJdzXWNdA2AXmoX842tzpnPDchaKOCQ24Qp9hFgmcUvE5oHpkE DcX2pVFPmgTMUbf2l+JXVyLL+cDLhtwRHxM/3jVOLHRayiXy922M144wDZyS8jmF TEjdjj5SC5bShQQfwu20D3zvhNtyA1cbADll8h27OBhNcMR2kIiNf6ErbTJ6UecB QT3pmmn8aHOhIMBPZP72HrXM+sTk2eb3UOUjaUapNFMxE16bzc0IJNiaLz8YPlYR jxVIt7wnAnIHWvJmxAwy/cfM+GrZcIzwwwXLd/xcdr91Uul/E0iynBrGT2w4jDA3 wluR9Equi54ctpatgevKjtb1TKuzgkNezyoHb9AmPfmw0ZorwyN3Z5Y5MUoAIS31 fiJHRATqISYJqNhGjEatTzCwT0dGw30AXfdFsPSPZrk+Y7+qjNZHGFJ8nEj3jSKX 3b+0o0KdEytI0QZY8

On Mon, Jan 24, 2022 at 02:12:06PM +0100, Jonas Smedegaard wrote:

Personally I am of the opinion that more ideally such documentation
should be treated as a source format with two targets - html and
plaintext - and that both those target formats should be generated
during package build and installed with the binary package(s).

For Github-flavored Markdown I recommend to render both target formats
using the command-line tool cmark-gfm. Here is an example of that: https://salsa.debian.org/debian/doctest/-/commit/d9b848b

For most other flavors of Markdown I recommend to render using pandoc.
Here is an example of that: https://salsa.debian.org/js-team/twitter-bootstrap3/-/commit/f138bf1

For Gitlab-flavored Markdown there are currently no parser in Debian,
but depending on the actual markup used you might get away with pandoc +
a filter (but may then give up on rendering as plaintext). Here is an example of that:
https://salsa.debian.org/matrix-team/olm/-/commit/094396d

Feel free to reach out if you need help juggling Markdown or using
pandoc. I am no expert, but am interested, and am in touch with the
author if all else fails ;-)

I maintain "lowdown" in Debian. It supports several markup extensions
including several from GFM and CommonMark, and can output in HTML5, roff (man/ms), LaTeX, ODF etc. It also has a terminal output mode, that can
be used to format and view Markdown documents in a pager. Upstream is at https://kristaps.bsd.lv/lowdown/ and the package in Debian is just
"lowdown". Upstream is very responsive, so if you miss a particular
feature please file a bug (preferrably upstream, but I can also forward)

It's written in plain C and has no dependencies apart from libbsd. That
is of note, because pandoc is notorious for being hard to bootstrap
(because of Haskell) and the only other alternative I had explored for
my use case was ronn, which is in Ruby and thus also has a complicated dependency chain. (Depending on your package, you may or may not care
about your build-dependency chain; I did.)

Regards,
Faidon

1: https://kristaps.bsd.lv/lowdown/

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Hi Faidon,

Quoting Faidon Liambotis (2022-01-24 15:03:44)

On Mon, Jan 24, 2022 at 02:12:06PM +0100, Jonas Smedegaard wrote:

Personally I am of the opinion that more ideally such documentation
should be treated as a source format with two targets - html and
plaintext - and that both those target formats should be generated
during package build and installed with the binary package(s).

For Github-flavored Markdown I recommend to render both target
formats using the command-line tool cmark-gfm. Here is an example
of that: https://salsa.debian.org/debian/doctest/-/commit/d9b848b

For most other flavors of Markdown I recommend to render using
pandoc. Here is an example of that: https://salsa.debian.org/js-team/twitter-bootstrap3/-/commit/f138bf1

For Gitlab-flavored Markdown there are currently no parser in
Debian, but depending on the actual markup used you might get away
with pandoc + a filter (but may then give up on rendering as
plaintext). Here is an example of that: https://salsa.debian.org/matrix-team/olm/-/commit/094396d

Feel free to reach out if you need help juggling Markdown or using
pandoc. I am no expert, but am interested, and am in touch with the author if all else fails ;-)

I maintain "lowdown" in Debian. It supports several markup extensions including several from GFM and CommonMark, and can output in HTML5,
roff (man/ms), LaTeX, ODF etc. It also has a terminal output mode,
that can be used to format and view Markdown documents in a pager.

There are _many_ markdown tools...

Lowdown indeed has some interesting features as interactive Markdown
*reader* - thanks for mentioning. Package description however does not mention if _always_ a superset of markdown/CommonMark is parsed or the
tool can be told to parse conservatively as well - perhaps relevant to
add such information to the package long description?

For *packaging* Markdown-authored documentation, where common format is
html and plaintext, I still recommend to first consider more
conservative and lightweight options¹, then more conservative yet heavy options² - i.e. only consider exciting tools when boring ones are
unsuitable.


- Jonas

¹ cmark is commonly regarded as one of the most conservative and
lightweight - see e.g. https://github.blog/2017-03-14-a-formal-spec-for-github-markdown/

² yes pandoc is big but battle-tested and exact about which flavors are parsed.

--
* Jonas Smedegaard - idealist & Internet-arkitekt
* Tlf.: +45 40843136 Website: http://dr.jones.dk/

[x] quote me freely [ ] ask before reusing [ ] keep private --==============�85354292421780436=MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Description: signature
Content-Type: application/pgp-signature; name="signature.asc"; charset="us-ascii"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEn+Ppw2aRpp/1PMaELHwxRsGgASEFAmHuxfAACgkQLHwxRsGg ASGKCg/8CECGI24fIZOWm4d2kTIePKcw2dChUjePzJvefRl7ct1DwkV5bBxvkNBH SY/ZGN6Fb7vXQuEYrT6yimhZRyGPlsvmUfWumd9cbV60ptiOli+MHllr2cn0IYRv vnxCwNkejU0mei0ctSLPAmeUeivFlni0oszh2Fne2udMNdC9H6HacuAg35t8s6v5 GUHA45sPeIpkjRl+dBaZ/EL9xDjpOWNZuK4CMhrhumlaYzTqLYkcOh3n9HYR2Jll QMz0VBe66mLFW8tyVQdq7kykrhp6DgW8YUETZT7Qgt0PacN+YwUGN7TfPNSd/Xwf nqWEDjeABQ9B6rd//u2pRuFdy5lp1304SHTI7eKpjrhbpqTZXMg+7bVS2k+5GWEX hoyLE3PIzcZRkh6Yw83qWqgIHJETxbWxZu7F1wBQedbGyttDKp8be0MfuFY5my3T e4IotarNSUHF6tqA6HhS26Ql/HaCb8pg7cVkpzhXo/EOVlMrU42aXP/kYbLIpNmd usQNX4O2yjkV739Hw

On Mon, Jan 24, 2022 at 04:29:54PM +0100, Jonas Smedegaard wrote:

Lowdown indeed has some interesting features as interactive Markdown
*reader* - thanks for mentioning. Package description however does not mention if _always_ a superset of markdown/CommonMark is parsed or the
tool can be told to parse conservatively as well - perhaps relevant to
add such information to the package long description?

lowdown describes itself primarily as a translator rather than a reader
(that part is already in the package description). There are indeed many customization options with regards to disabling various features,
whether markup extension-related (Markdown, CommonMark, GFM,
MultiMarkdown, PHP Extra) or otherwise, such as --parse-no-cmark.
lowdown(1) and lowdown(5) have all the details (in the package or on the website). I'll try to find a way to document that in the long
description in a future upload; thank you for the suggestion.

For *packaging* Markdown-authored documentation, where common format is
html and plaintext, I still recommend to first consider more
conservative and lightweight options�, then more conservative yet heavy options� - i.e. only consider exciting tools when boring ones are
unsuitable.

Agreed, and why I recommended lowdown as a pretty conservative and
lightweight option. cmark is a good option too; pandoc is as well, if bootstrapping is not a concern.

Regards,
Faidon

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Quoting Faidon Liambotis (2022-01-24 20:08:01)

On Mon, Jan 24, 2022 at 04:29:54PM +0100, Jonas Smedegaard wrote:

For *packaging* Markdown-authored documentation, where common format
is html and plaintext, I still recommend to first consider more conservative and lightweight options¹, then more conservative yet
heavy options² - i.e. only consider exciting tools when boring ones
are unsuitable.

Agreed, and why I recommended lowdown as a pretty conservative and lightweight option.

Sorry if I was unclear: I recommend *conservative* options over *pretty conservative* options. :-P

See e.g. "accurate" and "robust" at https://github.com/commonmark/cmark (didn't find any comparable claims at lowdown Homepage).

cmark is a good option too; pandoc is as well, if bootstrapping is not
a concern.

Use <!nodoc> to avoid bootstrapping being a concern.


- Jonas

--
* Jonas Smedegaard - idealist & Internet-arkitekt
* Tlf.: +45 40843136 Website: http://dr.jones.dk/

[x] quote me freely [ ] ask before reusing [ ] keep private --==============88098876241936416=MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Description: signature
Content-Type: application/pgp-signature; name="signature.asc"; charset="us-ascii"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEn+Ppw2aRpp/1PMaELHwxRsGgASEFAmHu/WcACgkQLHwxRsGg ASF+7Q//ZHMMztMXqFOUW2HJasUg+2wcoImVB2uZOlKqQBzsvavp1Q4a1XovTlQF ckdHKDwxWR5U1+xZT0YweBcN3zGkMiHMFxK6vc4QtBKDudvQWmsX8gCSLay59sL7 128R0wW6dchL6af0WDeS6C6MZcUXdRSxu2h/Fd0BKP8orDtLnMZ479MrkeIIgJxm nBv4cXogDdNSUNrcIA9Nuu4ZIDibVkQpb5vluD/6krZMEWI+JYpsV8ngyDaFNjgC cQt7lcaPpf7aAftBj07nLYlpjKR1BuIz1rlABrBTfUnss9nZWajzn1wJSH95mL7i 4dGPi02zbPpn0SzvKNZeWy+t86ynQDXLwL4tMh6isZ5ABFqYmOLMBM31DCVXleOT 2BRybT1oX2wjESrQG/GB3JeutYXv4LBo+OfqAj2c25XXfSl5ywaQVpiuPUdzlHR9 hJGmS5eFaPsusHrTPSCxoQsYTSHa4zubbCFLhshUiD8+xj+u6zfKDHfM8UclOdAV bcmsTrj1F7gvGuusz

This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --znp93ad9EmlfF21hT4n4RG8Iig3nqND1w
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable

Thanks again for your hints.
Finally I converts my MarkDown documents in HTML with pandoc.
Cheers,
Jerome

On 24/01/2022 12:46, Jerome BENOIT wrote:

Hello All, thanks for your replies.

On 24/01/2022 12:10, Jonas Smedegaard wrote:

Hi Jerome,

Quoting Jerome BENOIT (2022-01-24 10:36:50)

is there a virtual package for viewing MD documents
(as the virtual package pdf-viewer is for PDF documents) ?

I assume that by MD you mean markdown...

indeed

No, Debian has no general virtual "markdown-viewer" package.

Unlike PDF and DjVu, Markdown is by design sloppy which has lead to a
multitude of "flavors", so I suspect it is unlikely that we can find any
common baseline that such virtual package should promise to provide.

Possibly it would make sense to define a
"commonmark-github-flavored-viewer" since that is a reasonably popular
flavor?

Here are some markdown viewers/editors currently in Debian:

  * grip
  * formiko
  * mdp
  * pampi
  * ghostwriter
  * kookbook
  * retext

Why do you ask? Because you are looking for markdown viewers or because
you are packaging one and want to declare it as such, or...?

I am asking because a software that I am currently packaging has its documents
in MarDown (GitHub flavour, I guess).

So my understanding now is that there is no point to look for a generic MD viewer.

Therefore I am now considering to convert them in PDF and/or HTML documents.

Cheers,
Jerome

  - Jonas

--
Jerome BENOIT | calculus+at-rezozer^dot*net https://qa.debian.org/[email protected]
AE28 AE15 710D FF1D 87E5 A762 3F92 19A6 7F36 C68B


--znp93ad9EmlfF21hT4n4RG8Iig3nqND1w--

-----BEGIN PGP SIGNATURE-----

wsN5BAABCAAjFiEEriiuFXEN/x2H5adiP5IZpn82xosFAmH3xuAFAwAAAAAACgkQP5IZpn82xovg UiAApRpHK6PZXXUokEIBJHCAQU+WjHa5wBzhqG7P7j+v0Qnykjbr2EBJx/KGBDopHFJDMUg0Gh/E gxyyWnp0WhmdSd1jk1DkRXmGTGhyjNvvvMUGjBCOQJuqPspWfYN3jDRCzLVaKctaWRlQpq5bOZh3 LrPdyZVHuYPxYv2rGj76CSp11E6RzZSp1wvIyj33s+XkSXv6JqyBaltYdLODjqxmnBVUEcY4CgSs 8kpq/ec1hYzl3bimoGxjNKW7HqWVy74Dr5riNWI2gg9HBU56r0cZ9YjZ/LxAzR2NCeIq6n6VDq86 E8Dg6K0NfLy+aAJ4BuBhZMXolFouomK2a/F81AMwVhV2wGfjsDESTS2zi+YrAGikO+ZxrskQTct5 O2Lk9H9BC6uratkQDArygRpCxt6QNlJouhpuzF8UgWqOiqO2Icrzi3eXM/8UezvC9i7D1SBqTeuz j4+xIOa/ouragG/XH+eiEj4egreGhXyaSFJ5h926NdYJgrVQWy84bCa1V/2nLuhu46jG5z8jFwLW n92tPQKEpg5x9XbpjlTfGjVDRFO5C+ekREyBWvmQcBRSbQrgL8o81KxdAta1MlbSjCnarPTW0F5L xGzOSud+jK2mhOA9jRE455dfQMcUeTQfqOytLcBsGqNasG2LscdbtxFKeqHDINGyHO6Yx0GHFRcE