香草引导4主题

mkdocs-theme-bootstrap4的Python项目详细描述


MkDocs的bootstrap4主题

一个香草引导4主题。在


截图

快速入门

安装第一个程序包:

$ pip install mkdocs-theme-bootstrap4

然后启用它:

^{pr2}$

配置

将这些附加选项放在mkdocs.yml配置的theme:部分下,以更改主题的行为。在

# Show next/previous links between pages?next_previous:true

引导功能

一些引导组件需要添加额外的CSS类。要启用这些,请在mkdocs.yml中添加以下plugins

plugins:-bootstrap4-blockquotes-bootstrap4-tables

黑客攻击

首先,安装依赖项:

  • Python 2,对于我们的一些依赖项。在
  • Python 3,用于包生成过程。在
  • Yarn,用于管理前端依赖项。在

确保python2在python3之前在您的路径上找到,否则您将在node-gyp中得到错误。如果无法执行此操作,请将环境变量npm_config_python设置为一个命令,该命令将启动python2(py -2(在Windows上,python2在其他地方)。在

在Windows上:

  • 最简单的方法是不把Python放在您的路径上,而是依赖于^{} CLI。在
  • 您需要安装本机依赖项所需的构建工具:npm install -g --production windows-build-tools。在

要在编辑器中完成工作,请在此存储库的根目录中设置一个虚拟环境并安装MkDocs:

$ pip3 install --user --upgrade setuptools twine wheel
$ python3 -m venv venv
$ . venv/bin/activate
$ pip install -r requirements.txt

要以可编辑的形式将插件安装到本地MkDocs站点:

$ pip install --editable /path/to/mkdocs-theme-bootstrap4

正在升级依赖项

要升级依赖项,请安装pip-upgrader

. venv/bin/activatepip install -r requirements.dev.txt

然后继续更新依赖项:

pip-upgrade requirements.dev.txt

节点依赖关系可以用Yarn更新:

yarn upgrade

释放

构建可分发包:

$ python3 setup.py sdist bdist_wheel

将其推送到PyPI测试实例:

$ python3 -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*

在虚拟环境中进行测试:

$ pip install --index-url https://test.pypi.org/simple/ --no-deps mkdocs-drawio-exporter

让我们开始吧:

$ python3 -m twine upload dist/*

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
并行处理java。util。同时发生的叉子在游泳池里。常见的并行性准则,用于选择正确的并行度大小   java如何将空白字符追加到指定长度?   安卓应用程序中出现错误,SSLHandshakeException,找不到证书路径的信任锚点   java如何使用JUnit Mockito验证检查方法是否未被调用   java如何使用不同的@RequestMapping解析多个控制器中的静态页面   Selenium中的javascript需要验证搜索结果   访问数据库SQLiteopenHelper方法时java应用程序崩溃(nullpointerexception)   在二叉树中验证最小堆时出现java空指针异常   Java 7的SSL连接失败   java用RestEasyWebTarget替换ProxyFactory不起作用   在Java应用程序中单击“否”按钮后,数组程序冻结(无响应)   数组中的前缀Java初学者前进和   Java HTML解析器,包括脚本标记和LineNumberReader   在java中为长类型数字加前导零   正则表达式无法映射正则表达式java。lang.IllegalArgumentException:模式段中捕获组的数量