##### MapFull
from static-roam
• Here's a first cut at a static-roam tutorial. Not clear anyone else has tried to run this, but if you do, let me know.

# static-roam tutorial

19 Sep 2021 08:59 - 20 Sep 2021 08:43

• A guide to publishing your own site using static-roam.
• 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 cd to it before running any commands.
• ### Configure

• Copy resources/example-config.edn to resources/mysite-config.edn for your website.
• Copy bin/setup-example.sh to bin/setup.sh and 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 Downloads folder.
• ### Build locally

• bin/generate.sh
• ### Take a look

• bin/serve.sh
• ### Deploy to your server

• Will vary depending on your hosting arrangements. I use this
• scp -r output hyperphor:ammdi
• hyperphor is a host defined in my ~/.ssh/config .
• I plan to replace this with a git-based deploy in the future.