Develop

.gitignore

@@ -1,13 +1,17 @@
 .DS_Store
 
-node_modules
-
+/node_modules
+docsPostProcessed/
 lib/core/metadata.js
 lib/core/MetadataBlog.js
 
-website/translated_docs
+docsPostProcessed
+
+website/siteConfig.js
+
 website/build/
 website/yarn.lock
 website/node_modules
 !website/node_modules/highlight.js/lib/index.js
 !website/node_modules/highlight.js/lib/languages/code4d.js
+

crowdin.yml

@@ -1,7 +1,6 @@
 files:
   - source: /docs/**/*.md
     translation: /website/translated_docs/%two_letters_code%/**/%original_file_name%
-    type: fm_md7
   - source: /docs/assets/en/**/*.png
     translation: /docs/assets/%two_letters_code%/**/%original_file_name%
   - source: /website/i18n/en.json

docs/API/BlobClass.md

@@ -0,0 +1,92 @@
+---
+id: BlobClass
+title: Blob
+---
+
+The Blob class lets you create and manipulate [blob objects](../Concepts/dt_blob.md#blob-types) (`4D.Blob`).
+
+### Summary
+
+||
+|---|
+|[<!-- INCLUDE #4D.Blob.new().Syntax -->](#4dblobnew)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #4D.Blob.new().Summary -->|
+|[<!-- INCLUDE #Blob.size.Syntax -->](#size)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #Blob.size.Summary -->|
+|[<!-- INCLUDE #Blob.slice().Syntax -->](#slice)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #Blob.slice().Summary -->|
+
+## 4D.Blob.new()
+
+<details><summary>History</summary>
+|Version|Changes|
+|---|---|
+|v19 R2|Added|
+</details>
+
+<!-- REF #4D.Blob.new().Syntax -->
+**4D.Blob.new()** : 4D.Blob<br/>**4D.Blob.new**( *blobScal* : Blob ) : 4D.Blob<br/>**4D.Blob.new**( *blobObj* : 4D.Blob ) : 4D.Blob<!-- END REF -->
+
+<!-- REF #4D.Blob.new().Params -->
+
+| Parameter | Type            |     | Description  |
+| --------- | --------------- | :-: | ------------ |
+| blob      | Blob or 4D.Blob | ->  | Blob to copy |
+| Result    | 4D.Blob         | <-  | New 4D.Blob  |
+<!-- END REF -->
+
+#### Description
+
+`4D.Blob.new` <!-- REF #4D.Blob.new().Summary -->creates a new `4D.Blob` object optionally encapsulating a copy of the data from another blob (scalar blob or `4D.Blob`).<!-- END REF -->
+
+If the `blob` parameter is omitted, the method returns an empty 4D.Blob.
+
+## .size
+
+<!-- REF #Blob.size.Syntax -->
+**.size** : Real<!-- END REF -->
+
+#### Description
+The `.size` property <!-- REF #Blob.size.Summary -->returns the size of a `4D.Blob`, expressed in bytes.<!-- END REF -->
+
+## .slice()
+
+<details><summary>History</summary>
+|Version|Changes|
+|---|---|
+|v19 R2|Added|
+</details>
+
+<!-- REF #Blob.slice().Syntax -->
+**.slice()** : 4D.Blob<br/>**.slice**( *start* : Real ) : 4D.Blob<br/>**.slice**( *start* : Real; *end* : Real ) : 4D.Blob<!-- END REF -->
+
+<!-- REF #Blob.slice().Params -->
+| Parameter | Type ||Description |
+| --------- | ------- | :-: | --- |
+| start| Real    | ->  | index of the first byte to include in the new `4D.Blob`.               |
+| end| Real    | ->  | index of the first byte that will not be included in the new `4D.Blob` |
+| Result| 4D.Blob | <-  | New `4D.Blob`|<!-- END REF -->
+
+#### Description
+
+`.slice()` <!-- REF #Blob.slice().Summary --> creates and returns a `4D.Blob ` that references data from a subset of the blob on which it's called. The original blob is not altered.<!-- END REF -->
+
+The `start` parameter is an index into the blob indicating the first byte to include in the new `4D.Blob`. If you specify a negative value, 4D treats it as an offset from the end of the blob toward the beginning. For example, -10 would be the 10th from last byte in the blob. The default value is 0. If you specify a value for start that is larger than the size of the source blob, the returned `4D.Blob`'s size is 0, and it contains no data.
+
+The `end` parameter is an index into the blob indicating the first byte that will not be included in the new `4D.Blob` (i.e. the byte exactly at this index is not included). If you specify a negative value, 4D treats it as an offset from the end of the blob toward the beginning. For example, -10 would be the 10th from last byte in the blob. The default value is the size of the blob.
+
+#### Example
+
+```4d
+var $myBlob : 4D.Blob
+
+// Store text in a 4D.Blob
+CONVERT FROM TEXT("Hello, World!"; "UTF-8"; $myBlob)
+$is4DBlob:=OB Instance of($myBlob; 4D.Blob);   //True
+
+$myString:=Convert to text($myBlob; "UTF-8")
+// $myString contains "Hello, World!"
+
+// Create a new 4D.Blob from $myBlob
+$myNewBlob:=$myBlob.slice(0; 5)
+
+$myString:=Convert to text($myNewBlob; "UTF-8")
+// $myString contains "Hello"
+```

docs/API/ClassClass.md

@@ -0,0 +1,146 @@
+---
+id: ClassClass
+title: Class
+---
+
+
+When a user class is [defined](Concepts/classes.md#class-definition) in the project, it is loaded in the 4D language environment. A class is an object itself, of "Class" class, which has properties and a function.
+
+
+
+### Summary
+
+
+||
+|---|
+|[<!-- INCLUDE #ClassClass.name.Syntax -->](#name)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #ClassClass.name.Summary -->|
+|[<!-- INCLUDE #ClassClass.new().Syntax -->](#new)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #ClassClass.new().Summary --> |
+|[<!-- INCLUDE #ClassClass.superclass.Syntax -->](#superclass)<p>&nbsp;&nbsp;&nbsp;&nbsp;<!-- INCLUDE #ClassClass.superclass.Summary --> |
+
+
+
+<!-- REF ClassClass.name.Desc -->
+## .name   
+
+<details><summary>History</summary>
+|Version|Changes|
+|---|---|
+|v18 R3|Added|
+
+</details>
+
+<!-- REF #ClassClass.name.Syntax -->
+**.name** : Text<!-- END REF -->
+
+#### Description
+
+The `.name` property <!-- REF #ClassClass.name.Summary -->contains the name of the `4D.Class` object<!-- END REF -->. Class names are case sensitive.  
+
+This property is **read-only**. 
+
+<!-- END REF -->
+
+
+
+<!-- REF ClassClass.new().Desc -->
+## .new()
+
+<details><summary>History</summary>
+|Version|Changes|
+|---|---|
+|v18 R3|Added|
+</details>
+
+<!-- REF #ClassClass.new().Syntax -->
+**.new**( *param* : any { *;...paramN* } ) : 4D.Class<!-- END REF -->
+
+<!-- REF #ClassClass.new().Params -->
+|Parameter|Type||Description|
+|---------|--- |:---:|------|
+|param|any|->|Parameter(s) to pass to the constructor function|
+|Result|4D.Class|<-|New object of the class|
+<!-- END REF -->
+
+
+#### Description
+
+The `.new()` function <!-- REF #ClassClass.new().Summary -->creates and returns a `cs.className` object which is a new instance of the class on which it is called<!-- END REF -->. This function is automatically available on all classes from the [`cs` class store](Concepts/classes.md#cs). 
+
+You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed.
+
+If `.new()` is called on a non-existing class, an error is returned.
+
+#### Examples
+
+To create a new instance of the Person class:
+
+```4d
+var $person : cs.Person  
+$person:=cs.Person.new() //create the new instance  
+//$person contains functions of the class
+```
+
+To create a new instance of the Person class with parameters:
+
+```4d
+//Class: Person.4dm
+Class constructor($firstname : Text; $lastname : Text; $age : Integer)
+	This.firstName:=$firstname
+	This.lastName:=$lastname
+	This.age:=$age
+```
+
+```4d
+//In a method
+var $person : cs.Person  
+$person:=cs.Person.new("John";"Doe";40)  
+//$person.firstName = "John"
+//$person.lastName = "Doe"
+//$person.age = 40
+```
+
+
+<!-- END REF -->
+
+
+
+<!-- REF ClassClass.superclass.Desc -->
+## .superclass   
+
+<details><summary>History</summary>
+|Version|Changes|
+|---|---|
+|v18 R3|Added|
+
+</details>
+
+<!-- REF #ClassClass.superclass.Syntax -->
+**.superclass** : 4D.Class<!-- END REF -->
+
+#### Description
+
+The `.superclass` property <!-- REF #ClassClass.superclass.Summary -->returns the parent class of the class<!-- END REF -->. A superclass can be a `4D.Class` object, or a `cs.className` object. If the class does not have a parent class, the property returns **null**. 
+
+A superclass of a user class is declared in a class by using the [`Class extends <superclass>`](Concepts/classes.md#class-extends-classname) keyword.
+
+This property is **read-only**. 
+
+#### Examples
+
+```4d
+$sup:=4D.File.superclass //Document
+$sup:=4D.Document.superclass //Object
+$sup:=4D.Object.superclass //null
+
+// If you created a MyFile class  
+// with `Class extends File`
+$sup:=cs.MyFile.superclass //File 
+
+```
+
+
+
+**See also:** [Super](Concepts/classes.md#super)
+<!-- END REF -->
+
+<style> h2 { background: #d9ebff;}</style>