Questions tagged [jekyll]

Jekyll is a blog-aware, static site generator written in Ruby. Please refer to https://talk.jekyllrb.com before asking your question.

Jekyll logo

Jekyll is a blog-aware, static site generator written in Ruby.

It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache, the built-in WEBrick server or the web server of your choice. This is also the engine behind GitHub Pages, which you can use to host your project’s page or blog with GitHub.

Jekyll also offers a way to customize it via plugins written in Ruby.


Notable site using it:

Resources:


Latest Release:

Gem Version

6232 questions
66
votes
10 answers

Unable to set favicon using Jekyll and github pages

I am trying to set a favicon.ico for my github page, but it doesn't work. When I serve it locally I see the standard "empty" favicon and when I push it I see the facebook icon. Why is it so? I have the right favicon.ico in the root directory of my…
Dror
  • 12,174
  • 21
  • 90
  • 160
64
votes
25 answers

Error Installing Jekyll - Native Extension Build

I'm having some trouble installing jekyll. Can't quite figure out how to patch the missing link. I think it's an update to Ruby, but RVM is having trouble installing alternate versions of ruby as well. Heres the full post: $ sudo gem install jekyll…
Robb Schiller
  • 1,109
  • 2
  • 9
  • 17
62
votes
4 answers

Comment out an include statement inside an HTML file using Jekyll

Is there a way to comment out an include statement inside an HTML file using Jekyll? For example I have this inside one of my HTML files that I'd like to temporarily comment out. Standard HTML comment doesn't seem to work. {% include navbar.html %}…
Amit
  • 765
  • 1
  • 5
  • 9
59
votes
3 answers

What's the difference between categories and tags in Jekyll?

Both of their elements can be accessed by for..in, and the way of adding categories and tags are the same. So, what's the difference between categories and tags in Jekyll?
jiyinyiyong
  • 4,586
  • 7
  • 45
  • 88
58
votes
3 answers

Iterate over hashes in liquid templates

I'm writing a site in Jekyll, which uses Liquid. I have front matter for pages that I'd like to look like this: --- title: Designing algorithms that scale horizontally speaker: Luke Ehresman, CopperEgg category: notes.mongodallas.talks links: -…
Brian Hicks
  • 6,213
  • 8
  • 51
  • 77
57
votes
6 answers

Jekyll display posts by category

scratching my head over this - help much appreciated. I want to display a list of all my Jekyll posts, organised by category. I know Line 3 isn't correct but I can't figure out what it should be. Any ideas? Thanks! {% for category in…
Alex G
  • 1,646
  • 2
  • 17
  • 19
56
votes
18 answers

Jekyll - command not found

I am trying to get Jekyll running but I have no experience with Ruby. As far as I can tell the installation of Jekyll has succeeded. However: $ jekyll Gives an error: -bash: jekyll: command not found This is the gem env result: - RUBYGEMS…
DADU
  • 6,482
  • 7
  • 42
  • 64
56
votes
1 answer

Jekyll/Liquid - how to add large blocks of text to YAML front matter?

I'm trying to implement a service catalog in Jekyll, in which each of 20 or 30 pages will contain a 7x2 table. The left column will hold labels, e.g. Overview, Available To, etc, while the right column will hold between one line and several…
patrickjmc
  • 569
  • 1
  • 4
  • 3
55
votes
5 answers

Switch theme in an existing Jekyll installation

There are many themes for Jekyll, e.g. https://github.com/jekyll/jekyll/wiki/Themes. What is the easiest way to switch to a new theme in an EXISTING Jekyll installation?
majom
  • 7,863
  • 7
  • 55
  • 88
55
votes
8 answers

Jekyll/Liquid Templating: How to group blog posts by year?

I'm rewriting my blog to use Jekyll. Jekyll uses the Liquid templating language so it makes it a little more difficult to learn how to customize. I'd like to group my list of blog posts by year. How would I write the Liquid code to be able to do…
Andrew
  • 227,796
  • 193
  • 515
  • 708
55
votes
4 answers

Generating a list of pages (not posts) in a given category

I am using Jekyll as a static generator for a website (not a blog), and I want to have an automatically generated list of all pages on my index page. Specifically, I want to have different categories and list all articles in each category…
Mike
  • 1,569
  • 2
  • 14
  • 20
53
votes
7 answers

Embedding Markdown in Jekyll HTML

I'm trying to nest markdown in an HTML file while using Jekyll. Is there a way to achieve something like the following? # index.html --- layout: default ---

[Stack Overflow](http://www.stackoverflow.com)

Note: I'm aware that I could do…
sunnyrjuneja
  • 6,033
  • 2
  • 32
  • 51
52
votes
5 answers

How can I get a post excerpt in Jekyll?

I'm creating a new blog using Jekyll. On the main page, there will be a list of my 10 most recent posts. The entries on this list will include a title, the post date, and an excerpt, most likely the first paragraph. I'm only familiar with using…
corazza
  • 31,222
  • 37
  • 115
  • 186
51
votes
2 answers

Liquid templates: even/odd items in for loop

If I have a for loop in Liquid (using Jekyll), how can I target even (or odd) items only? I have tried: {% for item in site.posts %} {% if forloop.index % 2 == 1 %} but that doesn't seem to work. I have also tried: (forloop.index % 2) ==…
Adam Kiss
  • 11,811
  • 9
  • 48
  • 81