Absolute beginner

OK, thanks. The problem seems to be, that I think in wrong structures (classical HTML…), therefore I cannot resolve the problem.

Okay I see your part about Wordpress.

In Jekyll there is no PHP server or database. Only HTML (and images, JS and CSS files).

If you want to build your site locally and then upload using FTP, that sounds like it will work for you. I do that with one of my sites. I don’t even have to restart Apache - the changes are there immediately.

The FTP approach doesn’t need GitHub at all. It is convenient though to share your code on github even in a private repo for your team.

The FTP approach takes manual effort and is an old fashioned way. So maybe you start with that and then move to GitHub + GitHub Pages later. Because simply committing on GitHub or pushing code to GitHub will trigger a build for you. I often edit my GH Pages sites on my phone. I don’t have to touch FTP or Nginx care about building and moving code as it is all all automated.

OK, thanks. I see. Maybe i will hire someone to arrange everything for the first time. Later on he can explain me, what he did. That will be the fastest way. :wink:

The coding itself - as I heard - is more or less the same like “nomal” HTML/ CSS stuff. In that case, the start is the only problem now. :wink:

Thanks anyway.

when you run jekyll build (or serve) it will create all the html files for your site - and your entire site will be in the _site folder. This would be the classical html you mention. You can take everything in there and ftp it or copy to where ever you want. So if you are already doing that with what you are doing now it should be the same thing.

Using GH for hosting, or using a CI or putting it on AWS S3 are all good options too and can be a little easier once you understand how it all works.

1 Like

you need to upload everything in your jekyll _site folder to the root folder on your server the way you have always done with ftp (probably sftp). thats it.

Hi roadie,
OK that is good news. :wink: But what means everything? Lets say, I just want to craete a very simple website. In HTML it would have - lets say - two pages and a style.css. The pages would be:

  • index.html (content: “Hello world”)
  • a subfolder and inide of it another site e.g.- subsite1.html (content: “I am a subsite”)
  • style.css(content: body, div, p {font-size: 12px; color: #000;} )

So if you just tell me which files i have to upload in such a case, I think, I can continue on my own.


[UPDATE] Both of my hosters denied, that I can run Jekyll on a shared server. They said, that I will have to rent my own server. That is nor very helpfull, cause it is both expensive and needs much more work then just bookiing a shared hosting.

So if there is any possibility of avoiding to rent a server for running Jekyll in the web, please inform me.

you run jekyll locally - not on the server.

When you run jekyll build or jekyll serve it will create a _site directory at the root of your project - have you seen that? that has your rendered site, you would take everything there and ftp it to your server/host.

1 Like

Hi everybody,
thank you for all these answers so far. Unfortunately, I had no real success until now. My main problem is the first steps. Once this is done I will mostly work in CSS. This is no problem for me. But until now I always worked on PHP based CMSs. That is why I can’t proceed. :frowning:

So I did another trial today. Once again I had an error message. I would be very glad if you could have a look at the messages I received on the Mac terminal. They are stored here. https://pastebin.com/TNMnZmSZ

What is my problem?

Thank you!

Look at the recommendation just before the error 1 line

brew install ruby-dev

Hi Michael,
Thanks, but unfortunately I am not used to working with the console. So I cannot understand what the messages mean,

Lets start with detailed questions:

  1. line 6: WARNING: You don’t have /Users/raphaelbolius-catalina/.gem/ruby/2.6.0/bin in your PATH,

What does that mean? How can I change that in order to eliminate this warning?

If I can change that, I suppose the result will be better. (?)

  1. I do not find any line that has the content you quote:
    brew install ruby-dev
    Where is that written??

I am now trying since 10 days or more to have a result. But I do not. So maybe it would be better to ask somebody who is familiar with that kind of installing to help me. either by Skype or by teamviewer.

How much time it would take a pro to do that approximately? Knowing that I might ask on freelancer,com for help. Maybe that is better than investing more time in a task I cannot resolve. (?)


From this

You might have to install separate package for the ruby development
environment, ruby-dev or ruby-devel for example.
extconf failed, exit code 1

So run the brew line I sent and then gem install line as before should work.

It looks like you did run this.

echo 'export PATH="$HOME/.gem/ruby/2.6.0/bin:$PATH"' >> ~/.bash_profile

So f you reload the terminal and do gem install line again, you should not get the warning about path.

BTW The PATH setup matters for executing bundler and Jekyll from anywhere and won’t stop an install.

You have my email. I haven’t seen any messages recently but I can help on a video call if you are still stuck

Hi Michal,
thank you in the first place. :wink:
Then: Oh myGod. The whole thing is a nightmare. I am used to install Wordpress and start working on the code. Now I try to install Jekyll since 10 days.

I had several offers of different freelancers that say, that they can do it, but they need approx. 6 hours to install Jekyll on my machine and connect it to an URL. Ist that right? I cannot believe it and rather think they want to earn lots of money in a short tie.

OK, to make it short:

  1. YES I would gladfully accept your offer of helping me directly. But remember: I have no glue about the whole topic. I never used the command line before and I do not know what is a gem and so on. SORRY!

  2. I suppose after that one is finished, I will have to learn a lot about the command line and all of that stuff. I already learned a lot of things in computing so that will be no problem. but just now, I have no idea…


Thanks for the clarity. It has hard to remember my first time using command line and using Jekyll

If you get no more errors after the current one is solved with brew then I think you are set and don’t need help installing Jekyll and certainly won’t take 6 hours.
Regarding connecting to a URL, you want to do that separate from your machine. Like use a free service like Netlify or GH Pages to build your site and put your bought domain on top of it. Any self hosted server will be more troublesome - and once someone helps you set it up you won’t be able to work on it alone.
And you probably have experience with setting up a domain that has a folder for serving and using FTP to move the content there and that you won’t need an expert to do for you.

Once you have Jekyll installed, you only need to use a build command and a serve command. The deploy using CI or FTP or something can then be figured out.

I think more of the learning will be around syntax and pattern for Jekyll templating. Your knowledge of HTML, CSS and JS will be useful and you can stick to basic Jekyll functionality initially

Ok, I think I am done now. Everything seems to be installed. I do not know exactly what I did, but this time I did not receive any error messages. Later on, I will learn all that stuff, no doubt. but the very first goal is to have a very simple site (maybe just an index.html and some kind of basic CSS) visible in the browser.

It would be great, if you continue guiding me threw the process. Even if I feel a little bit simple minded. :wink:

What I know (or believe to know) is:

  1. I have a place somewhere on my machine (Mac) where I can create files.
  2. I need some webspace on GitHub where I can export the stuff I am doing on my local machine.
  3. I need some programme that connects to the GH space and pushed my creation there.
  4. I need to connect the GH-space with any URL (for the moment, I do not care, where it is visible. The first goal says: "any URL will be fine.)

So the basic questions:

  • How do I define that place where I work on my machine in the command line?
  • Can I fetch a readymade template or some kind of basic structure from somewhere and place it in my working folder?
  • How can I move it to github?
  • how do I connect it to a URL to make it visible?

Is there a basic tutorial available?

OK, I think i found one: https://jekyllrb.com/docs/step-by-step/01-setup/a
and I already created a Gemfile (whatecer that might be. :wink: But I located it on my machine. Feels great!

Ok, the first showstopper appears. :frowning:
Raphaels-MacBook-Pro:~ raphaelbolius$ gem “jekyll”
ERROR: While executing gem … (Gem::CommandLineError)
Unknown command jekyll
Raphaels-MacBook-Pro:~ raphaelbolius$

What is my mistake exactly?
Any ideas? :wink: I just did, what the tut said. :wink:


When you run

gem install 'jekyll'

That is in the shell.

When something says

gem 'jekyll'

That means it is Ruby code which goes in a Gemfile (which contains ruby code). It must not be run in the shell.

git is the command line tool you need to fetch files on github and push local changes to github.

The repo on github corresponds to a folder your machine, usually with the same name.

Keep going with the 10 step tutorial.

Once you can setup a site on github, you can add a custom URL on top.