Ein Seitenlayout-Compiler ist ein NodeJS-(CommonJS-)JavaScript-Modul, das das zugehörige Seitenlayout kompiliert.
Der Seitenlayout-Compiler für ein Seitenlayout wird durch Namensverknüpfung mit einer -compile.js
-Erweiterung definiert:
src
themes
<yourTheme>
layouts
<yourPageLayout>.html
<yourPageLayout>-compile.js
Wenn keine -compile.js
-Erweiterung für ein Seitenlayout vorhanden ist, wird keine benutzerdefinierte Kompilierung angewendet.
Ein Seitenlayout-Compiler muss eine compile()
-Schnittstelle implementieren, die einen Promise zurückgibt. Beispiel: about-compile.js
:
var mustache = require('mustache'); var PageCompiler = function () {}; PageCompiler.prototype.compile = function (args) { var self = this, layoutMarkup = args.layoutMarkup; self.SCSCompileAPI = args.SCSCompileAPI; return new Promise function (resolve, reject) { var compiledPage = layoutMarkup, id = self.SCSCompileAPI.navigationRoot; // page is compiled so there is no FOUC, can remove the opacity workaround compiledPage = compiledPage.replace('opacity: 0;', 'opacity: 1;'); // remove the dynamic menu creation, we'll be compiling it here compiledPage = compiledPage.replace('<script src="_scs_theme_root_/assets/js/topnav.js"></script>', ''); // add link to Home page. . . var homePageURL = (self.SCSCompileAPI.getPageLinkData(id) || {}).href; if (homePageURL) { compiledPage = compiledPage.replace('class="navbar-brand" href="#"', 'class="navbar-brand" href="' + homePageURL + '"'); } // build the menu and add it to the page var navMenu = self.createNavMenu(); compiledPage = compiledPage.replace('<!-- navigation menu goes in here -->', navMenu); // return the compiled page resolve(compiledPage); }); }; // Create the navigation menu that was previously dynamically generated on each page PageCompiler.prototype.createNavMenu = function () { . . . } module.exports = new PageCompiler();