Massive Wiki Wednesday, 2022-08-09

Topics

[ ] 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

Notes

"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)

Site Navigation

Plans

For Testing