Book Image

Eleventy by Example

By : Bryan Robinson
Book Image

Eleventy by Example

By: Bryan Robinson

Overview of this book

11ty is the dark horse of the Jamstack world, offering unparalleled flexibility and performance that gives it an edge against other static site generators such as Jekyll and Hugo. With it, developers can leverage the complete Node ecosystem and create blazing-fast, static-first websites that can be deployed from a content delivery network or a simple server. This book will teach you how to set up, customize, and make the most of 11ty in no time. Eleventy by Example helps you uncover everything you need to create your first 11ty website before diving into making more complex sites and extending 11ty’s base functionality with custom short codes, plugins, and content types. Over the course of 5 interactive projects, you’ll learn how to build basic websites, blogs, media sites, and static sites that will respond to user input without the need for a server. With these, you’ll learn basic 11ty skills such as templates, collections, and data use, along with advanced skills such as plugin creation, image manipulation, working with a headless CMS, and the use of the powerful 11ty Serverless plugin. By the end of this book, you’ll be well-equipped to leverage the capabilities of 11ty by implementing best practices and reusable techniques that can be applied across multiple projects, reducing the website launch time.
Table of Contents (13 chapters)

Creating Custom Shortcodes to Add Mixed Media to Markdown

Now that we have a basic blog, let’s make that blog stand out with various forms of media. The flavor of Markdown that 11ty uses allows for the use of HTML, so we could embed things like YouTube videos or CodePen pens with their basic HTML embeds, but that can be a lot of repetitive markup that needs to be added and modified on each blog post. Custom shortcodes allow us to set a standard template for each of these types of media and use a simplified tag in the Markdown files of our blog posts (and in any of our templates, as well).

In this chapter, we’ll cover the following basics of 11ty’s shortcodes and set up three different shortcodes to make our blog posts more fully featured:

  • What is a shortcode?
  • Creating a YouTube embed
  • Creating a custom blockquote with semantic HTML
  • Creating a CodePen embed with a customizable display

By the end of this chapter, we’ll have a fully...