文檔中心

STL模闆語言

STL，全稱為(wèi) XYCMS站(zhàn)群系統模版标簽語理船言，你可以把STL語言理(lǐ)解為(w呢公èi)帶有特定意義的占位符，這(zhè)些店暗(xiē)占位符通過标簽（元素及實體(tǐ)）來(lái)标記出需要調取并顯示師會的網站(zhàn)數據及功能(néng)；在生(shēng)成靜态頁面的過程學照中，XYCMS 系統通過STL解析引擎解析這(zh黃計è)些(xiē)占位符，從站(zhàn)點中獲取對應的數據，最終将占位得現符替換為(wèi)帶有數據或功能(néng)的HTML标簽并在服務(wù)公嗎器(qì)中生(shēng)成對應的靜态頁面文人都件。

XYCMS站(zhàn)群系統的核心由内容小唱管理(lǐ)與内容解析兩部分(fēn)組成，STL語白綠言就(jiù)是内容管理(lǐ)與内容解析的橋梁，将後錯費台管理(lǐ)的各種動态數據最終解析為(wèi)用戶林器能(néng)訪問的靜态頁面。

除了(le)将後台的動态數據解析為(wèi)前台的靜态頁面，ST們報L語言還能(néng)夠實現(xiàn)諸如(rú)功能(néng)互窗生動、動态顯示、數據統計、數據庫解析等一(yī)系列功能(néng)；現答除了(le) XYCMS 系統自帶的ST她她L标簽，各類插件也(yě)擁有自己的STL标簽，用以實現(xiàn)不同的謝短功能(néng)。

語言規則

和 HTML 語言一(yī)樣，STL語言窗黑也(yě)是一(yī)種标準通用标記語言，采用與 HTML 語言一(y哥子ī)緻的語法和規則。

STL語言并不複雜，但(dàn)功能(néng)強大，其主要規則如(如分rú)下(xià)：

  • 标簽不區分(fēn)大小寫 STL标簽是不區分(fēn)少醫大小寫的，和 HTML 标簽一(yī)樣，<stl:a> 和 <STL:A> 是相同的。

  • 屬性值區分(fēn)大小寫 STL标簽的屬性值是區分(fēn)大小寫的微制，例如(rú) <stl:a channelIndex煙些="News"> 和 <stl:a channelInde時門x="NEWS">去木 是不同的。

  • 結束标記可以省略 與 HTML 一(yī)樣，在沒有子(zǐ學放)标簽的情況下(xià)，STL 可以省略結束标記。例如(rú) <stl:value></stl:value> 與 <stl:value /> 是一(yī)緻的。

  • 标簽可以嵌套标簽 與 HTML 一(yī)樣，STL 的标簽可以相互嵌套，将章你一(yī)個(gè)或多個(gè)STL标簽放(fàng)到其他學廠STL标簽内部。例如(rú) <stl:a><stl:content ty木爸pe="title"></stl輛鐘:content></stl:a> 。

元素與實體(tǐ)

STL标簽由元素與實體(tǐ)組成，元素以尖括号 <> 作(zuò)為(wèi)标記，實體(tǐ)以大括号 {} 作(zuò)為(wèi)标記。

例如(rú)顯示内容标題可以采用STL 資地元素： <stl:content type="title&quo飛個t;></stl:content> 也(yě)可以采用STL 實體(tǐ)： {stl:content type=&q著章uot;title"} 或者内容實體(tǐ)的簡寫： {content.title}。

STL元素和STL實體(tǐ)的最大區别在于元素能(nén雜學g)夠嵌套子(zǐ)标簽而實體(tǐ)無法嵌套子(zǐ)标簽，例如(r子醫ú)鍊接标簽 <stl:a channelIndex="新(xīn)聞&q農化uot;>News</stl:a> （将解析為(wèi)HTML A标簽）無法通過銀樂實體(tǐ) {stl:a channelIndex="新(xīn船看)聞"} （将解析為(wèi)對應的鍊接地址字符串）表示。

在模闆中你可以使用元素也(yě)可以使用實體(tǐ)，通常情況下(x門用ià)在獨立使用時(shí)采用STL元素高得，在嵌入标簽屬性時(shí)采用STL實體(t亮木ǐ)，例如(rú)獨立使用時(shí)采用：<stl:content type="summ民場ary"></st刀答l:content>，嵌入屬性時(shí)采用：<stl:a title="{st得下l:content type=summary}">。

STL标簽的屬性值使用英文雙引号标識，例如(物快rú)：<stl:content type=&quo他呢t;title"></空鐘stl:content>，STL實體(tǐ)的屬性可以使用英文雙引号、英文單引号或者無标識，例如場兵(rú)：{stl:content type="title"}，{stl:content type='title'}或者{stl:content type=title}均為(wèi)正确的寫法。

地址通配符

在STL标簽中，地址使用通配符（“~”）和（“@在火”）來(lái)進行存儲和讀取，您可以使用通配符（“~”）來(lái)表友間示應用程序的根目錄，使用通配符（“@”）來(lái)表訊下示當前站(zhàn)點的域名地址，而不需要将地址硬編碼為(wèi)文件的數吧絕對地址。

例如(rú)，您可以使用 <stl:a href="index2刀問.html">主站(zh飛廠àn)</stl:a> 生(shēng)成指向到主站(zhàn)點index.html文件務唱的鍊接，使用 <stl:a href="@/inde外音x.html">本站(zhàn)</stl:a>北拿 生(shēng)成指向到當前站(zhàn)點index.html文北雪件的鍊接。

插件标簽

《STL語言參考手冊》僅列出了(le)系統自帶标簽，不包含師能具體(tǐ)插件的标簽使用說(shuō)明，如(電鐘rú)需要使用插件标簽，請查看具體(tǐ)的插件使用說(shuō)明和插件源碼看報。