Replace Meta Modules

Backgrounds

Initially, to make it easier for newbies to get started and familiarize themselves with the themes of the HB framework, we provide a number of meta modules, which are just collections of modules that don’t provide any functionalities.

However, meta modules have an obvious disadvantage that it is difficult to remove unwanted modules from them, so in this tutorial, we’re going to talk about how to replace the meta module.

Solution

To do this, we need to know which modules the meta-module has imported, then reimport the imported modules in order, remove the unwanted modules, and finally remove the meta module.

The order of imported modules is very important, which priority is from the top to bottom, if you're not familiar with this, just keep the same order as same as defined of the meta module.

Let’s say the site imports the github.com/hbstack/meta/recommended meta module.

1[[module.imports]]
2path = "github.com/hbstack/meta/recommended"

First of all, replace the meta module with the modules imported by it in order.

And then remove or replace the unwanted modules, for example, you might want to replace the github.com/hbstack/header/modules/search with github.com/hbstack/header/modules/docsearch for your open source project documentations site.

For other configurations written in YAML or JSON, you'll need to convert it to corresponding languages first.