分发演示文件的 PDF 版本是个好主意吗？如果是，我该怎么做？
-- build.lua
module = "bdoc"
sourcefiles = {"code/*.sty", "code/*.pdf"}
typesetdemofiles = {"demos/*.tex"}
答案1
这个答案可能意味着这个问题是“基于观点的”并且不适合该网站，但无论如何......
我根本不认为在 ctan（以及 texlive/miktex）上分发演示是一个好主意。
你的软件包的用户可能会尝试texdoc bdoc获取顶级文档，但如果你以这种方式分发它，其他任何东西都可能找不到
small2e.tex如今，即使是 latex2e 附带的非常简单的一页演示文件也几乎无法使用。
small2e.tex（但不是，回答问题，small2e.pdf）位于所有文档输入路径中的基础 latex 目录中，因此您可以在命令行上运行
pdflatex small2e
并在当前目录中查看您的第一个示例 latex 运行和生成small2e.pdf。但如今大多数用户不使用命令行（或使用没有命令行的 Overleaf 之类的东西）。要small2e使用 latex 运行，他们需要/usr/local/texlive/2023/texmf-dist/tex/latex/base/small2e.tex在编辑器中打开类似的东西并按“运行”或类似的东西，但这可能会失败，因为他们没有该目录的写权限，因此您需要先将文件复制到临时位置，然后突然间这个简单的例子变得不再简单。
在您的 github 源中包含演示和测试文件是有意义的，但您不需要将它们作为发布的一部分打包，您可以单独提供教程和演示，也许可以通过直接从您的源存储库运行 github-pages 站点来实现。
例如，这可以让人们有机会在线运行演示并查看生成的 PDF，例如