aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorikoamu <ikoamu@gmail.com>2024-01-24 23:37:22 +0900
committerikoamu <ikoamu@gmail.com>2024-01-24 23:37:22 +0900
commitddf17aecca8dcb16158de103200941cd75b67992 (patch)
treed9b2b04f4eacd4aa059bb0c2ea837ad3b99c76d1 /README.md
parenta5dca84a924acbba555e59cd6f74dc7d90bae44a (diff)
Add instructions for generating static org-roam-ui page
Diffstat (limited to 'README.md')
-rw-r--r--README.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/README.md b/README.md
index 9d35dab..242606a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,37 @@
# org-roam-ui-hosting
This action generates a static site for [org-roam-ui](https://github.com/org-roam/org-roam-ui) from [org-roam](https://www.orgroam.com/) files managed on GitHub.
+
It also allows deployment to GitHub Pages.
+
+## How to Use
+
+First, please manage the .org files in `org-roam-directory` and the db file in org-roam using git.
+
+```lisp
+(setq org-roam-directory "/path/to/org-roam-dir")
+(setq org-roam-db-location "/path/to/org-roam-dir/<org-roam-filename>.db")
+```
+
+```bash
+cd /path/to/org-roam-dir/
+git init
+```
+
+Then, a static org-roam-ui site is easily generated for the artifact by creating a workflow like the following.
+
+```yml
+name: Generate static org-roam-ui page
+on:
+ push:
+ branches:
+ - main
+jobs:
+ generate:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Generate org-roam-ui page
+ uses: ikoamu/org-roam-ui-hosting@main
+ with:
+ org-roam-db-filename: <org-roam-filename>.db
+```