Edit This Page Clicking 'Edit This Page' will open a new tab or window to edit this page on the Git forge. You'll need to be signed into the forge to edit. Close the edit page to return to this one.

Massive Wiki Wednesday, 2022-08-09


  • [ ] refactoring mwb.py
    • [ ] the code blocks that render html from markdown share identical code
    • [ ] replace os.walk code with list comprehensions using glob? (may be easier to read and maintain?)
  • [ ] review Massive Wiki Roadmap
  • [ ] releasing v2.0.x
  • [ ] review "Recent Pages" work
  • [ ] developing a project plan for upgrading various deployed wikis to v2.x
  • [x] celebrate MWB by reviewing a couple of Obsidian -> Hugo options


  • "sharing" (read/write) vs. "publishing" (mostly read-only)
  • Massive Wiki Starter is now biased towards people who want to publish
    • maybe rename/brand to emphasize Publishing
  • easy update process, see below "Refreshing a wiki to have MWB 2.x"

Refreshing a wiki to have MWB 2.x

Get a clean version for a new repo

This process re-instantiates the submodules, which is good for keeping MWB and MWT files out of the repo (there's a reference pointer to the repos, but the files themselves don't get added to the repo), and also good for local testing.

git clone git@github.com:Massive-Wiki/massive-wiki-starter.git developer.massive.wiki
cd developer.massive.wiki
rm -rf .git
git init
cd .massivewikibuilder
more ../.gitmodules # get addresses for MWB and MWT
rmdir massivewikibuilder massive-wiki-themes
git submodule add https://github.com/peterkaminski/massivewikibuilder.git
git submodule add https://github.com/peterkaminski/massive-wiki-themes.git
cd ..
git add .
git commit -m "start with Massive Wiki Starter"

Push this new repo to GitHub

gh repo create developer.massive.wiki --public --source=. --remote=upstream
git branch -M main
git remote add origin https://github.com/GH-UserID/developer.massive.wiki.git
git push -u origin main

Copy content over from previous version

  • copy over all the MD files and .obsidian (but don't overwrite netlify.toml)
    • cd ../old-developer.massive.wiki
    • cp -av * ../developer.massive.wiki # doesn't copy dotfiles/dotdirectories
    • cp -av .obsidian ../developer.massive.wiki # copy .obsidian
    • cd ../developer.massive.wiki
    • git checkout netlify.toml # restore netlify.toml we just copied over
  • copy over mwb.yaml
    • cp ../old-developer.massive.wiki/.massivewikibuilder/mwb.yaml .massivewikibuilder/
  • git add, commit, and push

Local Testing

(add setting up venv, pip install, npm ci, etc.)

Next Steps

  • Pete should announce MW and MWB on the Obsidian Forums (and wherever people talk about e.g., Obsidian+Hugo)