时间戳

首页 > 解决方案 > Python Sphinx css 在 github 页面上不起作用

python - Python Sphinx css 在 github 页面上不起作用

问题描述

我已经使用 Sphinx 为 Django 项目创建了文档，并html在执行make html命令后将文件夹的内容复制到docs/我的 repo 的文件夹中并将其推送到 Github。之后，我将此docs/目录设置为Github Pages，现在它正在加载文档，但css无法正常工作，它只是带有任何样式的文档文本。

这是我的狮身人面像config.py：

import os
import sys
import django
sys.path.insert(0, os.path.abspath('..'))
os.environ['DJANGO_SETTINGS_MODULE'] = 'PROJECT_NAME.settings'
django.setup()

templates_path = ['_templates']
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
html_theme = 'bizstyle'
html_static_path = ['_static']
BUILDDIR = '.'

这是来自 GitHub 页面的文档页面的链接：https ://arycloud.github.io/Tagging-Project-for-Machine-Learning-Natural-Language-Processing/

有什么问题？

标签： pythondjangogithub-pagespython-sphinx

解决方案

我使用 sphinx/githubpages 来记录我的一个 python 项目。我发现这篇博文很有帮助。这是我的工作文档目录的示例。

在 docs 目录中添加 .nojekyll 文件将解决此问题。这告诉 github 页面不要通过 jekyll 发布文件。有了这个，您不需要更改任何目录名称，它应该使用“_”前缀。

推荐阅读