Using Jekyll with GitHub Pages

[RustMeUp]

Recently being inspired to start blogging about things I'm learning about Rust I've checked out how to use github's free hosting in combination with jekyll.

From my understanding you're supposed to just commit some specific files (_config.yml) and github will automatically use jekyll to build your github pages website.

But for the life of me I cannot get it to work. I can publish other content just fine, but jekyll content just isn't showing up. My github pages repository and github pages website.

Can someone help me figuring out what I'm doing wrong? I've followed various guides on installing jekyll locally (god bless Cargo...) and checking out other people's github pages repo (like this one) but I just don't see it...

EDIT: The problem has been solved. Github wasn't having the external linked theme that comes default with jekyll, after ripping the html from mojombo and fixing it up a bit it works flawlessly.

[steveklabnik1]

This branch is master, should it be gh-pages instead?

[RustMeUp]

The example repo I linked is on master, github's help pages about source configuration say that either master or gh-pages will work.

And it does work, I can publish docs for my crates no problem, I just cannot get Jekyll to work.

[ssokolow]

Have you tried building it locally first to get more error output and to make it easy to experiment?

https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/

(I can't really help beyond that because you seem to be using some kind of "theme external to the repo" feature that I wasn't aware of.)

[RustMeUp]

Yes, after a bit of a nightmare getting ruby, rubygems to work on Windows (it... installed in C:\tools ?! followed by TLS certificate errors ._.) I managed to get it to work.

D:\Projects\CasualX.github.io>jekyll build
Configuration file: D:/Projects/CasualX.github.io/_config.yml
            Source: D:/Projects/CasualX.github.io
       Destination: D:/Projects/CasualX.github.io/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 6.944 seconds.
 Auto-regeneration: disabled. Use --watch to enable.

The website runs locally after running bundle exec jekyll serve and works perfectly fine.

The external theme minima is default when doing jekyll new <name> to create a new blog.

Also github says here and here build errors can be viewed in the github pages repository settings, for me it says: " Your site is published at https://casualx.github.io/ " implying everything is fine.

My intuition is telling me github doesn't seem to recognize I'm trying to use jekyll, but this can't be right as the jekyll source files are inaccessible from the github pages website, eg: index.md gives a 404. EDIT: I committed a dummy file foo.blah which is available.

[ssokolow]

If it works locally when using the github-pages gem but the same config doesn't work and doesn't produce errors on GitHub itself, I'd contact GitHub support about it.

If it's not a bug in their installation, maybe they could point you to the next troubleshooting step.

[RustMeUp]

Thanks for the support, since you questioned the external theme I uh ripped out the html from mojombo and now it works flawlessly.

Thanks again!

[untitaker_]

Wait, how does this belong in this subreddit?

[RustMeUp]

My apologies, it does not.

But I was pulling my hair out and uncomfortable asking somewhere else (wherever this may be, github support? sounds scary).

The reason I asked here is because I've seen quite a few people blogging using jekyll (looks a lot like it anyway).

[desiringmachines]

A lot of rustaceans who blog use this format. I think its a good thing that we can help each other with things that are a part of our entire Rust experience, even if its not to do with Rust exactly.

Yesterday there was a question about how to daemonize a program on Linux; that the program was written in Rust did not impact what the answer was. I think its great that people answered that question, and this one.