Docs for the released version 2.8.0

xuri · Aug 27, 2023 · 93b9612 · 93b9612
1 parent fabbb05
commit 93b9612
Show file tree

Hide file tree

Showing 66 changed files with 818 additions and 210 deletions.
diff --git a/ar/README.md b/ar/README.md
@@ -8,8 +8,8 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج
 - المساله: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues)
 - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
 - التراخيص: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
-- الإصدار الأخير: [v2.7.1](https://github.com/xuri/excelize/releases/latest)
-- وقت تحديث المستند: أغسطس 4, 2023
+- الإصدار الأخير: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
+- وقت تحديث المستند: أغسطس 28, 2023
 
 ## بعثة المشروع
 

diff --git a/ar/SUMMARY.md b/ar/SUMMARY.md
@@ -233,7 +233,7 @@
 * [أداء](performance.md)
 * [إسهام](contribution.md)
 * الإصدارات الصادرة
-  * [v2.8.0](releases/v2.8.0.md)
+  * [v2.8.0 (2023-08-28)](releases/v2.8.0.md)
   * [v2.7.1 (2023-04-10)](releases/v2.7.1.md)
   * [v2.7.0 (2023-01-09)](releases/v2.7.0.md)
   * [v2.6.1 (2022-08-22)](releases/v2.6.1.md)

diff --git a/ar/base/installation.md b/ar/base/installation.md
@@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15
 v2.0.2 ~ v2.3.2 | 1.10
 v1.0.0 ~ v2.0.1 | 1.6
 
-استخدام أحدث إصدار Excelize مكتبة تتطلب الانتقال الإصدار 1.16 أو أحدث.
+استخدام أحدث إصدار Excelize مكتبة تتطلب الانتقال الإصدار 1.16 أو أحدث. لاحظ أن هناك بعض [التغييرات غير المتوافقة](https://github.com/golang/go/issues/61881) في Go 1.21.0، ولا يمكن لهذه المكتبة العمل مع هذا الإصدار، إذا كنت تستخدم Go 1.21.x، فيرجى الترقية إلى Go 1.21.1 والإصدار الأحدث.
 
 - التركيب
 

diff --git a/ar/data.md b/ar/data.md
@@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"})
 f.AddDataValidation("Sheet1", dv)
 ```
 
+إذا قمت بكتابة العناصر في مربع حوار التحقق من صحة البيانات (قائمة محددة)، فإن الحد الأقصى هو 255 حرفًا، بما في ذلك الفواصل. إذا كانت صيغة مصدر قائمة التحقق من صحة البيانات الخاصة بك تتجاوز الحد الأقصى للطول، فيرجى تعيين القيم المسموح بها في خلايا ورقة العمل، واستخدام وظيفة `SetSqrefDropList` لتعيين المرجع للخلايا الخاصة بها.
+
 المثال 4 ، قم بتعيين التحقق من صحة البيانات على `Sheet1!A7:B8` باستخدام إعدادات مصدر معايير التحقق `Sheet1!E1:E3` ، قم بإنشاء قائمة منسدلة داخل الخلية عن طريق السماح بمصدر القائمة:
 
 <p align="center"><img width="654" src="./images/data_validation_04.png" alt="تأكيد صحة البيانات"></p>
@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3")
 f.AddDataValidation("Sheet1", dv)
 ```
 
+هناك حدود لعدد العناصر التي ستظهر في القائمة المنسدلة للتحقق من صحة البيانات: يمكن أن تظهر القائمة حتى تعرض 32768 عنصرًا من قائمة في ورقة العمل. إذا كنت بحاجة إلى المزيد من العناصر، فيمكنك إنشاء قائمة منسدلة تابعة، مقسمة حسب الفئة.
+
 ## الحصول على التحقق من صحة البيانات {#GetDataValidations}
 
 ```go

diff --git a/ar/releases/v2.8.0.md b/ar/releases/v2.8.0.md
@@ -1,34 +1,50 @@
 # Excelize v2.8.0
 
-* سيصدر: 28 أغسطس 2023
+* صدر هذا يوم: 28 أغسطس 2023
+* صدر في GitHub: [https://github.com/xuri/excelize/releases/tag/v2.8.0](https://github.com/xuri/excelize/releases/tag/v2.8.0)
 
 ## ملاحظات الإصدار
 
 التغييرات الأكثر بروزاً في هذا الإصدار:
 
 ### كسر التغييرات
 
-* التغييرات الفاصلة: إعادة تسمية المتغير الذي تم تصديره `ErrTableNameLength` إلى `ErrNameLength`
-* كسر التغييرات: إعادة تسمية النوع المُصدَّر `PaneOptions` إلى `Selection`
+* إعادة تسمية المتغير الذي تم تصديره `ErrTableNameLength` إلى `ErrNameLength`
+* إعادة تسمية النوع المُصدَّر `PaneOptions` إلى `Selection`
+* أعد تسمية الحقل `Runs` إلى `Paragraph` في نوع بيانات `Comment` المُصدَّر
 * قم بإزالة الحقل `Lang` في نوع بيانات `Style`
+* تمت إزالة نوع بيانات `ChartTitle` المُصدَّر ، واستخدام نوع بيانات `RichTextRun` بدلاً منه
+* تم تغيير نوع البيانات لـ `DecimalPlaces` إلى مؤشر عدد صحيح
 * قم بتغيير النقطة الافتراضية إلى عامل تحويل البكسل ، وحل المشكلات [#279](https://github.com/xuri/excelize/issues/279) و [#1536](https://github.com/xuri/excelize/issues/1536)
+* تغيير توقيع الوظيفة `AddShape`: غير `func (f *File) AddShape(sheet, cell string, opts *Shape) error` إلى `func (f *File) AddShape(sheet string, opts *Shape) error`
 
 ### ميزات بارزة
 
-* إضافة متغير خطأ جديد تم تصديره `ErrExistsTableName`
+* إضافة متغيرات خطأ جديدة تم تصديرها `ErrExistsTableName` و `ErrorFormControlValue`
 * إضافة خيارات جديدة `ShortDatePattern` و `LongDatePattern` و `LongTimePattern` و `CultureInfo` في نوع البيانات `Options` والمشكلة ذات الصلة [#1199](https://github.com/xuri/excelize/issues/1199)
 * إضافة تعداد نوع البيانات الجديدة المُصدرة `CultureName` لرمز البلد
-* دعم العنصر النائب ، والحشو ، وتقريب الأرقام ، وسلسلة العملة ، وسيطة التبديل بواسطة رمز تنسيق الرقم المحدد ، والمشكلة ذات الصلة [#660](https://github.com/xuri/excelize/issues/660)
+* دالات جديدة تدعم `GetTables` و `DeleteTable` للحصول على الجداول وإزالتها ، مشكلة ذات صلة [#674](https://github.com/xuri/excelize/issues/674) و [#1454](https://github.com/xuri/excelize/issues/1454)
+* وظيفة جديدة تدعم `GetStyle` للحصول على تعريفات الأنماط ، مشكلة ذات صلة [#314](https://github.com/xuri/excelize/issues/314) و [#1520](https://github.com/xuri/excelize/issues/1520) و [#1521](https://github.com/xuri/excelize/issues/1521)
+* دعم تطبيق قيمة الخلية مع العنصر النائب والحشو وأرقام التقريب والعملة والمحاسبة وتنسيق رقم وسيطة التبديل ودعم تطبيق تنسيق رقم التاريخ والوقت لعلامات اللغة 812 ، والمشكلة ذات الصلة [#660](https://github.com/xuri/excelize/issues/660)
+* دعم 10 وظائف صيغة جديدة: ARRAYTOTEXT و FORECAST و FORECAST.LINEAR و FREQUENCY و INTERCEPT و ODDFYIELD و ODDLPRICE و ODDLYIELD و PROB و VALUETOTEXT
 * أضف تفاصيل حدود طول مسار الملف في رسالة الخطأ
 * وظيفة جديدة دعم `GetPanes` للحصول على أجزاء الأوراق وعرض التحديد
+* دعم الوظائف الجديدة `AddFormControl` و `GetFormControls` و `DeleteFormControl` لعناصر تحكم النموذج ، القضايا ذات الصلة [#301](https://github.com/xuri/excelize/issues/301) و [#1169](https://github.com/xuri/excelize/issues/1169)
 * تدعم وظيفة `AddChart` تعيين العناوين الأساسية والمشكلات ذات الصلة [#1553](https://github.com/xuri/excelize/issues/1553)
+* تدعم وظيفة `AddChart` إنشاء مخطط بمحور سلسلة ثانوي ، مشكلة ذات صلة [#518](https://github.com/xuri/excelize/issues/518)
+* تدعم وظيفة `AddChart` التنسيق وتعيين عناوين النص المنسق للمخطط ، المشكلة ذات الصلة [#1588](https://github.com/xuri/excelize/issues/1588)
+* إضافة تحقق من نوع الشكل لوظيفة `AddShape` ، سيتم إرجاع خطأ إذا لم يتم تحديد نوع الشكل
+* دعم قراءة قيم الخلية المنسقة بواسطة تنسيق رقم التقويم الياباني ، والمشكلة ذات الصلة [#1590](https://github.com/xuri/excelize/issues/1590)
+* تدعم وظيفة `GetPictures` قراءة صور ارتساء خلية واحدة ، والمشكلة ذات الصلة [#1585](https://github.com/xuri/excelize/issues/1585)
+* تدعم وظيفة `NewConditionalStyle` إنشاء تنسيق شرطي بتنسيق الأرقام والحماية ، والمشكلة ذات الصلة [#1610](https://github.com/xuri/excelize/issues/1610)
 
 ### تحسين التوافق
 
 * دعم فحص طول قيمة الخلية بأحرف متعددة البايت ، والمسألة ذات الصلة [#1517](https://github.com/xuri/excelize/issues/1517)
 * منع إنشاء جداول مكررة واسم محدد بنفس الاسم
 * قم بتحسين توافق حجم مربع تعليق الخلية مع KingSoft WPS
 * دعم الرجوع إلى عرض العمود الافتراضي في خاصية تنسيق الورقة ، والمشكلة ذات الصلة [#1536](https://github.com/xuri/excelize/issues/1536)
+* جعل حالة الأحرف حساسة لمسار XML لورقة العمل الداخلية لتحسين التوافق ، والمشكلة ذات الصلة [#1591](https://github.com/xuri/excelize/issues/1591)
 
 ### إصلاحات الأخطاء
 
@@ -38,11 +54,18 @@
 * إصلاح ظروف السباق لوظائف أمان التزامن
 * إصلاح غير صحيح جولة مللي ثانية لوقت التاريخ
 * إصلاح النتيجة المنسقة بأرقام غير صحيحة للتاريخ والوقت بـ 12 ساعة في AM
-* تصحيح استثناء حساب الصيغة غير الصحيحة النتيجة المتوقعة
+* إصلاح دالات الصيغة غير الصحيحة نتيجة SUMIFS و AVERAGEIFS وحل المشكلة [#1564](https://github.com/xuri/excelize/issues/1564)
+* إصلاح مشكلات الأولوية الحسابية الأساسية في محرك الحساب ، وحل المشكلات [#1599](https://github.com/xuri/excelize/issues/1599)
 * إصلاح مشكلة مرجع ورقة العمل المتقاطعة لمحرك حساب الصيغة
 * إصلاح مشكلة ضبط الجدول عند حل المشكلة بعد إزالة الصفوف [#1539](https://github.com/xuri/excelize/issues/1539)
 * دعم للحصول على صور متعددة في خلية واحدة ، حل المشكلة [#1548](https://github.com/xuri/excelize/issues/1548)
-* إصلاح رقم الصف غير الصحيح عند الحصول على موضع الكائن ، وحل المشكلة [#1560](https://github.com/xuri/excelize/issues/1560)
+* إصلاح وضع الصورة المضافة كان غير صحيح في بعض الحالات ، حل المشكلة [#1560](https://github.com/xuri/excelize/issues/1560)
+* دعم تعديل الصيغة عند إدراج الأعمدة والصفوف ، وإصلاح تلف المصنف الناتج عن إدراج الأعمدة أو الصفوف الناتجة ، وحل المشكلة [#1565](https://github.com/xuri/excelize/issues/1565)
+* دالة الصيغة CONCAT ، CONCATENATE تدعم تسلسل قيم الخلايا المتعددة ، وحل المشكلة [#1569](https://github.com/xuri/excelize/issues/1569)
+* إصلاح الصيغة غير الصحيحة لحساب النتائج على دالة وسيطة متداخلة تقوم بإرجاع نتيجة رقمية ، وحل المشكلة [#1582](https://github.com/xuri/excelize/issues/1582)
+* إصلاح مشكلات عداد الكائنات الرسومية الداخلية التي تسببت في تكرار الصورة المضافة وحل المشكلة [#1584](https://github.com/xuri/excelize/issues/1584)
+* تم إصلاح نتيجة خلية تاريخ القراءة والوقت بشكل غير صحيح بسبب مشكلة تقريب الساعات ، وحل المشكلة [#1587](https://github.com/xuri/excelize/issues/1587)
+* أصلح حالة الذعر عند دمج الخلايا بنفس محور البداية والنهاية
 
 ### تحسين الأداء
 
@@ -70,3 +93,7 @@
 * @yicixin (壹次心)
 * @vb6iscool
 * @chengcxy (chengxinyao)
+* @lidp20
+* @JDavidVR (David)
+* @fsfsx
+* @cnmlgbgithub
diff --git a/ar/utils.md b/ar/utils.md
@@ -283,10 +283,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo
             <td>Value</td>
         </tr>
         <tr>
-            <td>Minimum</td>
+            <td>MinValue</td>
         </tr>
         <tr>
-            <td>Maximum</td>
+            <td>MaxValue</td>
         </tr>
         <tr>
             <td rowspan=4>date</td>
@@ -296,10 +296,10 @@ func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFo
             <td>Value</td>
         </tr>
         <tr>
-            <td>Minimum</td>
+            <td>MinValue</td>
         </tr>
         <tr>
-            <td>Maximum</td>
+            <td>MaxValue</td>
         </tr>
         <tr>
             <td>time_period</td>
@@ -550,7 +550,7 @@ format3, err := f.NewConditionalStyle(
 )
 ```
 
-type: `Minimum` - يتم استخدام معلمة `minimum` لتعيين قيمة الحد الأدنى عندما يكون `Criteria` إما `between` أو `not between`.
+type: `MinValue` - يتم استخدام معلمة `MinValue` لتعيين قيمة الحد الأدنى عندما يكون `Criteria` إما `between` أو `not between`.
 
 ```go
 // قاعدة الخلايا المميزة: بين...
@@ -560,14 +560,14 @@ err := f.SetConditionalFormat("Sheet1", "A1:A10",
             Type:     "cell",
             Criteria: "between",
             Format:   format,
-            Minimum:  "6",
-            Maximum:  "8",
+            MinValue: "6",
+            MaxValue: "8",
         },
     },
 )
 ```
 
-type: `Maximum` - تُستخدم معلمة `maximum` لتعيين قيمة الحد الأعلى عندما تكون المعايير إما `between` أو `not between`. انظر المثال السابق.
+type: `MaxValue` - تُستخدم معلمة `maximum` لتعيين قيمة الحد الأعلى عندما تكون المعايير إما `between` أو `not between`. انظر المثال السابق.
 
 type: `average` - يُستخدم النوع `average` لتحديد التنسيق الشرطي لنمط "المتوسط" في Office Excel:
 

diff --git a/de/README.md b/de/README.md
@@ -8,8 +8,8 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe
 - Problem: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues)
 - go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
 - Lizenzen: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
-- Letzte Version: [v2.7.1](https://github.com/xuri/excelize/releases/latest)
-- Dokument Aktualisierungszeit: August 4, 2023
+- Letzte Version: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
+- Dokument Aktualisierungszeit: August 28, 2023
 
 ## Project mission
 

diff --git a/de/SUMMARY.md b/de/SUMMARY.md
@@ -233,6 +233,7 @@
 * [Leistung](performance.md)
 * [Beitrag](contribution.md)
 * Freigegebene Versionen
+  * [v2.8.0 (2023-08-28)](releases/v2.8.0.md)
   * [v2.7.1 (2023-04-10)](releases/v2.7.1.md)
   * [v2.7.0 (2023-01-09)](releases/v2.7.0.md)
   * [v2.6.1 (2022-08-22)](releases/v2.6.1.md)

diff --git a/de/base/installation.md b/de/base/installation.md
@@ -11,7 +11,7 @@ v2.4.0 ~ v2.6.1 | 1.15
 v2.0.2 ~ v2.3.2 | 1.10
 v1.0.0 ~ v2.0.1 | 1.6
 
-Für die Verwendung der neuesten Version Excelize Bibliothek erfordern, um Version 1.16 oder höher.
+Für die Verwendung der neuesten Version Excelize Bibliothek erfordern, um Version 1.16 oder höher. Beachten Sie, dass es in Go 1.21.0 einige [inkompatible Änderungen](https://github.com/golang/go/issues/61881) gibt. Diese Bibliothek kann mit dieser Version nicht funktionieren. Wenn Sie Go 1.21.x verwenden, aktualisieren Sie bitte auf Go 1.21.1 und eine spätere Version.
 
 - Installation
 

diff --git a/de/data.md b/de/data.md
@@ -43,6 +43,8 @@ dv.SetDropList([]string{"1", "2", "3"})
 f.AddDataValidation("Sheet1", dv)
 ```
 
+Wenn Sie die Elemente in das Datenvalidierungsdialogfeld (eine durch Trennzeichen getrennte Liste) eingeben, beträgt die Grenze 255 Zeichen, einschließlich der Trennzeichen. Wenn die Quellformel Ihrer Datenvalidierungsliste die maximale Längenbeschränkung überschreitet, legen Sie bitte die zulässigen Werte in den Arbeitsblattzellen fest und verwenden Sie die Funktion `SetSqrefDropList`, um die Referenz für ihre Zellen festzulegen.
+
 Beispiel 4: Setzen Sie die Datenvalidierung auf `Sheet1!A7:B8` mit den Einstellungen der Validierungskriterienquelle `Sheet1!E1:E3`. Erstellen Sie ein Dropdown-Menü in der Zelle, indem Sie die Listenquelle zulassen:
 
 <p align="center"><img width="665" src="./images/data_validation_04.png" alt="Datenvalidierung"></p>
@@ -54,6 +56,8 @@ dv.SetSqrefDropList("$E$1:$E$3")
 f.AddDataValidation("Sheet1", dv)
 ```
 
+Die Anzahl der Elemente, die in einer Datenvalidierungs-Dropdown-Liste angezeigt werden, ist begrenzt: Die Liste kann bis zu 32768 Elemente aus einer Liste im Arbeitsblatt anzeigen. Wenn Sie mehr Elemente benötigen, können Sie eine abhängige Dropdown-Liste erstellen, die nach Kategorien aufgeschlüsselt ist.
+
 ## Datenvalidierung erhalten {#GetDataValidations}
 
 ```go