YYiki
2020-05-30 → 2025-08-31
YYiki is a personal Wiki created and managed by yy. It is built on The Rule of Least Power and aims to create a wiki that can be maximally portable with other systems.
- Arguably, the minimal text format that supports internal links and formatting is markdown. So Markdown is used.
- The pages (written in plain text markdown) can be managed in many ways (e.g., flat files or DB) but the least powerful and minimal solution is flat files (with hierarchically organized folders). So Flat files are used.
- How to manage the change history of pages and backups? Not to reinvent the wheels, we can simply use existing version control systems. So Git + GitHub is used.
The benefit of having a minimal system with flat files is that other software can use the same “database”. The page repo can be seamlessly used with tools like Obsidian.
Originally, yyiki was built for a dynamic website that allows editing online. However, the complexity and security risk may not justify the marginal utility of the online editing. Now it is built as a static site generator. The whole system is simply a folder with markdown pages (an Obsidian vault) + a static site generator.