包含文件

包含文件用于創建可在多個頁面(miàn)重複使用的頁眉、頁腳或元素。

<stl:include> 标簽會(huì)獲取指定文件中存在的所有文本/代碼/标記,并複制到使用 include 語句的文件中。

包含文件很有用,如果你需要在網站的多張頁面(miàn)上引用相同的 STL、HTML 或文本的話。

包含文件省去了大量的工作,這(zhè)意味著(zhe)你可以爲所有頁面(miàn)創建标準頁頭、頁腳或者菜單文件。然後(hòu),在頁頭需要更新時(shí),你隻需更新這(zhè)個頁頭包含文件即可。

需要注意的是,一旦包含文件中的内容更改了,需要生成(chéng)所有頁面(miàn)才能(néng)將(jiāng)變化體現到網站中。

示例

假設我們有一個名爲 "footer.html" 的标準的頁腳文件,存放在站點根目錄下的 include 文件夾中,就(jiù)像這(zhè)樣:

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

如需在模闆中引用這(zhè)個頁腳文件,請使用 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