# Help

**URL:** https://talk.jekyllrb.com/c/help/6.md

[Latest](https://talk.jekyllrb.com/latest.md) · [Categories](https://talk.jekyllrb.com/categories.md)

---

## [About the Help category](https://talk.jekyllrb.com/t/about-the-help-category/14)

<div class="topic-metadata">

**Author:** [@talk](https://talk.jekyllrb.com/u/talk)\
**Replies:** 1\
**Last updated:** [April 21, 2022, 11:22am UTC](https://talk.jekyllrb.com/t/about-the-help-category/14 "2022-04-21T11:22:51Z")

</div>

---

## [Do you usually test Jexyll builds locally before deploying?](https://talk.jekyllrb.com/t/do-you-usually-test-jexyll-builds-locally-before-deploying/10524)

<div class="topic-metadata">

**Author:** [@islabrown190](https://talk.jekyllrb.com/u/islabrown190)\
**Replies:** 1\
**Last updated:** [September 19, 2026, 8:31am UTC](https://talk.jekyllrb.com/t/do-you-usually-test-jexyll-builds-locally-before-deploying/10524 "2026-09-19T08:31:13Z")

</div>

I’m getting used to Jekyll so i have a basic question. please someone reply. Do you normally run jekyll build and check generated \_site locally before deploying, or do you mostly rely on the deployement build?

---

## [Jekyll 4/kramdown stops processing markdown after Bandcamp iframe embed](https://talk.jekyllrb.com/t/jekyll-4-kramdown-stops-processing-markdown-after-bandcamp-iframe-embed/10520)

<div class="topic-metadata">

**Author:** [@mistydemeo](https://talk.jekyllrb.com/u/mistydemeo)\
**Replies:** 2\
**Last updated:** [September 18, 2026, 6:20pm UTC](https://talk.jekyllrb.com/t/jekyll-4-kramdown-stops-processing-markdown-after-bandcamp-iframe-embed/10520 "2026-09-18T18:20:26Z")

</div>

I’m seeing an issue where Jekyll seems to entirely stop Markdown processing after it hits a Bandcamp embed iframe in a Markdown document. Here’s the iframe, using code directly copied from Bandcamp’s share widget: \<ifra…

---

## [Liquid in layout working everywhere except posts](https://talk.jekyllrb.com/t/liquid-in-layout-working-everywhere-except-posts/10463)

<div class="topic-metadata">

**Author:** [@ashParadise](https://talk.jekyllrb.com/u/ashParadise)\
**Replies:** 1\
**Last updated:** [September 11, 2026, 6:30pm UTC](https://talk.jekyllrb.com/t/liquid-in-layout-working-everywhere-except-posts/10463 "2026-09-11T18:30:33Z")

</div>

Working on building my blog and I have this in my sidebar on every page to show my most recent mini blog post: --- cardName: Navigation --- {% assign mini = "mini" %} {% for post in site.posts | where: "type", mini li…

---

## [Admin-panel or CMS for Jekyll](https://talk.jekyllrb.com/t/admin-panel-or-cms-for-jekyll/6480)

<div class="topic-metadata">

**Author:** [@stblog](https://talk.jekyllrb.com/u/stblog)\
**Replies:** 13\
**Last updated:** [September 11, 2026, 6:29pm UTC](https://talk.jekyllrb.com/t/admin-panel-or-cms-for-jekyll/6480 "2026-09-11T18:29:16Z")

</div>

Hello, I uploaded my first Jekyll site on github. I would like to connect the admin panel or cms system. I’ve been trying to connect NetlifyCMS all day, but I’m completely confused. Can someone suggest another easie…

---

## [Jekyll Website Builds Successfully but Updated Content Is Missing From the Generated Production Page](https://talk.jekyllrb.com/t/jekyll-website-builds-successfully-but-updated-content-is-missing-from-the-generated-production-page/10489)

<div class="topic-metadata">

**Author:** [@benstokesee](https://talk.jekyllrb.com/u/benstokesee)\
**Replies:** 2\
**Last updated:** [September 9, 2026, 5:41pm UTC](https://talk.jekyllrb.com/t/jekyll-website-builds-successfully-but-updated-content-is-missing-from-the-generated-production-page/10489 "2026-09-09T17:41:18Z")

</div>

Hello Jekyll Community, I am currently facing one persistent issue with my Jekyll website where the build process completes successfully, but an updated page does not always contain the latest content in the generated p…

---

## [How to add a logo to minima theme?](https://talk.jekyllrb.com/t/how-to-add-a-logo-to-minima-theme/4120)

<div class="topic-metadata">

**Author:** [@Tonterias](https://talk.jekyllrb.com/u/Tonterias)\
**Replies:** 15\
**Last updated:** [July 4, 2026, 1:35pm UTC](https://talk.jekyllrb.com/t/how-to-add-a-logo-to-minima-theme/4120 "2026-07-04T13:35:35Z")

</div>

Hi, I would like to add a logo to minima but as I see in github it is not clear how There have been several attempts but I do not find the solution: https://github.com/jekyll/minima/issues?q=logo Thanks a lot for you…

---

## [Adding local-only collections with \_config\_dev.yml or other methods](https://talk.jekyllrb.com/t/adding-local-only-collections-with-config-dev-yml-or-other-methods/10356)

<div class="topic-metadata">

**Author:** [@tatianaanthony](https://talk.jekyllrb.com/u/tatianaanthony)\
**Replies:** 1\
**Last updated:** [July 2, 2026, 9:33am UTC](https://talk.jekyllrb.com/t/adding-local-only-collections-with-config-dev-yml-or-other-methods/10356 "2026-07-02T09:33:37Z")

</div>

TL;DR: When using two config files, any collection only defined in the first config file does not get created appropriately. How can I tell Jekyll to merge the lists of collections and front matter defaults in both conf…

---

## [You don't have write permissions for the /var/lib/gems/2.3.0 directory](https://talk.jekyllrb.com/t/you-dont-have-write-permissions-for-the-var-lib-gems-2-3-0-directory/204)

<div class="topic-metadata">

**Author:** [@RobWardNZ](https://talk.jekyllrb.com/u/RobWardNZ)\
**Replies:** 17\
**Last updated:** [June 8, 2026, 8:47am UTC](https://talk.jekyllrb.com/t/you-dont-have-write-permissions-for-the-var-lib-gems-2-3-0-directory/204 "2026-06-08T08:47:29Z")

</div>

This seems to be a fairly common problem, evidenced by Googling. I have installed Jekyll quite a few times on Windows but this was on a clean install of Ubuntu 16.10... jack@jakobuntu:~$ gem install jekyll Fetching: pu…

---

## [Migrating My Interactive Morse Code Translator Website to Jekyll](https://talk.jekyllrb.com/t/migrating-my-interactive-morse-code-translator-website-to-jekyll/10406)

<div class="topic-metadata">

**Author:** [@benstokesee](https://talk.jekyllrb.com/u/benstokesee)\
**Replies:** 2\
**Last updated:** [June 6, 2026, 1:04pm UTC](https://talk.jekyllrb.com/t/migrating-my-interactive-morse-code-translator-website-to-jekyll/10406 "2026-06-06T13:04:10Z")

</div>

I run a fairly advanced Morse Code translator website that allows users to convert text into Morse code and decode Morse messages back into readable text in real time. The website includes JavaScript-powered translation …

---

## [Using templating and "@use" now Sass has deprecated "@import"](https://talk.jekyllrb.com/t/using-templating-and-use-now-sass-has-deprecated-import/10247)

<div class="topic-metadata">

**Author:** [@hraftery](https://talk.jekyllrb.com/u/hraftery)\
**Replies:** 12\
**Last updated:** [May 25, 2026, 3:24pm UTC](https://talk.jekyllrb.com/t/using-templating-and-use-now-sass-has-deprecated-import/10247 "2026-05-25T15:24:23Z")

</div>

Dart Sass deprecated the use of @import in 1.80.0. Jekyll depends on sass-embedded, ~\> 1.75, which looks to track the Dart Sass versioning. Hence, Jekyll now depends on a version of Sass that has deprecated @import. As …

---

## [Exec bundle jekyll serve is not loading from \_plugins, but](https://talk.jekyllrb.com/t/exec-bundle-jekyll-serve-is-not-loading-from-plugins-but/10310)

<div class="topic-metadata">

**Author:** [@dolfs](https://talk.jekyllrb.com/u/dolfs)\
**Replies:** 3\
**Last updated:** [May 13, 2026, 3:25pm UTC](https://talk.jekyllrb.com/t/exec-bundle-jekyll-serve-is-not-loading-from-plugins-but/10310 "2026-05-13T15:25:52Z")

</div>

bundle exec jekyll serve, the plugins are not loaded, and an error occurs. When I run bundle exec jekyll serve –plugins \_plugins, the plugins are loaded and everything works. I am doing all this in a docker container, w…

---

## [Is the Jekyll project dead?](https://talk.jekyllrb.com/t/is-the-jekyll-project-dead/6820)

<div class="topic-metadata">

**Author:** [@kevquirk](https://talk.jekyllrb.com/u/kevquirk)\
**Replies:** 22\
**Last updated:** [April 1, 2026, 7:26pm UTC](https://talk.jekyllrb.com/t/is-the-jekyll-project-dead/6820 "2026-04-01T19:26:36Z")

</div>

I just read this rather alarming post. Is the Jekyll project actually dead?

---

## [Posts and updates do not show up](https://talk.jekyllrb.com/t/posts-and-updates-do-not-show-up/10330)

<div class="topic-metadata">

**Author:** [@antonis755](https://talk.jekyllrb.com/u/antonis755)\
**Replies:** 4\
**Last updated:** [March 28, 2026, 9:24am UTC](https://talk.jekyllrb.com/t/posts-and-updates-do-not-show-up/10330 "2026-03-28T09:24:38Z")

</div>

So I did set up my blog theme many years ago, through github, and it used to work until today, where I tried to post a new post and it didn’t work at all. I then went to make an update on a post, and same thing, no updat…

---

## [Starting with CSV/XML](https://talk.jekyllrb.com/t/starting-with-csv-xml/6831)

<div class="topic-metadata">

**Author:** [@moorlag](https://talk.jekyllrb.com/u/moorlag)\
**Replies:** 6\
**Last updated:** [March 22, 2026, 3:35pm UTC](https://talk.jekyllrb.com/t/starting-with-csv-xml/6831 "2026-03-22T15:35:47Z")

</div>

Hi there, I’ve started a new pet project and I am asking for help. Heidis Koch Klub (Heidi’s Cooking Club). HKK is a paper-based recipe card system from the '70. Easy to understand recipes to feed a family. In the firs…

---

## [Theme not Found Locally (MissingDependencyException / Gem::MissingSpecError)](https://talk.jekyllrb.com/t/theme-not-found-locally-missingdependencyexception-gem-missingspecerror/10312)

<div class="topic-metadata">

**Author:** [@ahutnick](https://talk.jekyllrb.com/u/ahutnick)\
**Replies:** 1\
**Last updated:** [March 14, 2026, 11:34pm UTC](https://talk.jekyllrb.com/t/theme-not-found-locally-missingdependencyexception-gem-missingspecerror/10312 "2026-03-14T23:34:17Z")

</div>

Hello, First time developing a custom Jekyll theme. Uploaded the gem to rubygems successfully, installed the gem successfully, and set up the theme in the config file. However, when I run bundle exec jekyll serve, I get…

---

## [API documentation about Liquid::Tag](https://talk.jekyllrb.com/t/api-documentation-about-liquid-tag/10306)

<div class="topic-metadata">

**Author:** [@potr](https://talk.jekyllrb.com/u/potr)\
**Replies:** 0\
**Last updated:** [February 28, 2026, 1:32pm UTC](https://talk.jekyllrb.com/t/api-documentation-about-liquid-tag/10306 "2026-02-28T13:32:11Z")

</div>

Where can we get detailled information on Liquid internal API? That would be very useful for writing Liquid plugins (right now I’m trying with a Tag plugin). The problem is that nothings seems to be documented. The ruby…

---

## [Self hosting JS](https://talk.jekyllrb.com/t/self-hosting-js/10299)

<div class="topic-metadata">

**Author:** [@Ljalabs](https://talk.jekyllrb.com/u/Ljalabs)\
**Replies:** 1\
**Last updated:** [February 21, 2026, 3:20pm UTC](https://talk.jekyllrb.com/t/self-hosting-js/10299 "2026-02-21T15:20:12Z")

</div>

I’m using the Chirpy theme and wondered if it is possible to self host all of the JS? I believe the theme uses npm packages hosted on cdn.jsdelivr.net. I’m just trying to learn about web servers and security and would …

---

## [Initial commit gives me an error](https://talk.jekyllrb.com/t/initial-commit-gives-me-an-error/10164)

<div class="topic-metadata">

**Author:** [@Nathan](https://talk.jekyllrb.com/u/Nathan)\
**Replies:** 3\
**Last updated:** [February 12, 2026, 9:17pm UTC](https://talk.jekyllrb.com/t/initial-commit-gives-me-an-error/10164 "2026-02-12T21:17:01Z")

</div>

Hello everyone, I would like to build a website with Jekyll (with minimal mistake template GitHub - academicpages/academicpages.github.io: Github Pages template based upon HTML and Markdown for personal, portfolio-based…

---

## [Layout front matter data inheritance](https://talk.jekyllrb.com/t/layout-front-matter-data-inheritance/10284)

<div class="topic-metadata">

**Author:** [@arghc](https://talk.jekyllrb.com/u/arghc)\
**Replies:** 0\
**Last updated:** [February 9, 2026, 2:11am UTC](https://talk.jekyllrb.com/t/layout-front-matter-data-inheritance/10284 "2026-02-09T02:11:17Z")

</div>

Created a test to check inheritance of front matter variables to check how it works before programming something that depends on that. There are 3 layers of templates like so: outer.html --- layout: middle vari: "oute…

---

## [Intermittent Build, Rendering, and Data Consistency Issues in a Culver’s Menu Website Built With Jekyll and Dynamic Data Sources](https://talk.jekyllrb.com/t/intermittent-build-rendering-and-data-consistency-issues-in-a-culver-s-menu-website-built-with-jekyll-and-dynamic-data-sources/10270)

<div class="topic-metadata">

**Author:** [@benstokesee](https://talk.jekyllrb.com/u/benstokesee)\
**Replies:** 1\
**Last updated:** [February 5, 2026, 3:50pm UTC](https://talk.jekyllrb.com/t/intermittent-build-rendering-and-data-consistency-issues-in-a-culver-s-menu-website-built-with-jekyll-and-dynamic-data-sources/10270 "2026-02-05T15:50:06Z")

</div>

I’m currently building a Culver’s-inspired restaurant menu website using Jekyll as the static site generator, and the project has grown more complex than a typical blog-style setup. The site includes multiple menu catego…

---

## [Front matter liquid processing without filters](https://talk.jekyllrb.com/t/front-matter-liquid-processing-without-filters/10265)

<div class="topic-metadata">

**Author:** [@arghc](https://talk.jekyllrb.com/u/arghc)\
**Replies:** 2\
**Last updated:** [February 2, 2026, 10:18pm UTC](https://talk.jekyllrb.com/t/front-matter-liquid-processing-without-filters/10265 "2026-02-02T22:18:39Z")

</div>

What I want to do is process things like the page.title\* or page.description and then pass them down to a layout. Since yml front matter won’t accept {{ variables }} or liquid, there are options like flatify (which I ho…

---

## [How do pages get to \_site, and get a url](https://talk.jekyllrb.com/t/how-do-pages-get-to-site-and-get-a-url/10255)

<div class="topic-metadata">

**Author:** [@anitagraham](https://talk.jekyllrb.com/u/anitagraham)\
**Replies:** 1\
**Last updated:** [January 27, 2026, 1:35pm UTC](https://talk.jekyllrb.com/t/how-do-pages-get-to-site-and-get-a-url/10255 "2026-01-27T13:35:34Z")

</div>

I am a new user of Jekyll, and I’m transferring a traditional website to Jekyll. I’m familiar with Ruby, HTML, css, sass, js etc etc. I have read the docs, and questions many times…but I have a \_pages directory, with a…

---

## [Includes and collections not updating properly](https://talk.jekyllrb.com/t/includes-and-collections-not-updating-properly/10200)

<div class="topic-metadata">

**Author:** [@benstokesee](https://talk.jekyllrb.com/u/benstokesee)\
**Replies:** 3\
**Last updated:** [January 16, 2026, 4:54pm UTC](https://talk.jekyllrb.com/t/includes-and-collections-not-updating-properly/10200 "2026-01-16T16:54:02Z")

</div>

Hey everyone, I’m running a small content-based website that focuses on Texas Roadhouse menu updates, coupons, and restaurant guides. The site is built with Jekyll and hosted on GitHub Pages. For the most part, everythin…

---

## [Using kramdown to put a box around a paragraph with display math](https://talk.jekyllrb.com/t/using-kramdown-to-put-a-box-around-a-paragraph-with-display-math/10236)

<div class="topic-metadata">

**Author:** [@anita](https://talk.jekyllrb.com/u/anita)\
**Replies:** 1\
**Last updated:** [December 9, 2025, 1:36am UTC](https://talk.jekyllrb.com/t/using-kramdown-to-put-a-box-around-a-paragraph-with-display-math/10236 "2025-12-09T01:36:03Z")

</div>

Hi! I’m completely new to Jekyll and kramdown, so apologies in advance if I’m missing something obvious. I’m trying to use the TeXt theme (random decision, it was mainly for the header image support?). I want to box som…

---

## [How much time it will take to generate 500000 pages](https://talk.jekyllrb.com/t/how-much-time-it-will-take-to-generate-500000-pages/4693)

<div class="topic-metadata">

**Author:** [@tejas456sawant](https://talk.jekyllrb.com/u/tejas456sawant)\
**Replies:** 9\
**Last updated:** [November 20, 2025, 10:40pm UTC](https://talk.jekyllrb.com/t/how-much-time-it-will-take-to-generate-500000-pages/4693 "2025-11-20T22:40:51Z")

</div>

i have simple site with default theme. how much time it will take to generate 500000 pages

---

## [Github Pages fails build non-deterministically](https://talk.jekyllrb.com/t/github-pages-fails-build-non-deterministically/10222)

<div class="topic-metadata">

**Author:** [@alexirpan](https://talk.jekyllrb.com/u/alexirpan)\
**Replies:** 4\
**Last updated:** [November 16, 2025, 3:30pm UTC](https://talk.jekyllrb.com/t/github-pages-fails-build-non-deterministically/10222 "2025-11-16T15:30:55Z")

</div>

I am deeply, deeply confused about everything going on. I have a Github pages blog at GitHub - alexirpan/alexirpan.github.io: Repo backing personal website which has worked fine for years, but suddenly my local setup ha…

---

## [Liquid Exception: stack level too deep - on old commits of the blog too, but works without excerpt\_separator in \_config.yml](https://talk.jekyllrb.com/t/liquid-exception-stack-level-too-deep-on-old-commits-of-the-blog-too-but-works-without-excerpt-separator-in-config-yml/10221)

<div class="topic-metadata">

**Author:** [@xealits](https://talk.jekyllrb.com/u/xealits)\
**Replies:** 1\
**Last updated:** [November 13, 2025, 8:14pm UTC](https://talk.jekyllrb.com/t/liquid-exception-stack-level-too-deep-on-old-commits-of-the-blog-too-but-works-without-excerpt-separator-in-config-yml/10221 "2025-11-13T20:14:45Z")

</div>

I pushed a new post to GithubPages, and it did not show up on the website. Trying to rerun it locally shows the “Liquid Exception: stack level too deep” exception. Trying to run jekyll on any of the old commits runs into…

---

## [How to build bootstrap css with jekyll?](https://talk.jekyllrb.com/t/how-to-build-bootstrap-css-with-jekyll/9228)

<div class="topic-metadata">

**Author:** [@VillyVretthorn](https://talk.jekyllrb.com/u/VillyVretthorn)\
**Replies:** 22\
**Last updated:** [November 6, 2025, 12:03pm UTC](https://talk.jekyllrb.com/t/how-to-build-bootstrap-css-with-jekyll/9228 "2025-11-06T12:03:50Z")

</div>

Hi, tl;dr: How to build a custom bootstrap with jekyll? I utilize bootstrap 5 for most of my websites. (https://getbootstrap.com/) Bootstrap is a CSS framework that makes it easier to make a pretty, responsive website…

---

## [Jekyll theme gem is empty](https://talk.jekyllrb.com/t/jekyll-theme-gem-is-empty/10207)

<div class="topic-metadata">

**Author:** [@rtm223](https://talk.jekyllrb.com/u/rtm223)\
**Replies:** 2\
**Last updated:** [November 4, 2025, 4:31am UTC](https://talk.jekyllrb.com/t/jekyll-theme-gem-is-empty/10207 "2025-11-04T04:31:36Z")

</div>

Update, found the approximate cause of the issue. Still unclear to me of exactly what the underlying issues is though. See reply I’m trying to create a gem theme and the gem that is created is always empty. My minimal t…

[Next page](https://talk.jekyllrb.com/c/help/6.md?page=1)
