如果我想在我的 Apostrophe 项目中使用 LESS 文件中的编译 Bootstrap,什么被认为是最佳实践?
通过 NPM 安装 Bootstrap 更好,还是我应该手动下载 Bootstrap 并将文件放入lib/modules/apostrophe-assets/
?
我已经查看了我知道的文档以尝试解决这个问题。我没有找到任何关于包含位于lib
文件夹外部的 CSS 和 JS 资产的文档。
如果我想在我的 Apostrophe 项目中使用 LESS 文件中的编译 Bootstrap,什么被认为是最佳实践?
通过 NPM 安装 Bootstrap 更好,还是我应该手动下载 Bootstrap 并将文件放入lib/modules/apostrophe-assets/
?
我已经查看了我知道的文档以尝试解决这个问题。我没有找到任何关于包含位于lib
文件夹外部的 CSS 和 JS 资产的文档。
我是 P'unk Avenue 的 Apostrophe 的首席开发人员。
您可以将这些文件放在 lib/modules/apostrophe-assets/public/css (及其子目录,如果需要),并包括一个在您的配置中导入所有其他文件的文件apostrophe-assets
,完全按照教程中的描述:
或者,您可以从您自己的 LESS 文件中导入它,该文件也可以导入您的自定义站点特定样式。这真的取决于你。
当然,也没有什么可以阻止您将资产直接添加到您的outerLayout.html
通孔link
和script
标签,但如果您想利用 Apostrophe 的缩小过程,请按照教程进行操作。
需要明确的是,可以为您的特定项目覆盖 Apostrophe 中的任何和所有模板,而无需以任何方式修改 node_modules/apostrophe 文件夹。
如果此路径中存在模板:
node_modules/apostrophe/lib/module/MODULE-NAME/views/TEMPLATE-NAME.html
然后将其复制到您的项目中:
lib/module/MODULE-NAME/views/TEMPLATE-NAME.html
而您的版本将被渲染。
您可以使用 Nunjucksextends
关键字来扩展您自己发明的模板。您还可以使用跨模块语法来扩展不同模块中的模板:
{# Finds it in the apostrophe-templates module, your version first, #}
{# node_modules if that doesn't exist #}
{% extends "apostrophe-templates:layout.html" %}
希望这能让事情变得更好!