Documentation for ExtendScript API

This repo contains the source code for building the documentation system. To see the built documentation, here.

Prerequisites

Python3
Node.js and npm
Adobe InDesign/Illustrator/Photoshop/Bridge/Audition and ExtendScript Toolkit for XML source files
(for Mac users, if you want the InDesign/Audition/Premiere Pro OMs) Mac OS Mojave or lower - ESTK is not available for Catalina and the OMV has not been brought in to the VSCode solution yet.

Install node packages:

$ npm install

Build automatically (only works on OS X and Windows 10, 64bit):

$ npm run build

The docs will be compiled to public/. OMV XML files will automatically be found.

Building the documentation requires the following steps:

Locate the source OMV XML files, copy them to ./xml/source. The script ./src/findxml will do this for you on OSX, ./src/findxml.baton Windows
Parse the XML files, output as JSON with ./src/xml2json.py.
Map the output JSON files to the public directory with ./src/json2public.py. The file ./xml/map.json defines what files to copy.
Build the web interface.

gulp and npm are setup to run these for you.

To build all the documentation from scratch:

$ npm run build

To watch src/ and compile automatically to public/:

$ npm run watch

To clean the dist files:

$ npm run clean

The easiest way to view the docs locally is to use zapp.

$ npm install -g zapp
$ zapp public/

Now open your browser here.

The XML source files can be found in the following locations on Mac OS X:

/Library/Application Support/Adobe/Scripting Dictionaries CC/CommonFiles
/Library/Application Support/Adobe/Scripting Dictionaries CC/photoshop
/Library/Application Support/Adobe/Scripting Dictionaries CC/Illustrator 2020
/Library/Application Support/Adobe/Scripting Dictionaries CC/Adobe Bridge 2020
~/Library/Preferences/ExtendScript Toolkit/4.0

On Windows 10, 64bit:

C:\Program Files (x86)\Common Files\Adobe\Scripting Dictionaries CC\CommonFiles
C:\Program Files\Common Files\Adobe\Scripting Dictionaries CC\illustrator 2020
C:\Program Files (x86)\Common Files\Adobe\Scripting Dictionaries CC\photoshop
C:\Program Files\Common Files\Adobe\Scripting Dictionaries CC\Adobe Bridge 2020
C:\Users\<YourUserName>\AppData\Roaming\Adobe\ExtendScript Toolkit\4.0

If there is no warning about missing XML files for InDesign / Audition / Premiere Pro but the json/HTML is not generated, it may be that the major/minor version number has increased. Compare what is searched for in xml/map.json and the XML files found in xml/source.

All source code for generating the documentation is under the MIT license. The XML source files (not included) remain property of Adobe.