Enable Page Publishing
enable page publishing under Admin > Settings
Enable page publishing when login is required
show_published_pages_login_required under Admin > Settings will allow published pages to be visible even when not logged in.
Publish a Topic
On the first post of a public topic, hitting the
... menu (1) will reveal the wrench (2), which in turn will reveal the post administration menu (3), with a new option:
Go to post #1 and select the ellipsis icon…
Select the wrench icon
Select “Page Publishing”
This reveals a modal dialog proposing to publish the topic as a page, where you can choose the (pre-filled) slug, just as you would do for a category’s slug – it’s automatically generated from the post title. You will also get a preview of what your published page’s URL will look like.
A published topic shows a notice under the title that allows access to its publishing settings:
Unpublish a Topic
Publishing Settings will bring up options that allow you to unpublish the topic
Publishing Public Pages
In your admin settings, there is a
show published pages login required setting that you can override to allow your pages to be displayed to everyone even when
login_required is enabled on your account.
Public Page Indicators
There is a “public” checkbox on the Page Publishing modal dialog window to indicate that topic restrictions have been overriden:
There will be a “Public” tag under your original topic’s name to indicate that the page is public.
Styling of a Published Page
The structure of a published page makes it easy to customize its CSS style:
Beginning of the HTML document of a published page
<body class="published-page"> <div class="published-page-header"> <div class="published-page-header-wrapper"> <a> <img class="published-page-logo"/> </a> <h1 class="published-page-title">Guide for ActivityPub users</h1> </div> </div> <div class="published-page-content-wrapper"> <div class="published-page-content-header"> <div class="published-page-author"> <img class="avatar" src="/letter_avatar_proxy/v4/letter/n/da6949/90.png"> <div class="published-page-author-details"> <div class="username">nedjo</div> <div class="topic-created-at">February 8</div> </div> </div> </div> <div class="published-page-body">
The relevant CSS selectors
||the whole page (or simply:
||a div containing the page header (similar styling to discourse
||a div around the site logo and page title|
||The site logo (uses the small version)|
||The page title|
||a div around the content|
||the title and authorship information|
||the topic title (
||the avatar, name of the author, and topic creation date|
||the username and topic creation date|
||the author’s username|
||the topic’s creation date|
||the page contents|
You can go to Admin > Customize > Themes > CSS and play with it.
Big special thanks to @hellekin for starting the documentation and providing us with valuable feedback.
It’s possible to “publish” a wiki page, which means every member, not only Staff, can update it.
Users can look at creating a theme component to supplement the published pages.