chore(update to latest basil):

Author: fmoronzirfas

reference/data/forEach.md

@@ -0,0 +1,16 @@
+---
+layout: entry
+title: forEach
+codetitle: 'forEach(collection, cb)'
+description: 'Used to run a function on all elements of an array. Please note the existence of the convenience methods `stories()`, `paragraphs()`, `lines()`, `words()` and `characters()` that are used to iterate through all instances of the given type in the given document.'
+category: Data
+subcategory: Collections
+returns: null
+parameters:
+    - {name: collection, description: 'The array to be processed.', optional: false, type: [Array]}
+    - {name: cb, description: 'The function that will be called on each element. The call will be like function(item,i) where i is the current index of the item within the array.', optional: false, type: [Function]}
+kind: function
+todo: null
+examples: []
+
+---

reference/document/applyMasterPage.md

@@ -0,0 +1,22 @@
+---
+layout: entry
+title: applyMasterPage
+codetitle: 'applyMasterPage(page, master)'
+description: "Applies a master page to the given page.\n\nThe `page` parameter can be given as a page object, as a page name or as a page number (numbering starts at 1).\n\nThe `master` parameter can be given as a master spread object or as a string. If a string is used, it can either hold the master page prefix (e.g \"A\", \"B\") or the full name *including* the prefix (e.g \"A-Master\", \"B-Master\"). The latter is useful, if there are several masters using the same prefix. Alternatively, the constant `NONE` can be used to apply InDesign's `[none]` master to the page and thus remove the previously applied master page from the page."
+category: Document
+subcategory: Page
+returns:
+    name: null
+    description: 'The page the master page was applied to.'
+    type: [Page]
+parameters:
+    - {name: page, description: 'The page to apply the master page to.', optional: false, type: [Number, String, Page]}
+    - {name: master, description: 'The master page to apply.', optional: false, type: [String, MasterSpread]}
+kind: function
+todo: null
+examples:
+    - {description: 'Apply the master with prefix "B" to the documents third page', code: 'applyMasterPage(3, "B");'}
+    - {description: 'In a document with master pages "A-Text" and "A-Images", apply "A-Images" to the current page', code: 'applyMasterPage(page(), "A-Images");'}
+    - {description: 'Remove the master page from the page named "IV"', code: 'applyMasterPage("IV", NONE);'}
+
+---

reference/document/applyObjectStyle.md

@@ -0,0 +1,19 @@
+---
+layout: entry
+title: applyObjectStyle
+codetitle: 'applyObjectStyle(item, style)'
+description: 'Applies an object style to the given page item. The object style can be given as name or as an object style instance.'
+category: Document
+subcategory: 'Page Items'
+returns:
+    name: null
+    description: 'The page item that the style was applied to.'
+    type: [PageItem]
+parameters:
+    - {name: item, description: 'The page item to apply the style to.', optional: false, type: [PageItem]}
+    - {name: style, description: 'An object style instance or the name of the object style to apply.', optional: false, type: [ObjectStyle, String]}
+kind: function
+todo: null
+examples: []
+
+---

reference/document/linkTextFrames.md

@@ -0,0 +1,16 @@
+---
+layout: entry
+title: linkTextFrames
+codetitle: 'linkTextFrames(textFrameA, textFrameB)'
+description: 'Links the stories of two textframes to one story. Text of first textframe overflows to second one.'
+category: Document
+subcategory: Text
+returns: null
+parameters:
+    - {name: textFrameA, description: null, optional: false, type: [TextFrame]}
+    - {name: textFrameB, description: null, optional: false, type: [TextFrame]}
+kind: function
+todo: null
+examples: []
+
+---

reference/document/objectStyle.md

@@ -0,0 +1,19 @@
+---
+layout: entry
+title: objectStyle
+codetitle: 'objectStyle(itemOrName, [props])'
+description: 'Returns the object style of a given page item or the object style with the given name. If an object style of the given name does not exist, it gets created. Optionally a props object of property name/value pairs can be used to set the object style''s properties.'
+category: Document
+subcategory: 'Page Items'
+returns:
+    name: null
+    description: 'The object style instance.'
+    type: [ObjectStyle]
+parameters:
+    - {name: itemOrName, description: 'A page item whose style to return or the name of the object style to return.', optional: false, type: [PageItem, String]}
+    - {name: props, description: 'An object of property name/value pairs to set the style''s properties.', optional: true, type: [Object]}
+kind: function
+todo: null
+examples: []
+
+---

reference/document/placeholder.md

@@ -0,0 +1,18 @@
+---
+layout: entry
+title: placeholder
+codetitle: placeholder(textFrame)
+description: 'Fills the given text frame and all linked text frames with random placeholder text. The placeholder text will be added at the end of any already existing text in the text frame.'
+category: Document
+subcategory: Text
+returns:
+    name: null
+    description: 'The inserted placeholder text.'
+    type: [Text]
+parameters:
+    - {name: textFrame, description: 'The text frame to fill.', optional: false, type: [TextFrame]}
+kind: function
+todo: null
+examples: []
+
+---

reference/environment/inspect.md

@@ -0,0 +1,24 @@
+---
+layout: entry
+title: inspect
+codetitle: 'inspect(obj, [settings])'
+description: "Inspects a given object or any other data item and prints the result to the console. This is useful for inspecting or debugging any kind of variable or data item. The optional settings object allows to control the function's output. The following parameters can be set in the settings object:\n- `showProps`: Show or hide properties. Default: `true`\n- `showValues`: Show or hide values. Default: `true`\n- `showMethods`: Show or hide methods. Default: `false`\n- `maxLevel`: Chooses how many levels of properties should be inspected recursively. Default: `1`\n- `propList`: Allows to pass an array of property names to show. If `propList` is not set all properties will be shown. Default: `[]` (no propList)\nIf no settings object is set, the default values will be used."
+category: Environment
+subcategory: null
+returns: null
+parameters:
+    - {name: obj, description: 'An object or any other data item to be inspected.', optional: false, type: [Object]}
+    - {name: settings, description: 'A settings object to control the function''s behavior.', optional: true, type: [Object]}
+    - {name: settings.showProps, description: 'Show or hide properties. Default: `true`', optional: true, type: [Boolean]}
+    - {name: settings.showValues, description: 'Show or hide values. Default: `true`', optional: true, type: [Boolean]}
+    - {name: settings.showMethods, description: 'Show or hide methods. Default: `false`', optional: true, type: [Boolean]}
+    - {name: settings.maxLevel, description: 'How many levels of properties should be inspected recursively. Default: `1`', optional: true, type: [Number]}
+    - {name: settings.propList, description: 'Array of properties to show. Default: `[]` (no propList)', optional: true, type: [Array]}
+kind: function
+todo: null
+examples:
+    - {description: 'Inspecting a string', code: 'inspect("foo");'}
+    - {description: 'Inspecting the current page, its methods and an additional level of properties', code: 'inspect(page(), {showMethods: true, maxLevel: 2})'}
+    - {description: 'Inspecting an ellipse, listing only the properties "geometricBounds" and "strokeWeight"', code: "var myEllipse = ellipse(0, 0, 10, 10);\ninspect(myEllipse, {maxLevel: 2, propList: [\"geometricBounds, strokeWeight\"]});"}
+
+---

reference/environment/printInfo.md

@@ -0,0 +1,14 @@
+---
+layout: entry
+title: printInfo
+codetitle: printInfo()
+description: 'Print numerous information about the current environment to the console.'
+category: Environment
+subcategory: null
+returns: null
+parameters: []
+kind: function
+todo: null
+examples: []
+
+---

reference/environment/projectFolder.md

@@ -0,0 +1,17 @@
+---
+layout: entry
+title: projectFolder
+codetitle: projectFolder()
+description: 'Get the folder of the active document as a Folder object. Use .absoluteURI to access a string representation of the folder path.'
+category: Environment
+subcategory: null
+returns:
+    name: null
+    description: 'The folder of the the active document'
+    type: [Folder]
+parameters: []
+kind: function
+todo: null
+examples: []
+
+---

reference/environment/property.md

@@ -0,0 +1,22 @@
+---
+layout: entry
+title: property
+codetitle: 'property(obj, prop, [value])'
+description: 'Sets a property of an object or of any other given data item to the specified value. Alternatively an object of key value pairs can be used as the second argument to set several properties to specified values at once. To retrieve a list of available properties for the different data types, the inspect() method can be used.'
+category: Environment
+subcategory: null
+returns:
+    name: null
+    description: 'The object or other data item with the newly set property.'
+    type: [Any]
+parameters:
+    - {name: obj, description: 'An object or any other data item whose properties to change.', optional: false, type: [Any]}
+    - {name: prop, description: 'A string describing an object''s property or alternatively an object containing key value pairs.', optional: false, type: [String, Object]}
+    - {name: value, description: 'A value of the appropriate type to set the object''s property to.', optional: true, type: [Any]}
+kind: function
+todo: null
+examples:
+    - {description: 'Sets name and fill color of an ellipse', code: "var ell = ellipse(100, 100, 50, 50);\nproperty(ell, \"name\", \"Red Circle\");\nproperty(ell, \"fillColor\", color(255, 0, 0));"}
+    - {description: 'Sets name and fill color of a rectangle and locks it, using an object with key value pairs', code: "var blueSquare = rect(100, 100, 50, 50);\nvar squareProps = {\n  name: \"Blue Square\",\n  fillColor: color(0, 0, 255),\n  locked: true\n}\nproperty(blueSquare, squareProps);"}
+
+---