add more instructions

Author: nlharris

README.md

@@ -1,14 +1,30 @@
-# test conversion of the obf website
+# conversion of the obf website to GitHub pages
 
-Exploring the migration of the OBF WP site to a static site generator
+Migration of the OBF WP site to a static site generator (Hugo)
 
-
-## Running locally
+## Running hugo server locally
 
 1. [Install hugo](https://gohugo.io/installation/)
-2. Run `hugo server` from the root folder of the project to get a local server that automatically rebuilds
+2. Clone the GH repo:
+git clone  https://github.com/OBF/OBF.github.io
+3. Initialize hugo
+cd OBF.github.io
+git submodule init
+git submodule update
+4. Run `hugo server` from the root folder of the project to get a local server that automatically rebuilds
+hugo server &
+5. View the site in your web browser by going to [http://localhost:1313/](http://localhost:1313/)
+6. When you edit stuff, you should be able to reload http://localhost:1313/ to instantly see the changes!
+7. To push your changes back to the live site, remember to commit them:
+git checkout -b BRANCH_NAME
+git add FILES
+git commit -m "my changes"
+git push
+(Then go to https://github.com/OBF/OBF.github.io to make a PR)
+8. Once the PR is merged, your changes should be visible on https://obf.github.io/
+
 
-## Steps taken
+## Steps taken to port content from old WP site
 
 1. Create XML export of existing WP site with all pages & posts
 2. Run the conversion script [wp2hugo](https://github.com/ashishb/wp2hugo) in the following way `/wp2hugo -source obf.WordPress.2025-01-30.xml -output obf-test-hugo -download-media -continue-on-media-download-error`