hypnagaga_old/readme.md
2022-10-31 12:12:55 +01:00

3.7 KiB

Eleventy starter

Very opiniated Eleventy starter based on the workflow suggested by Andy Bell's https://buildexcellentwebsit.es/.

Preview

https://eleventy-excellent.netlify.app/

Features

This starter includes:

  • Accessible site navigation, editable in _data/navigation.js
  • Image optimization with Eleventy-img (see blog post)
  • Youtube embed with lite-youtube (see blog post)
  • Syntax highliting via eleventy-plugin-syntaxhighlight
  • SEO (XML-sitemap, metadata)
  • dayjs handling dates & times
  • filters and shortcodes for ..
  • The whole CSS workflow as suggested by buildexcellentwebsit.es
  • 301 redirects for netlify
  • All kind of markdown handling
  • Bundling via esbuild

First steps

  • Search and replace 'eleventy-excellent.netlify.app' with your own domain.
  • Set your icons in assets/images/favicon
  • edit meta data in _data/meta.js
  • edit your social media in _data/social.js and _includes/icons. Icons must be prefixed with "social-".
  • delete _data/github.js and pages/github.njk, as they are just an example
  • changed routes:
redirectFrom: ['/old-route/', '/optionally-another-old-route/']

Development

Install dependencies

npm install

Working locally

Starts watch tasks to compile when changes detected

npm start

Creating a production build

Minify JS, inline and minify CSS.

npm run build

Logbook

22-10-30

WebC in own branch, simplify main branch

22-10-03

  • first commit. Updated

22-10-04

  • All markdown syntax set. Some tests with web components and webC.
  • TODO: dark mode

Credits and Thank yous

Andy Bell

His CSS methodology makes sense to me. It also goes hand in hand with the Every Layout solutions he co-authors. An ardent opponent of the utility class framework Tailwind CSS. But has recently published an approach that incorporates Tailwind CSS into his methodology. This is built into my website and I'm working on tweaking it. I learned how to use Eleventy in 2020 with his (now free) course.

Heydon Pickering

I strongly orientate myself on Heydon's approaches and love his books.

Zach Leatherman

He is developing Eleventy.

Stephanie Eckles

She provides a lot of resources for Eleventy and modern CSS.

Aleksandr Hovhannisyan

I love order and structure. Aleksandr does this in an exemplary way, which is why I based the structure of eleventy.js on his personal site. The 301 redirect solution I'm using is from his blog.

Oliver Schöndorfer

Oliver is a type expert. He writes the Pimp my Type Newsletter where I dscovered the font I'm using for this website.

Manuel Matuzović

Manuel is an accessibility expert. The menu I'm using is from one of his articles on web.dev.