Docs

aka: how do i run this site? I will probably forget if I don’t touch it for a month, so recording here:


Site Maintenance

Editing and updating

Run eleventy: npx @11ty/eleventy --serve

Update by pushing changes to master branch on github. Netlify then builds the site and deploys it.


Eleventy Resources

Plugins:

  • markdown-it-anchor
  • markdown-it-class

starting a new 11ty project

—on a computer that already has 11ty installed. abridged from the official getting started docs

cd project-directory
npm init -y
npm install --save-dev @11ty/eleventy
npx @11ty/eleventy --serve

create .eleventy.js file in root directory

add css/imgs to load in _site

module.exports = function(eleventyConfig) {

eleventyConfig.addPassthroughCopy('css');
eleventyConfig.addPassthroughCopy('img');

return {
passthroughFileCopy: true
}
}

restart 11ty to see these changes npx @11ty/eleventy --serve


Git Cheatsheet

I use GitHub Desktop, but on occasion when I need to do something specific and have to use the terminal:

Copying a file from one branch to another

git checkout master -- posts/2022/details.md

This takes the posts/2022/details.md file from master and copies it over to the current branch.