当你浏览一个页面的时候，单击一个图片，文件缩略图或者链接将会运行预览。 预览视图包括了从远程 Web 页面导入的图片文件和已经附加到页面中的文件（尽管有可能这些文件没有在页面中显示）。 在预览中你可以： 现在图片文件。 上传一个文件的新版本（仅针对附件）。 评论一个文件。 通过选择桌面应用编辑一个文件。 在你浏览器中放大和缩小图片文件。 像幻灯片一样来进行浏览，使用前后箭头按钮。 查看附件到页面中的其他文件，和选择缩略图来预览这些文件。 切换到全屏显示模式。 很多文件类型都可以被预览，包括有 Office 文件, PDFs 和其他多种图片类型。  那些文件可以被预览？ 图片文件 Office 文件 其他文件 JPEG PNG TIFF PSD WMF EMF ICO ICNS DOC DOCX PPT PPTX XLS XLSX PDF MP3 MP4 查看更多文件（See more files）： 显示其他附加到本页面中的文件。 管理这个文件（Manage this file）：下载文件，上传一个文件的新版本或者在你的项目组中分享。 添加一个评论（Add a comment）：拖动 pin 来对文件进行评论。   https://www.cwiki.us/display/CONF6ZH/Display+Files+and+Images

文件可以在页面中以缩略图或者链接的方式显示。我们有多种办法能够上传文件，请参考 Upload Files 页面。 你可以控制文件如何在你的页面中显示。文件在页面中显示的可用方法与你的文件类型有关。   插入一个文件到你的页面 我们有下面几种办法能够插入一个文件到你的页面中： 在编辑器的工具栏中选择 插入（Insert）> 文件（Files），然后选择任何一个前期已经上传到页面中的文件。 直接拖动文件到编辑器（这个方法将会让上传和插入一次完成），或者 输入 ! 然后从自动显示的下拉选择中选择一个附加到页面中的附件。 你的文件将会在你的页面中以缩略图的方式进行显示，单击缩略图可以对缩略图进行大小调整或者显示为链接。 插入一个附加到其他页面中的文件 你可以显示在同一个 Confluence 站点中附加到其他页面中的文件，前提是你需要知道这个文件的名字。 希望显示一个附加到其他页面中的图片 进入 插入（Insert）>文件（Files）然后选择 搜索其他页面（Search on other pages）。 输入文件名。 选择在当前空间中进行查找或者搜索 所有空间（All Spaces）然后选择 搜索（Search）。 从搜索结果中选择文件，然后选择 插入（Insert）。 从网页（web）上插入一个图片文件 你可以在 Confluence 中显示一个远程 web 页面中的图片，而不需要讲文件下载后上传到你的 Confluence 站点中。你需要知道远程图片的 URL 地址，而不是远程 Web 页面的地址。 这种方式仅仅针对图片文件有效，不能插入其他类型的文件（例如文档）。 希望从远程 web 页面中显示一个图片： 在你对 Confluence 页面进行编辑的时候，将光标移动到你希望插入远程图片的位置。 选择 插入（Insert）>文件（Files） 然后选择 远程 web 的图片（Images from the web）。 输入图片的 URL （例如：http://atlassian.wpengine.netdna-cdn.com/wp-content/uploads/AtlassianBushRegeneration-12January2012-083-trunc.jpg）。 然后选择 预览（Preview）来检查插入的 URL 图片师傅显示正确。 选择 插入（Insert）。 从你的页面中删除文件 如果你在编辑器中删除一个文件或者图片，已经上传的文件不会被删除。 Go to  > Attachments 来从页面中晚期删除附件。 在你的页面中出现了 'unknown attachment' 占位符？这个表示的是这页面中显示的附件文件在本页面（或者其他页面）中已经被删除了。   https://www.cwiki.us/display/CONF6ZH/Display+Files+and+Images

当你上传一个文件的时候，例如上传一个图片或者文档，上传的文件将会附加到当前页面上。 你可以选择在页面中将文件显示为一个链接，一个图片或者嵌入到页面中（使用宏）。 上传一个文件到页面中你需要具有空间的权限 添加附件（Add Attachments）。 上传一个文件 有多种办法可以上传一个文件到页面中。 在页面编辑器中，你可以： 将文件直接拖动到页面中。 进入 插入（Insert）> 文件和图片（Files and images） 然后上传一个文件。 在查看一个页面的时候，你可以： 将文件直接拖动到页面中。 Go to  > Attachments 然后上传一个文件。 你可以一次上传多个文件。 接受的文件类型和大小 Confluence 允许你添加几乎任何类型的文件，但是你不能添加文件所在的文件夹（包括类似 Keynote 创建的文件夹，你需要将你需要上传的文件夹压缩成 ZIP 格式或者其他格式）。 尽管能够允许你添加任何类型的文件，但是不是所有的文件都能够显示或者嵌入到页面中显示。请查看 Display Files and Images 页面中的内容获得更多的信息。 Confluence 允许上传的文件的最大大小是由管理员进行限制的。默认情况下为 10MB，但是你的系统管理员可能会增加或者缩小这个限制。 文件版本 如果你上传的文件具有和页面中已经存在的文件有相同的文件名，Confluence 将会覆盖已经存在的文件，针对所有的附件，Confluence 保留附件的版本历史。请查看 Manage Files 页面来获得更多的内容。 任何对原文件进行的修改将不会影响 Confluence 中已经上传的版本，如果你希望更新 Confluence 中已经上传文件的拷贝，你需要将修改过的文件重新上传。 当一个文件上传后将会发生什么？ 文件将会被获取和索引 当一个文件被上传后，这个文件中的文本将会获取并且被索引，这个能够允许人们对文件的内容进行搜索而不仅仅只对文件名进行搜索。 请查看 Configuring Attachment Size 页面中的内容来了解文件是如何被索引的。 创建缩略图 当你插入一个上传的文件到页面的时候（例如 Word 文档或者 Excel 电子表格），Confluence 将会为这个文件的内容创建缩略图，这样这个文件可以在页面中被查看或者预览。在 Confluence 服务器上，缩略图的创建时由 Confluence 服务器完成的。 在 Confluence 数据中心，缩略图的创建是在外部进行的，这样能够尽量避免对节点的影响。这是因为在创建缩略图的时候需要消耗比较高的内存和 CPU，尤其针对比较复杂的文件的时候。请查看 Document conversion for Confluence Data Center 页面来获得更多内容。 备注  我们建议你不要在页面或者附件名中使用特殊字符串。如果你使用了特殊的字符串，页面或者附件可能不能在 Confluence 的搜索中找到，同时也有可能导致 Confluence 的功能损坏。 https://www.cwiki.us/display/CONF6ZH/Upload+Files

通过将你的文件上传到 Confluence 能够让你在一个统一的地方分享你项目小组的 PDF 文件，Office 文档，图片以及更多的内容。 自动版本，即时预览，权限控制和全文搜索意味着在网络驱动器上为你的项目小组分享你的内容已经成为了过去。 当你上传一个文件并且附加到当前的页面或者博客页面，这就是为什么文件在 Confluence 中通常被称为附件（attachments）。 你可以添加任何形式的文件，从项目计划，设计草图，视频或者音频文件。你和你的同事可以通过在包含有附件的页面中 对文件进行评论（commenting on files）来进行协同工作。 使用文件 Display Files and Images Manage Files Upload Files Share and Comment on Files Edit Office Files 权限 添加附件（Add Attachment）和 删除附件（Delete Attachment）权限被用来控制谁可以在空间中上传和删除附件。 具有 添加页面（Add Page）或者 添加博客页面（Add Blog）权限的用户可以在这个页面中插入已经存在的附件，但是这个用户不能上传一个新的附件，除非这个用户具有添加附件（Add Attachment）权限。 针对附件的下载，我们没有权限进行控制。如果你有这个方面的需求的话，请参考 KB 中页面 禁用附件下载（disabling the download of attachments）中的内容。   https://www.cwiki.us/display/CONF6ZH/Files

升级失败了？ 如果你需要对你的升级进行回退，你必须首先恢复你老的 Confluence 备份。不要尝试再次进行升级，也不要尝试再次对升级失败的 Confluence 进行再次启动。  在升级过程中遇到的一些常见问题... 因为许可证过期了而不能进行升级 如果你的许可证已经过期了，但是你再升级时候还没有对许可证进行更新，你将会在升级的过程中收到许可证的提示。请参考 upgrading beyond current license period 页面中的内容页来解决这个问题。 协同编辑错误 如果 Synchrony 没有运行，或者你看到了错误，请访问  Troubleshooting Collaborative Editing 页面来获得有关协同编辑的更多信息。最常见的问题就是反向代理没有正确配置或者 Synchrony 使用的 8091 端口不可用。 你也可以参考 Confluence 知识库中的 Upgrade Troubleshooting 内容，或者访问 Atlassian Answers 中 Confluence 社区里面的解决方案。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence+Manually

7. 重新安装服务（仅针对 Windows） 如果你的 Confluence 安装实例在 Windows 中是以服务来运行的话，你需要删除已经存在的 Windows 服务，然后重新安装 Windows 服务。可以通过运行 <install-directory>/bin/service.bat 来进行安装。 请确定你的服务获得最新的 JVM 选项。 8. 重新应用任何修改 如果你对你的 Confluence 安装实例进行了自定义（例如对 SSL 进行了配置，在 server.xml 文件中，或者在 confluence-init.properties 文件中配置了 CATALINA_OPTS 或者 JAVA_OPTS 参数 ），你需要在你安装完成后执行后面的操作： 停止你已经升级的 Confluence 安装实例。 在你新的 Confluence 安装实例的安装目录中应用相关的自定义文件。 重新启动更新后的 Confluence 实例。 我们强烈建议，在对这些配置应用到生产环境之前，在测试环境中对你的自定义配置进行测试，以确定这些自定义的配置能够没有问题的应用到新的 Confluence 版本中。 9. 更新你的反向代理然后检查访问 Confluence 如果你正在计划从 Confluence 5.x 升级 Confluence 6.x 你需要修改你的服务器反向代理（如果你使用了的话），并且添加 Synchrony，Synchrony 在协同编辑中使用。请参考 Proxy and SSL considerations 页面中的内容来获得更多的信息，你需要对你的反向代理来进行配置。一旦你的升级完成，你将可用访问 Confluence（通过代理访问，不是直接访问）并且： 进入  > 基本配置（General Configuration） > 协同编辑（Collaborative editing） 然后检查 Synchrony 的状态是否在运行（running）。 对任何页面在浏览器中进行编辑，并且确定你能够连接 Synchrony。 如果 Synchrony 没有运行或者你可以在编辑器中查看到错误，请访问 Troubleshooting Collaborative Editing 页面获得建议的修改步骤，有可能是你的反向代理没有配置正确。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence+Manually

4. 备份 备份你的数据库，并且确定的你的数据库备份已经被正确的创建了。 如果你的数据库不支持在线备份的话，你需要首先停止 Confluence 的运行。 备份你的 Confluence 安装目录（installation directory）和 Confluence Home 目录（home directory）。  我的 home 目录在哪里？ 5. 下载 Confluence 针对你的操作系统不同，下载正确的安装文件 - https://www.atlassian.com/software/confluence/download 6. 解压文件然后升级 Confluence 停止 Confluence. 如果你希望提供不间断访问的话，请参考 Using read-only mode for site maintenance 页面来将 Confluence 修改为只读模式。 解压（unzip）文件到目录中，这个目录是你的新安装目录，而且这个目录与当前的运行目录不能相同。 备注：针对 Windows 自带的解压归档文件会出现一些问题。我们推荐使用 7Zip 或 Winzip。 编辑  <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties 文件来指向你已经存在的 Confluence home 目录。 如果你现在使用的是 Oracle 或者 MySQL 数据库的话，你需要从你当前已经存在的 Confluence 安装路径下的 JDBC 驱动，拷贝到新的安装路径下面，这个文件位于 confluence/WEB-INF/lib 目录下。 有下面一些更进一步的步骤需要进行： 你通过 Windows 服务（Windows Service）的方式来运行 Confluence  单击这里延伸阅读... 如果你在 Windows 中通过服务的方式来运行 Confluence 的话，你需要在 Windows 的命令行中输入下面的命令： <Installation-Directory>\bin\service.bat remove Confluence 在对 Confluence 进行卸载的时候，停止和删除已经存在的 Confluence 服务非常重要。有关更多Confluence 以 Windows 服务方式运行的方法，请参考 Start Confluence Automatically on Windows as a Service 页面中的内容。  通过 Confluence 安装器删除已经安装的 Confluence 服务，你需要运行 <confluence auto installer installation folder>\UninstallService.bat. 如果你使用 JIRA 应用或者 LDAP 用户管理  单击这里延伸阅读... 如果你使用 Jira 或者 LDAP 来对用户进行管理，从老的 Confluence 安装实例中拷贝下面的文件到新的 Confluence 升级安装实例中。 <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml 如果你使用 Crowd 来进行用户管理  单击这里延伸阅读... 如果你正在使用 Crowd 来对进行用户管理，从你老的 Confluence 安装实例中拷贝下面的文件到新的 Confluence 安装实例： <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml （如果你从 Confluence 2.2 或者后续版本进行升级） <Installation-Directory>/confluence/WEB-INF/classes/crowd.properties 如果你的 Confluence 运行在不同的端口（不是默认的 8090）  单击这里延伸阅读... 如果你的 Confluence 没有运行在 8090端口，请更新 <Installation-Directory>\conf\server.xml 文件来更改你使用的端口。 重启你的 Confluence，你应该不会看见 Confluence 的启动配置向导。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence+Manually

1. 确定你的升级路径 使用下面的表格来确定最佳的升级路径来让你的Confluence 从当前版本升级到最新的 Confluence 版本。 你的版本 推荐升级到 Confluence 的升级路径 2.7 或者更早 升级到 2.7.4 然后升级到 3.5.17，然后按照下面的升级路径。 2.8 到 3.4 升级到 3.5.17，然后按照下面的升级路径。 3.5 升级到 5.0.3 ，然后升级到最新的 Confluence 6。 4.0 到 4.3 升级到 5.10.x ，然后升级到最新的 Confluence 6。 5.0 到 6.x 直接升级到最新的 Confluence 6。 Confluence 是一个主要的升级版本 请确定你在对你生产环境上进行升级之前，已经阅读了 Confluence 6.0 Upgrade Notes，进行了必要的备份，进行了测试你的升级（这边测试升级不应该在生产环境上进行测试）。 2. 完成预升级检查 针对你计划升级的版本查看 Upgrade Notes 页面来了解升级的内容（和版本直接的内容）。 进入  > 基本配置（General Configuration） > 问题检查和支持工具（Troubleshooting and support tools） 来运行健康检查（Confluence 及其后续版本中可用）。  许可证已过期？ 你的软件维护包含在你许可证有效期内，如果你的许可证已经过期了的话，你还是可以使用 Confluence 的，但是在升级之前你需要更新你的许可证。 进入  > 基本配置（General Configuration） > 许可证明细（License Details）根据提示来更新你的许可证。  还在使用的是嵌入式数据库？ 如果你使用的是 嵌入式数据库（测试用），你需要在升级前 整合到其他的数据库（Migrating to Another Database）。 这个数据库是针对 Confluence 进行评估使用的，我们不推荐在生产环境中使用这个数据库。请参考 Embedded H2 Database 来获得更多的信息。  数据库字符集不正确？ 数据库的字符集必须设置为 UTF+8（如果你使用的是 Oracle 数据库，那么需要设置为 AL32UTF8 ）。如果你的数据库字符集不正确的话，你将没有办法升级 Confluence 到当前最新的版本。   进入   然后向下移动到 Confluence 升级检查（Confluence Update Check）来检查你插件的兼容性 选择你计划升级的版本然后单击 检查（Check）。  如果你有不兼容的插件... 3. 在测试环境中升级 Confluence 创建一个从当前生产环境中拷贝数据的策略。 请参考 Create a staging environment for upgrading Confluence 页面中的内容来获得如何创建一个升级的测试环境。 请按照升级的步骤来在你的测试环境中进行升级。 在对正式服务器进行升级之前，测试任何不支持的用户自定义安装的应用，自定义配置（例如主题和布局）和反向代理服务器配置（如果你安装了的话）。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence+Manually

在本指南中，我们将会帮助你使用 zip / tar.gz 文件将你的 Confluence 安装实例在 Windows 或者 Linux 版本中升级到最新的版本。 升级到任何最新的版本都是免费的，如果你具有当前的软件维护许可证的话。请参考我们的 Licensing FAQ 来找到更多的信息。 对 Confluence 进行升级的其他方法： 安装器（Installer） – 升级 Confluence 最简单的方法。 Data Center – 升级你的数据中心集群。 XML 备份文件 不应该 应用到 Confluence 的升级中。 在你对 Confluence 进行升级之前，你需要询问一下下面的问题。 手动升级的方式是否适合你？  告诉我更多... 你可以选择使用安装程序，zip 或者 tar.gz 文件进行升级。在大部分情况下，使用安装程序为升级你 Confluence 安装实例最简便的方法。如果你遇到了下面的情况，那么你需要手动进行升级了： 你现在移动到其他的操作系统或者文件的路径属于本次升级的一部分。 你正在从 Confluence 3.5 或者早期版本上进行升级。 你正在从 Confluence 5.6 或者早期版本上进行升级，但是这些早期版本使用的是 EAR/WAR 分发包来进行部署到一个已经存在的应用服务器上的。 你的系统可以进行升级吗？  告诉我更多... 希望对你当前运行 Confluence 的实例的许可证是否当前，你可以进入  > 基本配置（General Configuration） > 问题检查和支持工具（Troubleshooting and support tools） 来确定你的许可证支持是否过期了。 软件维护（Software maintenance）：在这个时间区间内进行升级。 如果你的许可证支持以及过期了，请在对 Confluence 进行升级之前按照提示的步骤来对许可证进行更新。 我们支持的平台是否被修改了？  告诉我更多... 请查看 Supported Platforms 页面中的内容来获得你升级的 Confluence 支持的平台。在这个页面中我们给出了 Confluence 支持的操作系统，数据库和浏览器。 你应该了解： 如果你需要对你的 Java 进行升级，请记住更新你的的 JAVA_HOME 变量到新的版本路径。 Confluence 的安装器中包含有 Tomcat，因此你不需要单独安装新的 Tomcat。 如果你需要对你的数据库也进行升级的话，请确定将你的数据库升级到 Confluence 支持的数据库版本（或者任何之间的版本）。并且确定对数据库进行必要的修改。 你需要对环境进行修改吗？  告诉我更多... 更新的 Confluence 版本有时候需要要求修改你的环境，例如提供更多的内存或者调整反向代理设置。 你应该了解： 我们使用 升级日志 来告诉你 Confluence 的升级版本将会对你产生什么影响，例如： 修改支持的数据库，内存的需求，和其他的修改将会影响到你的 Confluence 运行环境。 Confluence 将会进行的重大修改和从这次发行版本中删除的内容。 当你升级完成后，你应该对你 Confluence 安装实例马上进行的操作。 针对你进行升级的 Confluence 版本之间，这些信息是非常重要的，你应该有所了解。例如，如果你从 Confluence 的 5.8 版本升级到 5.10 版本，你应该阅读 Confluence 5.9 和 5.10 版本的发行备注。   https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence+Manually

在签名的章节中，我们主要是针对没有完全合并完成余下的为合并内容的异常处理。最常见的情况是内容以及被合并了，但是页面使用 wiki 标记的内容没有被合并，通常这些 wiki 标记的内容使用了 'unmigrated-wiki-markup' 宏。任何使用了这个宏的页面将会显示在合并报告中。这部分的内容还是可以查看和编辑的，但是因为使用了是 wiki 的标记，这部分的内容没有办法使用富文本编辑器的所有功能。 通常遇到这部分的情况的页面是页面中使用了未知的宏（unknown macro）或者使用的宏不能兼容 Confluence 4.x。 有下面 2 种办法可以修正这个问题： 安装一个与 Confluence 4.x 兼容的宏，请参考 Plugin Development Upgrade FAQ for 4.0 页面中的内容。 对页面进行编辑，删除使用不兼容宏的部分的内容。 不管你选择哪种解决方案，你可以尝试强制合并所有的内容（包括模板中的内容）以及使用 'unmigrated-wiki-markup' 宏，这个特性可以在 <Confluence Address>/admin/unmigratedcontent.action 中找到。 备注 我们将 Confluence 的存储格式定义为 'XHTML-based'。实际上，正确的说法应该是被称为 XML，因为 Confluence 存储的格式并不完全与 XHTML 的定义相同。 实际上 Confluence 在存储中还包括了有关宏的自定义元素以及更多。我们使用术语 'XHTML-based' 来进行定义，因为在我们的存储格式中 HTML 占了大部分的内容。 https://www.cwiki.us/display/CONF6ZH/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format