發佈範本

關於出版物模板

發佈範本是要發佈的內容的識別卡。 它引用了發佈過程中使用的資源，即：

  • 資料模式，
  • 輸入表格，
  • 每個輸出文檔的轉換模板。

發佈模板的標識

出版物範本由其名稱和命名空間來識別。

樣式表的標識鍵是由命名空間和名稱以冒號分隔的字串組成；例如：cus:newsletter。

注意

在實踐中，建議對架構、表單和發佈模板使用相同的鍵。

建立和配置模板

預設情況下，出版物模板儲存在​Administration > Configuration > Publication templates​節點中。 若要建立新範本，請按一下範本清單上方的​New​按鈕。

要配置發佈模板，請填入模板的名稱（即由名稱和名稱空間組成的標識鍵）、其標籤、資料模式及其連結的輸入表單。

注意

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

檢查狀態以驗證內容生成​選項強制檢查內容實例的「已驗證」狀態以授權檔案生成。 有關詳細資訊，請參閱Publication。

必須為每個輸出文檔添加一個轉換模板。 您可以根據需要建立任意數量的轉換模板。

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或文字）自動填入。

注意

有關基於內容建立交付的示例，請參閱 Delivering a content instance。

聚合器

從指令碼或查詢清單匯整資料，可讓您以內容資料豐富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​欄位不用於產生多個檔案，但您仍必須填入此欄位，以避免發佈時發生錯誤。

本頁內容