☰

我如何为 CTAN 做出贡献？

tag-icon • tag-icon macros templates contribute ctan
我如何为 CTAN 做出贡献？

我创建了一个模板和一些宏，想分享。我该如何将它们贡献给 CTAN？

答案1

太棒了！流程很简单。上传页面上解释了所有内容（请参阅下面的实际链接）。下面列出了我自己的指南。

  1. 确保材料获得适当的许可。大多数 LaTeX 软件包都获得 LPPL 许可，但如果您愿意，也可以使用 GPL 或 Apache/BSD/MIT 许可之一。

  2. 确保将源代码包含在任何预构建文件中（适当情况下：图像等文件没有“源代码”）。TeX Live 不允许使用没有源文件的 PDF。LaTeX 软件包的常用系统是使用 DTX 文件作为组合源/文档文件，可以将其排版为 PDF，或使用 INS 文件提取到 STY 或 CLS 文件——这称为“docstrip”系统。请参阅 Scott Pakin 的文本点击此处获取良好的指导。

  3. 如果您没有使用 docstrip 作为软件包源，请确保材料已记录；如今没有 PDF 文档的软件包可能不被接受。请记住包含一个 readme 文件（名为README，即没有扩展名），简要介绍该软件包。

  4. 检查事物的命名。文件的名称不应与 CTAN 或 TeX Live/MiKTeX 中的任何内容冲突。名称越具体越好。例如，不要将会议类命名为conference.cls；明确指出它将用于哪个会议，例如active-conf-2006.cls。

完成后，将您的文件打包到 ZIP 或 TAR.BZ（或等等）存档中，然后上传。

答案2

我看到威尔已经回答了这个问题，但我将以稍微不同的形式提供相同的信息！

上传页面位于http://www.ctan.org/upload包含一些建议，以及一个上传表单。您只需上传文件本身，但通常会包含某种 README 文件，也可能包含一些文档。如果您有一个名为“mypkg”的包，您可能因此想要上传：

  • mypkg.sty，包本身
  • mypkg.pdf，文档
  • mypkg.tex，文档的来源（需要将文档放入 TeX Live）
  • README，自述文件

所有这些内容都需要放入一个 zip 文件中，然后上传。

许多 LaTeX 软件包都是以“dtx”格式编写的，它将文档的源代码和代码放在一个文件中。这也用于记录代码本身。如果你使用 dtx 格式，那么你需要上传

  • mypkg.dtx，源文件
  • mypkg.ins，用于解压dtx文件
  • mypkg.pdf，文档
  • README，自述文件

再次，所有内容都放入一个 zip 文件中，并使用 CTAN 网站上的表单上传。

您还可以上传其他内容，但首先我认为应该从这里开始。

相关内容