Confluencewiki 高级 pdf 导出自定义
Upcoming SlideShare
Loading in...5
×
 

Confluencewiki 高级 pdf 导出自定义

on

  • 308 views

Confluencewiki 高级 pdf 导出自定义

Confluencewiki 高级 pdf 导出自定义

Statistics

Views

Total Views
308
Views on SlideShare
308
Embed Views
0

Actions

Likes
0
Downloads
1
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

Confluencewiki 高级 pdf 导出自定义 Confluencewiki 高级 pdf 导出自定义 Document Transcript

  • OSSEZTEC http://cwiki.ossez.com P1 Copyright © 2014, OSSEZ INC 1. 2. 1. 2. 3. 1. 2. a. 自定义导出到 PDF Confluence 的管理员和空间管理员可以第为一个独立的空间定义一个 PDF 导出格式。 请注意: PDF 自定义格式可以为每个空间独立配置。 Confluence 的 PDF 自定义配置可以使用 HTML 和 CSS 的组合。 为了达到导出文件所需要的,你需要确定下面一个或者 2 个的要求: PDF 布局( ),这里使用 HTML 来定义一个导出内容的结构,包括有一些特性,如果页面标题,页头和页脚。PDF Layout PDF 样式表( ),这个 CSS 样式表被用来定义导出内容的样式,例如字体大小,边距,字体,颜色和列表数字等。PDF Stylesheet 有关更多的配置信息,请查看 页面中的相关说明。高级 PDF 导出自定义 自定义 PDF 布局 你可以添加你自己的 HTML 到页面,然后利用这个来定义 PDF 导出使用的页面标题,页头,页脚。 设置全局 PDF 布局 在屏幕的右上角单击 ,然后选择 链接。控制台按钮 Confluence Admin 选择 。你可以输入在页面中被使用的HTML 和 CSS 样式表,同时也包括页头和页脚。PDF 布局(PDF Layout) 在空间级别设置 PDF 布局 进入到空间,然后在左侧边栏中选择 。你需要有空间管理员权限才能进行操作。空间工具 > 界面外观(Space tools>Look and Feel) 选择 。PDF 布局(PDF Layout) 选择 编辑( )。Edit 如果你的空间使用的是文档主题的话: 在屏幕顶端选择 。浏览 > 空间管理(Browse>Space Admin) 如果你是一个空间管理员权限或者你是超级用户( )空间管理选项将会显示出来。文档: confluence-administrators组成员 在空间管理选项中 选择PDF 布局(PDF Layout)。 选择 编辑( )。Edit 当空间被导出为 PDF 的时候,你可以使用自定 HTML 来生成下面描述部分的内容。 PDF 空间导出页面标题(PDF Space Export Title Page)– 页面标题。 PDF Space Export Header)PDF 空间导出页面页头( – 页头。 PDF Space Export )PDF 空间导出页面页脚( Footer – 页脚。 针对需要输入信息的输入框中,输入你的自定义系想你。PDF 布局部分是可以使用 HTML 代码的。你也可以在你的 HTML 中包含有 CSS 样式表。
  • OSSEZTEC http://cwiki.ossez.com P2 Copyright © 2014, OSSEZ INC 1. 2. 1. 2. 3. 4. 1. 2. 3. 4. 本页中的内容: 自定义 PDF 布局 设置全局 PDF 布局 在空间级别设置 PDF 布局 自定义 PDF 样式 设置一个全局 PDF 样式表 设置一个空间样式表 自定义示例 页面大小 页面排版:横排或是竖排 页面边距 分页符 页面标题 内容列表 页头和页脚 页码 包含长段落 基本格式 备注 相关主题 相关页面: 自定义导出到 PDF 自定义 PDF 样式 你可以在 PDF 样式表界面中来通过 CSS 条件 PDF 页面的样式。 希望进行这方面的操作,从 PDF 样式表中下载默认的 CSS 规则 - 。confluencedefaultpdf.css 这个文件里面定义的所有规则都是可以被修改的,然后将修改的添加到 PDF 导出样式表部分。你的修改将会覆盖默认的 CSS 规则。如果没有自定义的 CSS 样式表,那么默认的样式表将会被使用。 在默认情况下,PDF 的导出不会包含页面标题,页头和页脚。你可以在 PDF 布局中定义。 希望自定义 PDF 样式表: 设置一个全局 PDF 样式表 在屏幕的右上角单击 ,然后选择 链接。控制台按钮 Confluence Admin 选择 界面和外观 > PDF 样式表( > )。然后输入你需要的 CSS 代码后保持,CSSLook and Feel PDF Stylesheet 的样式将在页面导出的时候生效。 设置一个空间样式表 进入到空间,然后在左侧边栏中选择 。你需要有空间管理员权限才能进行操作。空间工具 > 界面外观(Space tools>Look and Feel) 选择 。PDF 样式表(PDF Stylesheet) 选择 。编辑(Edit) 输入你的自定义样式。 如果你的空间使用的是文档主题的话: 在屏幕顶端选择 。浏览 > 空间管理(Browse>Space Admin) 如果你是一个空间管理员权限或者你是超级用户( )空间管理选项将会显示出来。文档: confluence-administrators组成员 在空间管理员选项中选择 PDF 样式表(PDF Stylesheet)。 选择编辑(Edit)。 输入你的自定义样式。 PDF 的导出样式表字段可也接受 CSS 样式表。PDF 导出样式表页面中显示了你当前 PDF 的样式。
  • OSSEZTEC http://cwiki.ossez.com P3 Copyright © 2014, OSSEZ INC 自定义示例 这部分提供了你可以添加的标准样式表示例,请参考 页面获得更多的配置信息。高级 PDF 导出自定义 页面大小 默认的页面大小是根据你 Confluence 服务器的位置决定的。例如,如果服务器是处在美国的话,那么默认的 PDF 导出文件页面大小设置为纸张为 US Letter (8.5 * 11)。如果服务器位于澳大利亚,那么默认的纸张大小将会设置为 A4 (210 * 297 mm)。更多有关纸张大小的设置,你可以在Wikip 中找到答案。edia 希望编辑纸张大小到 A4,你可以通过 编辑 PDF 的样式表,在 CSS@page 规则中添加 size 属性,如下所示: @page { /*The A4 paper size is 210 mm wide by 297 mm long*/ size: 210mm 297mm; } 页面排版:横排或是竖排 希望修改页面的排版方式,你可以简单的对页面设置规则中的纸张大小属性进行调整。把纸张大小中设置的值进行互相调换就可以了。 例如,希望创建一个 A4 大小的横排纸张,你的 规则如下所示:@page @page { /*A4-sized pages in landscape orientation are 297 mm wide by 210 mm long*/ size: 297mm 210mm; } 页面边距 希望设置 A4 页面的边距为 15 mm 的话,边距 CSS 样式表的 规则如下所示:CSS @page @page { size: 210mm 297mm; margin: 15mm; } 希望设置页面的没一个边距规则不同,边距 规则如下:@page CSS - PDF Stylesheet CSS - PDF Stylesheet CSS - PDF Stylesheet
  • OSSEZTEC http://cwiki.ossez.com P4 Copyright © 2014, OSSEZ INC @page { margin-top: 2.54cm; margin-bottom: 2.54cm; margin-left: 1.27cm; margin-right: 1.27cm; } 希望设置一个边框来提供文档的装订线,使用 和 伪类,如下所示::left :right @page :left { margin-left: 4cm; margin-right: 3cm; } @page :right { margin-left: 3cm; margin-right: 4cm; } @page :first { margin-top: 10cm /* Top margin on first page 10cm */ } 注意:在示例中使用 伪类,用户定义封面的的边距或者标题也的边距:first 分页符 默认的情况下,Confluence 页面不提供分页符。所以生成的 PDF 纸张越小。 希望每一 Confluence 页面在 PDF 文件中显示为不同的页,添加下面的规则到 PDF 样式表中: .pagetitle { page-break-before: always; } 页面标题 你可以通过在 PDF 布局屏幕中添加一个 HTML 标题页属性添加一个标题页到你的 PDF 文档中。下面的示例创建了这个标题页,然后添加了一个标题: CSS - PDF Stylesheet CSS - PDF Stylesheet CSS - PDF Stylesheet
  • OSSEZTEC http://cwiki.ossez.com P5 Copyright © 2014, OSSEZ INC 1. 2. 3. 4. <div class="fsTitlePage"> <img src="/download/attachments/590719/titlepage.png" /> <div class="fsTitle">Planning for Confluence 4.0</div> </div> 在 PDF 样式表中使用 CSS 规则来控制表页和标题文本的显示: .fsTitlePage { margin-left: auto; margin-top: 50mm; margin-right: auto; page-break-after:always } .fsTitle { font-size: 42px; font-weight: bold; margin: 72px 0 4px 0; text-align:center; } 添加一图片到标题也中 在上面的示例中,标题页面包含了一个称为 'titlepage.png' 图片,图片被定义在页面的中间。在 src 中的 ID 属性 "590719" 为这个图片的 ID。 下面的指南将会告诉你如何添加一个图片到你的标题页中: 添加一个图片到 Confluence 页面。 在这个页面中查看附件的列表,右键单击这个图片然后拷贝这个图片的位置。 将这个链接添加到 PDF 样式表中的 中,如上所示。src="" 输入图片的 URL 的相对路径,你需要删除 URL 中的域名定义,只使用 . 就可以了。/download/... 内容列表 在默认情况下,内容列表将会在表页面中自动创建或者在 PDF 文档的前面,如果没有标题页面被定义的话。希望修改默认的 CSS 规则( confluenc ),下载默认的 CSS 规则,然后查看命名为 toc 的内容。edefaultpdf.css 在定义的 PDF 样式表中做出必要的修改就可以了。 禁用内容列表 希望在生成 PDF 文档的时候不生成内容列表。添加 规则到 PDF 样式表中然后设置 属性为 none:div.toc display HTML - PDF Layout: Title Page Section CSS - PDF Stylesheet
  • OSSEZTEC http://cwiki.ossez.com P6 Copyright © 2014, OSSEZ INC 1. 2. div.toc { display: none; } 修改内容列表中的顶部章节 顶部章节在内容列表中被用来确定页面的数量。默认清晰顶部章节是 '.' (点) 字符。顶部的变量是 , 和 都是可用的。你可以使用dotted solid space 一个子付出,例如leader(". . . ") 希望修改顶部章节为实先,修改 中的变量 属性规则如下:leader() content span.toclead:before { content: leader(solid); } 页头和页脚 你可以在你的 PDF 页面中添加页头和页脚,在 PDF 布局屏幕中使用 'Header' 和 'Footer' 部分。在默认情况下,页头和页脚只对空间导出有效,对单一页面导出无效(然而,你可以进行修改,参考页面 )。下面就是高级 PDF 导出自定义 有关一个版权的页脚通知。 Copyright © 2014, OSSEZ INC 页码 希望在页面中添加页码,你需要对你 PDF 样式表中的 CSS 进行自定义。 PDF 的 HTML 布局:在页角部分(或者页头部分),使用一个空的 Span 元素来包含一个独立的 ID,例如 ,来启用页脚的占位置pageNum 符。 <span id="pageNum"/> PDF 样式表 CSS:创建下面的 CSS 样式表选择器规则来应用到你的空 span 标签中: CSS - PDF Stylesheet CSS - PDF Stylesheet HTML - PDF Layout: Footer Section HTML - PDF Layout: Footer Section
  • OSSEZTEC http://cwiki.ossez.com P7 Copyright © 2014, OSSEZ INC #pageNum:before { content: counter(page); } 分析上面的 CSS 选择器规则: #pageNum规则选择器使用特定 ID"pageNum" 来选择一个样式表。 元素是我们在页脚或者页头使用的标签。span :before的选择器部分来指定那个 CSS 样式是我们需要使用的。 counter(page)起到了返回页面数字内容的功能。 content属性告诉 CSS 处理区这个动态内容(随着内容自增的数字)被动态的插入到页面 span 标签中。 包含长段落 希望分隔一个很长的段落,或者没有空格的长字符,在 PDF 样式表中的 属性中添加值 :word-wrap break-word div { word-wrap: break-word; } 基本格式 你可以使用样式表在定义 Confluence 的界面和外观的输出。这个包含有字符,表格,直线分隔符,宏等。这个导出引擎是将 Confluence 的内容先导出为 HTML 格式的。第一步要做的工作是对导出为 HTML 的元素进行一些自定义。自定义的 PDF 样式将会在 PDF 导出中显示出来。 备注 标题元素的大小: , , 和其他h1 h2 。基于标题的管理和在导出使用的空间,Confluence 将会调整标题标题在导出空间中的显示。这个意思标题将会被重新计算,这个是在 PDF 导出样式表中进行定义的。 它可以计算由标题会以有应用了正确的CSS样式。一个标题将会按照在页面中的深度被降一级。(所有<H1>元素将成为<H2>元素,依此类 推)。一个页面的第二级将会被降低为 2, 以此类推。 Atlassian 只支持有限的 PDF 定制:我们支持使用 HTML 和 CSS 的 PDF 布局定制机制。如果你使用这种机制对你的 PDF 导出定制的时候,Atlassian 通常能够对这个提供技术支持。但是如果你使用了自定义的 PDF 样式表来定义 PDF 输出的话,Atlassian 将不会支持由你自定输出产生的问题。 相关主题 高级 PDF 导出自定义 CSS - PDF Stylesheet CSS - PDF Stylesheet