从sphinx的powerpoint演示文稿文件中提取图像。
pptshape的Python项目详细描述
ppt形状
pptshape从ppt文件中提取形状,并作为png文件嵌入到sphinx文档中。
pptshape添加了如下新指令。
.. ppt-shape:: abc.png :pptfilename: testppt.pptx :shapename: shape-title
指令的第一行指定要生成的图像文件的文件名。:pptfilename:指定 PowerPoint演示文稿的名称。:shape name:指定指定形状的名称(请参阅用法)。
在安装了PowerPoint的Windows Box上生成Sphinx项目时,pptshape将打开ppt文件 如果ppt文件比图像文件新,则创建png文件。
如果项目是在PC上生成的,则未安装PowerPoint或未安装Windows Box,则为ppt shape指令 就像标准的图像指令一样。
ppt shape指令派生自标准图像指令,因此您可以使用诸如 :高度:或:alt:图像指令有。
使用量
将pywin32程序包安装到Windows框中。
创建新演示文稿(.ppt)并绘制形状。
选择您编写的形状并显示“格式”选项卡。在“标题”字段中指定形状的名称。
保存演示文稿文件。
在sphinx项目的conf.py文件中,添加以下配置。
extensions=['pptshape.directive']
在.rst文件中添加以下行。
.. ppt-shape:: abc.png :pptfilename: testppt.pptx :shapename: shape-title
abc.png是要创建的PNG文件的名称。:pptfilename:指定PowerPoint演示文稿的名称。:shape name:指定在步骤3中指定的形状的名称。
建造狮身人面像工程。
特殊形状名称
pptshape指令中的shapename以指定 在PowerPoint演示文稿中的位置,而不是形状的标题。
- 在第张幻灯片中,m.n重复第n个形状。
- n表示整个PPT演示文稿的第n个形状。
n和m都应该是从1到上的数字索引页和形状。 例如,1是文档的第一个形状, 2.1是第二张幻灯片中的第一个形状。
对于无法修改以添加的文档,此方法很有用 形状标题,或用于不 支持形状标题。
要求
- python 2.7/3.3或更高版本
- pywin32生成png文件。
版权所有
版权所有(c)2013、2014 atsuo ishimoto
兹免费准许任何人取得副本 本软件和相关文档文件(“软件”)的 在软件中不受限制,包括但不限于 使用、复制、修改、合并、发布、分发、再授权和/或出售 软件的副本,并允许软件的用户 在满足以下条件的情况下,可以这样做:
上述版权公告及本许可公告须包括在 软件的所有副本或大部分。
本软件按“原样”提供,无任何形式的保证,明示或 默示的,包括但不限于适销性保证, 适合特定目的和不侵权。在任何情况下 作者或版权所有者应对任何索赔、损害或其他 责任,无论是在合同诉讼、侵权诉讼或其他诉讼中, 不属于或与软件、使用或其他交易有关 软件。