Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
100 additions
and
125 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,100 @@ | ||
# Adobe Illustrator Scripting Guide | ||
|
||
This repo hosts the Adobe Illustrator Scripting Guide RST docs, linked into a http://readthedocs.io system hosted at https://ai-scripting.docsforadobe.dev/ | ||
|
||
This came from the Adobe Illustrator CC Scripting Guide (https://www.adobe.io/apis/creativecloud/illustrator.html). | ||
|
||
--- | ||
|
||
## To-do | ||
|
||
This project is still VERY wip! Still to do: | ||
|
||
### Scripting Guide Section | ||
|
||
- Find/replace ``keyword`` with link to section | ||
|
||
### Code Reference: | ||
|
||
- Finish JS obj ref | ||
- Organize into folders / sections based on root object | ||
- Resolve all 'todo' parameter descriptions (what is ``relativeObject``?) | ||
- Add Applescript obj ref | ||
- Add VBScript obj ref | ||
- Changelog | ||
|
||
--- | ||
|
||
## Contribution | ||
|
||
Contributors are welcome and encouraged to suggest fixes, adjustments, notes/warnings, and anything else that may help the project. | ||
|
||
### Internal References | ||
|
||
Anchors should be defined at each page setting relative to the root folder; the anchor for the "Application" page within the JS Object Reference should be: | ||
|
||
.. _jsobjref/Application | ||
|
||
And the anchor for a child item (property, method or example): | ||
|
||
.. _jsobjref/Application.open | ||
|
||
Then, to link to these items from other pages, we use: | ||
|
||
:ref:`jsobjref/Application` | ||
|
||
or: | ||
|
||
:ref:`jsobjref/Application.open` | ||
|
||
### External Links | ||
|
||
These should follow the following structure: | ||
|
||
`Link Text <http://www.aenhancers.com>`__ | ||
|
||
### Tables | ||
|
||
Function parameter tables should have following order: | ||
|
||
+---------------+------+-----------------------------+ | ||
| Parameter | Type | Description | | ||
+===============+======+=============================+ | ||
| ``parameter`` | Type | What does the parameter do? | | ||
+---------------+------+-----------------------------+ | ||
|
||
Use `Table Formatter <https://marketplace.visualstudio.com/items?itemName=shuworks.vscode-table-formatter>`_ for VSCode for easier table formating. | ||
|
||
### Admonitions Usage | ||
|
||
Currently, the following `admonitions <http://docutils.sourceforge.net/docs/ref/rst/directives.html#admonitions>`_ are in use in this project. | ||
|
||
Try to keep one piece of data per note, for easier parsing. | ||
|
||
.. note:: | ||
Notes detail version added, and/or relevant pieces of information. | ||
|
||
.. tip:: | ||
Tips supply helpful suggestions on usage or behaviours. | ||
|
||
.. warning:: | ||
Warnings convey negative behaviours, or when something won't work the way you'd expect. | ||
|
||
--- | ||
|
||
## Build HTML Locally | ||
|
||
You may want to build the HTML locally before pushing, in order to ensure that the result is what you'd expect. These files aren't included in the git repo, nor are they used online; this is solely to create a local, offline version of the online docs. | ||
|
||
- Install ``Python 2.7`` | ||
- Install ``pip`` | ||
- Navigate to the project directory and use the command ``pip install -r requirements.txt`` | ||
- Build the docs using ``make html`` | ||
|
||
--- | ||
|
||
## Licensing & Ownership | ||
|
||
This project exists for educational purposes only. | ||
|
||
All content is copyright Adobe Systems Incorporated. |
This file was deleted.
Oops, something went wrong.