Open Custom Blocks

To enhance the extensibility of the FixIt theme, we provide some custom blocks that you can use in your project to achieve more functionality.

What’s the Meaning

By opening custom blocks, the extensibility of the FixIt theme is further enhanced.

After that, we can make full use of the basic features of the theme and build more upper-level components, so that the blog is full of unlimited imagination and creativity!

Entry File

The FixIt theme opens a unified custom template entry file layouts/_partials/custom.html.

In this file, the FixIt theme has defined all open custom blocks. If you want to further customize, you can copy it from the theme to your project and override it.

1

cp themes/FixIt/layouts/_partials/custom.html layouts/_partials/custom.html

Custom Blocks

You can implement these blocks through define.

Theme Configuration

To facilitate the management of introducing custom templates, you can specify the path of custom templates through the params.custom_partials parameter.

Custom partials must be stored in the /layouts/_partials/ directory.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

[params.custom_partials]
head = []
menu_desktop = []
menu_mobile = []
profile = []
aside = []
comment = []
footer = []
widgets = []
assets = []
post_toc_before = []
post_toc_after = []
post_content_before = []
post_content_after = []
post_footer_before = []
post_footer_after = []

How to Use

Now let’s take the custom home page custom-profile block as an example to demonstrate how to use custom blocks.

At first, create a custom file in the layouts/_partials/ directory, such as layouts/_partials/custom/profile.html.

Write any content:

1

The quick brown fox jumps over the lazy dog.

Then specify the path of the custom template in the configuration file.

1
2

[params.custom_partials]
profile = [ "custom/profile.html" ]

Visit the homepage, and you will see the custom content in the profile area.