Update documentation for the stream writer and graphic options

- Update QQ Group ID
xuri · Jul 18, 2023 · 2140298 · 2140298
1 parent 9fb1d01
commit 2140298
Show file tree

Hide file tree

Showing 63 changed files with 395 additions and 375 deletions.
diff --git a/ar/README.md b/ar/README.md
@@ -38,7 +38,7 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج
 - [Skype Community](https://join.skype.com/YW3OFS5QjYcV?source=qr-ios): <a href="../images/[email protected]" title="Excelize Skype Community" target="_blank">join via QR Code</a>
 - [Line Community](http://line.me/ti/g/NFIjhfbP_g): <a href="../images/[email protected]" title="Excelize Line Community" target="_blank">join via QR Code</a>
 - [DingTalk Group ID](https://qr.dingtalk.com/action/joingroup?code=v1,k1,6tmzbBbJuQkGezVdHJjsHz29CZI9F49xeW+cvOaECtk=&_dt_no_comment=1&origin=11): `30047129` | <a href="../images/[email protected]" title="Excelize DingTalk Group" target="_blank">join via QR Code</a>
-- [QQ Group ID](https://jq.qq.com/?_wv=1027&k=5imdV9h): `207895940` | <a href="../images/[email protected]" title="Excelize QQ Group ID" target="_blank">join via QR Code</a>
+- QQ Group ID: `1302058237` (Verification info: Excelize) | <a href="../images/[email protected]" title="Excelize QQ Group ID" target="_blank">join via QR Code</a>
 - Excelize WeChat ID: `hixuri` (Verification info: Excelize) | <a href="../images/[email protected]" title="Excelize WeChat Community" target="_blank">join via QR Code</a>
 - WeCom Group (Verification info: Excelize): <a href="../images/[email protected]" title="Excelize WeCom Group" target="_blank">join via QR Code</a>
 - Inflow Group ID: `4375928` | <a href="../images/[email protected]" title="Excelize Inflow Group" target="_blank">join via QR Code</a>

diff --git a/ar/image.md b/ar/image.md
@@ -70,28 +70,30 @@ func main() {
 }
 ```
 
-تحدد المعلمة الاختيارية `AutoFit` ما إذا كان حجم الصورة يناسب الخلية تلقائيًا ، فإن القيمة الافتراضية لذلك هي `false`.
-
-تحدد المعلمة الاختيارية `Hyperlink` الارتباط التشعبي للصورة.
-
-تحدد المعلمة الاختيارية `HyperlinkType` نوعين من الارتباط التشعبي `External` لموقع الويب أو `Location` للانتقال إلى إحدى الخلايا في هذا المصنف. عندما يكون `HyperlinkType` هو `Location` ، يجب أن تبدأ الإحداثيات بـ `#`.
-
-تحدد المعلمة الاختيارية `Positioning` نوعين من موضع الصورة في جدول بيانات Excel ، `oneCell` (نقل ولكن بدون تغيير الحجم مع الخلايا) أو `absolute` (لا تتحرك أو تحجم مع الخلايا). إذا لم تقم بتعيين هذه المعلمة ، فسيكون الموضع الافتراضي هو النقل والحجم بالخلايا.
+يتم استخدام المعلمة الاختيارية `AltText` لإضافة نص بديل إلى كائن الرسم البياني.
 
 تشير المعلمة الاختيارية `PrintObject` إلى ما إذا كانت الصورة ستتم طباعتها عند طباعة ورقة العمل ، والقيمة الافتراضية لذلك هي `true`.
 
+تشير المعلمة الاختيارية `Locked` إلى ما إذا كان يتم قفل الصورة أم لا. لا يكون لتأمين الكائن أي تأثير إلا إذا كانت الورقة محمية.
+
 تشير المعلمة الاختيارية `LockAspectRatio` إلى ما إذا كان قفل نسبة العرض إلى الارتفاع للصورة ، والقيمة الافتراضية لذلك هي `false`.
 
-تشير المعلمة الاختيارية `Locked` إلى ما إذا كان يتم قفل الصورة أم لا. لا يكون لتأمين الكائن أي تأثير إلا إذا كانت الورقة محمية.
+تحدد المعلمة الاختيارية `AutoFit` ما إذا كان حجم الصورة يناسب الخلية تلقائيًا ، فإن القيمة الافتراضية لذلك هي `false`.
 
 تحدد المعلمة الاختيارية `OffsetX` الإزاحة الأفقية للصورة بالخلية ، والقيمة الافتراضية لذلك هي 0.
 
-تحدد المعلمة الاختيارية `ScaleX` المقياس الأفقي للصور ، والقيمة الافتراضية لذلك هي 1.0 والتي تقدم 100٪.
-
 تحدد المعلمة الاختيارية `OffsetY` الإزاحة الرأسية للصورة بالخلية ، والقيمة الافتراضية لذلك هي 0.
 
+تحدد المعلمة الاختيارية `ScaleX` المقياس الأفقي للصور ، والقيمة الافتراضية لذلك هي 1.0 والتي تقدم 100٪.
+
 تحدد المعلمة الاختيارية `ScaleY` المقياس الرأسي للصور ، والقيمة الافتراضية لذلك هي 1.0 والتي تقدم 100٪.
 
+تحدد المعلمة الاختيارية `Hyperlink` الارتباط التشعبي للصورة.
+
+تحدد المعلمة الاختيارية `HyperlinkType` نوعين من الارتباط التشعبي `External` لموقع الويب أو `Location` للانتقال إلى إحدى الخلايا في هذا المصنف. عندما يكون `HyperlinkType` هو `Location` ، يجب أن تبدأ الإحداثيات بـ `#`.
+
+تحدد المعلمة الاختيارية `Positioning` ثلاثة أنواع من موضع كائن الرسم البياني في جدول بيانات: `oneCell` (نقل ولكن بدون تغيير الحجم مع الخلايا) ، و `twoCell` (النقل والحجم مع الخلايا) ، و `absolute` ( لا تتحرك أو تحجم بالخلايا). إذا لم تقم بتعيين هذه المعلمة ، فسيكون الموضع الافتراضي هو نقل الخلايا وتغيير حجمها.
+
 ```go
 func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error
 ```

diff --git a/ar/stream.md b/ar/stream.md
@@ -38,7 +38,7 @@ type RowOpts struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-تقوم NewStreamWriter بإرجاع بنية كاتب الدفق حسب اسم ورقة العمل المحددة لإنشاء ورقة عمل جديدة تحتوي على كميات كبيرة من البيانات. لاحظ أنه بعد تعيين الصفوف ، يجب استدعاء طريقة [`Flush`](stream.md#Flush) لإنهاء عملية الكتابة المتدفقة والتأكد من أن ترتيب أرقام الأسطر تصاعديًا، لا تستخدم دالات الوضع العادي ووظائف وضع الدفق مختلطة لكتابة البيانات على أوراق العمل. على سبيل المثال ، قم بتعيين بيانات ورقة العمل بحجم `102400` من الصفوف × `50` من الأعمدة بالأرقام والنمط:
+تقوم NewStreamWriter بإرجاع بنية كاتب الدفق بواسطة اسم ورقة العمل المعطى المستخدم لكتابة البيانات على ورقة عمل فارغة جديدة مع كميات كبيرة من البيانات. لاحظ أنه بعد كتابة البيانات باستخدام كاتب الدفق لورقة العمل ، يجب عليك استدعاء طريقة [`Flush`](stream.md#Flush) لإنهاء عملية الكتابة المتدفقة ، والتأكد من أن ترتيب أرقام الصفوف تصاعدي عند تعيين الصفوف ، ووظائف الوضع العادي ووظائف وضع الدفق لا يمكن عمل مختلط لكتابة البيانات على أوراق العمل. سيحاول كاتب الدفق استخدام الملفات المؤقتة على القرص لتقليل استخدام الذاكرة عندما تقطع البيانات في الذاكرة أكثر من 16 ميغا بايت ، ولا يمكنك الحصول على قيمة الخلية في هذا الوقت. على سبيل المثال ، قم بتعيين البيانات لورقة عمل بحجم `102400` صفًا × `50` عمودًا بالأرقام والنمط:
 
 ```go
 f := excelize.NewFile()

diff --git a/de/README.md b/de/README.md
@@ -38,7 +38,7 @@ Wenn Ihr Unternehmen oder Produkt auch Excelize verwendet, begrüßen Sie <a hre
 - [Skype Community](https://join.skype.com/YW3OFS5QjYcV?source=qr-ios): <a href="../images/[email protected]" title="Excelize Skype Community" target="_blank">join via QR Code</a>
 - [Line Community](http://line.me/ti/g/NFIjhfbP_g): <a href="../images/[email protected]" title="Excelize Line Community" target="_blank">join via QR Code</a>
 - [DingTalk Group ID](https://qr.dingtalk.com/action/joingroup?code=v1,k1,6tmzbBbJuQkGezVdHJjsHz29CZI9F49xeW+cvOaECtk=&_dt_no_comment=1&origin=11): `30047129` | <a href="../images/[email protected]" title="Excelize DingTalk Group" target="_blank">join via QR Code</a>
-- [QQ Group ID](https://jq.qq.com/?_wv=1027&k=5imdV9h): `207895940` | <a href="../images/[email protected]" title="Excelize QQ Group ID" target="_blank">join via QR Code</a>
+- QQ Group ID: `1302058237` (Verification info: Excelize) | <a href="../images/[email protected]" title="Excelize QQ Group ID" target="_blank">join via QR Code</a>
 - Excelize WeChat ID: `hixuri` (Verification info: Excelize) | <a href="../images/[email protected]" title="Excelize WeChat Community" target="_blank">join via QR Code</a>
 - WeCom Group (Verification info: Excelize): <a href="../images/[email protected]" title="Excelize WeCom Group" target="_blank">join via QR Code</a>
 - Inflow Group ID: `4375928` | <a href="../images/[email protected]" title="Excelize Inflow Group" target="_blank">join via QR Code</a>

diff --git a/de/image.md b/de/image.md
@@ -70,28 +70,30 @@ func main() {
 }
 ```
 
-Der optionale Parameter `AutoFit` gibt an, ob die Bildgröße automatisch in die Zelle passt, der Standardwert dafür ist `false`.
-
-Der optionale Parameter `Hyperlink` spezifiziert den Hyperlink des Bildes.
-
-Der optionale Parameter `HyperlinkType` definiert zwei Arten von Hyperlinks `External` für die Website oder `Location` zum Verschieben in eine der Zellen in dieser Arbeitsmappe. Wenn der `HyperlinkType` `Location` ist, müssen die Koordinaten mit `#` beginnen.
-
-Der optionale Parameter `Positioning` definiert zwei Arten der Position eines Bildes in einer Excel-Tabelle, `oneCell` (Verschieben, aber nicht mit Zellen skalieren) oder `absolute` (Nicht verschieben oder mit Zellen skalieren). Wenn Sie diesen Parameter nicht festlegen, ist die Standardpositionierung Verschieben und Größe mit Zellen.
+Der optionale Parameter `AltText` wird verwendet, um alternativen Text zu einem Diagrammobjekt hinzuzufügen.
 
 Der optionale Parameter `PrintObject` gibt an, ob das Bild gedruckt wird, wenn das Arbeitsblatt gedruckt wird, der Standardwert dafür ist `true`.
 
+Der optionale Parameter `Locked` gibt an, ob das Bild gesperrt ist. Das Sperren eines Objekts hat keine Auswirkung, es sei denn, das Blatt ist geschützt.
+
 Der optionale Parameter `LockAspectRatio` gibt an, ob das Seitenverhältnis für das Bild gesperrt ist, der Standardwert dafür ist `false`.
 
-Der optionale Parameter `Locked` gibt an, ob das Bild gesperrt ist. Das Sperren eines Objekts hat keine Auswirkung, es sei denn, das Blatt ist geschützt.
+Der optionale Parameter `AutoFit` gibt an, ob die Bildgröße automatisch in die Zelle passt, der Standardwert dafür ist `false`.
 
 Der optionale Parameter `OffsetX` gibt den horizontalen Versatz des Bildes mit der Zelle an, der Standardwert davon ist 0.
 
-Der optionale Parameter `ScaleX` spezifiziert die horizontale Skalierung von Bildern, der Standardwert davon ist 1.0, was 100% darstellt.
-
 Der optionale Parameter `OffsetY` gibt den vertikalen Versatz des Bildes mit der Zelle an, der Standardwert davon ist 0.
 
+Der optionale Parameter `ScaleX` spezifiziert die horizontale Skalierung von Bildern, der Standardwert davon ist 1.0, was 100% darstellt.
+
 Der optionale Parameter `ScaleY` spezifiziert die vertikale Skalierung von Bildern, der Standardwert davon ist 1.0, was 100% darstellt.
 
+Der optionale Parameter `Hyperlink` spezifiziert den Hyperlink des Bildes.
+
+Der optionale Parameter `HyperlinkType` definiert zwei Arten von Hyperlinks `External` für die Website oder `Location` zum Verschieben in eine der Zellen in dieser Arbeitsmappe. Wenn der `HyperlinkType` `Location` ist, müssen die Koordinaten mit `#` beginnen.
+
+Der optionale Parameter `Positioning` definiert drei Arten der Position eines Diagrammobjekts in einer Tabellenkalkulation: `oneCell` (Verschieben, aber Größe nicht mit Zellen anpassen), `twoCell` (Verschieben und Größe mit Zellen anpassen) und `absolute` ( Zellen nicht verschieben oder vergrößern). Wenn Sie diesen Parameter nicht festlegen, erfolgt die Standardpositionierung durch Verschieben und Größe mit Zellen.
+
 ```go
 func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error
 ```

diff --git a/de/stream.md b/de/stream.md
@@ -38,7 +38,7 @@ type RowOpts struct {
 func (f *File) NewStreamWriter(sheet string) (*StreamWriter, error)
 ```
 
-NewStreamWriter gibt die Stream-Writer-Struktur anhand des angegebenen Arbeitsblattnamens zurück, um ein neues Arbeitsblatt mit großen Datenmengen zu generieren. Beachten Sie, dass Sie nach dem Festlegen von Zeilen die [`Flush`](stream.md#Flush) Methode aufrufen müssen, um den Streaming-Schreibvorgang zu beenden und sicherzustellen, dass die Reihenfolge der Zeilennummern aufsteigend ist. Verwenden Sie nicht die normalen Modusfunktionen und Streammodusfunktionen, die mit dem Schreiben von Daten auf die Arbeitsblätter gemischt sind. Legen Sie beispielsweise Daten für das Arbeitsblatt der Größe `102400` Zeilen x `50` Spalten mit Zahlen und Stil fest:
+NewStreamWriter gibt die Stream-Writer-Struktur nach dem angegebenen Arbeitsblattnamen zurück, die zum Schreiben von Daten in ein neues vorhandenes leeres Arbeitsblatt mit großen Datenmengen verwendet wird. Beachten Sie, dass Sie nach dem Schreiben von Daten mit dem Stream-Writer für das Arbeitsblatt die Methode [`Flush`](stream.md#Flush) aufrufen müssen, um den Streaming-Schreibvorgang zu beenden. Außerdem müssen Sie sicherstellen, dass die Reihenfolge der Zeilennummern beim Festlegen von Zeilen aufsteigend ist, sowie die Funktionen im Normalmodus und im Stream-Modus Die Arbeit kann nicht mit dem Schreiben von Daten auf die Arbeitsblätter gemischt werden. Der Stream-Writer versucht, temporäre Dateien auf der Festplatte zu verwenden, um die Speichernutzung zu reduzieren, wenn In-Memory-Chunks Daten über 16 MB aufteilen und Sie derzeit keinen Zellenwert erhalten können. Legen Sie beispielsweise Daten für ein Arbeitsblatt mit der Größe `102400` Zeilen x `50` Spalten mit Zahlen und Stil fest:
 
 ```go
 f := excelize.NewFile()

diff --git a/en/README.md b/en/README.md
@@ -38,7 +38,7 @@ If your company or product is also using Excelize, welcome <a href="mailto: xuri
 - [Skype Community](https://join.skype.com/YW3OFS5QjYcV?source=qr-ios): <a href="../images/[email protected]" alt="Excelize Skype Community" target="_blank" target="_blank">join via QR Code</a>
 - [Line Community](http://line.me/ti/g/NFIjhfbP_g): <a href="../images/[email protected]" alt="Excelize Line Community" target="_blank" target="_blank">join via QR Code</a>
 - [DingTalk Group ID](https://qr.dingtalk.com/action/joingroup?code=v1,k1,6tmzbBbJuQkGezVdHJjsHz29CZI9F49xeW+cvOaECtk=&_dt_no_comment=1&origin=11): `30047129` | <a href="../images/[email protected]" alt="Excelize DingTalk Group" target="_blank" target="_blank">join via QR Code</a>
-- [QQ Group ID](https://jq.qq.com/?_wv=1027&k=5imdV9h): `207895940` | <a href="../images/[email protected]" alt="Excelize QQ Group ID" target="_blank" target="_blank">join via QR Code</a>
+- QQ Group ID: `1302058237` (Verification info: Excelize) | <a href="../images/[email protected]" alt="Excelize QQ Group ID" target="_blank" target="_blank">join via QR Code</a>
 - Excelize WeChat ID: `hixuri` (Verification info: Excelize) | <a href="../images/[email protected]" alt="Excelize WeChat Community" target="_blank" target="_blank">join via QR Code</a>
 - WeCom Group (Verification info: Excelize): <a href="../images/[email protected]" title="Excelize WeCom Group" target="_blank">join via QR Code</a>
 - Inflow Group ID: `4375928` | <a href="../images/[email protected]" alt="Excelize Inflow Group" target="_blank" target="_blank">join via QR Code</a>

diff --git a/en/image.md b/en/image.md
@@ -69,27 +69,29 @@ func main() {
 }
 ```
 
-The optional parameter `AutoFit` specifies if make image size auto fits the cell, the default value of that is `false`.
+The optional parameter `AltText` is used to add alternative text to a graph object.
 
-The optional parameter `Hyperlink` specifies the hyperlink of the image.
+The optional parameter `PrintObject` indicates whether the graph object is printed when the worksheet is printed, the default value of that is `true`.
 
-The optional parameter `HyperlinkType` defines two types of hyperlink `External` for the website or `Location` for moving to one of the cells in this workbook. When the `HyperlinkType` is `Location`, coordinates need to start with `#`.
+The optional parameter `Locked` indicates whether lock the graph object. Locking an object has no effect unless the sheet is protected.
+
+The optional parameter `LockAspectRatio` indicates whether lock aspect ratio for the graph object, the default value of that is `false`.
 
-The optional parameter `Positioning` defines two types of the position of a picture in an Excel spreadsheet, `oneCell` (Move but don't size with cells) or `absolute` (Don't move or size with cells). If you don't set this parameter, the default positioning is move and size with cells.
+The optional parameter `AutoFit` specifies if make graph object size auto fits the cell, the default value of that is `false`.
 
-The optional parameter `PrintObject` indicates whether the image is printed when the worksheet is printed, the default value of that is `true`.
+The optional parameter `OffsetX` specifies the horizontal offset of the graph object with the cell, the default value of that is 0.
 
-The optional parameter `LockAspectRatio` indicates whether lock aspect ratio for the image, the default value of that is `false`.
+The optional parameter `OffsetY` specifies the vertical offset of the graph object with the cell, the default value of that is 0.
 
-The optional parameter `Locked` indicates whether lock the image. Locking an object has no effect unless the sheet is protected.
+The optional parameter `ScaleX` specifies the horizontal scale of graph object, the default value of that is 1.0 which presents 100%.
 
-The optional parameter `OffsetX` specifies the horizontal offset of the image with the cell, the default value of that is 0.
+The optional parameter `ScaleY` specifies the vertical scale of graph object, the default value of that is 1.0 which presents 100%.
 
-The optional parameter `ScaleX` specifies the horizontal scale of images, the default value of that is 1.0 which presents 100%.
+The optional parameter `Hyperlink` specifies the hyperlink of the graph object.
 
-The optional parameter `OffsetY` specifies the vertical offset of the image with the cell, the default value of that is 0.
+The optional parameter `HyperlinkType` defines two types of hyperlink `External` for the website or `Location` for moving to one of the cells in this workbook. When the `HyperlinkType` is `Location`, coordinates need to start with `#`.
 
-The optional parameter `ScaleY` specifies the vertical scale of images, the default value of that is 1.0 which presents 100%.
+The optional parameter `Positioning` defines 3 types of the position of a graph object in a spreadsheet: `oneCell` (Move but don't size with cells), `twoCell` (Move and size with cells), and `absolute` (Don't move or size with cells). If you don't set this parameter, the default positioning is to move and size with cells.
 
 ```go
 func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error