From 72474663b797e0cbb78f1ed43bfa3956bb18e26a Mon Sep 17 00:00:00 2001 From: Lucee Docs GitHub Action Date: Tue, 12 Nov 2024 10:26:09 +0000 Subject: [PATCH 1/5] Update recipes index and README --- docs/recipes/README.md | 4 ++++ docs/recipes/index.json | 17 +++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/docs/recipes/README.md b/docs/recipes/README.md index 9c4b396f1..b4b09b624 100644 --- a/docs/recipes/README.md +++ b/docs/recipes/README.md @@ -272,6 +272,10 @@ Learn how to use request timeout correctly with Lucee. This document explains how to use retry functionality with some simple examples. +## [Using S3 Regions in Lucee](/docs/recipes/s3-region.md) + +Guide on configuring and interacting with specific S3 regions in Lucee using the S3 extension. + ## [Script Templates](/docs/recipes/script-templates.md) Learn about script templates in Lucee. This guide explains how Lucee supports templates with the `.cfs` extension, allowing you to write direct script code without the need for the `` tag. diff --git a/docs/recipes/index.json b/docs/recipes/index.json index 258a80d73..178c1783b 100644 --- a/docs/recipes/index.json +++ b/docs/recipes/index.json @@ -952,6 +952,23 @@ "Lucee" ] }, + { + "file": "s3-region.md", + "title": "Using S3 Regions in Lucee", + "path": "/docs/recipes/s3-region.md", + "hash": "0f033d87b29ca7e2e5b8fef6c2b9f10f", + "keywords": [ + "Virtual File System", + "VFS", + "S3", + "Regions", + "Buckets", + "Amazon S3", + "Wasabi", + "MinIO", + "Cloud Storage" + ] + }, { "file": "script-templates.md", "title": "Script Templates", From a4a879282c2e75a7a49a9f36d6fb606019fc3b58 Mon Sep 17 00:00:00 2001 From: Zac Spitzer Date: Tue, 12 Nov 2024 18:15:47 +0100 Subject: [PATCH 2/5] cross ref, cleanup, update to rc version --- .github/workflows/main.yml | 2 +- docs/03.reference/01.functions/createguid/function.md | 4 ++-- docs/03.reference/01.functions/createulid/function.md | 6 ++++-- docs/03.reference/01.functions/createuuid/function.md | 2 ++ docs/03.reference/01.functions/lslcase/function.md | 6 ++++-- docs/03.reference/01.functions/lsucase/function.md | 7 +++++-- docs/03.reference/01.functions/valueref/function.md | 6 ++---- 7 files changed, 20 insertions(+), 13 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index bcd7b4f70..2e8a84f63 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -39,7 +39,7 @@ jobs: with: webroot: ${{ github.workspace }} execute: /build-all.cfm - luceeVersion: 6.2.0.164-SNAPSHOT + luceeVersion: 6.2.0.164-RC # redis, chart, lucene, form. ajax, chart extensions: 60772C12-F179-D555-8E2CD2B4F7428718;version=3.0.0.54-SNAPSHOT,D46B46A9-A0E3-44E1-D972A04AC3A8DC10,EFDEB172-F52E-4D84-9CD1A1F561B3DFC8,FAD67145-E3AE-30F8-1C11A6CCF544F0B7,6E2CB28F-98FB-4B51-B6BE6C64ADF35473,DF28D0A4-6748-44B9-A2FDC12E4E2E4D38 - name: Upload Artifact diff --git a/docs/03.reference/01.functions/createguid/function.md b/docs/03.reference/01.functions/createguid/function.md index 20867a700..a6fc307e8 100644 --- a/docs/03.reference/01.functions/createguid/function.md +++ b/docs/03.reference/01.functions/createguid/function.md @@ -1,10 +1,10 @@ --- title: CreateGUID id: function-createguid -related: categories: +- core --- A globally unique identifier or GUID is a special type of identifier used in software applications to provide an unique reference number. -The value is represented as a 32 character hexadecimal string, such as {21EC2020-3AEA-1069-A2DD-08002B30309D} and usually stored as a 128 bit integer. \ No newline at end of file +The value is represented as a 32 character hexadecimal string, such as {21EC2020-3AEA-1069-A2DD-08002B30309D} and usually stored as a 128 bit integer. diff --git a/docs/03.reference/01.functions/createulid/function.md b/docs/03.reference/01.functions/createulid/function.md index c70dcefb4..9c6a0d1c4 100644 --- a/docs/03.reference/01.functions/createulid/function.md +++ b/docs/03.reference/01.functions/createulid/function.md @@ -1,10 +1,12 @@ --- -title: createULID +title: CreateULID id: function-createulid -description: Generates a ULID (Universally Unique Lexicographically Sortable Identifier) related: - function-createguid - function-createuuid +categories: +- core +description: Generates a ULID (Universally Unique Lexicographically Sortable Identifier) --- Generates a ULID (Universally Unique Lexicographically Sortable Identifier), a 128-bit identifier where the first 48 bits are a timestamp representing milliseconds since the Unix Epoch (1970-01-01), ensuring temporal ordering. diff --git a/docs/03.reference/01.functions/createuuid/function.md b/docs/03.reference/01.functions/createuuid/function.md index 2dd67b47c..238486294 100644 --- a/docs/03.reference/01.functions/createuuid/function.md +++ b/docs/03.reference/01.functions/createuuid/function.md @@ -4,6 +4,8 @@ id: function-createuuid related: - function-createguid - function-createulid +categories: +- core --- Creates a Universally Unique Identifier (UUID). diff --git a/docs/03.reference/01.functions/lslcase/function.md b/docs/03.reference/01.functions/lslcase/function.md index 8e527a7a3..5cbcd5089 100644 --- a/docs/03.reference/01.functions/lslcase/function.md +++ b/docs/03.reference/01.functions/lslcase/function.md @@ -1,8 +1,10 @@ --- -title: lslcase +title: LSLCase id: function-lslcase related: +- function-lcase categories: +- internationalization --- -Converts the alphabetic characters in a specified string to lowercase, respecting locale-specific casing rules. This is particularly important for languages where the standard lowercase conversion rules do not apply, ensuring accurate and culturally correct text processing. The function defaults to the current page's locale if no locale is specified. \ No newline at end of file +Converts the alphabetic characters in a specified string to lowercase, respecting locale-specific casing rules. This is particularly important for languages where the standard lowercase conversion rules do not apply, ensuring accurate and culturally correct text processing. The function defaults to the current page's locale if no locale is specified. diff --git a/docs/03.reference/01.functions/lsucase/function.md b/docs/03.reference/01.functions/lsucase/function.md index e32c1d78d..c8234cc31 100644 --- a/docs/03.reference/01.functions/lsucase/function.md +++ b/docs/03.reference/01.functions/lsucase/function.md @@ -1,10 +1,13 @@ --- -title: lsucase +title: LSUCase id: function-lsucase related: +- function-ucase categories: +- internationalization +description: Converts the alphabetic characters in a specified string to uppercase, respecting locale-specific casing rules --- Converts the alphabetic characters in a specified string to uppercase, respecting locale-specific casing rules. This is particularly important for languages where the standard lowercase conversion rules do not apply, -ensuring accurate and culturally correct text processing. The function defaults to the current page's locale if no locale is specified. \ No newline at end of file +ensuring accurate and culturally correct text processing. The function defaults to the current page's locale if no locale is specified. diff --git a/docs/03.reference/01.functions/valueref/function.md b/docs/03.reference/01.functions/valueref/function.md index b80afd2b4..1de4398dd 100644 --- a/docs/03.reference/01.functions/valueref/function.md +++ b/docs/03.reference/01.functions/valueref/function.md @@ -1,8 +1,6 @@ --- -title: valueref +title: ValueRef id: function-valueref -related: -categories: --- -creates a reference to a UDF that acts like a simple value. \ No newline at end of file +creates a reference to a UDF that acts like a simple value. From 778edd35efca6ee1d9a529cab4d6853438c7f39c Mon Sep 17 00:00:00 2001 From: Zac Spitzer Date: Tue, 12 Nov 2024 21:21:07 +0100 Subject: [PATCH 3/5] improve getPageContext() example --- .../01.functions/getpagecontext/_examples.md | 11 ++++++++++- docs/03.reference/01.functions/valueref/function.md | 2 ++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/03.reference/01.functions/getpagecontext/_examples.md b/docs/03.reference/01.functions/getpagecontext/_examples.md index 48e11d8d1..84d4e1f99 100644 --- a/docs/03.reference/01.functions/getpagecontext/_examples.md +++ b/docs/03.reference/01.functions/getpagecontext/_examples.md @@ -1,3 +1,12 @@ ```luceescript+trycf -writeDump(getPageContext()); +echo("Click to expand"); + pc = getPageContext(); + dump(var=pc, label="PageContext", expand=false); + dump(var=pc.getCFMLFactory(), label="CFMLFactory", expand=false); + dump(var=pc.getCFMLFactory().getEngine(), label="Engine",expand=false); + if( listFirst(server.lucee.version,".") lte 5) + dump(var=pc.getCFMLFactory().getConfig(), label="Config",expand=false); + else + dump(var=pc.getCFMLFactory().getConfigServer(), label="ConfigServer",expand=false); + dump(var=pc.getCFMLFactory().getScopeContext(), label="ScopeContext",expand=false); ``` \ No newline at end of file diff --git a/docs/03.reference/01.functions/valueref/function.md b/docs/03.reference/01.functions/valueref/function.md index 1de4398dd..93f94477d 100644 --- a/docs/03.reference/01.functions/valueref/function.md +++ b/docs/03.reference/01.functions/valueref/function.md @@ -1,6 +1,8 @@ --- title: ValueRef id: function-valueref +related: +- tag-function --- creates a reference to a UDF that acts like a simple value. From 805eb400c0282d83b5ee422ef8fd69153c85ac7b Mon Sep 17 00:00:00 2001 From: Zac Spitzer Date: Tue, 12 Nov 2024 23:34:34 +0100 Subject: [PATCH 4/5] default to lucee 6 for trycf --- builders/html/assets/trycf/index.html | 2 +- builders/html/assets/trycf/js/code-editor3.js | 22 ++++---- .../01.functions/valueref/_examples.md | 52 +++++++++++++++++++ 3 files changed, 64 insertions(+), 12 deletions(-) create mode 100644 docs/03.reference/01.functions/valueref/_examples.md diff --git a/builders/html/assets/trycf/index.html b/builders/html/assets/trycf/index.html index 2438df709..cf7d2bf96 100644 --- a/builders/html/assets/trycf/index.html +++ b/builders/html/assets/trycf/index.html @@ -14,7 +14,7 @@ width="100%" height="350px" fullscreen="true" - engine="lucee" + engine="lucee6" show-results="true" code=""> diff --git a/builders/html/assets/trycf/js/code-editor3.js b/builders/html/assets/trycf/js/code-editor3.js index 322c491ca..9c3933709 100644 --- a/builders/html/assets/trycf/js/code-editor3.js +++ b/builders/html/assets/trycf/js/code-editor3.js @@ -41,7 +41,7 @@ angular.module("code.editor", []).directive("codeEditor", function ($timeout) { ' ' + ' ' + ' ' + - ' >' + + ' >' + '