Stack Overflow
Stack Overflow

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
42
votes
4 answers

Include jekyll / liquid template data in a YAML variable?

I am using the YAML heading of a markdown file to add an excerpt variable to blog posts that I can use elsewhere. In one of these excerpts I refer to an earlier blog post via markdown link markup, and I use the liquid template data variable {{…
Gavin Simpson
  • 170,508
  • 25
  • 396
  • 453
41
votes
2 answers

Jekyll: Include HTML partial inside Markdown file

Is there a way to include an HTML partial from a Markdown file with Jekyll? Example: File index.md: --- layout: default title: Home --- This is a [Markdown](http://daringfireball.net/projects/markdown/) file. {% include foobar.html %} File…
François Beaune
  • 4,270
  • 7
  • 41
  • 65
41
votes
10 answers

Jekyll on Windows: Pygments not working

I updated to the latest JekyllBuild (1.0.3) before I always used the RC. After updating the parsing of codes (with Pygments) doesn't work anymore. I always get the following…
Sebastian Sebald
  • 16,130
  • 5
  • 62
  • 66
40
votes
3 answers

Jekyll default installation doesn't have _layouts directory

So I followed the guide on the Jekyll website by installing and running Jekyll (sure I don't have to post this here). And the site is up and running perfectly but for some reason I don't see the _layouts directory that's supposed to be there. In the…
user818700
40
votes
4 answers

Assign an array literal to a variable in Liquid Template

The only way i know to create an array from my liquid template is: {% assign my_array = "one|two|three" | split: "|" %} Is there any other way to do it?
Stefano Ortisi
  • 5,288
  • 3
  • 33
  • 41
39
votes
3 answers

Jekyll serve didn't work: It looks like you don't have pygments or one of its dependencies installed

Configuration file: /Users/andrechristoga/Documents/type-theme/_config.yml Deprecation: You appear to have pagination turned on, but you haven't included the `jekyll-paginate` gem. Ensure you have `gems: [jekyll-paginate]` in your…
Andre Christoga
  • 497
  • 1
  • 5
  • 11
39
votes
3 answers

How to render a Jekyll markdown page on sites index

I'm probably missing something simple but I have no way to test Jekyll locally. I'm using GitHub pages to render Jekyll, for starters I only want to render markdown content on the main index.html from one markdown page. The structure is:…
Wyck
  • 2,023
  • 4
  • 28
  • 34
39
votes
4 answers

How to show a preview of a post? (Using Jekyll Bootstrap theme)

This is probably an easy question, but how do I show previews of my posts on the default page? I am using the Jekyll Bootstrap theme Tom.
dsawler
  • 526
  • 1
  • 4
  • 4
38
votes
2 answers

How to use multiple arguments in an if statement with Liquid

I want to use an if statement in Liquid with multiple conditionals. Something like: {% if (include.featured == "true" and product.featured == "true") or (include.featured == "false" and product.featured == "false") %} Multiple conditionals don't…
Fisu
  • 3,294
  • 9
  • 39
  • 61
37
votes
6 answers

How to create a table of contents to Jekyll blog post?

If I have a page/post in Jekyll with headers, is it possible to auto-generate a table-of-contents/outline for navigation? Something akin to the top matter of a Wikipedia article.
Zando
  • 5,473
  • 8
  • 30
  • 37
35
votes
9 answers

How to list files in a directory with Liquid?

I'm trying to learn how to use Jekyll along with Bootstrap; while studying them, I decided that I'd like to have an image carousel on my homepage. Since I'm really lazy I don't want to hard-code the paths needed to display every image inside the…
Cesco
  • 3,770
  • 7
  • 24
  • 26
35
votes
5 answers

Table not render when use Redcarpet in Jekyll GitHub Pages?

As of maruku engine (the default), writing table like surround text, etc. | Tables | Are | Cool | | ------------- |:-------------:| -----:| | col 3 is | right-aligned | $1600 | | col 2 is | centered | $12 | |…
neizod
  • 1,582
  • 15
  • 24
34
votes
1 answer

Including HTML inside Jekyll tag

Instead of writing out {% include link_to.html i=5 text="hello world" %} all the time, I've written a custom tag that allows me to do {% link_to 5 hello world %}. It finds the page with data i equal to 5 and creates a link to it. But it feels clunky…
wrongusername
  • 18,564
  • 40
  • 130
  • 214
34
votes
4 answers

Why put the _site-directory of a Jekyll site in .gitignore?

The documentation of Jekyll tells me, that the _site-directory of a Jekyll site contains the compiled version of the site I have created after running Jekyll build Several articles recommend, that I include the _site-directory in my…
Otterfinger
  • 369
  • 1
  • 3
  • 8
34
votes
6 answers

Is it possible to serve multiple Jekyll sites locally?

Every time I serve a Jekyll site from the command line it is served on port 4000. Two sites can't be served on the same port. Is it possible to serve multiple Jekyll sites locally?
Brian Zelip
  • 2,909
  • 4
  • 33
  • 45
1 2 3
…
99 100