# Github Pages : use of Remote Theme **URL:** \ **Category:** Help\ **Created:** [April 28, 2018, 1:17pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737 "2018-04-28T13:17:30Z")\ **Posts on this page:** 19\ **Page:** 1
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 28, 2018, 1:17pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/1 "2018-04-28T13:17:30Z")
\_Starting today, you can use any of the hundreds of community-curated themes on [GitHub.com](http://GitHub.com). To build your site with any public, GitHub-hosted theme, add the following to your site’s _config.yml file:_ `remote_theme: owner/name` Been there, done that. And gotta say I’m a bit of confused. What does that exactly do, and what it doesn’t do? Can anyone guide me a bit? I’m pretty sure this means we don’t have to fork that theme in order to work, or do we? I’d appreciate any further explanation on this one. ---
**Author:** ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)\ **Post date:** [April 28, 2018, 7:22pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/2 "2018-04-28T19:22:26Z")
Yes it means you don’t have to fork a theme. As long as the theme is available as a Ruby gem you can use `remote_theme`. All it’s doing is pulling down the theme files (layouts, includes, CSS, etc) so you don’t have to manage them. Everything that applies for Gem-based themes applies for those assigned with `remote_theme`. The only difference being how you “install” them. > **[Themes](https://jekyllrb.com/docs/themes/)** > > Jekyll has an extensive theme system that allows you to leverage community-maintained templates and styles to customize your site’s presentation. Jekyll themes specify plugins and package up assets, layouts, includes, and stylesheets in a way that... ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 28, 2018, 9:02pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/3 "2018-04-28T21:02:45Z")
what troubles me is - what files should I exactly have in my repo afterwards and what not? coz right now I get bunch of 404’s , and I get basic skeleton but not card of theme, and don’t see my content, even tho I created .md file with some content. ---
**Author:** ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)\ **Post date:** [April 28, 2018, 9:31pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/4 "2018-04-28T21:31:44Z")
All depends on the theme you’re using, they’re all different. Point us to your GH repo, the theme you’re using, and can probably help more. ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 28, 2018, 9:42pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/5 "2018-04-28T21:42:39Z")
theme is called Sleek [my repo](https://github.com/diomed/diomed.github.io) ---
**Author:** ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)\ **Post date:** [April 28, 2018, 10:59pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/6 "2018-04-28T22:59:35Z")
You have a bunch of issues as to why this isn’t working. 1. If you’re using `remote_theme` don’t use `theme` as well. Remove `theme: jekyll-sleek` from your \_config.yml file 2. You have `url` in \_config.yml set wrong. You’ll probably want that to be set to your actual site. 3. Remove the `_layouts` folder and files unless you are overriding the ones in the theme. 4. Your post in `_posts` isn’t named correctly (e.g. YYYY-MM-DD-your-post.md) and doesn’t have any YAML front matter. 5. `index.md` is also missing YAML front matter and content. After all of those you’ll probably want to follow the theme’s instructions for setting it up as there are likely some other things you need to do. ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 29, 2018, 6:08pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/7 "2018-04-29T18:08:17Z")
thank you very much. so do posts really need to have date before their name? this is not optional? can I overwrite this somehow, not to have to use date? ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 29, 2018, 8:32pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/8 "2018-04-29T20:32:06Z")
I overwrote page in [layouts](https://github.com/diomed/diomed.github.io/blob/master/_layouts/default.html) I also typed my site’s title in config, I’m so frustrated, why doesn’t anything happen. ☹ ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 2:44pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/9 "2018-04-30T14:44:29Z")
> [@diomed](#): > > so do posts really need to have date before their name yes they do. I looked at your site and at a glance it looked ok. The contact page is 404 but I don’t see a contact page in the source. ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 30, 2018, 3:17pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/10 "2018-04-30T15:17:45Z")
It’s not the contact page that is problem. Didn’t set up that one yet. What I did set up was for name to change from Sleek to something else, also banner text, but that’s not changing at all. ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 3:30pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/11 "2018-04-30T15:30:02Z")
I would guess it is getting an error when building thus you don’t see any changes. The error may be that the post isn’t in the correct format - it needs to have the date it in it, try changing that to 2018-01-01-test.md or whatever and see if that fixes it. ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 4:01pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/12 "2018-04-30T16:01:16Z")
it also looks like you don’t have front matter on that post - at the top you need to have to sets of 2 dashes like so: ```auto --- --- ``` you could also remove that post entirely to eliminate it as a source of trouble. ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 30, 2018, 5:00pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/13 "2018-04-30T17:00:07Z")
how long does one have to wait for this to rebuild and for changes to take effect? ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 5:03pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/14 "2018-04-30T17:03:57Z")
should be pretty quick, couple minutes. The logo is an svg and isn’t going to change until you change it. Not sure why the banner isn’t changing. You are sure you are not getting emails from GH with an error message? it should send you an email when there is an error building. I would try doing something simple to see if it updates - like change the title in the config and see if the copyright in the footer changes. You could also remove the theme part and see what happens. ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 5:39pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/15 "2018-04-30T17:39:17Z")
I forked your repo and played around with it, I get build errors for that theme, I think maybe it is not a proper gem based theme? If I use one of mademistakes themes it works fine. I don’t use gem based themes so I don’t know enough to be able to tell what is wrong with it, I would open up an issue on that repo and see if anyone is able to use it as a remote theme. Again i don’t use gem based themes so it could easily be something I am doing wrong, I also find it a little interesting that it looks like the theme is working for you, just that you are getting build errors now so it is not updating any changes. hmmmm maybe I’ll keep trying. ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 30, 2018, 6:40pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/16 "2018-04-30T18:40:03Z")
I see theme has a gem file in official repo I’ve never actually tried to do anything with jekyll before, this is my first time. I know I could have just forked it but since Github so proudly announced it could be done this way, I wanna have it like this. ---
**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\ **Post date:** [April 30, 2018, 6:46pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/17 "2018-04-30T18:46:46Z")
if you are just starting out / learning I would recommend you fork a non theme based site to see how everything works, I think the themes hide a lot of the nuts and bolts and make it more mysterious than it really is. ---
**Author:** ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)\ **Post date:** [April 30, 2018, 7:22pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/18 "2018-04-30T19:22:40Z")
I’m getting this error on build now: ```auto jekyll 3.8.0 | Error: File exists @ dir_s_mkdir - /_site/assets/img/posts ``` Remove the empty `posts` file under `assets/img/` Doing that built the site. Your homepage looks fine ![image](https://canada1.discourse-cdn.com/flex030/uploads/jekyllrb/original/1X/a54ebfa4bbb5de8ecae0ad42b81a56bc8359f595.jpg) The first post “Bookofmozilla” doesn’t have any formatting because you don’t have any YAML Front Matter. You’ll want to add a `layout` and `title` like so: ```auto --- layout: post title: "The Book of Mozilla" --- ``` You can go ahead and remove the `#The Book of Mozilla` line in your body content as it’s not needed. I suggest you give [Jekyll’s documentation](https://jekyllrb.com/docs/home/) a good read to learn the basics. Then read the theme’s docs to understand how they set things up. Their README doesn’t have much info but looking through their demo site tells you more about how to get started. > **[Getting Started with Sleek](https://janczizikow.github.io/sleek/getting-started/)** > > Getting started ---
**Author:** ![diomed](https://avatars.discourse-cdn.com/v4/letter/d/ed8c4c/32.png) [@diomed](https://talk.jekyllrb.com/u/diomed)\ **Post date:** [April 30, 2018, 8:10pm UTC](https://talk.jekyllrb.com/t/github-pages-use-of-remote-theme/1737/19 "2018-04-30T20:10:00Z")
great! Thanks a lot for helping me out! 👍