11ty + Mattrbld Template

Template repository for my 11ty + Mattrbld projects.

Syncing

Always remember to check for changes before starting work, and sync your changes when your work is done.

Images

Please import images in the "Media Library" tab - uploading them directly via post creation seems to create issues with the image pathing.

---

full drone/submodule setup from scratch

1. create repo

in heckin gitea, create destination repo.

2. update dronefile in source repo

Update the <placeholder values> in .drone.yml.

3. create and add PAT (one-time, not per repo)

in heckin, go to settings > applications, and create a PAT with read & write permissions to repositories.

in drone, you can set your PAT either as a project secret or an organization secret. In either case call it GIT_TOKEN.

4. activate project in drone

in drone, find your project and activate it.

in the settings, I chose to disable pull requests and forks. I set my runner timeout to 15m.

5. first commit to submodule

assuming we are committing the _site folder...

cp -r _site ../temp
cd ../temp

git init
git add -A
git commit -m "first"

git remote add origin <remote-url>
git push -u origin main

then you can delete the temp directory.

6. add submodule to local repo

in root dir of local repo, add the submodule.

git submodule add <remote-url>

if you used the SSH url, set it to the HTTPS url.

git submodule set-url <dest-repo> <remote-url-https>
git add .gitmodules # the changes from submodule add are auto-staged, this config change isn't

commit your changes and push.

git commit -m "add submodule"

(commit your dronefile changes too.)

7. profit

if it doesn't work, cry