cli从简单的yaml文件生成powerpoint幻灯片
pptx-builder-from-yaml的Python项目详细描述
来自yaml的pptx生成器
CLI to generate powerpoint slides from simple yaml file[s]
- pptx-builder-from-yaml
运行cli的依赖项
>= python3.4
- python模块
click==7.0.0
- python-pptx==0.6.16
PyYAML==3.13
如何安装?
pip install pptx-builder-from-yaml
生成pptx的yaml文件是什么样子的?
这是一个示例yaml文件-Dummy.yml
如何使用cli?
$ pptx-builder --help Usage: pptx-builder [OPTIONS] YAML_PATHS... A powerpoint builder https://github.com/sukujgrg/pptx-builder-from-yaml Options: -pt, --pptx-template-path PATH [required] -ms, --master-slide-idx INTEGER [default: 0] -sl, --slide-layout-idx INTEGER [default: 6] -fs, --font-size INTEGER [default: 32] -fn, --font-name TEXT [default: Calibri] -ns, --dst-dir TEXT [default: ./generated-pptx] -ta, --slide-txt-alignment [left|middle|right][default: left] --validate Run yaml validation against schema --version Show the version and exit. --help Show this message and exit.
如何生成pptx[s]?
pptx-builder slide_yamls/ -pt pptx-templates/default.pptx
注释:
slide_yamls/
是保存幻灯片yaml
文件的目录。yaml
[s]必须 遵循代码中定义的架构。Here是 示例yaml
文件。slide_yamls
是位置参数,可以接受文件和 目录。如果一个位置参数是一个目录,它将尝试构建单独的pptx
与同一目录中的每个yaml
文件。--pptx-template-path | -pt
需要目录或pptx文件。如果是 目录,pptx-builder
将在同一目录中找到的所有pptx文件中选择一个。 PPTX模板文件不应更改主幻灯片索引或幻灯片中 布局索引。如果主幻灯片索引或幻灯片布局有任何更改,则需要 将相应的int
类型传递给-ms
和-sl
选项。 示例pptx模板文件可以在这里看到pptx-templates。- 默认的
--new-slide-path
是tmp
目录,因此它取决于操作 运行pptx-builder
的系统。
如何验证yaml并生成pptx?
pptx-builder slide_yamls/dummy.yml -dm master_slides/default.pptx --validate
常见问题
如何向使用cli生成的所有pptx添加相同的页脚?
使用--pptx-template-path
选项向要传递的pptx模板文件添加页脚
如何使用cli为生成的pptx文件获取不同的背景?
创建具有不同背景的不同pptx模板文件并将其传递给
--pptx-template-path
选项。请参阅上的this视频
正在创建pptx模板文件。
如何设置开发环境?
git clone https://github.com/sukujgrg/pptx-builder-from-yaml.git
cd pptx-builder-from-yaml
pipenv install --dev
pipenv shell
pipenv graph
如何运行测试?
cd pptx-builder-from-yaml/
tox .