Reviewed-on: anya/wikipages#2
pageswiki
Simplest and powerful wiki architecture for personal
Knowledge City Model
Pages Wiki uses urban language for its content hierarchy:
Campus → Domain → Zone (Quartier / Street) → Spot → Page
- Campus manages a group of Domains.
- Domain is a site space selected by a host or subdomain.
- Zone is the managed tree containing Quartiers and Streets.
- Quartier is a planned aggregation of Streets.
- Street groups Spots as the smallest city block.
- Spot is the smallest knowledge group.
- Page is the smallest knowledge unit and is identified by UUID, not path.
A Page may be linked from multiple Spots. Semantic paths are projections and must not be treated as Page identity.
Data CLI
The CLI in data/pageswiki-cli provides rsync-like transfers and an
interactive Semantic Path shell over SQLite and data/documents/:
data/pageswiki-cli put article.html path:/quartier/street/spot/page
data/pageswiki-cli get path:/quartier/street/spot/page article.html
data/pageswiki-cli shell
PAGESWIKI_DOMAIN=engineering data/pageswiki-cli ls /
The shell supports ls, cd, cat, view, edit, transfer, Revision,
diff/restore, and link commands, with tab completion and persistent history.
view uses PAGER; edit uses EDITOR.
Set PAGESWIKI_DATA_DIR when inspecting a different data directory.
PAGESWIKI_DOMAIN selects the active Domain by name, UUID, or host. In the
interactive shell, domain [NAME|UUID|HOST] displays or changes it.
An instance can enroll into a Controller Campus during container startup:
The included Docker Compose configuration enrolls app2 into a Controller
Campus. Copy .env.example to .env and set
PAGESWIKI_EXTERNAL_CAMPUS_TOKEN to the controller-issued enrollment token
before running Compose. The token is intentionally not committed; .env is
excluded from Git and Docker build contexts. Keep it private (for example,
chmod 600 .env).
PAGESWIKI_INSTANCE_FQDN=node.example.test \
pageswiki --add-external-campus campus.example.test "$CAMPUS_TOKEN"
For an explicitly trusted development network without TLS:
PAGESWIKI_INSTANCE_FQDN=node.internal.test \
pageswiki --add-external-campus-http campus.internal.test "$CAMPUS_TOKEN"
For a node dedicated to externally managed Domains, add
--no-default-campus. Its bootstrap Campus and Domain remain while approval
is pending, then are removed after the first assigned Domain is pulled:
PAGESWIKI_INSTANCE_FQDN=node.internal.test \
pageswiki --no-default-campus \
--add-external-campus-http campus.internal.test "$CAMPUS_TOKEN"
The controller records the instance public-key fingerprint. Domain placement only offers instances whose fingerprint has been approved.