{"repo":"llleixx/XCPC-Templates","free":true,"listed":false,"github":"https://github.com/llleixx/XCPC-Templates","clone":"git clone https://github.com/llleixx/XCPC-Templates.git","description":"一个利用 GitHub Action，采取无侵入式的、自动化的方式构建算法模板 PDF 的项目！","language":"TeX","stars":16,"topics":["algorithms","ccpc","icpc","template","xcpc"],"license":"MIT","category":"saas-starters-boilerplates","readme_excerpt":"这是什么？ 这是一个借助于 GitHub Action 实现自动生成算法模板的项目！ - 你 不需要安装 Python 环境 ； - 你也并 不需要安装臃肿的 LaTeX 环境（你甚至不需要会 LaTeX 语法） ； - 你 只需要提供你的模板文件并且加以简单配置 ，就能借助 GitHub Action 生成你的模板 PDF 到 Releases 一栏！ 具体生成结果可以参考本项目的 Releases以及该项目的 Releases。 如何使用该项目？ 你只需要的是： 1. fork 本项目，并在以下界面确保 开启 GitHub Action ； 2. 将你的的项目 Clone 到本地； 3. 在 templates 目录下构建你自己的算法模板结构； 4. 修改项目根目录的 config.yml ； 5. 运行项目根目录下的 gen.sh 或 gen.ps1 来生成模板目录的配置文件： 例如： ./gen.sh -r ./templates 或者 .\\gen.ps1 -r .\\templates ，其中 -r 代表递归生成， ./templates 指定需要生成配置文件的目录 注意 gen.sh 适用于 Linux, macOS 以及其他基于 Unix 的操作系统 （需要 Bash 版本 4.x 及以上），同时也适用于 Windows 平台下的 Git Bash 而 gen.ps1 适用于 Windows 平台 （需要 Powershell，但可能因为安全策略，你需要允许外部脚本运行） 6. 根据你期望的章节顺序或者章节名称对各个目录下的 config.yml 进行微调； 7. 提交修改，并 push 到 GitHub。 （如果你不想 fork，你也可以使用 GitHub template repository 来创建你的项目，点击该项目右上角的 Use this template ，坏处是这样会难以跟踪本项目的修改。） 当以上准备完毕，你就可以通过以下步骤来自动构建你的模板文件： 此时就会触发 GitHub Action 构建你的模板文件！ 在 Actions 页面会出现日志信息，当正确运行完毕，你就可以在项目的 Releases 页面发现你构建的 PDF 文件。 配置文件？ 配置文件有两种，一种是项目根目录下的 config.yml ，一种是算法模板目录下的 config.yml 。 项目根目录的 config.yml 用于定义项目的元信息。 配置项 类型 描述 --- --- --- root-directory String 指定算法模板目录 latex-pre String 指定生成的 tex 文件的头部文件 latex-post String 指定生成的 tex 文件的尾部文件 title String 指定生成的 tex 文件的 title author String 指定生成的 tex 文件的 author 示例如下： 模板目录的 config.yml 配置项 类型 描述 --- --- --- contents List 声明当前目录的组成结构 对于 contents List 的 Item 有两类： 一类是 directory 类型，该 Item 定义如下： 配置项 类型 描述 --- --- --- name String 声明子目录显示名称 directory String 指定子目录 一类是 code 类型，该 Item 定义如下： 配置项 类型 描述 --- --- --- name String 声明该 code 名称","default_branch":null,"files":null,"tree":[],"storefront":"/r/llleixx","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/llleixx/XCPC-Templates/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}