I made a GitHub action in order to build and deploy my docusaurus site on a GitHub page following the docusaurus documentation.
When I make a modification in one of my project file, the GitHub action works well, the pipeline works, the branch master has been updated and the gh-pages branch too, but when I refresh my GitHub page, the modification is not displayed.
Does someone know what could be the issue? I saw that the issue could come from the use of GITHUB_TOKEN?
Related
I've been able to publish GitHub sites under my domain on GitHub Pages from the master branch without issue, however in the docs it says to use a gh-pages branch or master/docs for publishing projects.
I also have a repository for my homepage index.html file/assets, where I link to each of the published GitHub repositories (which are published to my domain name.com/repo-name).
Why have I been able to publish from the master branch? Is there any reason to publish from the gh-pages branch or master/docs instead for publishing project repositories?
GitHub Pages can publish from any of those sources: gh-pages branch, master/docs, or just from the repo itself. It's more of a preference which route you use.
For example, Jekyll is publishing using the master/docs option. The rest of the repo outside of the docs folder is for the actual Jekyll code. One possible reason is that PR's with new features must also include documentation of that new feature. Otherwise, it won't get merged.
The gh-pages option means that code and documentation can be paced or managed differently. They live in the same repo, but the branches can grow at differing speeds.
In terms of technical differences, there's no technical costs/benefits to each option as far as I know. It's just how you want to organize your code and documentation.
Hope that helps!
GitHub requires user and organization sites to build from master, while project sites can build from gh-pages. If I understand correctly, you are publishing to your user site, i.e. yourusername.github.io.
Similar questions have been asked but I haven't been able to find my answer:
My site is fine locally and all the correct files seem to be on my GitHub, but my published site (https://username.github.io/project) is still only showing my first intitial push.
Can someone direct me to troubleshoot?
From "Configuring a publishing source for GitHub Pages"
make sure you have enabled GitHub Pages to publish your site from master or gh-pages
or that you are one a master branch, subfolder docs.
Then you might need to wait a minute or two before seeing those pages rendered.
There are a few similar questions but none of the solutions mentioned in the other questions could solve my issue.
I am using mkdocs to publish github pages. command I am using is mkdocs gh-deploy --clean
This has worked correctly in the past. But now suddenly after making a minor spelling change to one of the pages, the changes are not reflected in the git pages website. Note that in gh-pages branch I can see the changes were pushed correctly.
Shouldn't gh-pages branch be in sync with github pages website all the time ?
What am I missing here ?
//EDIT:
To say this problem in other words, It is a static site which is built using mkdocs. If gh-pages branch has all the changes (and it works fine locally), then shouldn't it update the github pages site automatically. As I understand there is no build process involved for static github pages site.
I have Jenkins setup for a scala/sbt project on github.
Everything seem to be working fine, except that the build being shown for Pull Request is done for the master branch (not for the branch which might be be merged).
Anyone has faced this problem before? Any advice / suggestions?
PS. Unfortunately the repo is not public and I can't provide direct link. Although I can add logs and more details, if you think its gonna be useful.
Note: The PR I was referring to was the PRs from forks.
I recently played around with the Jekyll/Poole/Lanyon theme for a new blog. At first, I linked my domain jonathancharleslee.com to my github pages site at jonathancharleslee.github.io
When I update files locally, I can update site features and posts - however, when I push to github it won't update on jonathancharleslee.github.io
Any help is much appreciated.
You're on a user/organisation repository (username.github.io). This type of repository needs you to push in master branch, not in gh-pages.
See Github Pages doc
You should be working and making all your changes on the development branch, then pushing ONLY your built files to the master branch, which is what Github Pages will publish.
There's step-by-step instructions on how to do this in this posting:
https://stackoverflow.com/a/44296933/7669275