search

mmistakes / minimal-mistakes

:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
https://mmistakes.github.io/minimal-mistakes/
MIT License
12.4k stars 25.56k forks source link

Question about running the theme on github #23

Closed augusto-garcia closed 10 years ago

augusto-garcia commented 10 years ago

Hello,

First, congratulations, your theme is pretty cool. I will use it for my Lab group. I have a server to upload the files.

However, I am having a problem on running it on github, that I would like to test and finish it it with my collaborators before uploading to the University's website.

Would you mind to take a look to see what is wrong? I tryed a number of options. It is running smoothly locally with "jekyll --server". Do I really need to include a .nojekyll file?

The page is here: github.com/augusto-garcia/statgen.esalq

Thank you very much!

mmistakes commented 10 years ago

I have no idea what a .nojekyll file is or does so I would say no, you don't need it. I host all of my themes on GitHub using the gh-pages like you are and have never included one.

What exactly isn't working for you when you push to GitHub? Does the site look messed up? Is not updating? Are you getting any sort of error notifications emailed to you from GitHub after pushing your commits? They're usually pretty good about letting you know if something failed.

The only thing I noticed in your repo was in _config.yml, you'll want to uncomment url: http://augusto-garcia.github.io/statgen.esalq so all the css and js loads properly.

jasonhodges commented 10 years ago

a .no-jekyll file is used to direct GitHub pages not to process your site as a Jekyll site. Some people host sites off GitHub pages that aren't built and compiled with Jekyll and may not want the automatic Jekyll processing that GitHub pages provides.

If you are including a .no-jekyll file when you push your site up to GitHub it is most likely not getting built properly or at all on GitHubs side. You should remove that file.

mmistakes commented 10 years ago

Thanks for clearing up what a .no-jekyll file is for @jasonhodges.

As I suspected @augusto-garcia, dump the .no-jekyll file from your repo, set the url in _config.yml and report back if that doesn't work.

augusto-garcia commented 10 years ago

Thank you both for the reply.

I removed the .no-jekyll and un-commented the url.

Now, when I click on "settings" for the project page, I am seeing the message "Your page is having problems building: Page build failed." (That is the reason I tryed using the .nojekyll thing).

So, http://augusto-garcia.github.io/statgen.esalq/ is not there.

Any ideas?

mmistakes commented 10 years ago

Does it give any specifics on what is causing the page build fail? Unless I'm missing something obvious I don't think it's anything in your repo. It's pretty much the same thing I host on GH for the theme demo with a few of your text modifications and url.

I thought maybe there's something goofy in your MarkDown or Liquid that is causing the fail, but since it builds locally I don't think the problem lies with the theme or the modifications you made. Worst case if you didn't have the correct url: set in _config.yml, the site would load but it would be missing the correct layout and styling.

To rule out the modifications you made as the culprit what happens if you try to publish the Minimal Mistakes gh-pages branch as is and then browse to http://augusto-garcia.github.io/minimal-mistakes/

Or maybe GH doesn't like your repo's name with the "."? I know there are some specific ways you have to have repos named and structured depending on how you host (ie: user vs org vs project pages).

augusto-garcia commented 10 years ago

OK, thanks. I will try both ideas and will post here soon.

augusto-garcia commented 10 years ago

1) deleted the old repo with a dot in the name (statgen.esalq), started a new one named statgen. gh-pages, etc, following the instructions, still having the same problem: "Your page is having problems building: Page build failed."

2) cloned minimal mistakes and uploaded it to my own minimal-mistakes repo. The site is there, although without proper layout. I guess this is easy to correct just by using the proper url, right?

So, I will try to find how I messed up the original template, since it seems that this is related with the problem. If I find, I will post here.

I hope I can managed to make this work, because I like the theme a lot.

mmistakes commented 10 years ago

2) Updating the url will fix the layout.

There's probably a bad Liquid tag if you changed anything with the _layouts or _includes. Otherwise it's probably something screwy in one of your posts or pages that the Markdown parser doesn't like.

On Wednesday, March 5, 2014, Antonio Augusto Franco Garcia < notifications@github.com> wrote:

1) deleted the old repo with a dot in the name (statgen.esalq), started a new one named statgen. gh-pages, etc, following the instructions, still having the same problem: "Your page is having problems building: Page build failed."

2) cloned minimal mistakes and uploaded it to my own minimal-mistakes repo. The site is there, although without proper layout. I guess this is easy to correct just by using the proper url, right?

So, I will try to find how I messed up the original template, since it seems that this is related with the problem. If I find, I will post here.

Thanks for your help! I hope I can managed to make this work, because I liked the theme a lot.

Reply to this email directly or view it on GitHubhttps://github.com/mmistakes/minimal-mistakes/issues/23#issuecomment-36772455 .

augusto-garcia commented 10 years ago

Well, I am very happy!

I found the problem. I created a page with title "People", but wrongly used layout: post, not layout: page. I changed and now the page is working: http://augusto-garcia.github.io/minimal-mistakes/ Later on, I will create an appropriate project name.

I still have one minor problem. On my home page, just below the picture, I have the link "Articles" that is poiting nowhere (404 error). On your page at http://mmistakes.github.io/minimal-mistakes/, you have the words "Latest posts", a link that is working. How should I fix this? I don't remember if I made some mistake when editing the template.

mmistakes commented 10 years ago

Excellent!

In your _config.yml I would remove the trailing slash in the url. It's adding double slashes in your links.

The "Articles" link isn't working because that page doesn't exist. Just change the link on this line to point to the Posts page instead. <a href="{{ site.url }}/posts/">Latest Posts</a>

augusto-garcia commented 10 years ago

Super! It's working! Now my Lab will have a "fancy and easy to maintain" web page.

Again, thanks a lot, and congratulations on your amazing work.