Starter wiki learnings (Bill)
2022-07-29
Reflections on using the massive-wiki-starter as the template for a personal Massive Wiki.
- Massive Wiki pre-requisites:
- make decisions on (1) authoring, (2) sharing, (3) versioning, and (4) having a public web site of wiki content.
- (1) authoring: Obsidian (or other app) to create Markdown files
- (2) sharing: Github (or other Git repository hosting) is one choice
- (3) versioning (is provided by Git repositories)
- (4) public web site requires web hosting (netlify.app is one option)
- Decisions made; let's get started:
-
choose a folder on your computer to contain your wiki content (Bill uses ~/Documents/myWikis/ as the base and create a different folder for each wiki)
-
we are using Github, so this is one way to proceed:
-
(1) general outline: use massive-wiki-starter repository code to populate the new wiki-repository (download .zip file? fork the repo?); initialize this content into its own Github repository; configure and add the MWB and MWT submodules (this is getting complicated); make sure everything is up-to-date; push the current state as a baseline version of this new wiki(?)
-
(2022-07-31 update: https://cli.github.com/manual has some useful examples of how to proceed with a starter-wiki repository:
e.g.,$ gh repo create mynewrepo --public --source=. --remote=upstreamalso see Github - getting started notes -
(2) edit the README.md file with information you want on your wiki home-page
- since we said "yes, we want a public website" now is the time to edit the MassiveWikiBuilder configuration file
.massivewikibuilder/mwb.yaml, cf. MWB configuration - using a Sidebar? now is the time to add content to Sidebar
- since we are implementing a Sidebar now is the time to edit
wiki_dir/netlify.tomland insure that the mwb command is using the basso theme
- since we said "yes, we want a public website" now is the time to edit the MassiveWikiBuilder configuration file
-