👀 Views: 0 💬 Answers: 1 📅 Created: 2025-06-14

github jekyll github-pages Markdown

This might be a silly question, but I've been struggling with this for a few days now and could really use some help. I'm trying to deploy a Jekyll site to GitHub Pages, but I keep working with a 404 behavior when accessing the site URL. I've ensured that the `baseurl` in my `_config.yml` is set correctly according to my repository name, like this: ```yaml baseurl: "/my-repo-name" ``` I've also verified that my GitHub repository is set to serve GitHub Pages from the `gh-pages` branch. My repository structure looks like this: ``` /my-repo-name ├── _config.yml ├── _posts ├── index.md └── README.md ``` To troubleshoot, I've done the following: 1. Ensured that the site builds correctly locally using `bundle exec jekyll serve`. 2. Checked that the `gh-pages` branch is up-to-date with the latest changes and includes all the necessary files. 3. Verified the repository settings under GitHub Pages are correctly pointing to the `gh-pages` branch and not a different source. Despite all this, when I navigate to `https://<username>.github.io/my-repo-name/`, I still get a 404 behavior. The console shows: ``` 404 Not Found Sorry, we couldn't find that page. ``` Is there something I've missed in the setup, or could it be a caching scenario with GitHub Pages? Any insights or troubleshooting tips would be greatly appreciated! My development environment is Ubuntu. Am I missing something obvious? The project is a CLI tool built with Markdown. I'd love to hear your thoughts on this. This is part of a larger microservice I'm building. Could someone point me to the right documentation? I'm working with Markdown in a Docker container on Windows 10. Has anyone else encountered this?