sphinx.plonetheme 2.0

关于

这是一个为Sphinx提供的主题，它提供了一个类似于plone.org的HTML输出。

安装

使用easy_install创建环境

$ easy_install sphinxjp.themes.impressjs

或使用buildout

[buildout]
parts=
    sphinx

[sphinx]
recipe=zc.recipe.egg
eggs=
    Sphinx
    sphinx.plonetheme

使用以下内容配置conf.py

extensions = ['sphinxjp.themecore']
html_theme = 'plonetheme'
# Opensearch support with Plone icon
html_use_opensearch = 'http://my.site.tld/mydoc'
...
# Have a disqus setting for this site to have visitors feedback?
# (register at http://disqus.com/)
html_theme_options = {
   'disqus_name': 'the_disqus_site_shortname'
}

并运行

$ make html

需求

库

• Python 2.6或更高版本（不支持3.x）

• Sphinx 1.0.x或更高版本。

测试于…

• Firefox 3

• Safari 4

• Chrome 5

• Opera 10

贡献

Fork或成为plone collective组织的一部分

https://github.com/collective/sphinx.plonetheme

“demo/”文件夹是我用来测试此主题的Sphinx。您可以在该处添加更多Sphinx结构来测试Plone Sphinx主题。

更多关于Sphinx主题的文档可以从这里找到。

致谢

• Gilles Lenfant

• Jean-Michel FRANCOIS

版权和许可证

呃，我不是律师，所以我只能说每个人都获准在Sphinx文档中使用这些文件。这些文件不提供任何支持或任何担保。

此主题包含Plone标志，这是Plone基金会的注册商标。请参阅http://plone.org/foundation/logo/the-plone-logo/

此主题包含来自http://www.psdgraphics.com/的免费图形。

由于所包含媒体的版权，您不能将此Sphinx主题用于商业文档。

待办事项

• 合并所有CSS到一个文件中，这样我们就不再依赖于'default.css'了。

• 测试和美化由标准扩展（代码API、doctests等）生成的HTML。

2.0 (2013-02-07)

• 使用sphinxjp.themecore进行了打包

1.1（未发布）

• 添加图形到警告标记[glenfant]

• 在Pygments卡在代码高亮时解决Sphinx + Pygments的bug（？）[glenfant]

• 警告IE6用户最好使用今天可用的任何其他浏览器（一个第三千年浏览器）[glenfant]

• 更吸引人的样式[glenfant]

• https链接也被视为外部链接[glenfant]

1.0（未发布）

• 初始版本，支持Sphinx 0.6.5及以上版本。[glenfant]