goddinpotty tutorial
16 Jan 2022 - 14 May 2022
- A guide to publishing your own site using Goddinpotty.
- State: in-progress.
Prerequisites
- You have to be able to run shell commands and know how to clone git repos.
- You need some kind of hosting service and know how to copy files to it. I use and recommend NearlyFreeSpeech.NET Web Hosting, but any will do.
- Not sure if the more consumer-focused services support static sites:
Setup
- Install Leiningen, which makes it possible to run Clojure programs
- Clone the repo and
cdto it before running any commands. Configure
- Copy
resources/example-config.edntoresources/mysite-config.ednfor your website. - Copy
bin/setup-example.shtobin/setup.shand fill it in with the appropriate values. Fetching the graph
- You can either do this manually or via a script.
- Manually
- In Roam, do a full graph export in JSON format. Make sure the result ends up in your
Downloadsfolder. Build locally
bin/generate.shTake a look
bin/serve.shDeploy to your server
- Will vary depending on your hosting arrangements. I use this
scp -r output hyperphor:ammdihyperphoris a host defined in my~/.ssh/config.- I plan to replace this with a git-based deploy in the future.