ctanify - 云端在线

程序：

您的姓名

ctanify - 准备要上传到 CTAN 的包

概要

化 [--pkg名称=绳子[--[没有]汽车[--tdsonly=文件规格 ...] [--[没有]统一]
[--[没有]跳过[--tdsdir=目录名 ...] [-- 特克斯=宏包[--[没有]错配] 文件规格[=目录名]
...

化 [ - 帮帮我]

化 [- 版]

商品描述

澄清 适用于拥有想要分发的 LaTeX 包的开发人员
通过综合 TeX 档案网络 (CTAN)。 给定文件名列表， 澄清
创建一个 tarball (a 名为.tar.gz 文件），文件以 CTAN 的首选结构排列。
tarball 还包含一个 ZIP (邮编) 文件，其中包含所有文件的副本
标准的 TeX 目录结构 (TDS)，它有助于将包包含在
TeX Live 发行版。

配置

澄清 接受以下命令行选项：

-h, - 帮帮我
输出基本使用信息并退出。

-V, - 版
输出 澄清的版本号并退出。

-p 绳子, --pkg名称=绳子
明确指定包名称。 一般， 澄清 使用第一个的基本名称
.ins or .sty 文件列为包名。 包名构成基本名称
的 tarball 澄清 生产。

--noauto
不要自动将文件添加到 tarball。 一般， 澄清 自动
包括在 a 中提到的所有文件 .ins 文件中。

-t 文件规格, --tdsonly=文件规格
指定在命令行上命名的文件的子集以仅包含在 TDS 中
ZIP 文件，不在 CTAN 包目录中。 允许使用通配符（如果
必要），以及 --tdsonly 可以在同一命令行上多次使用。

在命令行上必须至少指定一个文件名。 澄清 自动放置
基于扩展名的 TDS 树中的文件，但这可以通过指定覆盖
使用以下形式明确目标 TDS 目录 文件规格=目录名. 允许使用通配符
对于文件规范（必要时引用）。

附加 配置

以下选项在日常使用中不太可能是必需的。 他们提供
对于可能出现的特殊情况。

-d 目录名, --tdsdir=目录名
无需为 CTAN 创建 tarball，只需创建根目录下的包 TDS 树
目录 目录名.

-T 宏包, -- 特克斯=宏包
断言为 CTAN 打包的文件针对 TeX 宏包而不是
乳胶。 一些常见的例子 宏包 是“通用”、“普通”和“上下文”。

-诺, --no-unixify
存储未修改的文本文件，而不是将它们的行尾字符转换为 Unix
格式（一个没有回车符的换行符），即使
CTAN 更喜欢接收所有带有 Unix 格式行尾字符的文件。

-诺克, --不跳过
力 澄清 包含诸如 Unix 隐藏文件、Emacs 备份文件和
版本控制元数据文件，CTAN 不喜欢接收所有这些文件。

-m, --错位
将包含单个文件的目录重命名为“misc”。 （例如，重命名
“tex/latex/mypackage/mypackage.sty”到“tex/latex/misc/mypackage.sty”。）这是
过去的普遍做法，但现在强烈反对。

诊断

“复制失败 文件名 （没有 这样 文件 or 目录）”
此消息通常是由 .ins 生成的文件 文件名 但这有
尚未运行 TEX or 胶乳 实际生产 文件名. 澄清 不
不自动运行 TEX or 胶乳; 这需要由用户手动完成。 看
“注意事项”了解更多信息。

“修改的 文件名 至 使用 Unix的 线 结局 （使用 --no-unixify 至 防止 这个）”
为保持一致性，CTAN 存储所有带有 Unix 样式行结尾的文本文件（单个
没有回车符的换行符）。 为了帮助这项工作，
澄清 自动替换非 Unix 样式的行结尾。 前面的只是
消息通知用户他不应该惊慌地看到不同的尺寸
文件名 在 tarball 中与原始 文件名 在磁盘上（其中 澄清 决不要
修改）。 如果有充分的理由保留原始行尾（并且
很少是）， --no-unixify 选项可用于防止 澄清 从改变任何
将文件存储在 tarball 中时。

“不包括 文件名 （使用 --不跳过 至 力 包含）”
澄清 通常忽略文件——即使在命令中明确指定
线——CTAN 不喜欢接收。 这些包括名称以
"." (Unix 隐藏文件), 以 " 结尾~"（Emacs 自动备份），或者来自
CVS or .svn 目录（版本控制元数据文件）。 如果有充分的理由
将此类文件提交给 CTAN（很少有）， --不跳过 选项可用于
防止 澄清 从忽视他们。

“CTAN 更喜欢只有 PDF 文档（re： 文档名称）”
由于 PDF 格式的流行，CTAN 希望拥有尽可能多的文档
尽可能以 PDF 格式分发。 前面的消息要求用户更换任何
如果可能，使用 PDF 的 PostScript 或 DVI 文档。 (澄清 仍将包括
压缩包中的 PostScript 和 DVI 文档； 前面的消息只是一个
礼貌的请求。）

“不包括 文件名 in 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 TDS 树 （未知 延期）”
澄清 根据文件扩展名表将文件放置在 TDS 树中。 为了
例如，所有 .sty 文件被放置在 tex/乳胶/包名。 如果 澄清 才不是
知道将文件放在哪里它不会将它放在任何地方。 见最后一段
“OPTIONS”解释了如何明确指定文件的目标位置
TDS 树。 对于碰巧不存在的常见文件扩展名 澄清's
表，也考虑通知 澄清的作者在下面显示的地址下
“作者”。

示例

这个 相当常见 案例
通常，所有需要的就是告诉 澄清 的名字 .ins 文件（或 .sty 如果
包不使用 DocStrip）和预建文档，如果有的话：

$ ctanify mypackage.ins mypackage.pdf 自述文件

490347 mypackage.tar.gz

第1771章
第15453章
1957 年我的包裹/mypackage.ins
277683 我的包/我的包.pdf
246935 mypackage.tds.zip

第1771章
277683 文档/乳胶/mypackage/mypackage.pdf
15453 源/latex/mypackage/mypackage.dtx
1957 源/乳胶/mypackage/mypackage.ins
第1725章

澄清 输出生成的 tarball 的大小（以字节为单位）、其中的每个文件以及每个
包含的 ZIP 文件中的文件。 在前面的例子中，注意如何 澄清
自动执行以下所有操作：

· 包含 我的包.dtx （通过解析发现 我的包.ins) 在两个 我的包裹
目录和 ZIP 文件，

· 包含 我的包.sty （通过解析发现 我的包.ins) 在 ZIP 文件中，但是，因为
它是一个生成的文件，不在 我的包裹 目录，和

· 将所有文件放入适当的 TDS 目录（文档、源代码、主目录）
包）在 ZIP 文件中。

考虑手动生成等价物需要什么 我的包.tar.gz 文件中。
澄清 绝对是一个更简单、更快捷的选择。

先进的 用法
澄清 假定 PostScript 文件是文档，因此将它们存储在
文档/乳胶/包名/ 在 ZIP 文件中的 TDS 树中。 然而，假设一个
LaTeX 包使用一组 PostScript 文件来控制 会员的输出。 在这种情况下，
澄清 必须被告知将这些 PostScript 文件包含在包目录中，而不是
文档目录。

$ ctanify mypackage.ins "mypackage*.ps=tex/latex/mypackage"

使用 onworks.net 服务在线使用 ctanify