From 0b21a71b32368dd34681dc77ac49cf44f7df92ef Mon Sep 17 00:00:00 2001 From: Zac Spitzer Date: Fri, 17 Jan 2025 15:50:24 +0100 Subject: [PATCH] further cleanup --- .../datetimeformat/_arguments/mask.md | 96 +++++++-------- .../lsdatetimeformat/_arguments/mask.md | 95 ++++++++------- .../parsedatetime/_arguments/format.md | 93 +++++++------- .../04.cookbooks/25.Deploy-Archives/page.md | 78 ------------ .../04.cookbooks/52.Flyingsaucer/page.md | 115 ------------------ docs/recipes/archives-creating-and-deploy.md | 3 + docs/recipes/check-for-changes.md | 3 + docs/recipes/configuration.md | 11 +- docs/recipes/datasource-how-to-define-them.md | 4 + .../mappings-how-to-define-a-reg-mapping.md | 3 +- docs/recipes/pdf-engine-flying-saucer.md | 2 +- .../read-xml-with-a-listener-model-sax.md | 6 + .../using-s3-directly-for-source-code.md | 3 +- 13 files changed, 174 insertions(+), 338 deletions(-) delete mode 100644 docs/04.guides/04.cookbooks/25.Deploy-Archives/page.md delete mode 100755 docs/04.guides/04.cookbooks/52.Flyingsaucer/page.md diff --git a/docs/03.reference/01.functions/datetimeformat/_arguments/mask.md b/docs/03.reference/01.functions/datetimeformat/_arguments/mask.md index 66dda69ba..9d50d376e 100644 --- a/docs/03.reference/01.functions/datetimeformat/_arguments/mask.md +++ b/docs/03.reference/01.functions/datetimeformat/_arguments/mask.md @@ -1,53 +1,53 @@ Date time formatting mask (case sensitive): -- a,..,aaaa: AM/PM marker (see also "t" and "tt"; Example:AM) -- d: Day in month, no leading zero for single-digit days (Example:3) -- dd: Day in month, leading zero for single-digit days (Example:03) -- D: Day in year, no leading zero for single-digit days (Example:4) -- DD: Day in year, leading zero for single-digit days (Example:04) -- DDD: Day in year, 2 leading zero for single-digit days (Example:004) -- E,EE,EEE: Day of week as a three-letter abbreviation (Example:Tue) -- EEEE: Day of week as its full name (Example:Tuesday) -- F: Day of week in month, no leading zero for single-digit days (Example:4) -- FF: Day of week in month, leading zero for single-digit days (Example:04) -- G,GG: Era designator (Example:AD) -- h: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) -- hh: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) -- H: Hour in day (0-23), no leading zero for single-digit hours (Example:14) -- HH: Hour in day (00-23), leading zero for single-digit hours (Example:14) -- k: Hour in day (1-24), no leading zero for single-digit hours (Example:15) -- kk: Hour in day (1-24), leading zero for single-digit hours (Example:15) -- K: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) -- KK: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) -- l,L: milliseconds, with no leading zeros (Example:3) -- ll,LL: milliseconds, leading zero for single-digit days (Example:03) -- lll,LLL: milliseconds, 2 leading zero for single-digit days (Example:003) -- m,M: Month as digits, no leading zero for single-digit months (Example:6) -- mm,MM: Month as digits, leading zero for single-digit months (Example:06) -- mmm,MMM: Month as a three-letter abbreviation (Example:Jun) -- mmmm,MMMM: Month as its full name (Example:June) -- n,N: minutes in hour, no leading zero for single-digit minutes (Example:3) -- nn,NN: minutes in hour, leading zero for single-digit minutes (Example:03) -- s,S: seconds in minute, no leading zero for single-digit seconds (Example:3) -- ss,SS: seconds in minute, leading zero for single-digit seconds (Example:03) -- t,T: one-character time marker string (Example:P) -- tt,TT: multiple-character time marker string (Example:PM) -- w: Week in year, no leading zero for single-digit hours (Example:27) -- ww: Week in year, leading zero for single-digit hours (Example:27) -- W: Week in month, no leading zero for single-digit hours (Example:2) -- WW: Week in month, leading zero for single-digit hours (Example:02) -- y,yy,yyy: Year as last two digits, leading zero for single-digit (Example:09) -- yyyy: Year represented by four digits (Example:2009) -- z,zz,zzz: General time zone as a 3 to 4 letter abbreviation (Example:PST) -- zzzz: General time zone as its full name (Example:Pacific Standard Time) -- Z,..,ZZZZ: RFC 822 time zone (Example:-0800) +- `a,..,aaaa`: AM/PM marker (see also "t" and "tt"; Example:AM) +- `d`: Day in month, no leading zero for single-digit days (Example:3) +- `dd`: Day in month, leading zero for single-digit days (Example:03) +- `D`: Day in year, no leading zero for single-digit days (Example:4) +- `DD`: Day in year, leading zero for single-digit days (Example:04) +- `DDD`: Day in year, 2 leading zero for single-digit days (Example:004) +- `E,EE,EEE`: Day of week as a three-letter abbreviation (Example:Tue) +- `EEEE`: Day of week as its full name (Example:Tuesday) +- `F`: Day of week in month, no leading zero for single-digit days (Example:4) +- `FF`: Day of week in month, leading zero for single-digit days (Example:04) +- `G,GG`: Era designator (Example:AD) +- `h`: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) +- `hh`: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) +- `H`: Hour in day (0-23), no leading zero for single-digit hours (Example:14) +- `HH`: Hour in day (00-23), leading zero for single-digit hours (Example:14) +- `k`: Hour in day (1-24), no leading zero for single-digit hours (Example:15) +- `kk`: Hour in day (1-24), leading zero for single-digit hours (Example:15) +- `K`: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) +- `KK`: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) +- `l,L`: milliseconds, with no leading zeros (Example:3) +- `ll,LL`: milliseconds, leading zero for single-digit days (Example:03) +- `lll,LLL`: milliseconds, 2 leading zero for single-digit days (Example:003) +- `m,M`: Month as digits, no leading zero for single-digit months (Example:6) +- `mm,MM`: Month as digits, leading zero for single-digit months (Example:06) +- `mmm,MMM`: Month as a three-letter abbreviation (Example:Jun) +- `mmmm,MMMM`: Month as its full name (Example:June) +- `n,N`: minutes in hour, no leading zero for single-digit minutes (Example:3) +- `nn,NN`: minutes in hour, leading zero for single-digit minutes (Example:03) +- `s,S`: seconds in minute, no leading zero for single-digit seconds (Example:3) +- `ss,SS`: seconds in minute, leading zero for single-digit seconds (Example:03) +- `t,T`: one-character time marker string (Example:P) +- `tt,TT`: multiple-character time marker string (Example:PM) +- `w`: Week in year, no leading zero for single-digit hours (Example:27) +- `ww`: Week in year, leading zero for single-digit hours (Example:27) +- `W`: Week in month, no leading zero for single-digit hours (Example:2) +- `WW`: Week in month, leading zero for single-digit hours (Example:02) +- `y,yy,yyy`: Year as last two digits, leading zero for single-digit (Example:09) +- `yyyy`: Year represented by four digits (Example:2009) +- `z,zz,zzz`: General time zone as a 3 to 4 letter abbreviation (Example:PST) +- `zzzz`: General time zone as its full name (Example:Pacific Standard Time) +- `Z,..,ZZZZ`: RFC 822 time zone (Example:-0800) The following masks can be used to format the full date and time and may not be combined with other masks: -- short: equivalent to "m/d/y h:nn tt" -- medium: equivalent to "mmm d, yyyy h:nn:ss tt" -- long: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:nn:ss tt zzz" -- full: equivalent to "dddd, mmmm d, yyyy h:nn:ss tt zz" -- ISO8601/ISO: equivalent to "yyyy-mm-dd'T'HH:nn:ssXXX" -- epoch: Total seconds of a given date (Example:1567517664) (added in Lucee 6.0.0.83) -- epochms: Total milliseconds of a given date (Example:1567517664000) (added in Lucee 6.0.0.83) +- `short`: equivalent to "m/d/y h:nn tt" +- `medium`: equivalent to "mmm d, yyyy h:nn:ss tt" +- `long`: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:nn:ss tt zzz" +- `full`: equivalent to "dddd, mmmm d, yyyy h:nn:ss tt zz" +- `ISO8601/ISO`: equivalent to "yyyy-mm-dd'T'HH:nn:ssXXX" +- `epoch`: Total seconds of a given date (Example:1567517664) (added in Lucee 6.0.0.83) +- `epochms`: Total milliseconds of a given date (Example:1567517664000) (added in Lucee 6.0.0.83) diff --git a/docs/03.reference/01.functions/lsdatetimeformat/_arguments/mask.md b/docs/03.reference/01.functions/lsdatetimeformat/_arguments/mask.md index 19a5a4f87..e20e1ed74 100644 --- a/docs/03.reference/01.functions/lsdatetimeformat/_arguments/mask.md +++ b/docs/03.reference/01.functions/lsdatetimeformat/_arguments/mask.md @@ -1,52 +1,55 @@ Mask that has to be used for formatting. Date time formatting mask (case sensitive): -- a,..,aaaa: AM/PM marker (see also "t" and "tt"; Example:AM) -- d: Day in month, no leading zero for single-digit days (Example:3) -- dd: Day in month, leading zero for single-digit days (Example:03) -- D: Day in year, no leading zero for single-digit days (Example:4) -- DD: Day in year, leading zero for single-digit days (Example:04) -- DDD: Day in year, 2 leading zero for single-digit days (Example:004) -- E,EE,EEE: Day of week as a three-letter abbreviation (Example:Tue) -- EEEE: Day of week as its full name (Example:Tuesday) -- F: Day of week in month, no leading zero for single-digit days (Example:4) -- FF: Day of week in month, leading zero for single-digit days (Example:04) -- G,GG: Era designator (Example:AD) -- h: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) -- hh: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) -- H: Hour in day (0-23), no leading zero for single-digit hours (Example:14) -- HH: Hour in day (00-23), leading zero for single-digit hours (Example:14) -- k: Hour in day (1-24), no leading zero for single-digit hours (Example:15) -- kk: Hour in day (1-24), leading zero for single-digit hours (Example:15) -- K: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) -- KK: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) -- l,L: milliseconds, with no leading zeros (Example:3) -- ll,LL: milliseconds, leading zero for single-digit days (Example:03) -- lll,LLL: milliseconds, 2 leading zero for single-digit days (Example:003) -- m,M: Month as digits, no leading zero for single-digit months (Example:6) -- mm,MM: Month as digits, leading zero for single-digit months (Example:06) -- mmm,MMM: Month as a three-letter abbreviation (Example:Jun) -- mmmm,MMMM: Month as its full name (Example:June) -- n,N: minutes in hour, no leading zero for single-digit minutes (Example:3) -- nn,NN: minutes in hour, leading zero for single-digit minutes (Example:03) -- s,S: seconds in minute, no leading zero for single-digit seconds (Example:3) -- ss,SS: seconds in minute, leading zero for single-digit seconds (Example:03) -- t,T: one-character time marker string (Example:P) -- tt,TT: multiple-character time marker string (Example:PM) -- w: Week in year, no leading zero for single-digit hours (Example:27) -- ww: Week in year, leading zero for single-digit hours (Example:27) -- W: Week in month, no leading zero for single-digit hours (Example:2) -- WW: Week in month, leading zero for single-digit hours (Example:02) -- y,yy,yyy: Year as last two digits, leading zero for single-digit (Example:09) -- yyyy: Year represented by four digits (Example:2009) -- z,zz,zzz: General time zone as a 3 to 4 letter abbreviation (Example:PST) -- zzzz: General time zone as its full name (Example:Pacific Standard Time) -- Z,..,ZZZZ: RFC 822 time zone (Example:-0800) +- `a,..,aaaa`: AM/PM marker (see also "t" and "tt"; Example:AM) +- `d`: Day in month, no leading zero for single-digit days (Example:3) +- `dd`: Day in month, leading zero for single-digit days (Example:03) +- `D`: Day in year, no leading zero for single-digit days (Example:4) +- `DD`: Day in year, leading zero for single-digit days (Example:04) +- `DDD`: Day in year, 2 leading zero for single-digit days (Example:004) +- `E,EE,EEE`: Day of week as a three-letter abbreviation (Example:Tue) +- `EEEE`: Day of week as its full name (Example:Tuesday) +- `F`: Day of week in month, no leading zero for single-digit days (Example:4) +- `FF`: Day of week in month, leading zero for single-digit days (Example:04) +- `G,GG`: Era designator (Example:AD) +- `h`: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) +- `hh`: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) +- `H`: Hour in day (0-23), no leading zero for single-digit hours (Example:14) +- `HH`: Hour in day (00-23), leading zero for single-digit hours (Example:14) +- `k`: Hour in day (1-24), no leading zero for single-digit hours (Example:15) +- `kk`: Hour in day (1-24), leading zero for single-digit hours (Example:15) +- `K`: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) +- `KK`: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) +- `l,L`: milliseconds, with no leading zeros (Example:3) +- `ll,LL`: milliseconds, leading zero for single-digit days (Example:03) +- `lll,LLL`: milliseconds, 2 leading zero for single-digit days (Example:003) +- `m,M`: Month as digits, no leading zero for single-digit months (Example:6) +- `mm,MM`: Month as digits, leading zero for single-digit months (Example:06) +- `mmm,MMM`: Month as a three-letter abbreviation (Example:Jun) +- `mmmm,MMMM`: Month as its full name (Example:June) +- `n,N`: minutes in hour, no leading zero for single-digit minutes (Example:3) +- `nn,NN`: minutes in hour, leading zero for single-digit minutes (Example:03) +- `s,S`: seconds in minute, no leading zero for single-digit seconds (Example:3) +- `ss,SS`: seconds in minute, leading zero for single-digit seconds (Example:03) +- `t,T`: one-character time marker string (Example:P) +- `tt,TT`: multiple-character time marker string (Example:PM) +- `w`: Week in year, no leading zero for single-digit hours (Example:27) +- `ww`: Week in year, leading zero for single-digit hours (Example:27) +- `W`: Week in month, no leading zero for single-digit hours (Example:2) +- `WW`: Week in month, leading zero for single-digit hours (Example:02) +- `y,yy,yyy`: Year as last two digits, leading zero for single-digit (Example:09) +- `yyyy`: Year represented by four digits (Example:2009) +- `z,zz,zzz`: General time zone as a 3 to 4 letter abbreviation (Example:PST) +- `zzzz`: General time zone as its full name (Example:Pacific Standard Time) +- `Z,..,ZZZZ`: RFC 822 time zone (Example:-0800) The following masks can be used to format the full date and time and may not be combined with other masks: -- short: equivalent to "m/d/y h:nn tt" -- medium: equivalent to "mmm d, yyyy h:nn:ss tt" -- long: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:nn:ss tt zzz" -- full: equivalent to "dddd, mmmm d, yyyy h:nn:ss tt zz" -- ISO8601/ISO: equivalent to "yyyy-mm-dd'T'HH:nn:ssXXX" \ No newline at end of file +- `short`: equivalent to "m/d/y h:nn tt" +- `medium`: equivalent to "mmm d, yyyy h:nn:ss tt" +- `long`: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:nn:ss tt zzz" +- `full`: equivalent to "dddd, mmmm d, yyyy h:nn:ss tt zz" +- `ISO8601/ISO`: equivalent to "yyyy-mm-dd'T'HH:nn:ssXXX" +- `ISOMillis/ISOMs/javascript`: Javascript style ISO date, equivalent to "yyyy-mm-dd'T'HH:nn:ss.SSSXXX" +- `epoch`: Total seconds of a given date (Example:1567517664) +- `epochms`: Total millseconds of a given date (Example:1567517664000) \ No newline at end of file diff --git a/docs/03.reference/01.functions/parsedatetime/_arguments/format.md b/docs/03.reference/01.functions/parsedatetime/_arguments/format.md index d5f36e686..3d7401bb8 100644 --- a/docs/03.reference/01.functions/parsedatetime/_arguments/format.md +++ b/docs/03.reference/01.functions/parsedatetime/_arguments/format.md @@ -2,52 +2,53 @@ Mask that has to be used for formatting. the following characters are pattern letters (case sensitive) representing the components of a datetime string. All other characters are not interpreted -- a,..,aaaa: AM/PM marker (see also "t" and "tt"; Example:AM) -- d: Day in month, no leading zero for single-digit days (Example:3) -- dd: Day in month, leading zero for single-digit days (Example:03) -- D: Day in year, no leading zero for single-digit days (Example:4) -- DD: Day in month, leading zero for single-digit days (Example:04) -- DDD: Day in month, 2 leading zero for single-digit days (Example:004) -- E,EE,EEE: Day of week as a three-letter abbreviation (Example:Tue) -- EEEE: Day of week as its full name (Example:Tuesday) -- F: Day of week in month, no leading zero for single-digit days (Example:4) -- FF: Day of week in month, leading zero for single-digit days (Example:04) -- G,GG: Era designator (Example:AD) -- h: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) -- hh: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) -- H: Hour in day (0-23), no leading zero for single-digit hours (Example:14) -- HH: Hour in day (00-23), leading zero for single-digit hours (Example:14) -- k: Hour in day (1-24), no leading zero for single-digit hours (Example:15) -- kk: Hour in day (1-24), leading zero for single-digit hours (Example:15) -- K: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) -- KK: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) -- l,L: milliseconds, with no leading zeros (Example:3) -- ll,LL: milliseconds, leading zero for single-digit days (Example:03) -- lll,LLL: milliseconds, 2 leading zero for single-digit days (Example:003) -- m,M: Month as digits, no leading zero for single-digit months (Example:6) -- mm,MM: Month as digits, leading zero for single-digit months (Example:06) -- mmm,MMM: Month as a three-letter abbreviation (Example:Jun) -- mmmm,MMMM: Month as its full name (Example:June) -- n,N: minutes in hour, no leading zero for single-digit minutes (Example:3) -- nn,NN: minutes in hour, leading zero for single-digit minutes (Example:03) -- s,S: seconds in minute, no leading zero for single-digit seconds (Example:3) -- ss,SS: seconds in minute, leading zero for single-digit seconds (Example:03) -- t,T: one-character time marker string (Example:P) -- tt,TT: multiple-character time marker string (Example:PM) -- w: Week in year, no leading zero for single-digit hours (Example:27) -- ww: Week in year, leading zero for single-digit hours (Example:27) -- W: Week in month, no leading zero for single-digit hours (Example:2) -- WW: Week in month, leading zero for single-digit hours (Example:02) -- y,yy,yyy: Year as last two digits, leading zero for single-digit (Example:09) -- yyyy: Year represented by four digits (Example:2009) -- z,zz,zzz: General time zone as a 3 to 4 letter abbreviation (Example:PST) -- zzzz: General time zone as its full name (Example:Pacific Standard Time) -- Z,..,ZZZZ: RFC 822 time zone (Example:-0800) +- `a,..,aaaa`: AM/PM marker (see also "t" and "tt"; Example:AM) +- `d`: Day in month, no leading zero for single-digit days (Example:3) +- `dd`: Day in month, leading zero for single-digit days (Example:03) +- `D`: Day in year, no leading zero for single-digit days (Example:4) +- `DD`: Day in month, leading zero for single-digit days (Example:04) +- `DDD`: Day in month, 2 leading zero for single-digit days (Example:004) +- `E,EE,EEE`: Day of week as a three-letter abbreviation (Example:Tue) +- `EEEE`: Day of week as its full name (Example:Tuesday) +- `F`: Day of week in month, no leading zero for single-digit days (Example:4) +- `FF`: Day of week in month, leading zero for single-digit days (Example:04) +- `G,GG`: Era designator (Example:AD) +- `h`: Hour in am/pm (1-12), no leading zero for single-digit hours (Example:3) +- `hh`: Hour in am/pm (1-12), leading zero for single-digit hours (Example:03) +- `H`: Hour in day (0-23), no leading zero for single-digit hours (Example:14) +- `HH`: Hour in day (00-23), leading zero for single-digit hours (Example:14) +- `k`: Hour in day (1-24), no leading zero for single-digit hours (Example:15) +- `kk`: Hour in day (1-24), leading zero for single-digit hours (Example:15) +- `K`: Hour in am/pm (0-11), no leading zero for single-digit hours (Example:2) +- `KK`: Hour in am/pm (0-11), leading zero for single-digit hours (Example:02) +- `l,L`: milliseconds, with no leading zeros (Example:3) +- `ll,LL`: milliseconds, leading zero for single-digit days (Example:03) +- `lll,LLL`: milliseconds, 2 leading zero for single-digit days (Example:003) +- `m,M`: Month as digits, no leading zero for single-digit months (Example:6) +- `mm,MM`: Month as digits, leading zero for single-digit months (Example:06) +- `mmm,MMM`: Month as a three-letter abbreviation (Example:Jun) +- `mmmm,MMMM`: Month as its full name (Example:June) +- `n,N`: minutes in hour, no leading zero for single-digit minutes (Example:3) +- `nn,NN`: minutes in hour, leading zero for single-digit minutes (Example:03) +- `s,S`: seconds in minute, no leading zero for single-digit seconds (Example:3) +- `ss,SS`: seconds in minute, leading zero for single-digit seconds (Example:03) +- `t,T`: one-character time marker string (Example:P) +- `tt,TT`: multiple-character time marker string (Example:PM) +- `w`: Week in year, no leading zero for single-digit hours (Example:27) +- `ww`: Week in year, leading zero for single-digit hours (Example:27) +- `W`: Week in month, no leading zero for single-digit hours (Example:2) +- `WW`: Week in month, leading zero for single-digit hours (Example:02) +- `y,yy,yyy`: Year as last two digits, leading zero for single-digit (Example:09) +- `yyyy`: Year represented by four digits (Example:2009) +- `z,zz,zzz`: General time zone as a 3 to 4 letter abbreviation (Example:PST) +- `zzzz`: General time zone as its full name (Example:Pacific Standard Time) +- `Z,..,ZZZZ`: RFC 822 time zone (Example:-0800) The following masks can be used to format the full date and time and may not be combined with other masks: -- short: equivalent to "m/d/y h:mm tt" -- medium: equivalent to "mmm d, yyyy h:mm:ss tt" -- long: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:mm:ss tt zzz" -- full: equivalent to "dddd, mmmm d, yyyy h:mm:ss tt zz" -- ISO8601: equivalent to "yyyy-mm-dd'T'HH:nn:ss'Z'Z" +- `short`: equivalent to "m/d/y h:mm tt" +- `medium`: equivalent to "mmm d, yyyy h:mm:ss tt" +- `long`: medium followed by three-letter time zone; i.e. "mmmm d, yyyy h:mm:ss tt zzz" +- `full`: equivalent to "dddd, mmmm d, yyyy h:mm:ss tt zz" +- `ISO8601`: equivalent to "yyyy-mm-dd'T'HH:nn:ss'Z'Z" +- `ISOMillis/ISOMs/javascript`: Javascript style ISO date, equivalent to "yyyy-mm-dd'T'HH:nn:ss.SSS'Z'Z" diff --git a/docs/04.guides/04.cookbooks/25.Deploy-Archives/page.md b/docs/04.guides/04.cookbooks/25.Deploy-Archives/page.md deleted file mode 100644 index 5e78d4fba..000000000 --- a/docs/04.guides/04.cookbooks/25.Deploy-Archives/page.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Creating and deploying Lucee Archives (.lar files) -id: deploy-archives ---- -## Deploy Archive ## - -This document explains how to deploy an Application on a live server without using single CFML file. - -Simple example: - -### Using CFC file ### - -```lucee -//placed under outside root/component/org/lucee/examples/deploy/Test.cfc - -component test { - function salve() { - return "Hi There" - } -} - -``` - -You will need to add a mapping for the above cfc, because it's not inside the Root folder - -Create component mapping in **Archives & Resources -> Component** - -create a mapping test.cfc as like below - -``` -name: mycfc -resource: **Full folder path**/component/ -``` - -After creating the mapping, you need to create an archive file for the cfc. - -* Go to the detail view of mycfc mapping page, -* Click the button **assign archive to mapping**. - -Archive(lar file) created automatically and saved in WEB-INF\lucee\context\archives - -Now you can see the archive path on mycfc mapping - -### Using CFM file ### - -Create a mapping for below CFM file, - -```lucee -//placed under /ROOT/test/deploy/index.cfm - -test = new org.lucee.examples.deploy.Test(); -dump(test.slave()); - -``` - -``` -name: /deploy -resource: ROOT/test/deploy/index.cfm -``` - -After creating mapping in the Administrator, you can create an Archive file by clicking **assign archive to mapping** - -Now you can see the both lar files were in WEB-INF\lucee\context\archives folder. - -* One is lucee\context\archives\xxx-deploy.lar file, -* another one is lucee\context\archives\xxx-mycfc.lar - -Now you can place the archive files in your target server. - -Copy the archive files (deploy.lar, mycfc.lar) and placed in target server /WEB-INF/lucee/deploy folder wait for a minute. It successfully deploy your archives into the server. - -You can now view mappings in admin. - -### Footnotes ### - -Here you can see above details in video - -[Lucee Deploy Archive file](https://www.youtube.com/watch?time_continue=473&v=E9Z0KvspBAY) diff --git a/docs/04.guides/04.cookbooks/52.Flyingsaucer/page.md b/docs/04.guides/04.cookbooks/52.Flyingsaucer/page.md deleted file mode 100755 index c60a02810..000000000 --- a/docs/04.guides/04.cookbooks/52.Flyingsaucer/page.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Flying Saucer PDF Engine - CFDOCUMENT -id: flying_saucer -related: -- tag-document -categories: -- pdf -description: The new CFDOCUMENT PDF engine, Flying Saucer in Lucee 5.3 -menuTitle: The new PDF engine, Flying Saucer in Lucee 5.3 ---- - -This document provides information about the new PDF engine, [Flying Saucer](https://github.com/flyingsaucerproject/flyingsaucer) (FS) in Lucee 5.3 - -Flying saucer is a new PDF engine in Lucee. PDF engines are mainly used to convert HTML to PDF format. - -### Benefits of moving to Flying Saucer from the old engine (PD4ML) ### - -* Full support for CSS 2.1 -* On average the generated PDFs are smaller -* Consume less Memory and CPU -* Engine in active development, -* Better Results - -### Downsides to Flying Saucer compared to the old engine (PD4ML) ### - -* The generated PDF does not always look exactly the same when generated with the new FC compared to files generated with the PD4ML. - -If it's important that the PDF output remains exactly the same as the old PD4ML-generated file, you will need to check it manually. - -If you don't have time to check all PDF outputs, or you really don't care about the fancy new engine, simply add the following code to use the old PDF engine. - -via Application.cfc, - -```luceescript -this.pdf.type = "classic"; -``` - -or if you are using an Application.cfm, - -```lucee - -``` - -and since the PDF Extension 1.0.0.92-SNAPSHOT you can specify the engine using type - -```lucee - - or - -``` - -### Features of Flying Saucer ### - -You can define a font directory where you have the fonts(.ttf,.otf) you are using in your PDF. - -### Define the font directory #### - -```lucee - -``` - -Define the font directory Application itself: - -via Application.cfc - -```luceescript -this.pdf.fontDirectory = "path/to/my/font"; -``` - -or via application.cfm - -```lucee - -``` - -If the font directory isn't specified, Lucee will look for fonts in /WEB_INF/lucee/fonts and uses them if they match. - -**Note**: Classic engine works using the font-family-name from pd4fonts.properties file. Modern (Flying saucer) engine works using the font-family-name from the .ttf file with the same case. - -#### Simplify Attributes #### - -Attributes with cfdocument are a mess. You can make it clearer using the following syntax: - -Example: - -```lucee - -``` - -In Lucee you can do the following: - -```lucee - -``` - -Or even simpler - -```lucee - -``` - -#### Additional Units #### - -In addition to "inch" and "cm", the attribute unit now supports "pixel" and "points". - -```lucee - -``` - -If you find any issues while using the new PDF engine, please ask a question on the [mailing list](https://dev.lucee.org/) - -### Footnotes ### - -You can see the details in this video: -[Flying saucer](https://www.youtube.com/watch?v=B3Yfa8SUKKg) diff --git a/docs/recipes/archives-creating-and-deploy.md b/docs/recipes/archives-creating-and-deploy.md index d9d55c76d..f8603ae62 100644 --- a/docs/recipes/archives-creating-and-deploy.md +++ b/docs/recipes/archives-creating-and-deploy.md @@ -12,6 +12,9 @@ "Component", "CFC", "CFM" + ], + "categories": [ + "server" ] } --> diff --git a/docs/recipes/check-for-changes.md b/docs/recipes/check-for-changes.md index 50bbd0483..6851111c4 100644 --- a/docs/recipes/check-for-changes.md +++ b/docs/recipes/check-for-changes.md @@ -10,6 +10,9 @@ "Automatic update", "Server context", "Web context" + ], + "categories": [ + "server" ] } --> diff --git a/docs/recipes/configuration.md b/docs/recipes/configuration.md index 9c6ec1a0f..46e1a4fb8 100644 --- a/docs/recipes/configuration.md +++ b/docs/recipes/configuration.md @@ -1,11 +1,18 @@ diff --git a/docs/recipes/datasource-how-to-define-them.md b/docs/recipes/datasource-how-to-define-them.md index 00f3a7adb..e31247a3d 100644 --- a/docs/recipes/datasource-how-to-define-them.md +++ b/docs/recipes/datasource-how-to-define-them.md @@ -10,6 +10,10 @@ "Application.cfc", "Default datasource", "MySQL" + ], + "categories":[ + "query", + "server" ] } --> diff --git a/docs/recipes/mappings-how-to-define-a-reg-mapping.md b/docs/recipes/mappings-how-to-define-a-reg-mapping.md index 0b666a83e..535a21164 100644 --- a/docs/recipes/mappings-how-to-define-a-reg-mapping.md +++ b/docs/recipes/mappings-how-to-define-a-reg-mapping.md @@ -9,7 +9,8 @@ ], "categories": [ "application", - "files" + "files", + "server" ], "description": "All about the different mappings in Lucee and how to use them.", "keywords": [ diff --git a/docs/recipes/pdf-engine-flying-saucer.md b/docs/recipes/pdf-engine-flying-saucer.md index 68aac9d9e..6ac6825da 100644 --- a/docs/recipes/pdf-engine-flying-saucer.md +++ b/docs/recipes/pdf-engine-flying-saucer.md @@ -1,6 +1,6 @@ diff --git a/docs/recipes/using-s3-directly-for-source-code.md b/docs/recipes/using-s3-directly-for-source-code.md index 8d215107e..2f91c3a07 100644 --- a/docs/recipes/using-s3-directly-for-source-code.md +++ b/docs/recipes/using-s3-directly-for-source-code.md @@ -3,7 +3,8 @@ "title": "Using S3 directly for source code", "id": "using-s3-directly-for-source-code", "categories": [ - "s3" + "s3", + "server" ], "description": "Using S3 directly for source code", "keywords": [