發佈範本

關於出版物模板

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

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

發佈模板的標識

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

樣式表的標識鍵是由命名空間和名稱以冒號分隔的字串組成;例如: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​欄位不用於產生多個檔案,但您仍必須填入此欄位,以避免發佈時發生錯誤。

本頁內容