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
18
votes
2 answers

How do I put a hyperlink inside a list in Markdown on GitHub Pages?

I have tried the following syntax to make a Markdown list item on a GitHub page of mine a hyperlink: 1. [Caption]: https://example.com 2. Another list item Contrary to intuitive expectations it renders into the following HTML code
    …
Ivan
  • 63,011
  • 101
  • 250
  • 382
18
votes
1 answer

unable to build a jekyll site ... invalid date

when trying to build a jekyll site with "jekyll serve" I get this error: Generating... ERROR: YOUR SITE COULD NOT BE BUILT: ------------------------------------ Invalid date '<%= Time.now.strftime('%Y-%m-%d…
Nacho de Leon
  • 621
  • 5
  • 8
18
votes
2 answers

Hierarchical Categories in GitHub Pages

I'm using Jekyll on GitHub pages, and I want to have hierarchical categories like this: animals -> mammals -> cats -> _posts -> housecat.md, tiger.md animals -> mammals -> dogs -> _posts -> poodle.md, doberman.md animals -> reptiles -> lizards ->…
Kevin Workman
  • 41,537
  • 9
  • 68
  • 107
18
votes
1 answer

Add an element on the last Jekyll loop of posts

I'm sure this is simple but cant find the answer. There is a standard Jekyll/Liquid post iterator. How do i use the {% if %} statement below to put the
element for each post except the last?
    {% for post in site.posts…
David
  • 3,166
  • 2
  • 30
  • 51
18
votes
9 answers

How can I install Jekyll on OSX 10.11?

ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/jekyll I'm getting a permission error on trying to install Jekyll. I'm currently running OSX 10.11 (El Capitan). I also have Xcode 7 and have installed the developer…
lenignes
  • 333
  • 1
  • 5
  • 17
18
votes
1 answer

Using Liquid tags in a Jekyll page not working

I am attempting to setup a small blog using Jekyll. My work so far is as follows. Setup a Github pages repository Cloned the repo locally Installed Ruby vs 2 and the sdk (windows) Installed jekyll 'serve' the local website. Validated that I could…
nVentimiglia
  • 1,888
  • 4
  • 21
  • 37
18
votes
3 answers

jekyll installed but 'command not found'

I installed jekyll, but surprisingly somehow osx doesn't recognise its installed. $ sudo gem install jekyll Password: Successfully installed jekyll-1.2.1 Parsing documentation for jekyll-1.2.1 Done installing documentation for jekyll after 1…
aegyed
  • 1,320
  • 3
  • 20
  • 39
18
votes
2 answers

limit the number of post though a category with jekyll

I'm trying to filter some post with jekyll. I want to output all post with category: news. It works fine when i do: {% for post in site.posts %} {% if post.category[0] == "news" %}

{{ post.title }}

{% endfor %} but i'd like…
Yannick Schall
  • 32,601
  • 6
  • 29
  • 42
18
votes
4 answers

How to support scrolling when using pygments with Jekyll

Is it possible to use horizontal scrolling rather than text wrapping in a code section highlughted with pygments when working in Jekyll. Source of document: {% highlight bash %} Full thread dump OpenJDK Client VM (19.0-b09 mixed mode,…
Usman Ismail
  • 17,999
  • 14
  • 83
  • 165
18
votes
1 answer

Underscore issues: Jekyll + redcarpet == Github flavored markdown?

I'm buliding a site with github pages and do not want underscores within words to italicize portions of those words. E.g. function_name_here should not render with name italicized. I understand github flavored markdown is supposed to be smart…
Bosh
  • 8,138
  • 11
  • 51
  • 77
17
votes
3 answers

Syntax Highlighting with Pygments is failing via Liquid Templates String Error

I'm using Jekyll to convert my markdown and Pygments for syntax highlighting. Here is the error maruku displays: Liquid error: undefined method `join' for "\n song_info = []\n for song in songs:\n song_info.append(song.name) \n":String The markup…
muffs
  • 805
  • 10
  • 14
17
votes
3 answers

Check if variable is type of string or array in liquid

In Jekyll you can use liquid template and I am trying to write a nav that includes all links in the website. sitemap: home: "/" demo: right: "/right" left: "/left" What I am trying to achieve is to create a sidebar that icludes all…
ctrlmaniac
  • 404
  • 4
  • 13
  • 28
17
votes
2 answers

Table of contents using Jekyll and Kramdown

I'm trying to use Kramdown's auto "Table of Contents" generator on a page (not a post) on my Jekyll site. _includes/toc.html my_cool_stuff/my_cool_page.md --- layout: page --- {% include toc.html…
Devin
  • 465
  • 1
  • 6
  • 15
17
votes
5 answers

Jekyll/Ruby Kramdown Missing Dependency

I am struggling with trying to set up my first jekyll blog. I am trying to run jekyll server, but upon typing it into the terminal I get the error message: You are missing a library required for Markdown. Please run: $ [sudo] gem install…
abalabazn
  • 351
  • 3
  • 7
17
votes
2 answers

loop through filtered collection in jekyll

I try to do things like this in my post:
    {% for post in site.posts | where:'group', post.group %}
    {% include article-snippet.html %}
    {% endfor %}
but…
Anton Shuvalov
  • 3,560
  • 3
  • 16
  • 20
1 2 3
…
99 100