包含文件

包含文件用于创建可在多个页面重复使用的页眉、页脚或元素。

<stl:include> 标签会获取指定文件中存在的所有文本/代码/标记,并复制到使用 include 语句的文件中。

包含文件很有用,如果你需要在网站的多张页面上引用相同的 STL、HTML 或文本的话。

包含文件省去了大量的工作,这意味着你可以为所有页面创建标准页头、页脚或者菜单文件。然后,在页头需要更新时,你只需更新这个页头包含文件即可。

需要注意的是,一旦包含文件中的内容更改了,需要生成所有页面才能将变化体现到网站中。

示例

假设我们有一个名为 "footer.html" 的标准的页脚文件,存放在站点根目录下的 include 文件夹中,就像这样:

<p>Copyright © 2020-2025 {stl.siteName}</p>
1

如需在模板中引用这个页脚文件,请使用 include 语句:

<html>
<body>

<h1>欢迎访问我们的首页!</h1>
<p>一段文本。</p>
<p>一段文本。</p>

<stl:include file="/include/footer.html"></stl:include>

</body>
</html>
1
2
3
4
5
6
7
8
9
10
11