 |
Краткое описание | Placeholder Forms позволяет создавать динамическую документацию, формируя форму, которая заменяет любое вхождение =ШАБЛОН= в вашем сообщении значением из текстового поля или поля с выбором опций. |
 |
Предварительный просмотр | Предварительный просмотр в 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]
Ваш email: =NAME=-=COUNTRY=@example.com
Это приведёт к следующему результату:
Это используется в списках рассылки
Ваш email: =ZNAME=-=ZCOUNTRY=@example.com
Как видно выше, текст внутри обёртки будет использоваться как длинное описание.
[wrap=placeholder key=NAME description="Ваше имя"]
Это используется в списках рассылки
[/wrap]
Доступные ключи
- key: ключ, который должен быть заменён в вашем сообщении
- default/defaults: значение(я) по умолчанию
- description: текст-заполнитель для поля ввода
Примеры
# создать новый плагин
rails g plugin =PLUGIN_NAME=
cd plugins/=PLUGIN_NAME=
Мы используем его для создания руководств (runbooks), инструкций и многоразовых шаблонов (он работает и в блоках кода). Делитесь своими случаями использования!
Настройки
| Перевод | По умолчанию |
|---|---|
| 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 | Необязательные значения для вашего заполнителя; если определено несколько значений, будет использован выпадающий список. |
Хостится у нас? Компоненты тем доступны для использования на наших тарифных планах Standard, Business и Enterprise.