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

Can a Rails app and a Jekyll blog live together?

I have a Rails app and I want to add a blog feature; my idea is to use Jekyll which is a great blog tool, I just need to figure out if it's possible to use http://my.app.com/blog as a url (knowing that Jekyll will run its own server process with its…
Panchew
  • 283
  • 4
  • 6
26
votes
4 answers

Jekyll on GitHub Pages: include markdown in another markdown file

I'm using kramdown with Jekyll on GitHub Pages. I have a piece of markdown that I want to use twice, and don't want to maintain two versions of it. How can I include this in other markdown files? For example, I want to type something like {: include…
Andrew Mao
  • 35,740
  • 23
  • 143
  • 224
26
votes
4 answers

How can I add a button in a .md file with Jekyll

Is there a way to add a simple HTML button, with some CSS formatting to a Markdown file using Jekyll? I am very new to Jekyll and don't really know my way around it. I would like to make this button link to external URL for a file download.
Inigo Mantoya
  • 641
  • 2
  • 9
  • 14
26
votes
2 answers

How do I provide files for download?

I have written a post and would like to provide a file as attachment for download. So far I have created a link [Download files][download-file] declared the link as [download-file]: download.zip put download.zip in the _posts folder However, the…
Thomas Weller
  • 55,411
  • 20
  • 125
  • 222
26
votes
1 answer

How do I create an IF ELSE statement if there are no Jekyll posts in a category?

I have a FOR statement that outputs all posts of type jobs. {% for post in site.categories.jobs %} {% endfor %} But if there are…
astanush
  • 413
  • 1
  • 4
  • 9
26
votes
3 answers

grunt watch & connect

I am kinda new to grunt and want to use it with Jekyll and some LESS-compiling. My problem now is, I already have fully functioning LESS-comipiling with live reload and watch task and can build my jekyll site through grunt, but how do I run…
Kageetai
  • 1,268
  • 3
  • 12
  • 26
26
votes
9 answers

For loop, wrap every two posts in a div

Basically, I am using Jekyll (which uses the Liquid templating language) and I am trying to write a for loop which wraps every two items in a div. This is my current loop:
{% for post in site.posts %} {{…
Tom
  • 825
  • 2
  • 11
  • 22
25
votes
5 answers

Are there any GUI/WYSIWYG CMS editor based on Jekyll?

I find Jekyll to be very easy and useful to maintain static html sites and blogs, especially along with GitHub pages. Wanted to know if there are any Static site generators or CMS which helps in maintaining Jekyll sites with live preview, inline…
rmchndrng
  • 782
  • 1
  • 8
  • 18
25
votes
1 answer

Jekyll - exclude folder, but include subfolder

I have a structure like: folder/ folder/subfolder/ I want to exclude everything from folder/, except folder/subfolder/. I there any way to do this with Jekyll? I tried a few combinations, but neither works, e.g.: exclude: ["folder"] include:…
Marvin3
  • 5,741
  • 8
  • 37
  • 45
24
votes
4 answers

How can I make Jekyll use a layout without specifying it?

In order to keep some of my Jekyll sites simple, I'm always using the same layout. That is to say, I'm always writing something like. . . --- layout: default title: Here's my Title --- . . . as the YAML Front Matter at the top of my pages. What…
Philip Durbin
  • 4,042
  • 2
  • 25
  • 36
24
votes
6 answers

How to deploy a jekyll site locally with css, js and background images included?

I've been trying to load my octopress site (based on jekyll) to my local network. There is no server, I just want it available locally on a shared folder. Every time i deploy it to a local folder the css and js and background image links are…
user1026169
  • 5,345
  • 5
  • 21
  • 35
24
votes
2 answers

Can Jekyll act over css or js files?

I'm using Jekyll for one of my projects and it really seems a very good alternative for developing simple websites but maintaining some processes automated. It's nice how the Liquid Extensions work, so I was wondering if it's possible to make Jekyll…
zanona
  • 12,345
  • 25
  • 86
  • 141
24
votes
5 answers

How to suppress blank line in Jekyll?

I use GitHub Pages for my blog, and am running into a problem with Jekyll. My post.html has a block like this: {% for testpost in site.posts %} {% four %} {% lines of %} {% processing …
James Curran
  • 101,701
  • 37
  • 181
  • 258
24
votes
4 answers

How do I use markdownify in Jekyll to show an excerpt on the index

I'm looking to show a short excerpt of text from a longer post or page on the index page. I was going to use a custom variable in the Front Matter and grab that, but then I saw the filter for .excerpt I see in the Jekyll docs there's something…
kaplan
  • 4,109
  • 6
  • 30
  • 35
24
votes
5 answers

Site root: Github Pages vs. `jekyll --server`

When I run jekyll --server my site is available at http://localhost:4000/, but when I deploy to GitHub Project Pages, it's available at http://username.github.com/projectname/. This means that I cannot use absolute URLs when referring to stylesheets…
Andres Riofrio
  • 9,851
  • 7
  • 40
  • 60