Использовать Twitter Bootstrap МЕНЬШИЕ файлы с NPM, в Apostrophe CMS

Question

Что считается лучшей практикой, если я хочу использовать компиляцию Bootstrap из LESS-файлов в моем проекте Apostrophe?

Лучше установить Bootstrap через NPM, или мне нужно вручную загрузить Bootstrap и поместить файлы в lib/modules/apostrophe-assets/?

Я рассмотрел документацию, которую я знаю, чтобы попытаться понять это. Я не нахожу документацию о включении ресурсов CSS и JS, которые находятся за пределами папки lib.

Answer 1

Я ведущий разработчик Apostrophe на P'unk Avenue.

Вы можете поместить эти файлы в lib/modules/apostrophe-assets/public/css (и их подкаталоги, если это необходимо) и включить тот, который импортирует все остальные в вашей конфигурации для apostrophe-assets, точно так же, как описано в учебные пособия:

Pushing assets to the browser

Или вы можете импортировать его из файла МЕНЬШЕ свой собственный, который также импортирует пользовательские сайт-специфические стили. Это действительно зависит от вас.

Конечно там тоже ничего не мешает вам добавить активы непосредственно к вашим outerLayout.html через link и script тегов, но если вы хотите воспользоваться преимуществами процесса минификации апострофа, следуйте учебнику.

Чтобы быть ясным, любые и все шаблоны в Apostrophe могут быть переопределены для вашего конкретного проекта БЕЗ модификации папки node_modules/apostrophe.

Если шаблон существует на этом пути:

node_modules/apostrophe/lib/module/MODULE-NAME/views/TEMPLATE-NAME.html 

Тогда просто скопировать его здесь в вашего проекта:

lib/module/MODULE-NAME/views/TEMPLATE-NAME.html 

И ваша версия будет оказана вместо.

Вы можете использовать ключевое слово Nunjucks extends, чтобы расширить шаблоны, которые вы изобретаете самостоятельно. Вы можете также использовать синтаксис кросса-модуль для расширения шаблонов, которые находятся в другом модуле:

{# Finds it in the apostrophe-templates module, your version first, #} 
{# node_modules if that doesn't exist #} 

{% extends "apostrophe-templates:layout.html" %} 

Надеется, что это очищает вещи немного лучше!