ApmDocs

Good News: Your blog is ready!

Just a few steps to Finish Up:

Enable GitHub Pages
- Visit github.com/geokal/ApmDocs/settings/pages
- Select Source Branch: gh-pages
- Select / (root) (default)
- Save
Create your First Post
- Visit bliss.js.org to make your first post.
  - bliss.js.org/#/?o=geokal&r=ApmDocs&b=main&ght
Enable Comments (optional)
- Visit github.com/apps/utterances
- Click Install
- Select geokal and ApmDocs
- You're all set! Comments will become issues on this repo!
- To disable comments, comment out utterences_* in config.yaml

You can view your blog at geokal.github.io/ApmDocs.

You can make new blog posts as easy as Gists. Just write your ~~tweet~~ post, and Bliss will fill out the Front Matter for you.

🔎 Type bli in your browser's omnibar and hit enter (assuming you followed the steps above).
- (or visit bliss.js.org directly)
📝 Write your post
💾 Click Add to Github, and then Commit new file

Your new post will build automatically.

Manage your existing posts directly on GitHub.
Don't worry, .GitInfo.lastmod will pull the new "updated at" date from git!

/content/blog/

Just click edit, then edit and commit!

It's always nice to know that when the 💩 hits the fan, you can still get 💩 done all on your own.

Install hugo and node via Webi:

curl -sS https://webinstall.dev/hugo@v0.86 | bash
curl -sS https://webinstall.dev/node@v16 | bash
# or
# bash ./scripts/install-deps.sh

Clone and setup repo

git clone git@github.com:geokal/ApmDocs
pushd ./ApmDocs
git submodule init
git submodule update
hugo
# or
# bash ./scripts/build.sh

Deploy to GitHub pages

git checkout gh-pages
rsync -avhP public/ ./
rm -rf public/
git add ./
git commit -m "deploy: latest build"
git push
# or
# bash ./scripts/deploy.sh

Don't see gh-pages?

Generally the Use this template process takes about 30s. You check to see if it's complete at github.com/geokal/ApmDocs/actions.

Once the Action finishes it may take up to 5 minutes for the first Pages deploy to complete.

Something else wrong?