make init instructions better

README.md

@@ -2,21 +2,35 @@
 
 meow
 
+## ???
+
+this is a (very early stage) static site generator written in racket
+
+## why not frog?
+
+NIH syndrome :3
+
 ## install
 
 ```bash
-cd ext-mathml
-npm install
-cd -
+# external dependencies (unfortunately i could not reasonably replace these with racket)
+(cd ext-mathml && npm install)
 pip3 install --user pygments
+# install the package
 raco pkg install $PWD
+# ensure your PATH has racket stuff on it. replace 8.1 with your version
+# alternatively, you can use the capybara commands through raco
+export PATH=$HOME/.racket/8.1/bin:$PATH
 ```
 
 ## getting started
 
 ```bash
+# create a new project
 capybara-init my-awesome-website
 cd my-awesome-website
-nginx -c $PWD/nginx.conf
+# start serving it (nginx is required right now)
+nginx -c $PWD/nginx.conf &
+# view your masterpiece
 firefox http://localhost:8080
 ```

ext-mathml/package-lock.json

@@ -1,5 +1,5 @@
 {
-  "name": "wiki",
+  "name": "ext-mathml",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {

init.rkt

@@ -23,13 +23,16 @@
                (list 'tags "tag1" "tag2")
                (list 'lang "en")
                (list 'authors "you")))
-       (write-string "\n# trans rights\n\nmeow")))
+       (write-string "\n# welcome to capybara\n\nthis is a blank site. you should put stuff here")))
   (with-output-to-file
     (build-path src "index.scss")
     (λ () (write-string "/* your cool SCSS goes here */")))
   (with-output-to-file
     (build-path src "favicon.png.rkt")
-    (λ () (write-string "#lang capybara/pict\n\n(standard-cat 128 128)")))
+    (λ ()
+       (write-string "#lang capybara/pict\n\n")
+       (write-string "; this is an example pict which will become the site favicon\n")
+       (write-string "(standard-cat 128 128)")))
   (with-output-to-file
     (build-path src "config.rktd")
     (λ () (pretty-write (list (list 'base "http://localhost:8080")))))