Как написать скрипт для фотошопа

Здесь я буду вылкадывать простейшие действия со скриптами, в помощь изучающим возможности скриптов в #Photoshop. Это элементарные кирпичики из которых в последствии будут строиться сложные программы.
Внимание синтаксис!!!
Обращаю внимание на большие и маленькие буквы в тексте скриптов — это важно. Например не правильное написание activeDocument.АctiveLayer=… приведет к не работоспособности скрипта без сообщения об ошибке, правильная запись — activeDocument.activeLayer=… отличается только заглавной буквой — будьте внимательны к синтаксису #скриптов. Всего одна буква — большая разница.

---

Основные настройки документа.

preferences.rulerUnits = Units.MM;           //сделать размер документа в единицах изренения
preferences.typeUnits = TypeUnits.MM;     //задать для шрфиов единицу измерения

в примере еденицы измерения в миллиметрах — MM.
все возможные значения: CM INCHES MM PERCENT POINTS PIXELS PICAS

---

Функция определение битности документа.

function GetDocumentBitsPerChannel(){
var Bits =0;
if (app.activeDocument.bitsPerChannel == BitsPerChannelType.ONE) Bits = 1;
if (app.activeDocument.bitsPerChannel == BitsPerChannelType.EIGHT) Bits = 8;
if (app.activeDocument.bitsPerChannel == BitsPerChannelType.SIXTEEN) Bits = 16;
if (app.activeDocument.bitsPerChannel == BitsPerChannelType.THIRTYTWO) Bits = 32;
return Bits;
}

alert(‘ битность документа — ‘ +  GetDocumentBitsPerChannel() + ‘ бит ‘);

Функция GetDocumentBitsPerChannel() возвращает значения битности документа.

---

Определить есть ли открытый документ.

if (app.documents.length == 0)      {
alert(«нет открытого документа«)
}
else      {
alert («Выполнение основного кода«)
}

---

Окно ввода значений

var myInput = prompt(«Введите значение:«, «Значение по умолчанию«);
alert(«Введено значение » + myInput);

Окно для ввода значения переменной

---

Определение есть ли активное выделение в документе.

var GetSelect = 1;
try {var forgetIt = app.activeDocument.selection.bounds}
catch (a) {GetSelect = 0};
if (GetSelect==0 )  {
alert («Выделения нет«);
}
else  {
alert («Выделение есть«);
}

---

Окно сообщения с подтверждением действия ДА НЕТ.

var myResult = confirm(«Документ не сохранен. Сохранить его сейчас?«)
if (myResult == true) {
alert(«нажато ДА«)
}
else  {
alert(«Нажато НЕТ«)
}

---

Выбрать слой по имени слоя

activeDocument.activeLayer = activeDocument.artLayers.getByName(«имя слоя«);

---

Добавить выбор слоя по имени, к активному слою
если нужно выбрать сразу два слоя, нужно один слоя сделать активным — текст скрипта выше
добавление к выбранному осуществляется следующим кодом:

var D01 = new ActionDescriptor();
var R01 = new ActionReference();
R01.putName( 1283027488, «имя слоя» );
D01.putReference( 1853189228, R01 );
D01.putEnumerated( stringIDToTypeID( «selectionModifier» ), stringIDToTypeID( «selectionModifierType» ), stringIDToTypeID( «addToSelection» ) );
executeAction( 1936483188, D01, DialogModes.NO );

---

Получить размеры и положения слоя
будем получать всю информацию о размерах и положению активного слоя:

var bounds = activeDocument.activeLayer.bounds;
alert(«Х верхнего левого угла — «+bounds[0]+» Y верхнего левого угла — «+bounds[1]+»       Х нижнего правого угла — «+bounds[2]+» Y нижнего правого угла — «+bounds[3]);

bounds[0] — координата Х верхнего левого угла
bounds[1] — координата Y верхнего левого угла
bounds[2] — координата Х нижнего правого угла
bounds[3] — координата Y нижнего правого угла

получим размеры слоя:

var bounds = activeDocument.activeLayer.bounds;
var width = bounds[2].value — bounds[0].value;
var height = bounds[3].value — bounds[1].value;
var middleX = bounds[0].value + ( bounds[2].value — bounds[0].value )/2;
var middleY = bounds[1].value + ( bounds[3].value — bounds[1].value )/2;

в переменную width — передали ширину слоя
в переменную height — передали высоту слоя
в переменную middleX — передали координату X центра
в переменную middleY — передали координату Y центра

---

Определить размер слоя.

var bounds = activeDocument.activeLayer.bounds;
var width = bounds[2].value — bounds[0].value;
var height = bounds[3].value — bounds[1].value;
alert(«Ширина слоя «+width +» высота слоя «+height);

значения ширины и высоты находятся в переменных width и height соответственно

---

Изменение размера активного слоя в процентах.
Размер документа не изменяется.

activeDocument.activeLayer.resize(newSize, newSize, AnchorPosition.MIDDLECENTER);

описание параметров (newSizeW, newSizeH, AnchorPosition.MIDDLECENTER)

• newSizeW — изменение ширины в %
• newSizeH — изменение высоты в %
• AnchorPosition.MIDDLECENTER — точка от которой происходит изменение размера

возможные значения AnchorPosition:

• BOTTOMLEFT        нижний левый угол
• BOTTOMRIGHT      нижний правый угол
• MIDDLECENTER    центр
• MIDDLELEFT          середина левой стороны
• MIDDLERIGHT        середина правой стороны
• TOPCENTER          середина сверху
• TOPLEFT                верхний левый угол
• TOPRIGHT              верхний правый угол

---

Пропорциональное изменение размера активного слоя.
Изменение по ширине слоя:

var newWidth = требуемое значение по ширине;
var bounds = activeDocument.activeLayer.bounds;
var width = bounds[2].value — bounds[0].value; //получили текущую ширину слоя
var newSize = ((100 / width)*newWidth);
activeDocument.activeLayer.resize(newSize, newSize, AnchorPosition.MIDDLECENTER);

Изменение по высоте слоя:

var newHeight = требуемое значение по высоте;
var bounds = activeDocument.activeLayer.bounds;
var height = bounds[3].value — bounds[1].value; //получили текущую высоту слоя
var newSize = ((100 / height)*newHeight);
activeDocument.activeLayer.resize(newSize, newSize, AnchorPosition.MIDDLECENTER);

---

Если мы занимаемся веб-дизайном, то нам часто приходится иметь дело с сеткой, особенно если мы делаем адаптивный дизайн. В этом уроке, мы рассмотрим скрипт для Photoshop, который генерирует пользовательскую сетку, и более того мы заглянем под капот и разберем, как создать такой скрипт.

Вероятно, что вы уже используете psd файлы с той или иной сеткой. Возможно, что у вас открыт файл, и вы создали направляющие для данного размера документа, но если размер изменится, надо все менять.

В случае нашего скрипта, мы создаем направляющие независимо от размера документа. Он позволяет задать нам число колонок, промежуточные расстояния, и ширину макета. Я думаю этого достаточно для введения, давайте перейдем к уроку.

---

В этому уроке, мы напишем скрипт для Photoshop используя JavaScript. Ниже я перечислил функции и методы и другие детали, которые мы разберем.

• Использование переменных для обращения к активному документу.
• Использование вызова Prompt для входных данных от пользователя.
• Number() — функция для проверки, правильности входных данных (что это число).
• Метод Guides.add() для добавления направляющих в документ.
• Использование цикла  «for» для повторяющихся действий.
• Использование условного оператора «if» для запуска или прерывания программы.
• Разберем как менять единицы измерения в документе.

Прежде чем мы перейдем к процессу разработки, давайте сначала быстро разберем, как установить и использовать скрипты для  Adobe Photoshop.

---

Шаг 1: Загрузка и установка

Скрипт совместим с Photoshop CS5 и выше. Вы можете загрузить скрипт по ссылке «Download: Source code» или вы можете загрузить последнюю версию скрипта на моем веб-сайте. После того, как вы загрузите скрипт (.jsx файл), скопируйте его в директорию [Photoshop root]PresetsScripts.

Теперь он вам будет доступен через меню в  Photoshop, для этого зайдите в File > Scripts, как показано на рисунке ниже.

---

Шаг 2: Как Запустить Скрипт

Прежде чем вы запустите ваш скрипт, у вас должен быть открыть хотя бы один документ (иначе скрипт не будет работать и выдаст ошибку).  После того, как вы запустите скрипт, появится первое окно-подсказка. И вас попросят ввести ширину макета, которую вы будет использовать в своем дизайне.

Я использую 960рх по умолчанию, поэтому если вы не будете задавать другого значения, то останется 960рх.  Вы можете задать другую ширину, но лучше, если это будет четное число. Если вы зададите нечетное число, например 955, то в результате работы скрипта, получаться дробные числа.  Это значит, что это будет число с десятичной точкой, и тогда в расположении направляющей линии возникает неопределенность. Даже если мы округляем дробное число, мы не получим 100% точного расположения для наших направляющих.

---

Шаг 3: Количество Колонок

После того, как вы нажмете ввод, для первого запроса (или нажмите Ок, после того, как зададите ширину макета), появится следующий вопрос, который спросит у вас ввести количество колонок, которое будет у вас в макете. По умолчанию я сделал 12 колонок.

---

Шаг 4: Использование полей и межколоночного расстояния

И наконец, в третьем окне-запросе необходимо ввести размер полей (расстояние между границами и внешней стороной колонок). Эта величина удваивается, и получается межколоночное расстояние, как это делается в системе сеток 960.

---

Шаг 5: Использование Результатов

После того как вы введете данные во все три окна вы увидите , что вашем документе появились направляющие в виде колонок.  Вы не увидите направляющих линий, если они у вас отключены. Вы можете сделать их видимыми, если зайдете в View > Show > Guides (Ctrl+;).

На изображении выше, вы можете увидеть колонки, поля и межколоночное пространство. Цвета используются для того, чтобы показать, что есть что. Красным — обозначены колонки; белое — это межколоночное пространство, зеленый цвет для полей. У вас не будет всех этих цветов, только направляющие, как на следующей картинке.

---

Теперь вы знаете, как использовать скрипт, теперь давайте разберемся, как его создать, используя JavaScript!

---

Шаг 1: Проверка документа

Прежде чем запускать работу скрипта, на нужно убедиться, что в Photoshop открыт активный документ. Мы проверим это используя следующее условие:

 if ( app.documents.length != 0 ) 
 { 
 
 //Our entire code will go here 
 
 } else { 
 
 //No active document exists
 
 }

Мы пишем наш код, после фигурной скобки и должны закончит его, тоже фигурной скобкой, как вы видите выше.

---

Шаг 2: Конвертация единиц

Наша первая задача, сделать, чтобы единицами измерения в документе Photoshop были пиксели, потому что мы хотим чтобы наш дизайн был pixel perfect!

//This shall set  measuring units of document to Pixels.
  preferences.rulerUnits  = Units.PIXELS;

---

Шаг 3: Задаем Ширину Документа

Далее мы задаем размеры документа в Photoshop.

var doc = app.activeDocument; //save reference of active document to variable "doc" for easy typing later on
  var docWidth = doc.width; //gets the width of the document
and stores it in "docWidth"

Система сеток не зависит от высоты документа, поэтому мы ее здесь не учитываем.

---

Шаг 4: Вычисления горизонтального центра

Теперь нам нужно найти горизонтальный центр документа, или его ширина. Как это Сделать? Просто поделить документ на две части.

var docXcenter = docWidth / 2 ;

Возможно на данном этапе не совсем понятно, зачем мы вычисляем этот центр, но по мере дальнейшего нашего продвижения, станет ясно, для чего он нужен в нашем скрипте.

---

Шаг 5: Пользовательские Назначения

Теперь мы должны спросить пользователя, какую ширину макета он будет использовать, сколько будет колонок и какие поля между ними.

Например в сетках -960, используются следующие комбинации:

• Ширина макета : 960px
• 1й вариант: 12 колонок : 10px наружные поля : 20px межколоночное пространство
• 2й вариант: 16 колонок : 10px наружные поля : 20px межколоночное пространство
• 3й вариант: 24 колоноки : 5px наружные поля : 10px межколоночное пространство

Мы получим хорошие варианты, если будем использовать одну из этих комбинаций (выберем первую) по умолчанию.

// Get layout width from user. Default  to 960px.
var layoutWidth = Number ( prompt ( 'Enter layout width:' , 960 ) ) ;
 // This gets number of columns from user. Most appropriately 12,16, or 24. Default 12 columns. 
  var cols = Number ( prompt ( 'Enter numbers of columns:' , 12 ) );
// Gets margins from left right from user. Which will  later be doubled to get gutter. Default 10px
  var margin = Number ( prompt ( 'Enter space between columns:' , 10 ) );

---

Что такое Окно- Prompt()?

Ок, прежде чем мы пойдем дальше, давайте взглянем, что из себя представляет команда и окно «prompt».

prompt ("Message to user here", "Default value here");

Окно Prompt показывает диалоговое обращение к пользователю и дает возможность ввести значение, как вы можете видеть ниже:

Пользователь вводит требуемую величину, которую окно-prompt возвращает.

Первая часть аргументов в функции (которая идет до запятой) отвечает за сообщение для пользователя. Мы можем указать пользователю, какую величину мы от него требуем, какое ее значение будет корректным. Например:

prompt("Enter number of columns. Appropriate values are 12, 16, 24.", 12);

Второй аргумент в функции — это величина по умолчанию, которая будет появляться в окне ввода. В данном случае для колонок, мы используем величину 12.

А что На Счет Number( )?

Number  — это функция, которая позволяет нам получить число, из окна ввода. Если пользователь введет что-то отличное от числа (имя, например, или другую строку), тогда этот функция вернет NaN (Not a Number).  Эти меры безопасности, позволяют нам быть уверенными, что мы будем работать с числом, что важно для нашей ситуации. 

---

Теперь давайте разберемся с кодом, который мы написали чуть раньше.

Первая строчка, получает значение для ширины макета. Макет сайта будет лежать в этих пределах. Так как мы используем сетку 960, то величина по определению будет 960рх, но вы можете изменить это значение на любое, более предпочтительное для вас.

Во второй строчке, мы принимаем значения для числа колонок, которые пользователь хочет использовать в макете. В системе сеток 960 используются 12, 16 и 24 колонки, так как именно эти варианты наиболее эффективны, но они не обязательны.

И в третьей строке мы получаем информацию о пространстве между колонками и границах макета. Обычно это удвоенное расстояние образует межколоночное пространство.

---

Шаг 6: Вычисляем Межконолоночное Пространство и Центр

var gutter = space * 2; 
//Calculates the horizontal center of the layout and so the center of document 
  var layoutHalf = layoutWidth / 2 ;

Тут мы вычисляем межколоночное пространство и присваиваем значение переменной gutter. Во второй строчке, мы вычисляем середину макета, используя ширину, которую задал пользователь. Иными словами, вычисляем горизонтальный центр.

---

Шаг 7: Определяем Границы

В первой и второй строчках этой части нашего кода, мы вычисляем положение левой и правой границ нашего макета. Мы назовем их внешние границы (outer limits); левая граница — minLimitOuter, а правая граница — maxLimitOuter.

В следующих двух строчках мы вычисляем внутренние границы для макета. Это ширина макета минус размер полей. Можете думать о них как о поле, которое лежит в пространстве макета.

  //outer limits that is the layout width;
  var maxLimitOuter = docXcenter + layoutHalf;
var minLimitOuter = docXcenter - layoutHalf;

  //Inner limits for 960gs
  var minLimitInner = minLimitOuter + space;
  var maxLimitInner = maxLimitOuter - space;

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

Почему мы используем величину  layoutHalf? Это половина от ширины макета, заданной пользователем. Мы делим его пополам, чтобы мы могли разместить две половинки макета по разные стороны от docXcenter. Из этого мы можем определить положение направляющих на правом и левом краях макета.

Положение левой направляющей будет определяться как (Центр документа — половина ширины макета), а положение правой направляющей как (Центр документа + половина ширины макета).

---

Шаг 8: Ширина Колонок

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

 var colWidth = ( layoutWidth - ( cols * gutter ) ) / cols;

---

Шаг 9: Добавление направляющих для внешних границ

Наконец, мы подошли к нашему первому шагу по добавлению направляющих! Здесь мы добавляем две направляющих на границах макета; это наши внешние границы.

doc.guides.add ( Direction.VERTICAL , minLimitOuter );
doc.guides.add ( Direction.VERTICAL , maxLimitOuter );

В первой строчке мы добавляем вертикальную направляющую для нашего документа в положении minLimitOuter, — это слева, и в правой части макета — maxLimitOuter.

Позвольте мне объяснить подробнее последние строчки кода.

 doc.guides.add(Direction.VERTICAL/HORIZONTAL, position)

В этой строке добавляется направляющая в нашем Photoshop документе.»doc» — ссылается на наш активный документ.  «guides» это объект класса guides, который является элементом документа и отвечает за поведение и свойства направляющих в документе Photoshop. «add» — это метод класса guides, который позволяет добавить направляющую в наш документ.

doc.guides.add() это метод, которому требуется на входе два параметра. Первый — это направление для направляющей, она может быть вертикальной или горизонтальной. Второй параметр, это положение направляющей. Если у нас единицы измерения в пикселях, то предполагается, что положение задается в пикселях, или в других величинах при других единицах измерения.

---

Шаг 10: Первый Цикл

Первый цикл создает первую группу направляющих и внутренние границы:

  for ( i = 0 ; i < cols ; i++ ) {
  guidPos = minLimitInner + ( ( colWidth + gutter ) * i );
  if ( guidPos > maxLimitInner ) {
  break;
  }
  doc.guides.add ( Direction.VERTICAL , Number ( guidPos ) );
  }

Рассмотрим подробнее. Мы повторяем наш код col раз, так как это число колонок, которое задал пользователь. Также в этой части кода мы добавляем наши внутренние границы.

Первая строчка после «for» начинается с переменной «guidPos», которая используется для положения. Мы начинаем отсчет положений для направляющих от «minLimitInner»; внутренняя граница.  Далее мы умножаем colWidth и gutter на «i» , где i — принимает значения от 0 до «cols». Таким образом, мы получаем нашу первую группу направляющих. Эти направляющие будут расположены слева от каждой колонки.

Во второй строчке, мы проверяем, чтобы наша величина guidPos не превысила maxLimitInner; правая внутренняя граница документа. Если она ее превышает, то цикл прерывается. Если условие не выполняется, то цикл продолжается, пока не выполнится условие.

В третьей строке кода, мы просто добавляем направляющую в положении guidPos.

---

Шаг 11: Делаем Второй Цикл

Теперь  пришло время сделать вторую группу направляющих. 

for ( j = 0 ; j < cols ; j++ )
  {
if ( j == 0 ) 
{ multiply = 0
  }
  else
  {
  multiply = 1;
  }

temp_gutter = ( gutter * multiply ) ;
guidPos = ( minLimitOuter - space ) + ( ( colWidth + gutter ) * ( j + 1 ) );
 if ( guidPos > maxLimitInner ) 
{
  break;
  }  
doc.guides.add ( Direction.VERTICAL , Number ( guidPos ) );

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

Вот как выглядит наш скрипт полностью:

if ( app.documents.length != 0 ) 
{ 
    preferences.rulerUnits = Units.PIXELS;
    var layoutWidth = Number ( prompt ( ' Enter layout width: ' , 960 ) );
    var cols = Number ( prompt ( ' Enter numbers of columns: ' , 12 ) );
    var space = Number ( prompt ( ' Enter space between columns: ' , 10 ) );
    
    var doc = app.activeDocument;
    var docWidth = doc.width;
    var docXcenter = docWidth / 2;
    
    
    var gutter = space * 2; //gutter space
    var layoutHalf = layoutWidth / 2;
    
    
    //outer limits that is the layout width;
    var maxLimitOuter = docXcenter + layoutHalf;
    var minLimitOuter = docXcenter - layoutHalf;
    
    
    //Inner limits for 960gs
    var minLimitInner = minLimitOuter + space;
    var maxLimitInner = maxLimitOuter - space;
    
    var colWidth = ( layoutWidth - ( cols * gutter ) ) / cols;
    
    
    doc.guides.add ( Direction.VERTICAL , minLimitOuter );
    doc.guides.add ( Direction.VERTICAL , maxLimitOuter );
    
    
    for ( i = 0 ; i < cols ; i++ )    
    {    
        guidPos = minLimitInner + ( ( colWidth + gutter ) * i );
        
        if ( guidPos > maxLimitInner )
        { 
            break;
        }
        
        doc.guides.add ( Direction.VERTICAL , Number ( guidPos ) );
    
    }
    
    
    
    for ( j = 0 ; j < cols ; j++ ) 
    {
        if ( j== 0 )
        {
            multiply = 0
        }
        
        else
        {
            multiply = 1;
        }
        
        temp_gutter = ( gutter * multiply );
        
        guidPos = ( minLimitOuter - space ) + ( ( colWidth + gutter ) * ( j + 1 ) );
        
        if ( guidPos > maxLimitInner ) 
        {
            break;
        }
        doc.guides.add ( Direction.VERTICAL , Number ( guidPos ) );
    }
     
    }// end-if app.documents.length
        
    else
    {
       alert ( " No active document exists " );
      }

Хотя этот скрипт может содержать недостатки, главное его целью было дать вам представление о написании кода на JavaScript для Photoshop, на практическом примере.  Возможно, вам не все было понятно, но я надеюсь, что этот урок разбудит в вас любопытство. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь и оставляйте их в комментариях.

Photoshop Scripting in Python

Scripting in Photoshop is used to automate repetitive tasks and are often used as a creative tool to streamline tasks that might be too
time consuming to do manually. For example, you could write a script to generate a number of localized
versions of a particular image or to gather information about the various color profiles used by a collection
of images.

Photoshop COM & DOM

Photoshop can be scripted through COM(Component Object Model). Its DOM(Document Object Model) is the same when accessing it through either its own JavaScript engine or Python or any other scripting language it supports. The Photoshop DOM consists of a hierarchical representation of the Photoshop application, the documents used in it, and the components of the documents. The DOM allows you to programmatically access and manipulate the document and its components. For example, through the DOM, you can create
a new document, add a layer to an existing document, or change the background color of a layer. Most of
the functionality available through the Photoshop user interface is available through the DOM.

But why Python?

Photoshop scripting officially supports JavaScript, AppleScript & VBScript. However, Scripting in Python is also fairly easy if not easier if you’re already comfortable with Python. You may have already heard that Python is gaining in popularity, but did you know it’s now the most popular introductory programming language in U.S. universities? Python is also cross platform just like JavaScript is and lately becoming one of the fastest growing programming language according to StackOverflow as of 2017 / as of 2019

Python is easy to use, powerful, and versatile, making it a great choice for beginners and experts alike. Python’s readability makes it a great first programming language — it allows you to think like a programmer and not waste time understanding the mysterious syntax that other programming languages can require.

Getting Started

Python allows you to access COM and it’s DOM with the help of a Python extensions like «pypiwin32» or «comtypes». Install these modules and you’re ready to start scripting Photoshop in Python

• pip install pypiwin32 or pip install comtypes

Hello World!

from win32com.client import Dispatch

app = Dispatch("Photoshop.Application")
doc = app.Documents.Add(320, 240)
layerRef = doc.ArtLayers.Add()

psTextLayer = 2  # from enum PsLayerKind
layerRef.Kind = psTextLayer

textItem = layerRef.TextItem
textItem.Contents = "HELLO WORLD!"
textItem.Position = (120, 120)

How to inspect scripting object properties?

There’s not a straight forward way, you need to read the documentation to understand what properties/attributes are available for a scripting object, or possibly a COM browser. For example, I’ve extracted the Python scripting object reference for Photoshop CC 2018 at api_reference

GUI tool example

See gui_tool for an example of how you can use Photoshop Scripting to develop your own tool/utilities

Scripting on Mac?

Yes, scripting on Mac is also possible, see mac_scripting for more details

Photoshop Scripting Resources

• Photoshop Scripting Documentation
• Photoshop Scripting Developer Forum
• Photoshop Scripting API Reference
• Photoshop Scripting Tutorials

Also see

• InDesign Scripting in Python
• Illustrator Scripting in Python

Contribution

If you’ve written a useful Photoshop Python script and wants to share with the world, please create a new issue with the file as an attachment to the issue.

When you submit a script, please try to include the following information at the start of your script

# script_file_name.py

# Created: 1st January 2019
__author__ = 'Your Name or Original Author Name'
__version__ = '1.0'

"""
A short description of what the script does
"""

"""
Instructions on how to use the script, if any
"""

• Go to photoshop-scripting-python/issues/new
• Add title as Useful Script
• Drag & drop your .py script file into the description area
• Click Submit new issue