Начал писать документацию движка JP

От проекта к проекту генерации pdf-файлов в браузере у движка всё больше функций. Какие-то используются постоянно. Некоторые — редкие, и применение забывается.

Настройки документа стараюсь уместить в шаблон. Там описаны не только цвета, позиции и размеры, но и условия. Есть даже понятие «опциональный объект» — правило применяется, когда объект существует.

Если натыкаюсь на правило, которое не помню, открываю прошлые проекты и копирую. Но иногда даже и скопированный код не помню, как работает. Приходится искать выполнения этого правила внутри. 🤪

Например, что означает

lineHeightType: JPLineHeightType.baselineXHeight

? Вроде ясно, что тут что-то связано с межстрочным расстоянием по xHeight шрифта. Но как именно работает и отчего зависит, уже неизвестно...

Поэтому начал писать документацию. Пока просто в описательной форме на стандартных стилях. Потом, конечно, перенесу на какой-то движок.

Ну и это дополнительная защита от возможных коллекторов техдокументации.

ChatGPT

Попробовал нейронку для генерации кода. Такое ощущение, что подходит чат не для всех языков программирования.

Пытался получить простой (на первый взгляд) код — вывести текст из переполненного текстового блока Индизайна. Фиг там :))

В его коде на первом слайде видно, что он булево свойство

.overflows

тут же использует как массив. Конечно, в JS всё можно пихать в

if

, но...

10 раз уточнял вопрос. Чат писал «Вы правы, это не работает. Вот...» и выдавал похожее другими методами. Самое смешное, что код выдаётся как работающий. Это легко! На! Без сомнения.

На картинке 2 видно, что чат от бессилия предложил сам создать текстовый блок :))

Конечно, я задал вопрос с небольшим подвохом. Но это не супер уж сложная задача.

Когда я сам написал правильный код, чат на белом глазу написал: «Да, вы правы...» и 3 строчки кода.

В общем, не скоро он доберётся до ExtendScript, тем более что он задокументирован не весь, а что задокументировано не всегда работает.

Это ж Ад'об

Самое странное для меня, что чат применяет несуществующие штуки. А когда ему говоришь, что это не работает, он такой: Да, вы правы, действительно.

Прям как на экзамене: когда не знаешь предмет, говоришь преподу какую-то чепуху, а когда тебя поправляют, ты такой: «Да, вы правы» и погнал дальше.

Но попробую позже новую версию чата.

Кстати, что такое ExtendScript? И какого он года?

Отвечать будет ChatGPT:

(я думал он 2004 года....)