06-public-profile-and-sharing
Public Profile & Sharing
One of Kherpi's key features is the ability to publish documents to a public profile page, accessible to anyone on the web.
Your public profile
Every user has a public profile at:
https://yoursite.com/u/yourname
Your profile page displays:
- Your avatar (generated from your initials)
- Your username
- A grid of your published public documents
- Any public subfolders containing published content
[screenshot: public profile page showing avatar, name, and document grid]
Publishing a document
To make a document appear on your public profile:
- Open the document in the editor
- Set the Status to "Published" (using the dropdown in the toolbar)
- Toggle Public on (using the toggle in the toolbar)
- Click Save
The document will now be visible on your public profile and at its own public URL.
[screenshot: editor toolbar with status set to Published and Public toggled on]
Public URLs
Public documents are accessible at URLs that follow this pattern:
https://yoursite.com/u/yourname/document-slug
If the document is inside a folder, the folder path is included:
https://yoursite.com/u/yourname/folder/subfolder/document-slug
The full public URL is shown in the Properties panel of the editor when a document is both public and published.
Public document view
When someone visits a public document, they see:
- A breadcrumb navigation at the top (username / folder / document)
- The document type badge
- The document title
- The author name and last updated date
- Any custom properties with values (displayed in a card)
- The full rendered Markdown content
[screenshot: public document view with breadcrumb, title, properties card, and content]
Pinned documents
You can pin important documents using the "Pinned" toggle in the editor's Properties panel. Pinned documents are visually highlighted on your public profile with a pin icon, making them stand out.
[screenshot: public profile with a pinned document highlighted]
NSFW content
Documents marked as NSFW display an 18+ badge on both the public profile grid and the document page itself. This helps visitors know what to expect before clicking.
[screenshot: document card on public profile with NSFW badge]
Folders on your public profile
If you have published documents inside folders, those folders appear as clickable cards on your public profile. Visitors can browse through your folder structure just like navigating a file system.
[screenshot: public profile showing folder cards alongside document cards]
Theming
You can customise the appearance of your public profile through Settings > Appearance. Custom CSS lets you personalise your public pages with your own colours and styling, giving your public profile a unique look.
[screenshot: public profile with custom theme applied]