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 --quiet --incremental

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

---

Site structure

• Media Diary: watchlist, books, music are JSON files, making use of Eleventy data files. I wrote more about it here: Media Diary with Eleventy. Games are all their own separate posts.
• Photos: also a JSON file (more in: The photo gallery, returned)
• Projects, sketchbook, journal, digital garden: all normal posts

---

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.