v7 v8

發佈範本

上次更新： 2023-08-31
  • 主題：
  • Templates
    檢視有關此主題的更多資訊
  • 建立對象：
  • User

關於發佈範本

發佈範本會參考發佈程式中使用的資源，即：

  • 資料結構描述，
  • 輸入表單，
  • 每個輸出檔案的轉換範本。

出版物範本的識別

發佈範本由其名稱和名稱空間識別。

樣式表的識別索引鍵是由名稱空間和以冒號分隔的名稱所組成的字串；例如： cus：newsletter.

注意

實際上，建議對結構描述、表單和發佈範本使用相同的索引鍵。

建立及設定範本

發佈範本預設會儲存在 Administration > Configuration > Publication templates 節點。 若要建立新範本，請按一下 New 按鈕來設定範本清單的上方。

若要設定發佈範本，請填入範本的名稱（即包含名稱和名稱空間的識別鍵）、其標籤、資料結構描述及其連結的輸入表單。

注意

每次根據此出版物範本建立內容時，標籤都會出現。

此 檢查狀態以驗證內容產生 選項會強制檢查內容例項的「已驗證」狀態，以授權產生檔案。 有關詳細資訊，請參閱 出版物.

必須為每個輸出檔案新增轉換範本。 您可以視需要建立儘可能多的轉換範本。

此 Name of template 欄位是自由標籤，說明輸出時的演算型別。 對於每個轉換範本，出版物設定都可在標籤中使用。

呈現

此 Rendering 標籤，選擇：

  • 用於投影輸出檔案的演算型別：XSL樣式表或JavaScript範本，
  • 輸出檔案的格式：HTML、文字、XML或RTF、
  • 包含建構資料的範本，即要使用的樣式表或JavaScript範本。

出版物

出版物涉及以檔案形式生成輸出檔案，如果所選型別為 File.

下列發佈選項可供使用：

  • 輸出檔案編碼字元集可以透過 Encoding 欄位。 依預設，會使用拉丁文1 (1252)字元集。

  • 此 Multi-file generation 選項會啟動特殊檔案發佈模式。 此選項包括在輸出檔案每一頁的開頭填入分割標籤。 產生內容將會為每個填入的分割標籤產生檔案。 此模式用於從內容區塊產生迷你網站。 有關詳細資訊，請參閱 多檔案產生.

  • 此 Location 欄位包含輸出檔案的名稱。 名稱可由變陣列成，以產生自動檔案名稱。

    變數會以下列格式填入： $(<xpath>)，其中 <xpath> 是發佈範本資料結構描述的欄位路徑。

    檔案名稱可由日期型別欄位組成。 若要正確格式化此欄位，請使用 $date-format 函式，使用欄位路徑和輸出格式作為引數。

    依預設，檔案名稱的建構格式使用「@name」和「@date」欄位上的變數：

    ct_$(@name)_$date-format(@date,'%4Y%2M%2D').htm

    產生的檔案名稱如下： ct_news12_20110901.htm。

    注意

    有關產生內容的詳細資訊，請參閱 建立內容例項.

傳遞

此索引標籤可讓您選取案例，以直接在內容上啟動傳送。 電子郵件內容將會根據輸出格式(HTML或文字)自動填入。

注意

如需根據內容建立傳送的範例，請參閱 傳遞內容例項.

彙總

從指令碼或查詢清單彙總資料，可讓您以內容資料擴充XML檔案。 其目的是要補充連結所參考的特定資訊，或從資料庫新增元素。

多檔案產生

若要啟用多重檔案產生，請選取 Multi-file generation 發佈模型中的選項。 此選項可讓您在樣式表中指定輸出檔案每一頁開頭的分割標籤。 產生內容時，會針對每個遇到的分割標籤產生檔案。

要整合在樣式表中的分割標籤如下：

<xsl:comment> #nl:output_replace(<name_of_file>) </xsl:comment> 位置 <name_of_file> 是要產生之頁面的檔案名稱。

範例： 使用"cus：book"結構描述產生多個檔案。

其原理是產生一個列出章節的首頁面，並可能在外部頁面中顯示章節的詳細資訊。

對應的樣式表(「cus：book.xsl」)如下：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:output encoding="ISO-8859-1" method="html"/>

  <!-- Style sheet entry point -->
  <xsl:template match="/book">
    <html>
      <body>
        <h1><xsl:value-of select="@name"/></h1>
        <lu>
          <xsl:for-each select="chapter">
            <li><a target="_blank" href="chapter{@id}.htm"><xsl:value-of select="@name"/></a></li>
          </xsl:for-each>
       </lu>
      </body>
    </html>
   </xsl:template>
</xsl:stylesheet>

需要第二個樣式表(「cus：chapter.xsl」)來產生章節的詳細資訊：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:output encoding="ISO-8859-1" method="html"/>

  <!-- Detail of a chapter -->
  <xsl:template match="chapter">
    <!-- Cut tag -->
    <xsl:comment> #nl:output_replace($(path)/chapter<xsl:value-of select="@id"/>.htm)</xsl:comment>

    <html>
      <body>
        <h1><xsl:value-of select="@name"/></h1>
        <xsl:value-of select="page" disable-output-escaping="yes"/>
      </body>
    </html>
  </xsl:template>

  <!-- Style sheet entry point -->
  <xsl:template match="/book">
    <xsl:apply-templates/>
   </xsl:template>
</xsl:stylesheet>

分割標籤會填入在頁面的開頭處，以包含在要產生的檔案中。

<xsl:comment> #nl:output_replace($(path)/<xsl:value-of select="@id"/>.htm)</xsl:comment>

檔案名稱是使用 $(path) 變數，其中包含發佈路徑和 <xsl:value-of select="@id" />，會比對輸入檔案中章節的識別碼。

出版物模型必須填入兩個樣式表「cus：book.xsl」和「cus：chapter.xsl」。

此 Multi-file generation 選項必須在章節轉換模型上為作用中：

此 Location 欄位並未用於產生多個檔案，但您仍須填入此欄位以避免發佈時發生錯誤。

上一頁
Next page

此頁面上的