このガイドでは、Discourse のページ発行機能の使用方法について説明します。この機能により、スタッフユーザーはトピックをカスタムスタイリングが施されたスタンドアロンの静的ページに変換できます。利用規約やプライバシーポリシーのページなどがこれにあたります。
必要なユーザーレベル: スタッフ
Discourse での静的ページの公開
ページ発行機能により、スタッフユーザーはトピックからスタンドアロンの静的ページを作成できます。これは、利用規約やプライバシーポリシーのページを作成するプロセスと似ています。
概要
このドキュメントでは、以下について説明します。
- ページ発行の有効化
- トピックをページとして発行する
- トピックの発行を解除する
- 一般的な問題と解決策
- よくある質問 (FAQ)
- その他のリソース
ページ発行の有効化
管理>設定に移動します。ページ発行を有効にする設定を有効にします。
ログインが必要な場合にページ発行を有効にする
ユーザーがログインしていない場合でも公開されたページを表示できるようにするには:
管理>設定でshow_published_pages_login_required設定を有効にします。
トピックの発行
公開トピックの最初の投稿に移動し、省略記号アイコン (
...) を選択します。
レンチアイコンを選択します。
「ページ発行 (Page Publishing)」オプションを選択します。
モーダルダイアログが表示され、スラッグ（投稿タイトルから事前入力可能）を確認し、発行されたページの URL をプレビューできます。
ページ発行を許可するには、セキュアアップロード (secure upload) サイト設定を無効にする必要があります。
⋌small>:information_source: ホストされているサイトの場合、セキュアアップロードはエンタープライズプランに制限されています。
公開されたトピック
公開 (Public)オプションがチェックされている場合、public ラベルが表示されます。
公開されたトピックには、その発行設定へのアクセスを許可する通知がタイトルの下に表示されます。
公開されたページ
トピックの発行を解除する
通知の下にある
発行設定 (Publishing Settings)を選択します。
発行解除 (Unpublish) をクリックします
ページが発行解除されます。
一般的な問題と解決策
ログアウト時に公開されたページが表示されない
管理>設定でshow_published_pages_login_required設定が有効になっていることを確認してください。公開されたページに Discourse のヘッダーを追加する
現在、静的ページは最小限にすることを意図しており、標準の Discourse のヘッダーとフッターは含まれていません。
よくある質問 (FAQ)
FAQ ページや「概要」ページを公開できますか?
必要なコンテンツで新しいトピックを作成し、それをページとして発行できます。サイト設定内のリンクをこれらの新しいページに向けるように変更してください。
公開されたページの見た目をカスタマイズするにはどうすればよいですか?
HTML ドキュメントの構造と対応する CSS セレクターを使用して、
管理>カスタマイズ>テーマ>CSSの下でカスタムスタイルを適用します。その他のリソース
まず実際に試してみないといけないので、以下の内容は現実とズレがあるかもしれませんが：
この権限モデルは、ページの内容が常に2箇所に存在する状況を作り出しているように思えます。1つは関連する Discourse カテゴリに、もう1つは公開されたページ自体にあります。Discourse ユーザーと一般公開したいページの内容が似ている、あるいは同一である場合、これはもちろん重複して見えてしまいます。
一方、ページに「誰でも閲覧可能」フラグがあれば、閲覧・編集できる人を少数グループに制限しつつ、他の Discourse ユーザーがコンテンツにアクセスできるのは公開されたリンクのみ、という構成が可能になります。
（ここでは「ドキュメントサイト」というユースケースを想定しています。）
それ以外は、実際に試すのがとても楽しみです！
素晴らしいですね！ユーザーの声を聞いていただき、改めてありがとうございます。Discourse が持つ「みんなでより良くしていこう」という雰囲気が大好きです。これからは積極的に活用させていただきます。
あるユーザーが、インストールが少し失敗してしまった場合の修正について話している際、ケーキに追加できるもう一つの「仕上げ」として、まだ残っている機能に気づいたそうです。
現在、ログイン必須のサイトでは /faq と /about が非表示になっていますが、これらも公開できるようにする機能は追加できないでしょうか？もちろん、先ほどリリースされた既存の機能を使って、独自の /faq ページを作成し、設定でリンクを変更して明示的にリンクを貼ることは可能です。しかし、これは見た目が美しくなく、既存のナビゲーションは依然として非表示のままです。/about については、そもそもそのようなことはできません。
この機能に追加すると良いのは、投稿を Onebox 対応にすることで、ユーザーが簡単にコンテンツを共有できるようにすることです。
初心者で無知なことをお許しください。HTML/CSSの分野ではまだ未熟者ですが、公開されたページにテーマカラーを適用するにはどうすればよいでしょうか？最も単純な方法としては、ダークモードの体験をフォーラムと同じようにするために、背景を暗く、文字を白にしたいと考えています。
これはすでに製品に含まれている機能でしょうか、それともHTML/CSSをいじる必要がありますか？後者の場合、どなたか方向性を示唆していただけませんでしょうか？よろしくお願いいたします。
この件は別の特徴リクエストとして作成いただけますでしょうか？これはページ公開機能とは直接関係ありません。つまり、これを可能にするためにページ公開に関する変更を加える必要はないからです。これらの「静的」ページがほぼ同じ動作を持つ方が望ましいとは私も思います。ただし、いくつかの解決策が考えられます（何もしない？サイト設定を追加する？これらをページ公開に移行する？など）ので、この件については専用のトピックを作成した方が良いかもしれません。
公開ページで GTM が読み込まれていませんか？あればいいのですが。
うーん、それは本当に良い指摘ですね。
ここで解決策を考えてみましょうか……type="text/javascript"とtype="text/discourse-plugin"を別々に扱うのはどうでしょうか？API には後者が必要ですよね？
はい、テーマフィールドに text/javascript を含めることは既にサポートされていると思いますので、この分野には確実に解決策があります。
それは素晴らしいですね。
つまり、現在、レスポンシブな公開ページを実現することは不可能です。しかし、このサイトでは特に以下の2点が求められています。
- 公開メディアへの共有時に画像を利用可能にすること、および
- レスポンシブ/リサイズされた画像を表示すること（特にモバイル端末で）。モバイル端末ではCSSで画像をリサイズするだけで済むはずです。それで問題ないですよね？
公開ページに Discourse ヘッダーがあることに +1 します。ウェブサイトのロゴ、カスタムヘッダーリンク、そして愛すべきハンバーガーメニューがなくて寂しいです 
もう一つ奇妙な点：投稿内ではライトボックス画像が素敵なポップアップで開きますが、公開ページでは新しいタブで開きます…
必要なのは、そのような機能を追加するテーマコンポーネントのセットだと思います。以前、この機能を使わなければならなかった最後のクライアントは、トピック作成者を削除したいと要望していました。これについては、人々のニーズに合致するものを推測するのは難しいと思います！
現在、公開ページに「シンプル」な（API を使用しない）JavaScript サポートを追加するための取り組みは進められていますか？それとも、近い将来から中期的にはこの計画は諦めるべきでしょうか？
このページに外部の非 Discourse JSON を表示することはできますか？ここでは PHP コードが使えず、Discourse が HTML の大部分を除去してしまうため、どのようにすればよいかわかりません。
公開されたページで問題が発生しています。コードブロックの内容をコピーするボタンが公開ページに表示されません。スクリーンショット: Screenshot by Lightshot
この問題を再現できますか？解決策はありますか？
@riking さん、ありがとうございます！
どうやら、テーマコンポーネントの header または footer にある「通常の」text/javascript は、公開されたページで実行されているようです。
ハッ！どうやら、テーマコンポーネントをページ公開と連携させるためのちょっと荒技な方法があるようです。
公開されたページにヘッダーやフッターを追加しようと考えているのですが、テーマコンポーネントを使うのが良さそうです。ただ、近い将来に壊れる可能性のあるものを無理やり実装するのは良くない気がします。
@riking さん、公開ページで header や footer 内の text/javascript タイプが機能しているのは意図しないものだったようですね。これは 修正 される予定ですか、それとも公開ページの拡張に 利用 される予定ですか？
DiscPage の作者である @syl さんは、Page Publishing 機能を使って DiscPage プラグインを再実装する可能性 について触れていました。@syl さん、まだそのご予定はありますか？@riking さん、両方の機能を統合する上で、最も抵抗の少ない道はどのようなものだと思いますか？
残念ながら、「Page Publishing」機能は私の要件を満たしません。これを利用するには、公開されたページが以下の条件を満たす必要があります：
- 通常の Discourse レイアウト内（利用規約やプライバシーポリシーと同様に、標準的な Discourse ヘッダー付き）に表示されること、
- 通常の（装飾された）トピックと同様にレンダリングされ、bbcode やプラグインをサポートすること。
その間、私はデフォルトのDiscourseカスタマイズ機能を使用しました：
- 追加された要素を特定します（例：
published-page-footer-linksCSSクラスを使用）。 - デフォルトではこの要素を非表示にし、公開ページでのみ表示するようにCSSをカスタマイズします。
- 要素を
Footerスペースに追加します。
2. CSSに以下を追加：
/* 公開ページでのみフッターリンクを表示 */
.published-page-footer-links { display: none; }
.published-page .published-page-footer-links { display: block;}
3. Footerに以下を追加：
<nav class="published-page-footer-links">
こんにちは！これは公開ページ用のフッターです！
</nav>