// Tutorial //

Loading Scripts or Stylesheets Conditionally With Jekyll

Published on November 30, 2016
Default avatar
By Alligator.io
Developer and author at DigitalOcean.
Loading Scripts or Stylesheets Conditionally With Jekyll

While we believe that this content benefits our community, we have not yet thoroughly reviewed it. If you have any suggestions for improvements, please let us know by clicking the “report an issue“ button at the bottom of the tutorial.

In an effort to reduce page weight to a minimum, there are a few tricks where Jekyll’s front matter can become really handy.

Only specific pages of 🐊 call for certain scripts or need certain styles applied. Front matter allows to create custom variables, so it becomes very easy to include the scripts or stylesheets only where needed.

Here’s for example the front matter for a guest post, interesting part highlighted:

---
layout: page-fullwidth
title:  "Sass @each Loops"
categories:
    - sass
image:
    thumb: sass/sass-each-loops.png
meta_description: "Loop through maps and lists in Sass. Here's a quick snippet that shows you how."
guest: true
---

And here’s how it’s conditionally included in the footer include file:

_includes/footer_scripts.html

  <link rel="stylesheet" property="stylesheet" href="/assets/css/authors.css">

Note that including stylesheets within the body tag is usually not allowed for valid html. A trick is to use property=“stylesheet” instead of type=“text/css” to make validators happy.

Note also that this creates a new http request, and some may argue that it’s probably better to have one large stylesheet file instead. Separating CSS into multiple modular files seems to be the way of the future though, so let’s optimize for that!


And here’s an example for a post that calls a Can I Use script for embedding Can I Use data:

---
layout: page-fullwidth
title:  "The CSS calc() function"
categories:
    - css
image:
    title:  css/calc-2.svg
meta_description: "A nice little CSS function to let you calculate things."
caniuse: true
---

And finally, the liquid markup that conditionally includes it in the footer include file:

_includes/footer_scripts.html

  <script async src="//cdn.jsdelivr.net/caniuse-embed/1.0.1/caniuse-embed.min.js"></script>


Want to learn more? Join the DigitalOcean Community!

Join our DigitalOcean community of over a million developers for free! Get help and share knowledge in our Questions & Answers section, find tutorials and tools that will help you grow as a developer and scale your project or business, and subscribe to topics of interest.

Sign up
About the authors
Default avatar
Developer and author at DigitalOcean.

Still looking for an answer?

Was this helpful?
Leave a comment