node-remark-slide for Debian
============================

Package name
------------
Upstream refers to their package as simply "remark", but there is
another "remark" (https://remark.js.org/) that currently is available
from npm by that name (although it is not available in Debian).

There is an unofficial npm package, uploaded by hirokiky, under the
name "remark-slide".  See https://github.com/gnab/remark/issues/385.
We use this name for consistency with npm and to avoid any potential
future conflicts if the other remark is ever uploaded to Debian.

Using remark remotely
---------------------
One of the example files (boilerplate-remote.html) was removed from
the package to avoid a Lintian privacy-breach-generic warning.  It
showed how to include a remote copy of remark in your project instead
of installing it locally.  To do this, use the following:

<script src="https://remarkjs.com/downloads/remark-latest.min.js"
        type="text/javascript"></script>

Online documentation
--------------------
Additional documentation is available online:

* https://remarkjs.com/
* https://github.com/gnab/remark/wiki

Example fonts
-------------
The fonts in the boilerplate-*.html example files are obtained by
upstream from Google Fonts.  This has been patched out in the Debian
package, and instead the corresponding Debian font packages have been
added to Suggests.

Note that texlive-fonts-extra (which contains the Droid Serif font)
does not make its fonts available to the browser.  One workaround is
create a symbolic link to a location where the browser can find it,
e.g.,:

mkdir -p ~/.local/share/fonts
ln -s /usr/share/texlive/texmf-dist/fonts/truetype/ascender/droid/droidserif/DroidSerif-Regular.ttf ~/.local/share/fonts

 -- Doug Torrance <dtorrance@debian.org>, Tue,  1 Mar 2022 12:12:06 -0500
