Optimize 23 Watermark Java pages

.github/workflows/production.yml

@@ -26,23 +26,25 @@ jobs:
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-            submodules: true  # Fetch Hugo themes
-            fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+            submodules: true
+            fetch-depth: 0
       - name: Checkout theme repo
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
         with:
           repository: groupdocs/tutorials-theme
           token: ${{ secrets.REPO_TOKEN }}
           fetch-depth: 0
           path: themes/tutorials-theme
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       - name: Install Theme Dependencies
         run: npm install
-        working-directory: ./themes/tutorials-theme      
-      # Step 2 - Sets up the latest version of Hugo
+        working-directory: ./themes/tutorials-theme
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -54,7 +56,6 @@ jobs:
         run:  npm install -D --save postcss-cli
       - name: Install Dependicies3
         run:  npm install -D postcss
-      # Also specifies the theme we want to use
       - name: Build
         run: hugo --configDir config/watermark --environment production --minify
 

.github/workflows/staging.yml

@@ -39,7 +39,11 @@ jobs:
           token: ${{ secrets.REPO_TOKEN }}
           ref: beta
           fetch-depth: 0
-          path: themes/tutorials-theme      
+          path: themes/tutorials-theme 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       # Step 2 - Sets up the latest version of Hugo
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2

content/chinese/java/spreadsheet-document-watermarking/groupdocs-watermark-java-wordart-excel/_index.md

@@ -0,0 +1,226 @@
+---
+date: '2026-07-01'
+description: 了解如何使用 Java 和 GroupDocs.Watermark 为 Excel 文件添加水印，包括逐步的说明来在 Java 中添加 Excel
+  水印。
+keywords:
+- how to watermark excel
+- java add excel watermark
+- GroupDocs.Watermark
+- Excel WordArt watermark
+schemas:
+- author: GroupDocs
+  dateModified: '2026-07-01'
+  description: Learn how to watermark Excel files using Java with GroupDocs.Watermark,
+    including step‑by‑step instructions to java add excel watermark.
+  headline: How to Watermark Excel with WordArt – GroupDocs.Watermark Java
+  type: TechArticle
+- description: Learn how to watermark Excel files using Java with GroupDocs.Watermark,
+    including step‑by‑step instructions to java add excel watermark.
+  name: How to Watermark Excel with WordArt – GroupDocs.Watermark Java
+  steps:
+  - name: Load the Excel Document
+    text: Instantiate a `Watermarker` object with the path to your `.xlsx` file and
+      a `SpreadsheetLoadOptions` instance. This tells the library to treat the file
+      as a spreadsheet and prepares it for watermarking.
+  - name: Create a TextWatermark
+    text: Create a `TextWatermark` object, passing the WordArt text (e.g., “CONFIDENTIAL”)
+      and a `Font` that defines size, style, and color. GroupDocs.Watermark automatically
+      converts this text into a WordArt drawing.
+  - name: Configure Modern WordArt Options
+    text: Use `SpreadsheetWatermarkModernWordArtOptions` to specify the target worksheet
+      (by index or name), rotation angle, opacity, and scaling. Setting `setRotateAngle(45)`
+      and `setOpacity(0.3)` yields a subtle diagonal watermark that doesn’t obscure
+      cell content.
+  - name: Add the Watermark and Save
+    text: Call `watermarker.add(watermark, options)` to apply the WordArt to the selected
+      sheet, then invoke `watermarker.save("output.xlsx")`. The `save` method writes
+      a new workbook while leaving the original untouched.
+  type: HowTo
+- questions:
+  - answer: Yes – iterate over each sheet index and call `watermarker.add(watermark,
+      options)` with the corresponding `SpreadsheetWatermarkModernWordArtOptions`.
+    question: Can I apply the same WordArt watermark to all worksheets in a workbook?
+  - answer: No – the watermark is added as a drawing layer, leaving all cell data,
+      formulas, and pivot configurations untouched.
+    question: Does the watermark affect Excel formulas or pivot tables?
+  - answer: The library supports **50+ formats**, including CSV, XLS, ODS, and even
+      PDF, enabling cross‑format watermarking with the same API.
+    question: What file formats can GroupDocs.Watermark handle besides XLSX?
+  - answer: Adjust the `Color` property of the `Font` object when creating the `TextWatermark`,
+      e.g., `new Color(0, 120, 215)` for a corporate blue.
+    question: How do I change the watermark color to match my corporate palette?
+  - answer: Absolutely – add each watermark sequentially with its own options; they
+      will be layered in the order of insertion.
+    question: Is it possible to add multiple watermarks (e.g., logo + text) to the
+      same sheet?
+  type: FAQPage
+title: 如何使用 WordArt 为 Excel 添加水印 – GroupDocs.Watermark Java
+type: docs
+url: /zh/java/spreadsheet-document-watermarking/groupdocs-watermark-java-wordart-excel/
+weight: 1
+---
+
+# 如何使用 WordArt 为 Excel 添加水印 – GroupDocs.Watermark Java
+
+在 Excel 工作簿中嵌入水印是一种可靠的方式，可保护机密数据、强化品牌或指示文档状态。在本指南中，您将学习使用 Java 的 GroupDocs.Watermark 库为 **如何为 Excel 添加水印** 文件，采用现代 WordArt 样式，在任何工作表上都显得专业。我们将逐步介绍前置条件、具体的 API 调用、性能技巧以及常见陷阱，帮助您快速自信地实现该解决方案。
+
+## 快速答案
+- **我可以在不编写 XML 的情况下添加 WordArt 水印吗？** 是的 – GroupDocs.Watermark 为您处理所有底层细节。  
+- **需要哪个库版本？** 版本 24.11 或更高支持现代 WordArt API。  
+- **开发时需要许可证吗？** 免费试用许可证可用于测试；生产环境需要正式许可证。  
+- **水印会影响公式吗？** 不会 – 水印以绘图层的形式呈现，不会触及单元格数据。  
+- **该过程是线程安全的吗？** 是的，只要每个线程使用各自的 `Watermarker` 实例。
+
+## 什么是“如何为 Excel 添加水印”？
+**“如何为 Excel 添加水印”** 指的是以编程方式在 Excel 工作簿中插入视觉覆盖层，以标示所有权、机密性或版本状态的过程。使用 GroupDocs.Watermark，您可以在一次方法调用中应用此覆盖层，而不更改底层数据。
+
+## 为什么在 Excel 中使用 WordArt 水印？
+WordArt 水印提供现代、风格化的外观，比普通文本或图像水印更突出。GroupDocs.Watermark 支持 **50+ 输入和输出格式**，并且能够在不将整个工作簿加载到内存的情况下处理高达 **500 MB** 的 Excel 文件，兼具视觉冲击力和高性能。
+
+## 前置条件
+- **Java Development Kit (JDK) 8+** 已在您的机器上安装。  
+- **GroupDocs.Watermark for Java** 版本 24.11 或更高（从官方发布页面下载）。  
+- 如 **IntelliJ IDEA** 或 **Eclipse** 等 IDE，用于编辑和构建项目。  
+- 用于解锁水印功能的 **临时或正式许可证** 密钥。
+
+### 必需的库和依赖项
+在您的 `pom.xml` 中添加 GroupDocs.Watermark Maven 仓库和依赖项：
+
+```xml
+<repositories>
+   <repository>
+      <id>repository.groupdocs.com</id>
+      <name>GroupDocs Repository</name>
+      <url>https://releases.groupdocs.com/watermark/java/</url>
+   </repository>
+</repositories>
+
+<dependencies>
+   <dependency>
+      <groupId>com.groupdocs</groupId>
+      <artifactId>groupdocs-watermark</artifactId>
+      <version>24.11</version>
+   </dependency>
+</dependencies>
+```
+
+如果您更喜欢手动设置，也可以直接从 [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/) 页面获取 JAR 包。
+
+## 如何使用 GroupDocs.Watermark Java 为 Excel 工作表添加 WordArt 水印？
+`SpreadsheetLoadOptions` 指定电子表格文件的加载选项。  
+`TextWatermark` 表示可以渲染为 WordArt 的文本水印。  
+`SpreadsheetWatermarkModernWordArtOptions` 配置 WordArt 的外观和目标工作表。  
+`add` 方法将水印应用到文档。  
+`save` 方法将修改后的工作簿写入文件。
+
+使用 `SpreadsheetLoadOptions` 加载 Excel 工作簿，创建包含所需 WordArt 文本的 `TextWatermark`，配置 `SpreadsheetWatermarkModernWordArtOptions` 以定位到第一个工作表，最后调用 `add` 再调用 `save`。整个流程仅需四次 API 调用，并自动保留公式、图表和单元格格式，同时将水印渲染为可缩放的矢量图形。
+
+## 步骤实现
+
+### 步骤 1：加载 Excel 文档
+实例化一个 `Watermarker` 对象，传入 `.xlsx` 文件的路径以及 `SpreadsheetLoadOptions` 实例。这告诉库将文件视为电子表格，并为水印做准备。
+
+### 步骤 2：创建 TextWatermark
+创建一个 `TextWatermark` 对象，传入 WordArt 文本（例如 “CONFIDENTIAL”）和定义大小、样式、颜色的 `Font`。GroupDocs.Watermark 会自动将此文本转换为 WordArt 绘图。
+
+### 步骤 3：配置现代 WordArt 选项
+使用 `SpreadsheetWatermarkModernWordArtOptions` 指定目标工作表（按索引或名称）、旋转角度、不透明度和缩放。设置 `setRotateAngle(45)` 和 `setOpacity(0.3)` 可得到细微的对角线水印，不会遮挡单元格内容。
+
+### 步骤 4：添加水印并保存
+调用 `watermarker.add(watermark, options)` 将 WordArt 应用于选定的工作表，然后调用 `watermarker.save("output.xlsx")`。`save` 方法会写入一个新工作簿，原始文件保持不变。
+
+## 如何配置 WordArt 选项以获得最佳外观？
+`WordArtOptions` 保存 WordArt 水印的样式属性。  
+设置 `WordArtOptions` 的属性，如 `fontFamily`、`fontSize`、`color`、`rotateAngle` 和 `opacity`，以符合您的品牌指南。对于平衡的外观，**36 pt** 的字体大小、**0.25** 的半透明不透明度以及 **-30°** 的旋转在标准 A4 大小的工作表上效果良好。
+
+## 如何在对大型 Excel 文件加水印时确保性能？
+`Watermarker` 是加载和保存文档的主要类。  
+对每个文件复用单个 `Watermarker` 实例，使用 `watermarker.close()` 及时关闭，并通过启用流模式 (`setEnableStreaming(true)`) 避免将整个工作簿加载到内存。即使是包含数百个工作表的工作簿，此方法也能将内存消耗控制在 **100 MB** 以下。此外，仅在需要加水印的子集时逐个处理工作表，以进一步降低内存使用。
+
+## 实际应用
+1. **文档安全** – 通过叠加 “CONFIDENTIAL” WordArt 印章，防止财务模型未经授权的分发。  
+2. **品牌强化** – 在每份面向客户的报告上添加公司标志的样式化文本。  
+3. **版本控制** – 在工作表上直接显示 “DRAFT” 或 “FINAL” 状态，明确正在审阅的版本。
+
+## 性能考虑因素
+- **资源管理** – 始终关闭 `Watermarker` 以释放文件句柄。  
+- **批量处理** – 将相同水印应用于多个工作簿时，复用 `TextWatermark` 实例以减少对象创建开销。  
+- **大文件** – 对于大于 **200 MB** 的文件，启用流模式并逐个处理工作表，以保持堆内存使用低。
+
+## 常见问题与解决方案
+- **水印不可见** – 确认工作表索引与目标工作表匹配；默认是第一张工作表 (`0`)。  
+- **文字失真** – 确保所选字体已在服务器上安装；缺失的字体会导致回退渲染。  
+- **许可证错误** – `License.setLicense` 注册许可证文件以解锁全部功能。测试时使用有效的试用密钥；生产部署必须通过 `License.setLicense("path/to/license.lic")` 注册永久许可证。
+
+## 常见问答
+
+**Q: 我可以将相同的 WordArt 水印应用于工作簿中的所有工作表吗？**  
+A: 可以 – 遍历每个工作表索引，并使用相应的 `SpreadsheetWatermarkModernWordArtOptions` 调用 `watermarker.add(watermark, options)`。
+
+**Q: 水印会影响 Excel 公式或数据透视表吗？**  
+A: 不会 – 水印作为绘图层添加，不会触及任何单元格数据、公式和数据透视表配置。
+
+**Q: 除了 XLSX，GroupDocs.Watermark 还能处理哪些文件格式？**  
+A: 该库支持 **50+ 种格式**，包括 CSV、XLS、ODS，甚至 PDF，使用相同的 API 实现跨格式水印。
+
+**Q: 我如何更改水印颜色以匹配公司的配色方案？**  
+A: 在创建 `TextWatermark` 时调整 `Font` 对象的 `Color` 属性，例如 `new Color(0, 120, 215)` 可得到公司蓝。
+
+**Q: 能否在同一工作表上添加多个水印（例如徽标+文字）？**  
+A: 完全可以 – 为每个水印使用各自的选项依次添加；它们会按照插入顺序层叠。
+
+## 结论
+现在，您已经掌握了一套完整的、可用于生产环境的 **如何为 Excel 添加水印** 方法，使用 Java 的 GroupDocs.Watermark，具备现代 WordArt 样式、性能最佳实践和故障排除技巧。尝试不同的字体、颜色和旋转角度以匹配您的品牌，并考虑将此方法扩展为一次性批量处理多个工作簿。
+
+---
+
+**最后更新：** 2026-07-01  
+**测试环境：** GroupDocs.Watermark 24.11 for Java  
+**作者：** GroupDocs  
+
+**资源**  
+- [文档](https://docs.groupdocs.com/watermark/java/)  
+- [API 参考](https://reference.groupdocs.com/watermark/java)  
+- [下载 GroupDocs.Watermark for Java](https://releases.groupdocs.com/watermark/java/)  
+- [GitHub 仓库](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java)  
+- [免费支持论坛](https://forum.groupdocs.com/c/watermark/10)  
+- [获取临时许可证](https://purchase.groupdocs.com/temporary-license/)
+
+```java
+import com.groupdocs.watermark.Watermarker;
+import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
+
+// Initialize load options and watermarker.
+SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
+Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);
+```
+
+```java
+import com.groupdocs.watermark.watermarks.Font;
+import com.groupdocs.watermark.watermarks.TextWatermark;
+
+// Configure font and watermark text.
+TextWatermark textWatermark = new TextWatermark("Test watermark", new Font("Arial", 8));
+```
+
+```java
+import com.groupdocs.watermark.options.SpreadsheetWatermarkModernWordArtOptions;
+
+// Apply watermark to the first sheet.
+SpreadsheetWatermarkModernWordArtOptions options = new SpreadsheetWatermarkModernWordArtOptions();
+options.setWorksheetIndex(0);
+```
+
+```java
+// Add watermark and save the watermarked file.
+watermarker.add(textWatermark, options);
+watermarker.save("YOUR_OUTPUT_DIRECTORY/watermarked_spreadsheet.xlsx");
+// Release resources.
+watermarker.close();
+```
+
+## 相关教程
+
+- [如何使用 GroupDocs.Watermark for Java 为 Excel 工作表添加文本水印](/watermark/java/spreadsheet-document-watermarking/add-text-watermark-excel-groupdocs-watermark-java/)
+- [使用 GroupDocs.Watermark Java SDK 为 Excel 电子表格添加图像水印](/watermark/java/spreadsheet-document-watermarking/add-image-watermark-spreadsheet-groupdocs-java/)
+- [GroupDocs.Watermark Java 的 Excel 电子表格水印教程](/watermark/java/spreadsheet-document-watermarking/)