Discourse поддерживает импорт тем, содержащих ресурсы из удалённого репозитория.
Это позволяет авторам тем делиться шрифтами и изображениями.
Создайте новый репозиторий Git с шрифтом
mkdir discourse-roboto-theme
cd discourse-roboto-theme
git init .
vim about.json
Для файла about.json добавьте шаблон конфигурационного файла:
{
"name": "Компонент темы Roboto",
"about_url": "",
"license_url": "",
"assets": {
"roboto": "assets/roboto.woff2"
}
}
Добавьте файл LICENSE. Я обычно использую лицензию MIT.
vim LICENSE
Загрузите шрифт
Сайт http://localfont.com/ удобен для поиска шрифтов.
mkdir assets
cp ~/Downloads/roboto.woff2 roboto.woff2
Добавьте CSS, использующий тему
mkdir common
cd common
Создайте файл с именем common.scss со следующим содержимым:
@font-face {
font-family: Roboto;
src: url($roboto) format("woff2");
}
body {
font-family: Roboto;
}
Отправьте изменения на GitHub
Добавьте все ваши изменения:
git add LICENSE
git add about.json
git add assets/roboto.woff2
git add common/common.scss
git commit -am "first commit"
Создайте учётную запись на GitHub.com, а затем создайте новый репозиторий.
(Необязательно) Создайте тему на Discourse как место для обсуждения вашей цветовой схемы
В идеале вы создадите тему в категории #plugin:theme с несколькими скриншотами вашей цветовой схемы. Вы будете использовать эту тему как значение для about_url.
Заполните недостающую информацию в файле about.json
-
Перейдите на страницу LICENSE в вашем репозитории на GitHub и укажите этот URL как
license_url. -
В качестве
about_urlиспользуйте либо URL проекта на GitHub, либо URL темы на Discourse.
В конце процесса ваш файл about.json будет выглядеть примерно так:
{
"name": "Компонент темы Roboto",
"about_url": "https://github.com/SamSaffron/discourse-roboto-theme",
"license_url": "https://github.com/SamSaffron/discourse-roboto-theme/blob/master/LICENSE",
"assets": {
"roboto": "assets/roboto.woff2"
}
}
Добавьте изменения и отправьте их на GitHub:
git commit -am "added more details"
git push
Протестируйте компонент шрифта
- На экране
admin/customize/themeимпортируйте вашу тему с GitHub.
Теперь вы можете легко делиться шрифтами!
См. также:
Этот документ находится под версионным контролем — предлагайте изменения на GitHub.