Added placeholder script sample

Author: estruyf

content/docs/content-creation/placeholders.md

@@ -3,7 +3,7 @@ title: Placeholders
 slug: content-creation/placeholders
 description: null
 date: 2022-03-14T08:42:21.626Z
-lastmod: 2023-08-20T11:04:12.770Z
+lastmod: 2024-01-31T16:17:03.272Z
 weight: 200.4
 ---
 
@@ -140,26 +140,30 @@ Here is an example of a dynamic `uniqueId` placeholder:
 "frontMatter.content.placeholders": [
   {
     "id": "uniqueId",
-    "script": "./scripts/uniqueId.js",
-    "command": "~/.nvm/versions/node/v16.13.1/bin/node"
+    "script": "./scripts/uniqueId.mjs",
+    "command": "~/.nvm/versions/node/v18.17.1/bin/node"
   }
 ]
 ```
 
 #### Placeholder script
 
-The base script looks like this:
+To get started, you first need to install the
+[@frontmatter/extensibility](https://www.npmjs.com/package/@frontmatter/extensibility) 
+dependency.
+
+```bash
+npm i @frontmatter/extensibility
+```
+
+Once installed, you can use the following example:
 
 ```javascript
-const arguments = process.argv;
+import { PlaceholderScript } from "@frontmatter/extensibility";
 
-if (arguments && arguments.length > 0) {
-  const workspaceArg = arguments[2]; // The workspace path
-  const filePath = arguments[3]; // The path of the file
-  const title = arguments[4]; // Title of the page
+const { workspacePath, filePath, title, answers } = PlaceholderScript.getArguments();
 
-  console.log(Math.random().toString(36).substring(2, 15));
-}
+PlaceholderScript.done(Math.random().toString(36).substring(2, 15));
 ```
 
 > **Info**: Like the other content scripts, you can use other types of scripts like Python, Bash,
@@ -172,6 +176,38 @@ that the file is still not completely processed, and not all front matter fields
 > **Important**: In case you need to retrieve the whole front matter object, you can make use of the
 > `postScript` property on your content type in combination with a [content script][01].
 
+You can also ask additional input/questions during the placeholder script execution.
+For instance, if you want to pick between a category upon content creation, you can use the
+`PlaceholderScript.askQuestions` method.
+
+```javascript
+import { PlaceholderScript } from "@frontmatter/extensibility";
+
+(async () => {
+  const { answers } =
+    PlaceholderScript.getArguments();
+
+  if (!answers) {
+    PlaceholderScript.askQuestions([
+      {
+        name: "category",
+        message: "What category do you want to use for this article?"
+      },
+    ]);
+    return;
+  }
+
+  const { category } = answers;
+
+  if (!category) {
+    PlaceholderScript.done(undefined);
+    return;
+  }
+
+  PlaceholderScript.done(category);
+})();
+```
+
 #### Placeholder usage
 
 To use the `ogImage` placeholder, you need to define the `{{ogImage}}` value in your field as

content/docs/custom-actions.md

@@ -3,7 +3,7 @@ title: Custom actions
 slug: custom-actions
 description: null
 date: 2021-08-30T16:13:00.546Z
-lastmod: 2023-12-07T16:37:05.124Z
+lastmod: 2024-01-31T12:48:37.504Z
 weight: 500
 ---
 
@@ -116,12 +116,12 @@ When you do not want to use the `@frontmatter/extensibility` package, you can cr
 follows:
 
 ```javascript
-const arguments = process.argv;
+const args = process.argv;
 
-if (arguments && arguments.length > 0) {
-  const workspaceArg = arguments[2]; // The workspace path
-  const fileArg = arguments[3]; // The file path
-  const frontMatterArg = arguments[4]; // Front matter data
+if (args && args.length > 0) {
+  const workspaceArg = args[2]; // The workspace path
+  const fileArg = args[3]; // The file path
+  const frontMatterArg = args[4]; // Front matter data
 
   console.log(`The content returned for your notification.`);
 }
@@ -130,9 +130,9 @@ if (arguments && arguments.length > 0) {
 The current workspace-, file-path, and front matter data will be passed as a arguments. Like you can
 see in the above sample script, you can fetch these argument values as follows:
 
-- `arguments[2]`: The workspace path
-- `arguments[3]`: The file path (Markdown file)
-- `arguments[4]`: The front matter data as object
+- `args[2]`: The workspace path
+- `args[3]`: The file path (Markdown file)
+- `args[4]`: The front matter data as object
 
 ### Creating a script with the extensibility package
 
@@ -272,8 +272,8 @@ Here is a sample on how you can define a media script:
 
 The script will provide you the following arguments:
 
-- `arguments[2]`: The workspace path
-- `arguments[3]`: The file or folder path. This depends on the type of script.
+- `args[2]`: The workspace path
+- `args[3]`: The file or folder path. This depends on the type of script.
 
 When using the `@frontmatter/extensibility` package, you can get the arguments as follows:
 
@@ -383,15 +383,15 @@ print(f'frontMatterArg: {sys.argv[3]}')
 ```javascript
 const path = require("path");
 
-const arguments = process.argv;
+const args = process.argv;
 
 (async () => {
-  if (arguments && arguments.length > 0) {
+  if (args && args.length > 0) {
     const imagemin = (await import("imagemin")).default;
     const imageminJpegtran = (await import("imagemin-jpegtran")).default;
     const imageminPngquant = (await import("imagemin-pngquant")).default;
 
-    const fileArg = arguments[3]; // The file path
+    const fileArg = args[3]; // The file path
 
     await imagemin([fileArg], {
       destination: path.dirname(fileArg),
@@ -413,16 +413,16 @@ const arguments = process.argv;
 ```javascript
 const path = require("path");
 
-const arguments = process.argv;
+const args = process.argv;
 
 (async () => {
-  if (arguments && arguments.length > 0) {
+  if (args && args.length > 0) {
     const imagemin = (await import("imagemin")).default;
     const imageminJpegtran = (await import("imagemin-jpegtran")).default;
     const imageminPngquant = (await import("imagemin-pngquant")).default;
 
-    const workspaceArg = arguments[2]; // The workspace path
-    const folderArg = arguments[3]; // The folder path
+    const workspaceArg = args[2]; // The workspace path
+    const folderArg = args[3]; // The folder path
 
     const files = await imagemin([path.join(folderArg, "*.{jpg,png}")], {
       destination: folderArg,