构建Ansible分发的工具
antsibull的Python项目详细描述
antsibull—Ansible构建脚本
用于构建与Ansible相关的各种东西的工具
此处的脚本:
- antsibull build-从组件集合(docs)生成Ansible-2.10+
- antsibull docs-从ansible插件中提取文档
- antsibull lint-现在只验证
changelogs/changelog.yaml
文件(docs)
这还包括一个Sphinx extensionsphinx_antsibull_ext
,它为Ansible输出提供了一个lexer和一个最小的CSS文件来正确地呈现antsibull-docs
的输出。在
一个相关的项目是antsibull-changelog,它在它的own repository中。在
脚本是在构建时由诗歌创建的。所以如果你想逃离 结帐时,你得在诗下面写:
python3 -m pip install poetry
poetry install # Installs dependencies into a virtualenv
poetry run antsibull-build --help
。。注意:安装poethy发布的包时,最好使用 pip>;=19.0。使用pip-18.1及以下版本安装可以创建脚本 使用pkg_资源可以减慢启动时间(在某些环境中 相当大的数量)。在
除非代码中另有说明,否则它是根据GNU的条款授权的 通用公共许可证v3,或根据您的选择,稍后。在
使用狮身人面像扩展
把它包括在你的狮身人面像配置中conf.py
:
更新Sphinx扩展的CSS文件
CSS文件sphinx_antsibull_ext/antsibull-minimal.css是使用SASS和{a9}使用autoprefixer和{a11}从{a7}生成的。在
使用sphinx_antsibull_ext/css/
中的脚本build.sh
从.scss
文件生成{
cd sphinx_antsibull_ext/css/
./build-css.sh
要使其正常工作,您需要确保sassc
和{
# Debian:
apt-get install sassc
# PostCSS, autoprefixer and cssnano require nodejs/npm:
npm install -g autoprefixer cssnano postcss postcss-cli
创建新版本:
如果要创建新版本:
poetry build
poetry publish # Uploads to pypi. Be sure you really want to do this
git tag $VERSION_NUMBER
git push --tags
vim pyproject.toml # Bump the version number
git commit -m 'Update the version number for the next release' pyproject.toml
git push
- 项目
标签: