一个自动化的项目经理。
texproject的Python项目详细描述
TexPRoject是一个命令行LaTeX模板和项目经理编写的 在Python中。在
安装
在类UNIX的系统上,通常可以安装命令行工具 使用以下命令:
pip install texproject git clone https://github.com/alexrutar/texproject-templates ~/.local/share/texproject mkdir -p ~/.config/texproject cp ~/.local/share/texproject/config/user_config_example.yaml ~/.config/texproject/config.yaml
Texproject符合XDG Base Directory Specification; 将~/.local/share或~/.config替换为已配置的 目录。目前,没有安装脚本或程序包 经理的支持,但我希望最终能实现这一点。在
基本用途
Texproject安装在命令行工具tpr下。创建 新建项目,创建一个空目录,切换到其中,然后运行
^{pr2}$此命令将使用名为的模板创建新项目 <template>在当前目录中。指定不同的 目录中,使用-C <path>标志。这将创建文件 main.tex(用于主文档内容)和project-macros.sty (对于特定于项目的宏)。要获取可用模板的列表,请运行
tpr info --list T
如果当前在项目文件中,请运行
tpr export
要在同一目录中创建项目的导出版本, 与冻结(未链接)包裹。在
如果要编辑文档的参数(例如引用文件, 其他宏集或其他功能),运行
tpr config
打开$EDITOR中的项目配置文件。一旦你是 完成后,运行tpr refresh,以反映支持中的更改 文件夹。在
了解更多跑步功能
tpr --help tpr <subcommand> --help
用法示例
在这里,我们演示一个基本项目的构建。首先,创建 使用empty模板的名为example的项目,以及 进入目录。在
mkdir example; cd example tpr init empty
此目录中的相关项目文件是main.tex和 project-macros.sty。文件main.tex文件是主文档 可以编辑以生成文档的文件。这个 project-macros.styfile是一个空包,您可以在其中输入 自定义项目相关序言。这些包总是加载的 在任何指定的项目文件之后。在
假设我们想在项目中包含宏集general。 运行tpr config打开项目配置文件,并添加 线路
- general
在以macros:开头的行下面。保存文件,然后运行
tpr refresh
重新生成链接和支持文件。新的宏是 自动添加到项目文件中。如果你想分享这个 与其他人合作,简单地运行
tpr export
它将在项目中生成文件example.zip 目录。此zipfile包含所有重要的项目文件,如 以及动态宏文件的冻结版本。在
术语
在冻结的项目中,所有宏文件都被复制,而不是符号链接。 默认情况下,冻结的宏文件永远不会被覆盖,即使在 将项目转换为未冻结状态。这对 防止旧项目或更新宏时中断宏文件 文件夹。在
若要覆盖冻结的宏文件,请运行tpr refresh --force。在
配置文件
项目配置
用户配置
系统配置
- 项目
标签: