Massive Wiki Wednesday, 2022-08-09


  • [ ] refactoring
    • [ ] 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
rm -rf .git
git init
cd .massivewikibuilder
more ../.gitmodules # get addresses for MWB and MWT
rmdir massivewikibuilder massive-wiki-themes
git submodule add
git submodule add
cd ..
git add .
git commit -m "start with Massive Wiki Starter"

Push this new repo to GitHub

gh repo create --public --source=. --remote=upstream
git branch -M main
git remote add origin
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 ../
    • cp -av * ../ # doesn't copy dotfiles/dotdirectories
    • cp -av .obsidian ../ # copy .obsidian
    • cd ../
    • git checkout netlify.toml # restore netlify.toml we just copied over
  • copy over mwb.yaml
    • cp ../ .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)