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

How to tune layout for a particular page/post in Jekyll?

I would like to make some changes in Jekyll's layout. Changes are small and different. For example, linking an additional CSS or JavaScript file. Or adding some info in header. Or tuning page title. Important that these changes depend on a…
Varvara Stepanova
  • 3,489
  • 4
  • 22
  • 26
24
votes
1 answer

How to support line number when using pygments with Jekyll

How can I number the code lines which are highlighted using pygments in Jekyll?
Usman Ismail
  • 17,999
  • 14
  • 83
  • 165
23
votes
10 answers

Jekyll: Include a file from directory outside of _includes

I have an directory called /patterns in my Jekyll site, whose structure generally looks generally like this: _includes _layouts _site /patterns index.html I need to keep the /patterns directory outside _includes for a number of reasons, but mostly…
Brad Frost
  • 401
  • 1
  • 4
  • 9
23
votes
3 answers

Jekyll on Github Pages not rendering CSS

I've been experimenting with Jekyll using Octopress for deployment. I've got it working perfectly on localhost, but for some reason the CSS isn't getting loaded when the site loads on Github Pages. I'd appreciate any assistance understanding…
Scro
  • 1,353
  • 2
  • 15
  • 26
23
votes
2 answers

How do I configure GitHub to use non-supported Jekyll site plugins?

I just created a great gallery for my Jekyll blog which builds perfectly on my localhost:4000. However, GitHub pages doesn't support the Jekyll Gallery Generator plug-in I am using: https://github.com/ggreer/jekyll-gallery-generator I read about the…
aaron-coding
  • 2,571
  • 1
  • 23
  • 31
23
votes
7 answers

Modulus (or lack thereof) in Ruby's Liquid templating engine

I'm working on a Jekyll site and am trying to output three column divs nested in a row div. Liquid makes this pretty easy with their cycle filter: {% for p in site.categories.post %} {% cycle 'add rows': '
', nil, nil %} …
Andrew
  • 36,541
  • 13
  • 67
  • 93
23
votes
2 answers

How can a Jekyll page access its filename?

My goal is to create links from any published jekyll page back to its location on Github. And so, I'd need access to a page's pathname when constructing this url. However, I don't see anything in the api for templates that provides this info. I…
Dogweather
  • 15,512
  • 17
  • 62
  • 81
22
votes
1 answer

Jekyll remote theme doesn't work locally

Abstract I wanted to see a page in the local machine made by Jekyll using gem "jekyll-remote-theme" So I ran bundle exec jekyll serve But a blank page came out What I want to achieve To see a page in the local machine made by Jekyll using gem…
dixhom
  • 2,419
  • 4
  • 20
  • 36
22
votes
3 answers

Limit jekyll post list to certain categories

I have a jekyll website and I have a category (called photo) and I wanted to create a separate layout for a page that would list just the posts that were in the photo category. I also want to keep posts with the photo category out of the main index…
Mark Szymanski
  • 56,590
  • 24
  • 70
  • 87
22
votes
5 answers

Jekyll compiling seems WAY too slow

I'm building a site with Jekyll for the first time. I'm loving it so far; my only problem is the exceedingly long build times. Right now, when I run jekyll build, it takes about 30 seconds to generate the site. 30 seconds might not seem like a lot,…
Keith Pickering
  • 696
  • 10
  • 24
22
votes
1 answer

Using liquid tags in YAML Front Matter variables

Is it possible to use Liquid tags in YAML Front Matter variables? For example if test.html contains: --- variable: "Date: {% date: '%D' %}" --- {{ page.variable }} then Jekyll will generate the following HTML: Date: {% date: '%D' %} instead of…
gvas
  • 317
  • 3
  • 8
22
votes
2 answers

How can I get a longer automatic excerpt in Jekyll?

Currently, I include excerpts like this: {{ post.excerpt | strip_html }} But this seems to give only the first paragraph. But I would like to get a fixed number of words. Or better: I would like to define a maximum number of characters and get so…
Martin Thoma
  • 124,992
  • 159
  • 614
  • 958
22
votes
4 answers

Convert Google Docs to Jekyll Markdown

How can I convert a Google Docs, which contains images and tables, into a Markdown file which can be published as a post using Jekyll? Is it possible to first export the Google Docs into a PDF and then convert the PDF to Markdown? What will happen…
orschiro
  • 19,847
  • 19
  • 64
  • 95
22
votes
4 answers

My jekyll site can't build: Liquid Exception: incompatible character encodings

I do not know what I changed, but today I can no longer build my site's front page with jekyll successfully. It is now complaining about: [2012-10-30 14:22:10] regeneration: 1 files changed Liquid Exception: incompatible character encodings: UTF-8…
incumbent
  • 355
  • 2
  • 7
21
votes
2 answers

js and css not loading when hosting next application on GitHub pages

Next.js builds all the static assets in _next folder but Github pages does not need to serve those files. I am 404 for static assets. Example repo: https://github.com/ajaymathur/ajaymathur.github.io Master branch is hosted and dev branch is for…
Ajay Narain Mathur
  • 5,326
  • 2
  • 20
  • 32
1 2 3
…
99 100