Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

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.

2026-11-09 05:49:44 +09:00
Languages
Go 79.9%
JavaScript 8.3%
Go Template 6.2%
Python 3.6%
CSS 1.9%