github pages 无法加载css的问题

今天再将sphinx自动生成的html上传到github上面充当说明文档，遇到了一个问题，就是_static/css/路径下的css和js文件加载不出来，查了很多方法，都没有试成功，其实后面我测试的时候发现，只要带下划线的文件里面的内容都无法访问，这是因为github pages的jekyll模版会忽略下划线开头的文件，所以要禁用jekyll。

禁用方法就是在项目根目录下添加一个空白文件，命名为：.nojekyll

这样就解决了无法加载_static文件的问题。

note：在操作的时候，不要开代理服务器，发现我网络开着代理服务器，还是没有加载成功，幸好自己在手机上试了试发现可以正常显示css样式，然后让同学试了试也没问题，这才找到问题。

另外记录一下整个过程：
关于sphinx生成说明文档的过程，可以查看我的这篇博客使用sphinx自动生成python项目说明文档，下面是在说明文档已经生成之后的步骤：

1.首先创建一个仓库，仓库的名字antsesame.github.io，注意antsesame可以修改，后面的github.io是不可以修改的，建议尽量和自己的github名字一样（我的github名字就是antsesame），这样直接通过antsesame.github.io就可以访问，如果你设置的是其他的名字比如abc.github.io,后面访问的时候需要通过antsesame.github.io/abc.github.io才可以进行访问。

2.点击settings，找到github Pages，点击check it out here

3.branch选择main，后面选择/(root)，这个地方选择/(root)是指的你的仓库的根目录就是root目录，所以index直接放到仓库根目录下就可以，如果选择/docs，意味着你得建一个docs文件夹，docs是项目的github pages根目录，然后index放到docs这个文件下。另外在这里可以直接看到访问的站点信息。

4.然后往仓库里面放网站的内容就可以了，由于我的是通过sphinx生成的html所以我直接把html中的所有内容放到根目录就可以了。

5.通过settings中的github Pages上面显示的站点信息访问就可以了。（注意此处已经将空白的.nojekyll文件放到根目录下了。）

参考：
sphinx生成说明文档放到github pages官方指南
https://daler.github.io/sphinxdoc-test/includeme.html

在github上搭建个人博客
https://zhuanlan.zhihu.com/p/28321740

github pages 无法加载css的问题相关推荐

requireJS 加载css、less文件
-- requireJS 同样可以加载css 文件,有require-css的插件,只需要把插件放入main.js同文件夹,在依赖处采用 'css! test.css'的形式就可以加载css文件 - ...
javascript动态加载css、javascript脚本方法
1. 动态加载js文件到head标签并执行回调方法调用:dynamicLoadJs('http://www.yimo.link/static/js/main.min.js',function(){a ...
php laravel 加载css,Laravel无法加载css文件(Laravel can't load css file)
Laravel无法加载css文件(Laravel can't load css file) 我无法在Laravel项目中加载css文件. /public/css/style.css确实存在IDE确认, ...
IE浏览器加载CSS文件，但是不起作用的原因
如果有哪一天,你突然发现自己写的的脚本不起作用了,而这一切又只是发生在IE浏览器上,你会怎么办?你是认为自己写的程序有问题呢?还是认为IE处理程序有问题?其实这个问题想都不用想,肯定是我们写的程序有问 ...
asp.net MVC发布iis无法加载css,js和图片
今天真够郁闷的,遇到了在本地能运行的项目到了iis服务器那里就不行了,无法加载css,js和图片,这里说清楚一下先,关于asp.net 的MVC中这样的情况其实不少,但是之前遇到的是在visual s ...
yii 加载php文件,Yii2框架加载css和js文件的方法分析
本文实例讲述了Yii2框架加载css和js文件的方法.分享给大家供大家参考,具体如下: 1.第一步是要把我们的css.js文件放到web目录下 2.第二步修改assets/AppAsset.php文件 ...
[css] 异步加载CSS的方式有哪些？
[css] 异步加载CSS的方式有哪些? 异步加载CSS 说到加载 CSS 这种事儿不是很简单吗?像这样咯: 这不就完事儿了嘛! 这样是没错!但是这样有问题啊--会阻塞渲染!浏览器看到这个标签就会停下 ...
JQuery 加载 CSS、JS 文件
JS 方式加载 CSS.JS 文件: //加载 css 文件 function includeCss(filename) {var head = document.getElementsByTagNa ...
php 无法加载css文件,解决ThinkPHP样式无法加载问题（CSS,JS）,
解决ThinkPHP样式无法加载问题(CSS,JS)解决了ThinkPHP风格无法加载的问题(CSS,JS),以下是thinkphp框架教程栏目,对ThinkPHP风格无法加载(CSS,JS)问题的解 ...

github pages 无法加载css的问题

github pages 无法加载css的问题相关推荐

最新文章

热门文章