Browse Source
Implements [[term]], [[w:term]], and [[d:term]] wiki link syntax: - New wiki_links.ts utility for parsing and tag generation - Extract wiki links from content and generate w/d tags - CodeMirror syntax highlighting (violet/cyan/amber) - Preview displays extracted wiki tags separately from hashtags - Tutorial documentation for wiki link usage Per WIKI_TAG_SPEC.md: - [[term]] and [[w:term]] generate w-tags (references/mentions) - [[d:term]] generates d-tags (definitions) - Custom display text: [[term|display text]] 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>master
limina1
4 months ago
3 changed files with 310 additions and 20 deletions
@ -0,0 +1,145 @@
@@ -0,0 +1,145 @@
|
||||
/** |
||||
* Wiki link parsing and tag generation utilities |
||||
* Supports [[term]], [[w:term]], and [[d:term]] syntax |
||||
*/ |
||||
|
||||
export interface WikiLink { |
||||
fullMatch: string; |
||||
type: 'w' | 'd' | 'auto'; // auto means [[term]] without explicit prefix
|
||||
term: string; |
||||
displayText: string; |
||||
startIndex: number; |
||||
endIndex: number; |
||||
} |
||||
|
||||
/** |
||||
* Extracts all wiki links from AsciiDoc content. |
||||
* Supports three formats: |
||||
* - [[term]] - Auto (will query both w and d tags) |
||||
* - [[w:term]] - Explicit reference/mention (backward link) |
||||
* - [[d:term]] - Explicit definition (forward link) |
||||
*/ |
||||
export function extractWikiLinks(content: string): WikiLink[] { |
||||
const wikiLinks: WikiLink[] = []; |
||||
|
||||
// Match [[prefix:term]] or [[term]]
|
||||
// Captures: optional prefix (w: or d:), term, optional display text after |
|
||||
const regex = /\[\[(?:(w|d):)?([^\]|]+)(?:\|([^\]]+))?\]\]/g; |
||||
|
||||
let match; |
||||
while ((match = regex.exec(content)) !== null) { |
||||
const prefix = match[1]; // 'w', 'd', or undefined
|
||||
const term = match[2].trim(); |
||||
const customDisplay = match[3]?.trim(); |
||||
|
||||
wikiLinks.push({ |
||||
fullMatch: match[0], |
||||
type: prefix ? (prefix as 'w' | 'd') : 'auto', |
||||
term, |
||||
displayText: customDisplay || term, |
||||
startIndex: match.index, |
||||
endIndex: match.index + match[0].length, |
||||
}); |
||||
} |
||||
|
||||
return wikiLinks; |
||||
} |
||||
|
||||
/** |
||||
* Converts a term to a clean tag format (lowercase, hyphenated). |
||||
* Example: "Knowledge Graphs" -> "knowledge-graphs" |
||||
*/ |
||||
export function termToTag(term: string): string { |
||||
return term |
||||
.toLowerCase() |
||||
.trim() |
||||
.replace(/\s+/g, '-') |
||||
.replace(/[^a-z0-9-]/g, ''); |
||||
} |
||||
|
||||
/** |
||||
* Generates Nostr event tags from wiki links. |
||||
* Format: ['w', 'tag-slug', 'Display Text'] or ['d', 'tag-slug'] |
||||
*/ |
||||
export function wikiLinksToTags(wikiLinks: WikiLink[]): string[][] { |
||||
const tags: string[][] = []; |
||||
|
||||
for (const link of wikiLinks) { |
||||
const tagSlug = termToTag(link.term); |
||||
|
||||
if (link.type === 'w' || link.type === 'auto') { |
||||
// Reference tag includes display text
|
||||
tags.push(['w', tagSlug, link.displayText]); |
||||
} |
||||
|
||||
if (link.type === 'd') { |
||||
// Definition tag (no display text, it IS the thing)
|
||||
tags.push(['d', tagSlug]); |
||||
} |
||||
} |
||||
|
||||
return tags; |
||||
} |
||||
|
||||
/** |
||||
* Replaces wiki link syntax with HTML for preview rendering. |
||||
* Can be customized for different rendering styles. |
||||
*/ |
||||
export function renderWikiLinksToHtml( |
||||
content: string, |
||||
options: { |
||||
linkClass?: string; |
||||
wLinkClass?: string; |
||||
dLinkClass?: string; |
||||
onClickHandler?: (type: 'w' | 'd' | 'auto', term: string) => string; |
||||
} = {}, |
||||
): string { |
||||
const { |
||||
linkClass = 'wiki-link', |
||||
wLinkClass = 'wiki-link-reference', |
||||
dLinkClass = 'wiki-link-definition', |
||||
onClickHandler, |
||||
} = options; |
||||
|
||||
return content.replace( |
||||
/\[\[(?:(w|d):)?([^\]|]+)(?:\|([^\]]+))?\]\]/g, |
||||
(match, prefix, term, customDisplay) => { |
||||
const displayText = customDisplay?.trim() || term.trim(); |
||||
const type = prefix ? prefix : 'auto'; |
||||
const tagSlug = termToTag(term); |
||||
|
||||
// Determine CSS classes
|
||||
let classes = linkClass; |
||||
if (type === 'w') classes += ` ${wLinkClass}`; |
||||
else if (type === 'd') classes += ` ${dLinkClass}`; |
||||
|
||||
// Generate href or onclick
|
||||
const action = onClickHandler |
||||
? `onclick="${onClickHandler(type, tagSlug)}"` |
||||
: `href="#wiki/${type}/${encodeURIComponent(tagSlug)}"`; |
||||
|
||||
// Add title attribute showing the type
|
||||
const title = |
||||
type === 'w' |
||||
? 'Wiki reference (mentions this concept)' |
||||
: type === 'd' |
||||
? 'Wiki definition (defines this concept)' |
||||
: 'Wiki link (searches both references and definitions)'; |
||||
|
||||
return `<a class="${classes}" ${action} title="${title}" data-wiki-type="${type}" data-wiki-term="${tagSlug}">${displayText}</a>`; |
||||
}, |
||||
); |
||||
} |
||||
|
||||
/** |
||||
* Converts wiki links to plain text (for content storage). |
||||
* Preserves the display text if custom, otherwise uses the term. |
||||
*/ |
||||
export function wikiLinksToPlainText(content: string): string { |
||||
return content.replace( |
||||
/\[\[(?:w|d:)?([^\]|]+)(?:\|([^\]]+))?\]\]/g, |
||||
(match, term, customDisplay) => { |
||||
return customDisplay?.trim() || term.trim(); |
||||
}, |
||||
); |
||||
} |
||||
Loading…
Reference in new issue