Awesome Open Source
Awesome Open Source

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.

Generating the documentation

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.

Development guide

Building the documentation requires the following steps:

  1. 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
  2. Parse the XML files, output as JSON with ./src/xml2json.py.
  3. Map the output JSON files to the public directory with ./src/json2public.py. The file ./xml/map.json defines what files to copy.
  4. 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.

XML file locations

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

Troubleshooting

  • 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.

License

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


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
pug (97