| 概要 | プレースホルダー形式を使用すると、投稿内の =PATTERN= というパターンを、テキスト入力フィールドや選択入力フィールドの値に置き換えるフォームを作成することで、動的なドキュメントを構築できます。 |
|
| プレビュー | Discourse Theme Creator でプレビュー | |
| リポジトリリンク | https://github.com/discourse/discourse-placeholder-theme-component | |
| Discourse テーマは初めてですか? | Discourse テーマの使い方の初心者ガイド |
このテーマコンポーネントをインストール
機能
投稿に以下の形式でプレースホルダーを追加します。
[wrap=placeholder key=NAME description="あなたの名前"][/wrap]
[wrap=placeholder key=COUNTRY default=US defaults=FR,DE,US,CN,AU,CA][/wrap]
あなたのメール: =NAME=-=COUNTRY=@example.com
これにより、以下のような結果になります。
これはメーリングリストで使用されます。
あなたのメール: =ZNAME=-=ZCOUNTRY=@example.com
上記の通り、ラッパー内のテキストは長い説明として使用されます。
[wrap=placeholder key=NAME description="あなたの名前"]
これはメーリングリストで使用されます
[/wrap]
利用可能なキー
- key: 投稿内で置き換えるキー
- default/defaults: デフォルト値(複数可)
- description: 入力用のプレースホルダーテキスト
例
# 新しいプラグインを作成
rails g plugin =PLUGIN_NAME=
cd plugins/=PLUGIN_NAME=
ランブック、ハウツー、再利用可能なテンプレートを作成するために使用しています(コードブロック内でも機能します)。あなたの使用例もぜひ共有してください!
設定
| 翻訳 | デフォルト |
|---|---|
| toolbar.builder | プレースホルダーを追加 |
| builder.errors.no_key | キーは必須です。 |
| builder.title | プレースホルダーを追加 |
| builder.insert | 挿入 |
| builder.key.label | キー |
| builder.key.description | 投稿内で置き換える =キー=。 |
| builder.description.label | 説明 |
| builder.description.description | 値が設定されていない入力に表示される説明。 |
| builder.values.label | デフォルト値(複数可) |
| builder.values.description | プレースホルダーのオプションの値(複数値が定義されている場合、選択リストが使用されます)。 |
\u003cbr\u003e
\u003e:discourse2: 当方でホストされていますか? テーマコンポーネントは、Standard、Business、Enterprise プランで利用可能です。
