Publish the OpenWiki specification: a wiki that is a folder of Markdown files - #189
Merged
Merged
Conversation
…wn files OpenWiki writes down what the [[Page]] convention already is in practice, so a wiki can be moved, mirrored, read by a directory and edited by an agent without reading any engine's source. One Markdown file per page with a small optional front matter (title, aliases, tags, summary, author, made_by, disclosure, created, updated, license, lang, redirect); wikilinks resolved by exact name, loose name, alias, path, then wanted; one address with three representations (rendered, .md, .md?rev=) and a history.json per page; a descriptor at /.well-known/openwiki.json with pages_url, changes (Atom), repo, edit, editors and accepts; editing as PUT of the same file with If-Match on the revision; discovery; what a directory owes a wiki. Every revision says who made it: human, ai or both, the same word OpenWebring uses. A folder that follows it opens unchanged in Obsidian and Logseq, and any such folder becomes an OpenWiki by adding the two files. The first host, goviral.wiki, is being built on it. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XYae2mH3khdwiXUVzcVMDw
ThreatCrush Security Scan22 finding(s) HIGH/CRITICAL: 3 | MEDIUM: 10 | LOW: 9
Snippets are redacted; ThreatCrush never prints matched credential material. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Anthony: "we need an openwiki on logicsrc that stores native wiki data as markdown. we have goviral.wiki we can use it on: Markdown with wikilinks, the [[Page]] convention Obsidian, Logseq and most modern note tools share, with no formal spec and no agreed front matter."
OpenWiki 0.1 at
/openwikiand/docs/openwiki, in the catalog beside OpenWebring.title,aliases,tags,summary,author,made_by,disclosure,created,updated,license,lang,redirect); absent is unstated.[[Page]],[[Page|label]],[[Page#Section]],![[Page]]; resolution order exact, loose (case and space/hyphen/underscore), alias, path, wanted./going-viralrendered,/going-viral.mdas stored (ETag = revision id),?rev=<id>,/going-viral.history.jsonwith author,made_by, summary and parent per revision./.well-known/openwiki.json(pages_url,changesAtom,repo,edit,editorsopen|accounts|closed,accepts), andpages.jsonwith the link graph andwantedpages.PUT <page>.mdwithIf-Match; 412 means read and retry;X-OpenWiki-Made-By; OpenAccess scopeopenwiki:edit.Compatibility is the point: an Obsidian or Logseq folder is already the page format; the two JSON files make it a host. goviral.wiki is named as the first host, being built.
🤖 Generated with Claude Code
https://claude.ai/code/session_01XYae2mH3khdwiXUVzcVMDw