Optimize 69 Viewer Java pages

content/chinese/java/export-conversion/groupdocs-viewer-java-convert-archives-html/_index.md

@@ -1,36 +1,44 @@
 ---
-"date": "2025-04-24"
-"description": "了解如何使用 GroupDocs.Viewer Java 将 ZIP、RAR 压缩包转换为单页和多页 HTML 文件。简化您的文档转换流程。"
-"title": "使用 GroupDocs.Viewer Java 将档案转换为 HTML 综合指南"
-"url": "/zh/java/export-conversion/groupdocs-viewer-java-convert-archives-html/"
-"weight": 1
+date: '2026-02-23'
+description: 了解如何设置每页项目数、嵌入资源 HTML，以及使用 GroupDocs.Viewer Java 批量将压缩包转换为单页或多页 HTML。
+keywords:
+- convert archives to HTML Java
+- GroupDocs.Viewer Java tutorial
+- render ZIP RAR to HTML
+title: 设置每页项目数：使用 GroupDocs.Viewer Java 将归档转换为 HTML
 type: docs
+url: /zh/java/export-conversion/groupdocs-viewer-java-convert-archives-html/
+weight: 1
 ---
-# 使用 GroupDocs.Viewer Java 将档案转换为 HTML：综合指南
 
-## 介绍
+# 设置每页项目数：使用 GroupDocs.Viewer Java 将归档文件转换为 HTML
 
-将 ZIP 或 RAR 等存档文件转换为 Web 友好格式是系统内共享、审阅和集成文档的常见需求。本教程将指导您使用 GroupDocs.Viewer Java——一个专为无缝文档转换而设计的强大库。
+将 ZIP 或 RAR 等归档文件转换为适合网页的 HTML 是在浏览器中直接共享或审阅文档时的常见需求。在本指南中，您将学习**如何设置每页项目数**，如何嵌入资源 HTML 以生成自包含的输出，以及如何使用 GroupDocs.Viewer Java 高效批量转换归档。
 
-**您将学到什么：**
-- 将档案呈现为单页和多页 HTML 格式。
-- 配置 HTML 输出中嵌入资源的选项。
-- 优化渲染过程以提高性能和资源效率。
+![使用 GroupDocs.Viewer for Java 将归档转换为 HTML](/viewer/export-conversion/convert-archives-to-html-java.png)
 
-让我们使用正确的工具和知识来设置 GroupDocs.Viewer Java 来开始。
+## 快速答复
+- **“设置每页项目数” 控制什么？** 它决定了归档中的多少文件或文件夹会出现在每个生成的 HTML 页面上。  
+- **我可以直接在 HTML 中嵌入图像和 CSS 吗？** 可以——使用 `forEmbeddedResources` 选项来嵌入资源 HTML。  
+- **批量转换是否可行？** 完全可以；您可以遍历一组归档文件，并使用相同的设置渲染每个文件。  
+- **使用 GroupDocs.Viewer 是否需要 Maven？** 是的，按下面所示添加 `maven groupdocs viewer` 依赖。  
+- **支持哪些输出格式？** 单页 HTML Java 和多页 HTML Java 均可用。
 
-## 先决条件
+## GroupDocs.Viewer 中的 “设置每页项目数” 是什么？
+**设置每页项目数** 设置属于归档渲染选项。它告诉查看器在生成多页 HTML 文档时，每个 HTML 页面应显示多少归档条目（文件或文件夹）。调整此值有助于在页面大小和导航速度之间取得平衡，尤其是针对大型归档。
 
-开始之前请确保您已具备以下条件：
-- **所需库：** 在您的项目中包含 GroupDocs.Viewer 版本 25.2 或更高版本。
-- **环境设置：** 系统上已配置的 Java 开发工具包 (JDK)。
-- **知识前提：** 对 Java 编程和 Maven 依赖管理有基本的了解。
+## 为什么要嵌入资源 HTML？
+将资源（图像、CSS、字体）直接嵌入 HTML 文件可生成一个单一的可移植文档，无需外部文件即可打开。这对于电子邮件附件、离线查看或将输出嵌入其他网页非常理想。
 
-## 为 Java 设置 GroupDocs.Viewer
+## 前置条件
 
-要使用 GroupDocs.Viewer，请使用 Maven 将其作为依赖项添加到项目中：
+- **必需的库：** 包含 GroupDocs.Viewer 版本 25.2 或更高。  
+- **环境：** 已安装并配置 Java Development Kit (JDK)。  
+- **知识要求：** 基础的 Java 和 Maven 依赖管理。  
 
-**Maven设置：**
+## Maven GroupDocs Viewer 设置
+
+在您的 `pom.xml` 中添加 GroupDocs 仓库和 viewer 依赖：
 
 ```xml
 <repositories>
@@ -50,160 +58,122 @@ type: docs
 </dependencies>
 ```
 
-### 许可证获取
-
-GroupDocs.Viewer 提供多种许可选项：
-- **免费试用：** 从免费试用开始探索其功能。
-- **临时执照：** 获得临时许可证以延长使用期限，不受评估限制。
-- **购买：** 考虑购买许可证以获得完全访问和支持。
-
-**基本初始化：**
+### 获取许可证
+GroupDocs.Viewer 提供 **免费试用链接**、临时许可证或完整购买选项。请选择最符合您项目时间表的方案。
 
-添加 GroupDocs.Viewer 作为依赖项后，在 Java 应用程序中对其进行初始化：
+### 基本初始化
+完成 Maven 设置后，将 viewer 引入您的代码中：
 
 ```java
 import com.groupdocs.viewer.Viewer;
-// 您的初始化代码在这里
+// Your initialization code here
 ```
 
-## 实施指南
-
-一切设置完毕后，让我们逐步实现这些功能。
-
-### 将档案渲染为单页 HTML
-
-**概述：**
-将整个档案转换为单页 HTML 文档，以便轻松共享和查看，而无需浏览多个页面。
-
-#### 步骤 1：定义输出目录路径
-
-设置输出目录：
+## 如何将归档渲染为单页 HTML
 
+### 步骤 1：定义输出目录
 ```java
 Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");
 ```
 
-这指定了渲染的 HTML 的保存位置。
-
-#### 步骤 2：设置单页输出的文件名
-
-定义单页 HTML 文件的名称：
-
+### 步骤 2：设置单页输出的文件名
 ```java
 Path pageFilePathFormat = outputDirectory.resolve("RAR_result.html");
 ```
 
-#### 步骤3：初始化查看器实例
-
-初始化一个 `Viewer` 您的存档文件实例：
-
+### 步骤 3：初始化 Viewer
 ```java
 try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
-    // 进一步的配置步骤如下
+    // Further configuration steps follow
 }
 ```
 
-#### 步骤 4：配置渲染选项
-
-设置将档案呈现为 HTML 格式的选项，将资源直接嵌入 HTML 中：
-
+### 步骤 4：配置渲染选项（嵌入资源 HTML）
 ```java
 HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
 ```
 
-#### 步骤 5：渲染为单个页面
-
-配置查看器以在一页上输出整个档案：
-
+### 步骤 5：渲染为单页
 ```java
 options.setRenderToSinglePage(true);
 viewer.view(options);
 ```
 
-### 将档案渲染为多页 HTML
-
-**概述：**
-对于较大的存档，可将内容拆分为多个页面。此功能有助于跨多个 HTML 文件渲染存档。
-
-#### 步骤 1：定义输出目录路径
-
-重复使用单页实现中的输出目录设置：
+## 如何将归档渲染为多页 HTML 并设置每页项目数
 
+### 步骤 1：复用输出目录
 ```java
 Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");
 ```
 
-#### 步骤 2：设置多页输出的文件名格式
-
-创建文件名格式以适应多个页面，使用 `{0}` 作为页码的占位符：
-
+### 步骤 2：定义多页的文件名格式
 ```java
 Path pageFilePathFormat = outputDirectory.resolve("RAR_result_page_{0}.html");
 ```
 
-#### 步骤3：初始化查看器实例
-
-初始化你的 `Viewer` 类似于单页设置的实例：
-
+### 步骤 3：再次初始化 Viewer
 ```java
 try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
-    // 继续进行多页配置
+    // Continue with multi‑page configuration
 }
 ```
 
-#### 步骤 4：配置多页渲染选项
-
-设置使用嵌入资源渲染成多个页面的选项：
-
+### 步骤 4：配置多页选项（嵌入资源 HTML）
 ```java
 HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
 ```
 
-#### 步骤 5：指定每页项目数
-
-确定每页显示的项目（文件或文件夹）数量。请根据您的需求调整此设置：
-
+### 步骤 5：设置每页项目数（关键操作）
 ```java
-options.getArchiveOptions().setItemsPerPage(10); // 默认值为 16
+options.getArchiveOptions().setItemsPerPage(10); // Default is 16
 viewer.view(options);
 ```
 
 ## 实际应用
 
-- **文档管理系统：** 无缝集成档案查看功能。
-- **门户网站：** 以适合网络的格式为用户提供可下载内容的便捷访问。
-- **协作工具：** 使团队成员能够直接在浏览器中查看共享文档。
+- **文档管理系统：** 添加归档预览功能，无需安装额外的查看器。  
+- **Web 门户：** 为用户提供快速、无需下载的方式来浏览打包文档。  
+- **协作工具：** 让团队直接在浏览器中检查共享的归档文件。  
 
 ## 性能考虑
 
-在实施 GroupDocs.Viewer 时，请考虑以下性能提示：
-- **资源管理：** 监视内存使用情况并在必要时优化垃圾收集设置。
-- **批处理：** 如果要转换大量档案，请批量处理该过程以管理系统负载。
-- **缓存策略：** 对经常访问的文档实施缓存机制以提高速度。
+- **资源管理：** 关注内存使用情况；对于大批量处理，可考虑调优 JVM 的垃圾回收器。  
+- **批量转换归档：** 遍历归档文件列表并调用相同的渲染逻辑，以最大化吞吐量。  
+- **缓存策略：** 如果同一归档被频繁访问，可将渲染后的 HTML 存入缓存。  
+
+## 常见问题
+
+**Q: 什么是 GroupDocs.Viewer Java？**  
+A: 一个多功能库，用于将文档（包括归档）渲染为 HTML、PDF 和图像等格式。
 
-## 结论
+**Q: 我如何获取 GroupDocs.Viewer 的免费试用？**  
+A: 访问[免费试用链接](https://releases.groupdocs.com/viewer/java/)下载并测试。
 
-现在，您已经掌握了如何使用 GroupDocs.Viewer Java 将存档文件转换为单页和多页 HTML 格式。您可以尝试不同的设置，找到最适合您特定用例的设置。如需进一步探索，您可以考虑集成其他功能或尝试 GroupDocs.Viewer 支持的其他文档类型。
+**Q: 我可以转换除归档之外的其他文档类型吗？**  
+A: 可以，viewer 支持 PDF、Word、Excel 等多种格式。
 
-准备好迈出下一步了吗？将这些技巧运用到你的项目中，看看它们如何提升你的工作流程！
+**Q: 如果渲染速度慢该怎么办？**  
+A: 减少每页项目数，启用流式处理，或将归档分成更小的批次处理。
 
-## 常见问题解答部分
+**Q: 我在哪里可以获得帮助或支持？**  
+A: 通过[支持论坛](https://forum.groupdocs.com/c/viewer/9)联系。
 
-1. **什么是 GroupDocs.Viewer Java？**
-   - 一个多功能库，用于将文档呈现为各种格式，包括 HTML。
-2. **如何获得 GroupDocs.Viewer 的免费试用版？**
-   - 访问 [免费试用链接](https://releases.groupdocs.com/viewer/java/) 下载并测试。
-3. **我可以使用 GroupDocs.Viewer Java 转换其他文档类型吗？**
-   - 是的，它支持档案以外的格式，例如 PDF 和 Word 文档。
-4. **如果我的渲染很慢我该怎么办？**
-   - 优化资源使用或调整多页输出每页的项目数。
-5. **如何联系 GroupDocs.Viewer Java 的支持？**
-   - 通过他们的 [支持论坛](https://forum.groupdocs.com/c/viewer/9) 寻求帮助。
+**Q: 是否可以直接在 HTML 中嵌入 CSS 和图像？**  
+A: 当然——如示例所示，使用 `HtmlViewOptions.forEmbeddedResources`。
+
+**Q: 如何批量转换一个归档文件夹？**  
+A: 使用 `for` 循环遍历每个文件，对每次迭代应用相同的 `Viewer` 和 `HtmlViewOptions` 配置。
 
 ## 资源
 
-- **文档：** 深入了解 [GroupDocs 文档](https://docs。groupdocs.com/viewer/java/).
-- **API 参考：** 探索详细的 API 参考 [GroupDocs API](https://reference。groupdocs.com/viewer/java/).
-- **下载：** 从 [下载页面](https://releases。groupdocs.com/viewer/java/).
-- **购买和许可：** 详细了解其购买选项 [购买页面](https://purchase。groupdocs.com/buy).
-- **支持和社区：** 与社区互动或通过以下方式寻求支持 [GroupDocs 论坛](https://forum。groupdocs.com/c/viewer/9).
+- **文档：** 通过[GroupDocs 文档](https://docs.groupdocs.com/viewer/java/)深入了解功能。  
+- **API 参考：** 在[GroupDocs API](https://reference.groupdocs.com/viewer/java/)查看完整 API。  
+- **下载：** 从[下载页面](https://releases.groupdocs.com/viewer/java/)获取最新二进制文件。  
+- **购买与授权：** 在[购买页面](https://purchase.groupdocs.com/buy)查看选项。  
+- **支持与社区：** 在[GroupDocs 论坛](https://forum.groupdocs.com/c/viewer/9)加入讨论。
+
+---
+
+**最后更新：** 2026-02-23  
+**测试版本：** GroupDocs.Viewer 25.2  
+**作者：** GroupDocs