Phonemos User Guide

Glossary

Announcement Channel — A chronological feed for pushing news, updates, and notifications within a topic. Functions like an internal blog.

Auto-Save — Phonemos continuously saves changes as you type. There is no manual Save button. Changes are preserved as drafts even if the browser crashes.

Collaborative Editing — Multiple users can edit the same page simultaneously. Each user's cursor is visible in real time, and changes are merged automatically without conflicts.

Custom Role — A user-defined role with a specific set of permissions, beyond the predefined roles (Viewer, Editor, Manager, etc.).

Decorator — A visual enhancement applied to a page, such as a header image, page icon, or width control.

DeepL Integration — Built-in automatic translation powered by DeepL, used to generate initial translations of page content into other languages.

Draft — The working version of a page being edited. Drafts are visible to editors but not to general readers until published.

External Data Connector — A generic integration framework allowing Phonemos to connect to custom or third-party systems via a Swagger/OpenAPI specification.

File List — A container for uploaded files within a topic's page tree. File lists are first-class content elements alongside wiki pages.

File Stack — A grouping mechanism within a file list for organizing related files.

FIDO2 / Passkey — A passwordless authentication standard using hardware security keys or biometrics. Phishing-resistant.

Group — A named collection of users. Groups simplify permission management by allowing roles to be assigned to groups rather than individuals.

Instance — The top-level entity in the Phonemos hierarchy. A complete deployment containing all sites, users, and configuration.

Kanban Board — A visual task management board with columns (e.g., To Do, In Progress, Done) for tracking work items within topics.

Keycloak — An open-source identity and access management system. Phonemos can be deployed with a dedicated Keycloak instance for advanced SSO.

Label — A freeform tag attached to a page for cross-cutting categorization across the page tree.

Language Version — A translation of a page into a different language. Multiple language versions share the same position in the page tree.

MCP (Model Context Protocol) — An open standard allowing AI assistants to access external data sources. Phonemos provides an MCP server that exposes wiki content to AI tools.

Metadata Field — A structured, typed property attached to a page (text, date, dropdown, user reference, etc.) that can be embedded in content and queried to generate filterable tables.

Metadata Domain — A set of metadata fields defined within a zone, inherited by all pages in that zone.

Metadata Table — A dynamically generated, filterable view that aggregates pages based on their metadata values.

OIDC (OpenID Connect) — An identity authentication protocol used by modern identity providers. One of two SSO protocols supported by Phonemos (alongside SAML).

One-Time Token — An authentication method where a time-limited login link is sent to the user's email. Also called a "magic link."

Page — The primary content unit in Phonemos. A rich-text document supporting collaborative editing, versioning, metadata, multilingual content, and comments.

Page Tree — The hierarchical arrangement of pages within a topic. Pages can be nested and reordered via drag and drop.

Pandoc — An open-source universal document converter used by Phonemos as its export engine, enabling export to Word, PDF, Markdown, LaTeX, and more.

Personal Note Area — A private space for each user to draft content or keep personal notes, visible only to the user.

Public Site — A Phonemos site configured to be accessible without authentication, used for customer-facing documentation and public portals.

Publishing Workflow — The lifecycle process for controlled content: Draft > (Review) > Published. Configurable to include approval steps.

Q&A Forum — A discussion format where users can post questions, provide answers, and mark accepted answers.

Role — A named set of permissions defining what actions a user can perform. Phonemos provides predefined roles (Viewer, Commenter, Editor, Manager, Administrator) and supports custom roles.

SAML (Security Assertion Markup Language) — An XML-based authentication protocol used by enterprise identity providers. One of two SSO protocols supported by Phonemos (alongside OIDC).

Semantic Search — AI-powered search that understands meaning rather than matching exact keywords.

Site — A separately addressable website within a Phonemos instance, with its own URL, navigation, theme, and permissions.

SSO (Single Sign-On) — Authentication where users log in with existing organizational credentials via an identity provider.

Synthetic Metadata — Automatically generated metadata fields such as "last updated," "last editor," and "revision number."

Template — A reusable blueprint for creating pages or entire page-tree structures, pre-filling headings, metadata, and placeholder text.

Topic — A named container for related content within a site, appearing in the site's main navigation.

Tree-Structure Template — A template that creates an entire sub-tree of pages in one action.

Typst — A modern document typesetting system used by Phonemos as one of the PDF export backends alongside LaTeX.

Version History — The complete record of all published versions of a page, including who published each version, when, and what changed.

Zone — A protected folder within a topic with independent permissions and metadata schema.