No theme appearing #22050
-
The theme at my gh-pages site is not appearing. The support from MkDocs said that it is a GitHub specific problem: MkDocs doesn't deploy · Issue #2659 · mkdocs/mkdocs · GitHub |
Beta Was this translation helpful? Give feedback.
Replies: 12 comments
-
upon checking your site, you have but your GitHub Pages is working, your only problem is the theme, and upon checking your
this is the most common problem, you can try the absolute link, or put wait for 5-10 minutes to see if it is working or not, because it will take time, |
Beta Was this translation helpful? Give feedback.
-
That’s not the problem, since MkDocs works for others too. |
Beta Was this translation helpful? Give feedback.
-
okay I see, I did not notice that, it is also a static site generator, but GitHub Pages has its own, Jekyll, it’s actually powered by Jekyll, so it’s best to use the default one, that’s actually one common problem with using other external apps, because if you are not keen, you might not realize that there is the problem with the app when used with another one, |
Beta Was this translation helpful? Give feedback.
-
jdevstatic:
What do you mean by that? |
Beta Was this translation helpful? Give feedback.
-
that it is not working with GitHub Pages, from the support of your static site generator, they are telling that the problem is from GitHub, not from them, so you really need to put effort in order to find what’s actually causing that issue, |
Beta Was this translation helpful? Give feedback.
-
yup, this is the same thing that I’m referring to, I mentioned you have my suggestion is try to deploy it again, say in if it is still causing the issue, I think, the problem is really the URL, put some time to check that, relative URLs are tricky, that’s the most common problem encountered here when deploying a page through GitHub Pages, |
Beta Was this translation helpful? Give feedback.
-
jdevstatic:
Why not? Other MkDocs users have it there as well.
jdevstatic:
How do I do that? |
Beta Was this translation helpful? Give feedback.
-
yup, that’s what I’m talking to, let me check first, good you provided many details, |
Beta Was this translation helpful? Give feedback.
-
This is an example of a working site: GitHub - nanoblox/core |
Beta Was this translation helpful? Give feedback.
-
see, that’s the confusion, the so now, what you want to do is to transfer that in now, this one is really tricky, so better create a new repo, host it in |
Beta Was this translation helpful? Give feedback.
-
Ahh it works now. I just changed this setting: I thought that it has to be the markdown files, I’m dumb 😂🤦♂️ |
Beta Was this translation helpful? Give feedback.
-
okay no problem, welcome, |
Beta Was this translation helpful? Give feedback.
see, that’s the confusion,
the
index.md
is the one being deployed and you don’t have there your background theme, it’s ongh-pages
and GitHub Pages cannot see that,so now, what you want to do is to transfer that in
docs
, transfer all your project files there, and do not change the setting on GitHub Pages,now, this one is really tricky, so better create a new repo, host it in
docs
folder ofmain
and put all of your project files there,