diff --git a/docz/docs/02-getting-started/01-installation/04-amd.md b/docz/docs/02-getting-started/01-installation/04-amd.md index 4698990..179933e 100644 --- a/docz/docs/02-getting-started/01-installation/04-amd.md +++ b/docz/docs/02-getting-started/01-installation/04-amd.md @@ -36,7 +36,7 @@ define(['N/file', './xlsx.full.min'], function(file, XLSX) { }) ``` -As explained in the [NetSuite demo](/docs/demos/netsuite), module +As explained in the [NetSuite demo](/docs/demos/cloud/netsuite), module aliases are created in config files referenced via `@NAmdConfig` comments. ## SAP UI5 diff --git a/docz/docs/03-demos/10-frontend/02-react.md b/docz/docs/03-demos/01-frontend/01-react.md similarity index 97% rename from docz/docs/03-demos/10-frontend/02-react.md rename to docz/docs/03-demos/01-frontend/01-react.md index 818ca40..79ba1b1 100644 --- a/docz/docs/03-demos/10-frontend/02-react.md +++ b/docz/docs/03-demos/01-frontend/01-react.md @@ -1,8 +1,8 @@ --- title: ReactJS -pagination_prev: demos/server -pagination_next: demos/aws -sidebar_position: 2 +pagination_prev: demos/index +pagination_next: demos/mobile/index +sidebar_position: 1 --- [ReactJS](https://reactjs.org/) is a JS library for building user interfaces. diff --git a/docz/docs/03-demos/10-frontend/03-vue.md b/docz/docs/03-demos/01-frontend/02-vue.md similarity index 98% rename from docz/docs/03-demos/10-frontend/03-vue.md rename to docz/docs/03-demos/01-frontend/02-vue.md index 2f2ab35..a31db7a 100644 --- a/docz/docs/03-demos/10-frontend/03-vue.md +++ b/docz/docs/03-demos/01-frontend/02-vue.md @@ -1,8 +1,8 @@ --- title: VueJS -pagination_prev: demos/server -pagination_next: demos/aws -sidebar_position: 3 +pagination_prev: demos/index +pagination_next: demos/mobile/index +sidebar_position: 2 --- [VueJS](https://vuejs.org/) is a JS library for building user interfaces. diff --git a/docz/docs/03-demos/10-frontend/01-angular.md b/docz/docs/03-demos/01-frontend/03-angular.md similarity index 99% rename from docz/docs/03-demos/10-frontend/01-angular.md rename to docz/docs/03-demos/01-frontend/03-angular.md index 673db0c..fb9bf8e 100644 --- a/docz/docs/03-demos/10-frontend/01-angular.md +++ b/docz/docs/03-demos/01-frontend/03-angular.md @@ -1,8 +1,8 @@ --- title: Angular -pagination_prev: demos/server -pagination_next: demos/aws -sidebar_position: 1 +pagination_prev: demos/index +pagination_next: demos/mobile/index +sidebar_position: 3 --- import Tabs from '@theme/Tabs'; diff --git a/docz/docs/03-demos/10-frontend/04-svelte.md b/docz/docs/03-demos/01-frontend/04-svelte.md similarity index 98% rename from docz/docs/03-demos/10-frontend/04-svelte.md rename to docz/docs/03-demos/01-frontend/04-svelte.md index 4946d0c..d0fab62 100644 --- a/docz/docs/03-demos/10-frontend/04-svelte.md +++ b/docz/docs/03-demos/01-frontend/04-svelte.md @@ -1,7 +1,7 @@ --- title: Svelte -pagination_prev: demos/server -pagination_next: demos/aws +pagination_prev: demos/index +pagination_next: demos/mobile/index sidebar_position: 4 --- diff --git a/docz/docs/03-demos/10-frontend/08-bundler.md b/docz/docs/03-demos/01-frontend/08-bundler.md similarity index 99% rename from docz/docs/03-demos/10-frontend/08-bundler.md rename to docz/docs/03-demos/01-frontend/08-bundler.md index d294d3e..07acdab 100644 --- a/docz/docs/03-demos/10-frontend/08-bundler.md +++ b/docz/docs/03-demos/01-frontend/08-bundler.md @@ -1,7 +1,7 @@ --- title: Bundlers -pagination_prev: demos/server -pagination_next: demos/aws +pagination_prev: demos/index +pagination_next: demos/mobile/index sidebar_position: 8 sidebar_custom_props: skip: 1 diff --git a/docz/docs/03-demos/10-frontend/09-legacy.md b/docz/docs/03-demos/01-frontend/09-legacy.md similarity index 99% rename from docz/docs/03-demos/10-frontend/09-legacy.md rename to docz/docs/03-demos/01-frontend/09-legacy.md index 91a0dec..2c1f10e 100644 --- a/docz/docs/03-demos/10-frontend/09-legacy.md +++ b/docz/docs/03-demos/01-frontend/09-legacy.md @@ -1,7 +1,7 @@ --- title: Legacy Frameworks -pagination_prev: demos/server -pagination_next: demos/aws +pagination_prev: demos/index +pagination_next: demos/mobile/index sidebar_position: 9 sidebar_custom_props: skip: 1 diff --git a/docz/docs/03-demos/10-frontend/_category_.json b/docz/docs/03-demos/01-frontend/_category_.json similarity index 73% rename from docz/docs/03-demos/10-frontend/_category_.json rename to docz/docs/03-demos/01-frontend/_category_.json index e72711d..47e260c 100644 --- a/docz/docs/03-demos/10-frontend/_category_.json +++ b/docz/docs/03-demos/01-frontend/_category_.json @@ -1,5 +1,5 @@ { "label": "Web Frameworks", - "position": 10, + "position": 1, "collapsed": false } \ No newline at end of file diff --git a/docz/docs/03-demos/10-frontend/index.md b/docz/docs/03-demos/01-frontend/index.md similarity index 97% rename from docz/docs/03-demos/10-frontend/index.md rename to docz/docs/03-demos/01-frontend/index.md index d7f5e11..a9a7551 100644 --- a/docz/docs/03-demos/10-frontend/index.md +++ b/docz/docs/03-demos/01-frontend/index.md @@ -1,7 +1,7 @@ --- title: Web Frameworks -pagination_prev: demos/server -pagination_next: demos/aws +pagination_prev: demos/index +pagination_next: demos/mobile/index --- import DocCardList from '@theme/DocCardList'; diff --git a/docz/docs/03-demos/02-mobile/01-reactnative.md b/docz/docs/03-demos/02-mobile/01-reactnative.md index 88498bd..5672b3a 100644 --- a/docz/docs/03-demos/02-mobile/01-reactnative.md +++ b/docz/docs/03-demos/02-mobile/01-reactnative.md @@ -1,6 +1,6 @@ --- title: React Native -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index sidebar_position: 1 sidebar_custom_props: diff --git a/docz/docs/03-demos/02-mobile/02-nativescript.md b/docz/docs/03-demos/02-mobile/02-nativescript.md index 64c4dd9..9bde775 100644 --- a/docz/docs/03-demos/02-mobile/02-nativescript.md +++ b/docz/docs/03-demos/02-mobile/02-nativescript.md @@ -1,6 +1,6 @@ --- title: NativeScript -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index sidebar_position: 2 sidebar_custom_props: diff --git a/docz/docs/03-demos/02-mobile/03-quasar.md b/docz/docs/03-demos/02-mobile/03-quasar.md index f9ef1fb..65440c4 100644 --- a/docz/docs/03-demos/02-mobile/03-quasar.md +++ b/docz/docs/03-demos/02-mobile/03-quasar.md @@ -1,6 +1,6 @@ --- title: Quasar -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index sidebar_position: 3 sidebar_custom_props: diff --git a/docz/docs/03-demos/02-mobile/04-ionic.md b/docz/docs/03-demos/02-mobile/04-ionic.md index e6e879d..f397c8e 100644 --- a/docz/docs/03-demos/02-mobile/04-ionic.md +++ b/docz/docs/03-demos/02-mobile/04-ionic.md @@ -1,6 +1,6 @@ --- title: Ionic -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index sidebar_position: 4 sidebar_custom_props: diff --git a/docz/docs/03-demos/02-mobile/05-capacitor.md b/docz/docs/03-demos/02-mobile/05-capacitor.md index fd7a82c..0c35374 100644 --- a/docz/docs/03-demos/02-mobile/05-capacitor.md +++ b/docz/docs/03-demos/02-mobile/05-capacitor.md @@ -1,6 +1,6 @@ --- title: CapacitorJS -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index sidebar_position: 5 sidebar_custom_props: diff --git a/docz/docs/03-demos/02-mobile/_category_.json b/docz/docs/03-demos/02-mobile/_category_.json index 4fbae02..4295678 100644 --- a/docz/docs/03-demos/02-mobile/_category_.json +++ b/docz/docs/03-demos/02-mobile/_category_.json @@ -1,4 +1,4 @@ { "label": "iOS and Android Apps", - "position": 3 + "position": 2 } \ No newline at end of file diff --git a/docz/docs/03-demos/02-mobile/index.md b/docz/docs/03-demos/02-mobile/index.md index cef0475..0c94e05 100644 --- a/docz/docs/03-demos/02-mobile/index.md +++ b/docz/docs/03-demos/02-mobile/index.md @@ -1,6 +1,6 @@ --- title: iOS and Android Apps -pagination_prev: demos/salesforce +pagination_prev: demos/frontend/index pagination_next: demos/desktop/index --- diff --git a/docz/docs/03-demos/03-desktop/01-electron.md b/docz/docs/03-demos/03-desktop/01-electron.md index a6c1a7d..bb4db74 100644 --- a/docz/docs/03-demos/03-desktop/01-electron.md +++ b/docz/docs/03-demos/03-desktop/01-electron.md @@ -1,7 +1,7 @@ --- title: Electron pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 1 sidebar_custom_props: summary: Embedded NodeJS + Chromium diff --git a/docz/docs/03-demos/03-desktop/02-nwjs.md b/docz/docs/03-demos/03-desktop/02-nwjs.md index f3f5a0f..180d3ba 100644 --- a/docz/docs/03-demos/03-desktop/02-nwjs.md +++ b/docz/docs/03-demos/03-desktop/02-nwjs.md @@ -1,7 +1,7 @@ --- title: NW.js pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 2 sidebar_custom_props: summary: Embedded Chromium + NodeJS diff --git a/docz/docs/03-demos/03-desktop/03-wails.md b/docz/docs/03-demos/03-desktop/03-wails.md index 377f95d..03306bd 100644 --- a/docz/docs/03-demos/03-desktop/03-wails.md +++ b/docz/docs/03-demos/03-desktop/03-wails.md @@ -1,7 +1,7 @@ --- title: Wails pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 3 sidebar_custom_props: summary: Webview + Go Backend diff --git a/docz/docs/03-demos/03-desktop/04-tauri.md b/docz/docs/03-demos/03-desktop/04-tauri.md index 59524b9..a161728 100644 --- a/docz/docs/03-demos/03-desktop/04-tauri.md +++ b/docz/docs/03-demos/03-desktop/04-tauri.md @@ -1,7 +1,7 @@ --- title: Tauri pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 4 sidebar_custom_props: summary: Webview + Rust Backend diff --git a/docz/docs/03-demos/03-desktop/05-neutralino.md b/docz/docs/03-demos/03-desktop/05-neutralino.md index 4f9568c..61a153c 100644 --- a/docz/docs/03-demos/03-desktop/05-neutralino.md +++ b/docz/docs/03-demos/03-desktop/05-neutralino.md @@ -1,7 +1,7 @@ --- title: NeutralinoJS pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 5 sidebar_custom_props: summary: Webview + Lightweight Extensions diff --git a/docz/docs/03-demos/03-desktop/06-reactnative.md b/docz/docs/03-demos/03-desktop/06-reactnative.md index cf76f7c..4a97731 100644 --- a/docz/docs/03-demos/03-desktop/06-reactnative.md +++ b/docz/docs/03-demos/03-desktop/06-reactnative.md @@ -1,7 +1,7 @@ --- title: React Native for Desktop pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index sidebar_position: 6 sidebar_custom_props: summary: Native Components with React diff --git a/docz/docs/03-demos/03-desktop/index.md b/docz/docs/03-demos/03-desktop/index.md index ec9e6be..e7f34ca 100644 --- a/docz/docs/03-demos/03-desktop/index.md +++ b/docz/docs/03-demos/03-desktop/index.md @@ -1,7 +1,7 @@ --- title: Desktop Applications pagination_prev: demos/mobile/index -pagination_next: demos/grid +pagination_next: demos/cloud/index --- import DocCardList from '@theme/DocCardList'; diff --git a/docz/docs/03-demos/01-salesforce.md b/docz/docs/03-demos/04-cloud/01-salesforce.md similarity index 99% rename from docz/docs/03-demos/01-salesforce.md rename to docz/docs/03-demos/04-cloud/01-salesforce.md index 1d14421..00c290f 100644 --- a/docz/docs/03-demos/01-salesforce.md +++ b/docz/docs/03-demos/04-cloud/01-salesforce.md @@ -1,5 +1,8 @@ --- title: Salesforce LWC +pagination_prev: demos/desktop/index +pagination_next: demos/grid +sidebar_position: 1 --- Salesforce apps can use third-party libraries in "Lightning Web Components". diff --git a/docz/docs/03-demos/21-aws.md b/docz/docs/03-demos/04-cloud/02-aws.md similarity index 98% rename from docz/docs/03-demos/21-aws.md rename to docz/docs/03-demos/04-cloud/02-aws.md index 739d4e3..33b8c95 100644 --- a/docz/docs/03-demos/21-aws.md +++ b/docz/docs/03-demos/04-cloud/02-aws.md @@ -1,6 +1,8 @@ --- title: Amazon Web Services -pagination_prev: demos/frontend/index +pagination_prev: demos/desktop/index +pagination_next: demos/grid +sidebar_position: 2 --- AWS is a Cloud Services platform which includes traditional virtual machine diff --git a/docz/docs/03-demos/22-azure.md b/docz/docs/03-demos/04-cloud/03-azure.md similarity index 98% rename from docz/docs/03-demos/22-azure.md rename to docz/docs/03-demos/04-cloud/03-azure.md index ee69740..960a4ed 100644 --- a/docz/docs/03-demos/22-azure.md +++ b/docz/docs/03-demos/04-cloud/03-azure.md @@ -1,5 +1,8 @@ --- title: Azure Cloud Services +pagination_prev: demos/desktop/index +pagination_next: demos/grid +sidebar_position: 3 --- Azure is a Cloud Services platform which includes traditional virtual machine diff --git a/docz/docs/03-demos/23-netsuite.md b/docz/docs/03-demos/04-cloud/04-netsuite.md similarity index 97% rename from docz/docs/03-demos/23-netsuite.md rename to docz/docs/03-demos/04-cloud/04-netsuite.md index d1cdd8c..e45a821 100644 --- a/docz/docs/03-demos/23-netsuite.md +++ b/docz/docs/03-demos/04-cloud/04-netsuite.md @@ -1,5 +1,8 @@ --- title: NetSuite +pagination_prev: demos/desktop/index +pagination_next: demos/grid +sidebar_position: 4 --- This demo discusses the key SheetJS operations. Familiarity with SuiteScript 2 diff --git a/docz/docs/03-demos/04-cloud/_category_.json b/docz/docs/03-demos/04-cloud/_category_.json new file mode 100644 index 0000000..78c3007 --- /dev/null +++ b/docz/docs/03-demos/04-cloud/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Cloud Platforms", + "position": 4, + "collapsed": false +} \ No newline at end of file diff --git a/docz/docs/03-demos/04-cloud/index.md b/docz/docs/03-demos/04-cloud/index.md new file mode 100644 index 0000000..1603355 --- /dev/null +++ b/docz/docs/03-demos/04-cloud/index.md @@ -0,0 +1,39 @@ +--- +title: Cloud Platforms +pagination_prev: demos/desktop/index +pagination_next: demos/grid +--- + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + +Cloud platforms can provide remote storage, compute, and other infrastructure. +SheetJS libraries are written in pure JavaScript and are readily integrated in +cloud platforms. Some platform-specific configuration may be required. + +## Platform as a Service + +Cloud PaaS typically offer extensibility through client-side scripts or special +code that is run in NodeJS or RhinoJS or other engines: + +- [Salesforce Lightning Web Components](/docs/demos/cloud/salesforce) +- [NetSuite](/docs/demos/cloud/netsuite) + +## Cloud Compute + +Cloud computing is commonly offered as "serverless" functions, small snippets +of code that are run in NodeJS or other server-side JS platforms. While SheetJS +libraries can run in server-side environments, the cloud platforms can corrupt +form data. This can be disabled with cloud-specific configuration: + +- [AWS Lambda Functions](/docs/demos/cloud/aws#aws-lambda-functions) +- [Azure Functions](/docs/demos/cloud/azure#azure-functions) + +## Cloud Storage + +The primary pitfall with cloud storage is binary data mangling. Spreadsheet +files typically contain binary characters. Cloud storage APIs can corrupt +binary data, so special care must be taken. + +- [Amazon Simple Storage Service (S3)](/docs/demos/cloud/aws#s3-storage) +- [Azure Blob Storage](/docs/demos/cloud/azure#azure-blob-storage) diff --git a/docz/docs/03-demos/04-grid.md b/docz/docs/03-demos/04-grid.md index e7e4c3d..cad4f43 100644 --- a/docz/docs/03-demos/04-grid.md +++ b/docz/docs/03-demos/04-grid.md @@ -1,6 +1,6 @@ --- title: Data Grids and Tables -pagination_prev: demos/desktop/index +pagination_prev: demos/cloud/index --- Various JavaScript UI components provide a more interactive editing experience. @@ -518,10 +518,7 @@ npm i -S https://cdn.sheetjs.com/xlsx-latest/xlsx-latest.tgz vue3-table-lite 3) Download [`src/App.vue`](pathname:///vtl/App.vue) and replace the contents: ```bash -cd src -rm -f App.vue -curl -LO https://docs.sheetjs.com/vtl/App.vue -cd .. +curl -L -o src/App.vue https://docs.sheetjs.com/vtl/App.vue ``` 4) run `npm run dev`. When you load the page in the browser, it will try to diff --git a/docz/docs/03-demos/06-content.md b/docz/docs/03-demos/06-content.md index f8feda6..a54efb2 100644 --- a/docz/docs/03-demos/06-content.md +++ b/docz/docs/03-demos/06-content.md @@ -42,8 +42,7 @@ The project will be configured and modules will be installed. ```bash mkdir -p _data -curl -LO https://sheetjs.com/pres.numbers -mv pres.numbers _data +curl -L -o _data/pres.numbers https://sheetjs.com/pres.numbers ``` 3) Create a `index.njk` file that references the file. Since the file is @@ -223,8 +222,7 @@ move the downloaded file into the new folder: ```bash mkdir -p src/data -curl -LO https://sheetjs.com/pres.xlsx -mv pres.xlsx src/data +curl -L -o src/data/pres.xlsx https://sheetjs.com/pres.xlsx ``` 7) To verify, open the GraphiQL editor at `http://localhost:8000/___graphql`. @@ -848,8 +846,7 @@ The server is listening on that URL. Open the link in a web browser. 3) Download and move to the `content` folder. ```bash -curl -LO https://sheetjs.com/pres.xlsx -mv pres.xlsx content/ +curl -L -o content/pres.xlsx https://sheetjs.com/pres.xlsx ``` 4) Modify `nuxt.config.js` as follows: diff --git a/docz/docs/03-demos/index.md b/docz/docs/03-demos/index.md index de856d3..f075b10 100644 --- a/docz/docs/03-demos/index.md +++ b/docz/docs/03-demos/index.md @@ -65,13 +65,13 @@ run in the web browser, demos will include interactive examples. - [`Chrome and Chromium Extensions`](/docs/demos/chromium) - [`Google Sheets API`](/docs/demos/gsheet) - [`ExtendScript for Adobe Apps`](/docs/demos/extendscript) -- [`NetSuite SuiteScript`](/docs/demos/netsuite) -- [`Salesforce Lightning Web Components`](/docs/demos/salesforce) +- [`NetSuite SuiteScript`](/docs/demos/cloud/netsuite) +- [`Salesforce Lightning Web Components`](/docs/demos/cloud/salesforce) - [`Excel JavaScript API`](/docs/demos/excelapi) - [`Headless Automation`](/docs/demos/headless) - [`Other JavaScript Engines`](/docs/demos/engines) -- [`Azure Functions and Storage`](/docs/demos/azure) -- [`Amazon Web Services`](/docs/demos/aws) +- [`Azure Functions and Storage`](/docs/demos/cloud/azure) +- [`Amazon Web Services`](/docs/demos/cloud/aws) - [`Databases and Structured Data Stores`](/docs/demos/database) - [`NoSQL and Unstructured Data Stores`](/docs/demos/nosql) - [`Legacy Internet Explorer`](/docs/demos/frontend/legacy#internet-explorer) diff --git a/docz/docusaurus.config.js b/docz/docusaurus.config.js index 9a9261c..037a1b6 100644 --- a/docz/docusaurus.config.js +++ b/docz/docusaurus.config.js @@ -178,6 +178,11 @@ const config = { { from: '/docs/demos/vue', to: '/docs/demos/frontend/vue/' }, { from: '/docs/demos/bundler', to: '/docs/demos/frontend/bundler/' }, { from: '/docs/demos/legacy', to: '/docs/demos/frontend/legacy/' }, + /* cloud */ + { from: '/docs/demos/salesforce', to: '/docs/demos/cloud/salesforce/' }, + { from: '/docs/demos/aws', to: '/docs/demos/cloud/aws/' }, + { from: '/docs/demos/azure', to: '/docs/demos/cloud/azure/' }, + { from: '/docs/demos/netsuite', to: '/docs/demos/cloud/netsuite/' }, ] }] ]