bundledoc - 云端在线

程序：

您的姓名

bundledoc - 捆绑 LaTeX 文档所需的所有文件

概要

捆绑文档 [- 版[ - 帮帮我[--[没有]详细[--文本文件=文件[- 目录=目录]
[--[没有]仅限本地[- 排除=绳子[- 包括=文件规格[- 显现=文件]
[--listdeps=[是|否|仅|相关]...] [--[没有]保持目录[--配置=文件] .dep 文件

商品描述

捆绑文档 是一个后处理器 快照 捆绑在一起的所有
构建给定的 LaTeX 文档所需的类、包和文件。 它读取 .dep
文件 快照 生成，找到其中提到的每个文件，并将它们打包
到单个存档文件（例如，一个 名为.tar.gz 文件），适合跨系统移动，
转发给同事等

作为最简单的例子，考虑一个名为的 LaTeX 文件，例如， 你好.tex:

\RequirePackage{snapshot} % bundledoc 需要
\documentclass[11pt]{文章}

\ {开始}文件
您好，世界！
\ END {}文件

"\RequirePackage{snapshot}" 导致 你好.dep 要生成的文件。 什么时候 捆绑文档 is
然后给定“hello.dep”作为参数，它定位依赖文件—— 快照.sty,
文章.cls及 大小11.clo -- 并将它们捆绑到一个存档文件中，以及
你好.tex 的网络 表现 文件（在下面的“选项”中描述）。

配置

在以下描述中， 某个文件 指的是您的主要 LaTeX 文档的名称（没有
延期）。

捆绑文档 需要由生成的依赖文件的名称 快照 （一般
某个文件.dep）。 还可以提供以下选项：

- 版
输出 捆绑文档 脚本的版本号。 这将覆盖所有剩余的
选项​​。

- 帮帮我
给出一个简短的使用信息。 这将覆盖所有剩余的选项。

--[没有]详细 （默认值：“noverbose”）
捆绑文档 除了错误信息外，通常不输出任何内容。 使用“--verbose”，
它输出大量的状态消息。

--文本文件=主 .tex 文件 （默认： 一些文件.tex)
快照的依赖文件没有列出主要的 LaTeX 文件（通过
至 胶乳）。 为了 捆绑文档 查找并捆绑该文件， 捆绑文档 假设它
同名 快照 依赖文件，但有一个 .tex 延期。 如果这
不是这样，然后使用“--texfile”指定正确的文件名。

- 目录=档案 目录 （默认： 某个文件)
什么时候 捆绑文档 创建档案（例如，一个 。柏油 or 邮编 文件）包含
文档的文件，它将所有这些文件放在一个目录中以避免混乱当前
包含文件的目录。 如果给定的依赖文件被调用 某个文件.dep 那么
默认情况下，生成的存档会将所有相关文件存储在 某个文件
目录。 要更改目录名称，请使用“--directory”选项。

--[没有]仅限本地 （默认值：“nolocalonly”）
尽管 捆绑文档 通常归档所有命名的文件 .dep 文件，
“--localonly”选项告诉 捆绑文档 排除位于其他目录中的所有文件
比 .tex 文件的目录或其子目录之一。

- 排除=绳子 （默认： 没有)
而“--localonly”会导致文件超出 .tex 文件的目录树
从存档中省略，“--exclude”提供对文件的更细粒度的控制
从存档中省略。 “--exclude”选项，可以重复指定
命令行，导致名称包含的所有文件 绳子 从
存档。

- 包括=文件规格 （默认： 没有)
“--include”选项，可以在命令行重复指定，
指示 捆绑文档 将所有匹配的文件包含在存档中 文件规格，即使
如果它们没有在 .dep 文件中。

- 显现=舱单 文件 （默认： 表现)
除了依赖文件， 捆绑文档 在存档文件中包含一个额外的
文件调用，默认情况下，``表现''。 表现 是一个文本文件，列出了
所有依赖项的原始文件名。 将文件名从 ``表现''
对于其他内容，请使用“--manifest”选项。 作为特殊情况，"--manifest="""
告诉 捆绑文档 根本不包含清单文件。

--listdeps=[yes|no|only|rel]...]（默认值：“否”）
"--listdeps" 接受一个或多个 "yes"、"no"、"only" 或 "rel" 作为逗号分隔
列表。 只要“否”未出现在此列表中， 捆绑文档 输出所有主要的
LaTeX 文件的依赖项。 如果列表包含“rel”，则 捆绑文档 输出
具有相对路径名的依赖项列表。 如果列表包含“仅”，则
捆绑文档 显示列表后退出，不生成存档。

--[没有]保持目录 （默认值：“nokeepdirs”）
通常，存档文件 捆绑文档 产生包含一个目录——和
子目录，如果文档明确引用它们——其中所有的
依赖文件撒谎。 如果指定了“--keepdirs”，则存储所有依赖文件
使用它们的原始路径名。 例如，如果 一些文件.tex 依赖于取决于
数字/somefigure.eps, 文章.cls及 快照.sty，则 某个文件 存档将
通常包含以下文件：

· 一些文件/一些文件.tex

· 一些文件/数字/somefigure.eps

· 一些文件/article.cls

· 一些文件/snapshot.sty

· 某个文件/清单

但是，“--keepdirs”会导致 某个文件 存档包含以下种类
文件名代替：

· 家/我/mydocs/somefile.tex

· 家/我/mydocs/figures/somefigure.eps

· usr/share/texmf/tex/latex/base/article.cls

· usr/share/texmf/tex/latex/snapshot/snapshot.sty

当“--keepdirs”有效时不使用“--directory”。 此外，没有清单
文件被写入存档文件，因为它包含冗余信息。

--配置=配置 文件 （默认： )
“--config”选项用于指向 捆绑文档 到适当的配置
(.CFG) 文件用于您的 TeX 发行版和操作系统。 捆绑文档 附带一个
很少的配置文件，很容易写更多。 参见“配置文件”
（下面）有关配置文件格式的说明。

配置 FILES

格式
配置文件遵循相当简单的格式。 以“#”开头的行是注释。
空行被忽略。 所有其他行的格式如下：

变量：值

当前版本的 捆绑文档 识别以下变量：

捆
用于将一组文件捆绑到单个存档文件中的命令

水槽
命令的后缀以丢弃其输出

发现
在 TeX 树中查找文件的命令。

对于一行来说太长的值可以通过使用“\”作为多行拆分
续行符号。

有两个环境变量 捆绑文档 可供使用
配置文件命令：“BDBASE”，设置为 某个文件 （如在“选项”中），以及
“BDINPUTS”，它被设置为一个命令要操作的以空格分隔的文件列表
之上。 也就是说，当与“bundle”关联的命令正在运行时，“BDINPUTS”包含
要存档的所有文件的列表。 相反，当命令
与正在运行的“查找”相关联，“BDINPUTS”包含要搜索的文件的名称。

国际私人包机价格项目范例
以下配置文件平行 捆绑文档的各种默认值
配置文件变量，代表运行的基于 kpathsea 的 TeX 发行版
在通用 Unix 系统上，它不一定具有任何 GNU 工具，例如
GZIP 或 GNU 焦油:

# “默认”配置文件
# 斯科特·帕金[电子邮件保护]>

捆绑包：（tar -cvf - $BDINPUTS | compress > $BDBASE.tar.Z）
接收器：> /dev/null 2>&1
查找： kpsewhich -progname=latex $BDINPUTS

“bundle:”行中的括号告诉 Unix shell 在
子壳。 这是为了使“sink:”词缀正常工作（即，因此没有两个
">" 在同一命令中）。

注意命令如何像对待任何其他环境变量一样对待“BDBASE”和“BDINPUTS”
在 Unix shell 中，使用“$”来获取它们的值。 其他操作系统使用不同的
引用环境变量的约定。 例如，一个配置文件
对于基于 Windows 的 TeX 发行版，将使用 "%BDBASE%" 和 "%BDINPUTS%" 代替。

“sink:”的值特定于操作系统。 “查找：”的值是
特定于 TeX 发行版。 “捆绑：”是定制机会最多的地方
谎言。 您可以使用“bundle:”来指定您喜欢的存档格式。 例如，你
可以在 Unix 上生成一个类似于以下内容的 shar 文件：

包: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh)

或 Microsoft Windows 上的 CAB 文件，例如：

捆绑包： cabarc -r -p N %BDBASE%.cab %BDINPUTS%

示例

假使，假设 我的文件目录 是从 我的文件 按照说明进行操作
说明部分。 以下命令产生一个 邮编 文件与 MikTeX TeX
在 Microsoft Windows 上运行的发行版：

bundledoc --config=miktex.cfg myfile.dep

（在实践中，可能需要指定“--config”到
捆绑文档's miktex.cfg文件 配置文件。）

下面建立一个 名为.tar.gz 使用在 Unix 上运行的 TeX Live 发行版进行存档
比如操作系统。 捆绑文档 将产生描述其操作的详细输出。
所有文件不在同一目录树中 我的文件 以及所有包含“.fd”的文件或
名称中的“.sty”被省略。 然而，所有 。围兜 当前目录中的文件将
被包含在档案中，即使它们都没有被引用 我的文件目录.
最后，没有 表现 将生成文件。

bundledoc --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \
我的文件目录

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