# 包含文件
包含文件用于创建可在多个页面重复使用的页眉、页脚或元素。
<stl:include> 标签会获取指定文件中存在的所有文本/代码/标记,并复制到使用 include 语句的文件中。
包含文件很有用,如果你需要在网站的多张页面上引用相同的 STL、HTML 或文本的话。
包含文件省去了大量的工作,这意味着你可以为所有页面创建标准页头、页脚或者菜单文件。然后,在页头需要更新时,你只需更新这个页头包含文件即可。
需要注意的是,一旦包含文件中的内容更改了,需要生成所有页面才能将变化体现到网站中。
# 示例
假设我们有一个名为 "footer.html" 的标准的页脚文件,存放在站点根目录下的 include 文件夹中,就像这样:
<p>Copyright © 2006-2018 {stl.siteName}</p>
如需在模板中引用这个页脚文件,请使用 include 语句:
<html>
<body>
<h1>欢迎访问我们的首页!</h1>
<p>一段文本。</p>
<p>一段文本。</p>
<stl:include file="/include/footer.html"></stl:include>
</body>
</html>