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
20
votes
6 answers

Deploying Jekyll to Github Pages

I have built a site locally with Jekyll, and have pushed it to a new master repo (username.github.com) and the site works great yay. My question is, how do I move just the deployable part, the _site directory, into a gh-pages branch? Or rather, the…
thatryan
  • 1,551
  • 6
  • 21
  • 39
20
votes
2 answers

For loops in Liquid: using reversed in conjunction with limit:1

I'm building a simple blog using Jekyll, and I'm pulling my hair out trying to figure out this problem. The index page of the site is meant to feature a single, most recent article, with the structure looking something like below (pardon the…
Harrison Grieve
  • 303
  • 1
  • 2
  • 4
20
votes
3 answers

Get Jekyll Configuration Inside Plugin

I'd like to make changes to the Jekyll Only First Paragraph plugin to make the generation of a 'read more ' link a configurable option. To do this I'd need to be able to access the Jekyll site config inside the plugin's AssetFilter. With the…
Jon Cram
  • 16,609
  • 24
  • 76
  • 107
19
votes
1 answer

Jekyll without a theme

I'm trying to create a static website. I want to be able to do some simple preprocessing, such as including one page within another, without the use of PHP or JavaScript. Jekyll seemed perfect for this, especially given its support on GitHub…
OMGtechy
  • 7,935
  • 8
  • 48
  • 83
19
votes
4 answers

Permanent redirect from Github gh-pages

I want to create a homepage and, for now, I think Github's pages features will serve my needs. However, I might want to switch to a more full-blown CMS/blog engine later on. Is it possible to serve a permanent redirect (HTTP 301) from Github pages…
Fred Foo
  • 355,277
  • 75
  • 744
  • 836
19
votes
4 answers

Jekyll link within page

I'm using Jekyll on Github, and I wonder whether there's a way to link to a section within a page. Say I have a section like ## Section 1 ## section content and later in the same page I want to link to this section. I've found how to link to…
user7843034
  • 429
  • 4
  • 8
19
votes
1 answer

Mathjax curly brackets don't show up (using jekyll)

I use Mathjax on my static (jekyll-generated) site : Mathjax is loaded but curly brackets don't show up. $ \{ 2*3 \} $ -> 2*3 $ \left{ 2*3 \right} -> \left{ 2*3 \right} (math style) I'd like to have (for instance) a simple {2*3} Cheers
ted
  • 13,596
  • 9
  • 65
  • 107
19
votes
1 answer

How to insert the last updated time-stamp in Jekyll page at build time?

I would like to automatically insert a last updated timestamp (Not the date variable for the page) for each post at Jekyll build time, how to achieve that? I think I have to declare a variable but I am not sure how to assign the value to that…
XY L
  • 25,431
  • 14
  • 84
  • 143
19
votes
1 answer

What does {% capture var %} do in jekyll?

What does {% capture var %} do in Jekyll? Can I for example, in a .md file do: {% capture head %} I am the head {% endcapture %} and then in the .html file do: {{head}} Am I using capture correctly?
biw
  • 3,000
  • 4
  • 23
  • 40
19
votes
2 answers

Jekyll raw HTML in post

I have a Jekyll website, with Posts written in Markdown using the Kramdown parser. I would like to add some raw HTML within the post. However when I try to add the HTML, it parses it as markdown (changing <'s to < for example). I have tried:…
Marcus Hughes
  • 5,123
  • 1
  • 25
  • 39
19
votes
2 answers

Insert HTML to Jekyll post

I'd like to include some Web Audio API HTML5 code into a Jekyll post. Here's a clone of the HTML page + Javascript code that I'd like to include: view-source:http://www.smartjava.org/examples/webaudio/example3.html How should this be achieved?
19
votes
3 answers

Excluding page from Jekyll navigation bar

I am setting up a basic Github-hosted Jekyll website (so minimal, I am not even bothering to change the default theme). I have a nested site with a small number of first-tier pages that I would like to appear in the navigation bar (i.e. the default…
Peter
  • 4,219
  • 4
  • 28
  • 40
19
votes
4 answers

jekyll 2.2.0 | Error: Address already in use - bind(2)

I am new to Jekyll blogging and trying to view blog locally on http://localhost:4000 but failed. ➜ my-awesome-site > jekyll serve Notice: for 10x faster LSI support, please install http://rb-gsl.rubyforge.org/ Configuration file:…
controlled
  • 211
  • 1
  • 2
  • 6
19
votes
2 answers

Custom Variables in Jekyll Front Matter

New to Jekyll and wondering if it's possible to include custom variables in Jekyll Front Matter. It would be useful for nested layouts, for example something like: layouts/artist.html ---- layout: default title: {{ page.artist }} (Artist) ---- I…
mahemoff
  • 44,526
  • 36
  • 160
  • 222
18
votes
1 answer

How to run "bundle exec jekyll new ."

I'm trying to follow "Creating a GitHub Pages site with Jekyll" but when I run any of these commands: $ bundle exec jekyll VERSION new . $ bundle exec jekyll _4.0.0_ new . $ bundle exec jekyll 4.0.0 new . I get this error: "Could not locate Gemfile…
user2901351
  • 629
  • 8
  • 22