Merge branch 'main' into feat-666

Author: delei

.github/workflows/ci-docs.yml

@@ -0,0 +1,59 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+name: Documentation CI
+
+on:
+  pull_request:
+    paths:
+      - 'website/**'
+
+jobs:
+  build-and-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+          run_install: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Enable corepack
+        working-directory: website
+        run: npm i -g --force corepack && corepack enable
+
+      - name: Install dependencies
+        working-directory: website
+        run: pnpm install
+
+      - name: Build website
+        working-directory: website
+        run: pnpm build
+
+      - name: Lint markdown files
+        uses: DavidAnson/markdownlint-cli2-action@992badcdf24e3b8eb7e87ff9287fe931bcb00c6e
+        with:
+          globs: 'website/**/*.md'
+          config: 'website/.markdownlint-cli2.jsonc'

.github/workflows/markdownlint.yml

@@ -19,17 +19,20 @@
 
 package org.apache.fesod.sheet.metadata.csv;
 
+import java.util.EnumMap;
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.Setter;
 import org.apache.fesod.sheet.metadata.data.DataFormatData;
 import org.apache.poi.ss.usermodel.BorderStyle;
+import org.apache.poi.ss.usermodel.CellPropertyType;
 import org.apache.poi.ss.usermodel.CellStyle;
 import org.apache.poi.ss.usermodel.Color;
 import org.apache.poi.ss.usermodel.FillPatternType;
 import org.apache.poi.ss.usermodel.Font;
 import org.apache.poi.ss.usermodel.HorizontalAlignment;
 import org.apache.poi.ss.usermodel.VerticalAlignment;
+import org.apache.poi.ss.util.CellUtil;
 
 /**
  * csv cell style
@@ -279,4 +282,12 @@ public void setShrinkToFit(boolean shrinkToFit) {}
     public boolean getShrinkToFit() {
         return false;
     }
+
+    @Override
+    public EnumMap<CellPropertyType, Object> getFormatProperties() {
+        return CellUtil.getFormatProperties(this);
+    }
+
+    @Override
+    public void invalidateCachedProperties() {}
 }

fesod/src/main/java/org/apache/fesod/sheet/metadata/csv/CsvCellStyle.java

@@ -20,7 +20,6 @@
 package org.apache.fesod.sheet.write.metadata.fill;
 
 import java.util.List;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.Setter;
 import org.apache.fesod.sheet.enums.WriteTemplateAnalysisCellTypeEnum;
@@ -32,7 +31,6 @@
  **/
 @Getter
 @Setter
-@EqualsAndHashCode
 public class AnalysisCell {
     private int columnIndex;
     private int rowIndex;

fesod/src/main/java/org/apache/fesod/sheet/write/metadata/fill/AnalysisCell.java

@@ -53,7 +53,7 @@
         <maven.javadoc.skip>true</maven.javadoc.skip>
         <maven.test.skip>true</maven.test.skip>
         <commons-csv.version>1.11.0</commons-csv.version>
-        <poi.version>5.4.1</poi.version>
+        <poi.version>5.5.1</poi.version>
         <ehcache.version>3.9.11</ehcache.version>
         <commons-io.version>2.16.1</commons-io.version>
         <slf4j-api.version>1.7.36</slf4j-api.version>

pom.xml

@@ -44,6 +44,7 @@ Replace your existing dependency with Apache Fesod (Incubating):
 | **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod | 1.3.0+ |
 
 **Maven:**
+
 ```xml
 <dependency>
     <groupId>org.apache.fesod</groupId>
@@ -53,6 +54,7 @@ Replace your existing dependency with Apache Fesod (Incubating):
 ```
 
 **Gradle:**
+
 ```gradle
 implementation 'org.apache.fesod:fesod:1.3.0'
 ```
@@ -101,23 +103,27 @@ Replace deprecated entry point classes with FesodSheet.
 Utilize the deprecated alias classes for a phased migration approach.
 
 **Phase 1: Dependency Update Only**
+
 - Update Maven/Gradle dependency to Apache Fesod (Incubating)
 - Keep using FastExcel classes (now deprecated aliases)
 - Update package imports only
 - Run comprehensive tests to verify compatibility
 
 **Phase 2: Class Name Migration**
+
 - Progressively replace deprecated classes with FesodSheet
 - Use IDE refactoring tools for bulk renaming
 - Migrate module by module or feature by feature
 - Maintain thorough test coverage throughout
 
 **Phase 3: Cleanup**
+
 - Remove all references to deprecated classes
 - Resolve deprecation warnings
 - Update documentation and code comments
 
 **Benefits:**
+
 - Lower risk through incremental changes
 - Easier rollback if issues arise
 - Minimal disruption to ongoing development

website/docs/migration/from-fastexcel.md

@@ -26,5 +26,9 @@
   "sidebar.docs.category.fesod-sheet": {
     "message": "Fesod Sheet",
     "description": "The label for category fesod-sheet in sidebar docs"
+  },
+  "sidebar.docs.category.migration": {
+    "message": "Migration",
+    "description": "The label for category migration in sidebar docs"
   }
 }

website/i18n/en/docusaurus-plugin-content-docs/current.json

@@ -26,5 +26,9 @@
   "sidebar.docs.category.fesod-sheet": {
     "message": "Fesod Sheet",
     "description": "The label for category fesod-sheet in sidebar docs"
+  },
+  "sidebar.docs.category.migration": {
+    "message": "迁移",
+    "description": "The label for category migration in sidebar docs"
   }
 }

website/i18n/zh-cn/docusaurus-plugin-content-docs/current.json

@@ -44,6 +44,7 @@ keywords: [fesod, 迁移, fastexcel, apache, excel, 升级]
 | **Apache Fesod (Incubating)** ✅    | org.apache.fesod | fesod      | 1.3.0+ |
 
 **Maven 配置:**
+
 ```xml
 <dependency>
     <groupId>org.apache.fesod</groupId>
@@ -53,6 +54,7 @@ keywords: [fesod, 迁移, fastexcel, apache, excel, 升级]
 ```
 
 **Gradle 配置:**
+
 ```gradle
 implementation 'org.apache.fesod:fesod:1.3.0'
 ```
@@ -101,23 +103,27 @@ implementation 'org.apache.fesod:fesod:1.3.0'
 利用已废弃的别名类进行分阶段迁移。
 
 **阶段 1: 仅更新依赖**
+
 - 将 Maven/Gradle 依赖更新为 Apache Fesod (Incubating)
 - 继续使用 FastExcel 类(现为已废弃的别名)
 - 仅更新包导入
 - 运行全面测试以验证兼容性
 
 **阶段 2: 类名迁移**
+
 - 逐步将已废弃的类替换为 FesodSheet
 - 使用 IDE 重构工具进行批量重命名
 - 逐个模块或逐个功能进行迁移
 - 在整个过程中保持全面的测试覆盖
 
 **阶段 3: 清理**
+
 - 删除所有对已废弃类的引用
 - 解决废弃警告
 - 更新文档和代码注释
 
 **优势:**
+
 - 通过增量更改降低风险
 - 如果出现问题更容易回滚
 - 对正在进行的开发影响最小