现代灵敏的狮身人面像主题设计

editorial-sphinx-theme的Python项目详细描述


Build StatusDownload per monthPackage versionPython LicenseSupported Python versionsDependency npm StatusDependency PyPi Status

编辑是斯芬克斯的主题,重点是方便阅读文档,以便使用整个 屏幕宽度,您的设计响应迅速,可适应任何设备

此主题的现场示例可以在:

这个模板基于html5 up(html5up.net)的编辑,只是在sphinx上做了必要的修改。

功能

  • 易于安装,不进行任何额外设置
  • 简洁的设计
  • 响应灵敏,可从移动设备调整到PC
  • 单击一次即可隐藏侧边栏
  • 对Google Analytics的集成和可选支持

安装

VIA套餐

下载包或将其添加到requirements.txt文件:

$ pip install editorial_sphinx_theme

conf.py文件中:

importeditorial_sphinx_themehtml_theme="editorial_sphinx_theme"html_theme_path=[editorial_sphinx_theme.get_html_theme_path()]

通过git或下载

您可以直接从git存储库中安装它,记住这将下载最后所做的更改 可能不稳定,导致失败。对于生产中的站点,请尝试使用pypi中提供的版本。

有两个主要分支“主”与稳定的代码和“开发”与最新的修改。

symlink或subtree将editive_sphinx_theme/editive_sphinx_theme存储库链接到您的文档中 docs/\u themes/editorial\u sphinx\u theme然后将以下两个设置添加到sphinx conf.py文件:

分支master

pip install -e git+https://gitlab.com/opb/editorial-sphinx-theme.git@master#egg=editorial_sphinx_theme

分行开发

pip install -e git+https://gitlab.com/opb/editorial-sphinx-theme.git@develop#egg=editorial_sphinx_theme
html_theme="editorial_sphinx_theme"html_theme_path=["_themes",]

选项

基本

基本工具或功能

滚动到顶部

Include a button in the lower right corner to return to the top of the page.

prev_next_按钮u底部

Navigation buttons at the end of the page, to go to the previous and next page.

prev_next_按钮侧边栏

Navigation buttons at the end of the sidebar, to go to the previous and next page.

回购信息

与使用过的存储库相关的信息

回购名称

Name of the repository service, for example GitLab. This name will be displayed in some parts of the page.

repo网址

Repository address, for example: https://gitlab.com/opb/editorial-sphinx-theme

谷歌分析[可选]

分析ID

This indicates the Google Analytics ID used by this service, if you do not pass any value the javascript script will not load on the page. The value must have the format “UA-XXXXX-Y”.

异步分析

This option indicates which version of the Google Analytics script to use, for more information in your website https://developers.google.com/analytics/devguides/collection/analyticsjs/#alternative_async_tracking_snippet

Fork Me Ribbon[可选]

您可以在页面的一角启用功能区,并使用图例“fork me on<;repo_name>;”和 目标url是“repo_url”中指定的存储库

您可以使用的选项如下:

forkme_色带

It enables the use, only loaded if it is equal to ‘True’.

forkme_对齐

Where shown, take the following locations: left-top, right-top, left-bottom, right-bottom

forkme_已修复

If you pass ‘True’ to this option, the ribbon will be shown with the CSS property fixed, and as we scroll on the page will continue showing in the same corner.

如何贡献

  • 检查打开的问题或打开一个新的问题,开始围绕功能想法或错误的讨论。
  • 在github上分叉存储库以开始进行更改,最好创建一个分支来转储这些更改。
  • 运行或编写测试以确保一切正常工作。
  • 完成后发送拉取请求

许可证

此模板在gnu通用公共许可v3(gplv3)许可下分发,有关更多信息,请参阅文件许可。

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

推荐PyPI第三方库


热门话题
java如何将cassandra中的行数据转换为与列相关的嵌套json   java如何使用jcr XPath在jcr:content/@jcr:data中搜索?   java在使用openCV进行安卓开发时如何利用手机的广角镜头   java解析扩展了接口,结束了一个潜在的无限循环   位置服务的@Override方法中存在java Android应用程序错误   java本地线程的用途和需求是什么   具有左右子访问的java节点树遍历   java验证JsonWebToken签名   JUL日志处理程序中的java日志记录   嵌入式Java读取给定时间段的串行数据。   java有没有办法从多个URL获取多个图像?   java线程通过等待intent阻止自己发送intent   java Spring MVC解析多部分内容请求   java JPA/Hibernate静态元模型属性未填充NullPointerException   java格式错误的字符(需要引号,得到I)~正在处理   java为什么PrintWriter对象抛出FileNotFoundException?   java Neo4j未正确保存标签   java IE不加载图像