hans/racket-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

namespaces added and documentation

Browse Source
This commit is contained in:
Hans Dijkema
2026-08-15 15:01:50 +02:00
parent b9e081b13d
commit 8997f7f94a
20 changed files with 696 additions and 158 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scrbl/racket-wiki.scrbl
+13 -1
View File
@@ -71,6 +71,18 @@ reader receives a normal not-found view. Unauthenticated browser requests are
redirected to @tt{/login} before the wiki application is served.
@section{Page namespaces}
Pages have an explicit namespace in addition to their stable slug. Existing pages
are migrated to the root namespace. A compact page reference uses
@tt{namespace:slug}, for example @tt{racket:roadmap}. Explicit Markdown links
may therefore use @tt{[Roadmap](racket:roadmap)}. A classic WikiWord can also be
qualified, for example @tt{RWS:ModelTreeWalker}.
The namespace and slug are stored separately in PostgreSQL and their combination
is unique. Todo items and bookmarks are grouped by namespace in the browser.
@section{Page contents}
The application sidebar gives the current page's headings priority over the
@@ -105,7 +117,7 @@ language-specific stemmer.
@section{Database schema migrations}
Racket Wiki records PostgreSQL schema migrations in @tt{wiki_schema}. The current page is stored in @tt{pages}; every saved historical revision is stored in @tt{page_versions}. Attachments, including their binary content, are stored in @tt{attachments}. Schema migrations run in order when the application starts.
Racket Wiki records PostgreSQL schema migrations in @tt{wiki_schema}. The current page is stored in @tt{pages}; every saved historical revision is stored in @tt{page_versions}. Attachments, including their binary content, are stored in @tt{attachments}. Schema migrations run in order when the application starts. Schema 7 adds page namespaces and a unique namespace/slug index.
@section{Todo items}