Phonemos User Guide

Public Site

The Public Site feature allows you to publish Phonemos content to a public-facing website without requiring authentication. This enables organizations to share documentation, announcements, and files with external audiences while maintaining full control over what content is published.

How It Works

Public Sites use Server-Side Rendering (SSR) to generate pages, with selective client-side hydration for interactive components like search and language switching. The system fetches content from Hasura using a Keycloak service account, ensuring secure data access while providing fast page loads.

Key Features

  • Multiple Content Types — Publish wikipages, announcement channels (with automatic RSS/Atom/JSON feeds), and downloadable files

  • Multi-language Support — Built-in language switcher for topics with multiple enabled languages

  • Full-Text Search — Interactive search across all published content with keyboard navigation

  • Custom Theming — Customize the appearance using CSS stylesheets and HTML templates with Handlebars

  • Responsive Design — Mobile-friendly layout with collapsible navigation and table of contents

Customization Documentation

For detailed customization options, see the following pages:

Feed Support

Announcement channels automatically generate feeds in multiple formats:

  • RSS 2.0/feed/rss for traditional feed readers

  • Atom/feed/atom for modern feed aggregators

  • JSON Feed/feed/json for programmatic access