Ссылка на гайд по публикации: https://atom.io/docs/v1.2.4/hacking-atom-package-word-count#publish-your-package

Действия, которые необходимо выполнить для публикации пакета:

• В файле package.json есть поля name, description и repository.
• В файле package.json есть поле version со значением "0.0.0".
• В файле package.json есть поле engines, содержащую указание версий Atom, например "engines": {"atom": ">=0.50.0"}.
• В вашем пакете есть файл README.md в корне репозитория. (необходимо наполнение файла)
• Ваш пакет - это репозиторий git, который был опубликован на GitHub.

Для разработки запускателя oscript в Atom, видимо, так же потребуется описывать часть процедур по запуску в coffee файлах внутри пакета.
Пример пакета, работающего по ctrl+r https://github.com/lsegal/atom-runner

Если в определении процедуры/функции после скобок есть точка с запятой (а синтаксис это позволяет), то вся функция начинает подсвечиваться, кхм, странно :)

Если указан Экспорт без пробела, то так же рисуется некорректно

Из обсуждения #13 (comment)

На данный момент инструкции препроцессору объявлены как meta.preprocessor.bsl.
Для meta по умолчанию нет раскраски.

Атом, например, вроде позволяет инлайнить кусочки стилей в основной стиль

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

Экспорт определяется только у объявлений процедур и функций. Надо вернуть подсветку у объявлений переменных.
Сломано коммитом bb620bc

Хотелось бы получить группировку/сворачивание по произвольным текстовым блокам //{ и //}

На данный момент в грамматике только русские варианты операторов.
Необходимо добавить перевод.

Тоже пожелание от коллеги.
Если есть закомментированный кусок кода:

// Процедура ТестоваяПроцедура()
// А = 0;
// // Даже просто с обычными комментариями
// КонецПроцедуры

То в автокомплит попадают все токены из комментов: и ТестоваяПроцедура, и Даже, и обычными, все подряд. (подтверждено на ST)

Не знаю, можно ли это как-то настроить, но как пожелание зафиксирую.

Совместим ли данный проект с механизмом подсветки синтаксиса в GitLab'е?
Если да, скажите как прикрутить к GitLab'у

Грамматика

Как можно проверить правильность грамматик?
Какие есть инструменты и рекомендации?

В Атоме точно есть настройка, каким образом комментировать блок выделенного текста через Ctrl-/

Сейчас Атом ставит стандартные /* ... */. В конфигах синтаксис-пакета можно переопределить.

Проверить, что в остальных редакторах блочное комментирование работает корректно либо так же поправить.

Добавление функций вообще ongoing задача, но работа со строками за глаза цепляется.

Слить текущую грамматику в корне репо и описание @vsuh из VSCode/.vscode/extensions

Проверить все регулярки на попадание буквы "ё" - она не попадает в стандартный блок [а-я]. Точно надо добавить в определение параметра в процедуре

Добавить в грамматику все функции из ветки глобального контекста.

Урра!
На VSC с помощью Андрея @EvilBeaver заработал разбор сообщений об ошибках. Теперь по F8 можно перескакивать между ошибочными строками.

см. файл VSC/[PROJECT_DIR]/.vscode/tasks.json

By @vsuh

таки, определились с репозиторием? тогда сюда.
При редактировании в vsc *.os файла нажать F1 написать task и нажать Enter

Попадаем в инструмент Tasks: Configure task runner который реализован в виде файла tasks.json в специальном каталоге .vscode текущего проекта. Вставить туда следующий текст:

tasks.json

{
"version": "0.1.0",
"windows": {
    "command": "oscript.exe"
},
"linux": {
    "command": "/opt/bin/oscript"
},
"isShellCommand": true,
// Show the output window only if unrecognized errors occur.
"showOutput": "silent",
"args": [
    "-encoding=utf-8"
],
"tasks": [
    {
        "taskName": "Compile",
        "args": [
            "-compile",
            "${file}"
        ],
        "echoCommand": true,
        "showOutput": "always",
        "suppressTaskName": true,
        "isBuildCommand": true
    },
    {
        "taskName": "Run",
        "args": [
            "${file}"
        ],
        //"echoCommand": true,
        "showOutput": "always",
        "suppressTaskName": true,
                 "problemMatcher": "$gulp-tsc",
        "isBuildCommand": true
    }
]
}

В результате в списке задач появится две задачи Compile и Run вызвать их можно опять же комбинацией F1 tasks: run task или назначить комбинацию клавиш командой File -> Preferences -> Keyboard Shortcuts на команду workbench.action.tasks.runTask.

Кстати, выражение "isBuildCommand": true в задаче Compile обозначает, что ее можно запустить комбинацией Ctrl-Shift-B

Текст написан по мотивам официальной документации на VSC

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

Для подсвечивает только если либо следуют 2 пробела, либо есть конструкция Для Каждого

Ошибку искать тут: https://github.com/xDrivenDevelopment/1c-syntax/blob/master/1c.YAML-tmLanguage#L75

@vsuh
а куда делись секции foldingStartMarker и foldingStopMarker или их изначально не было?
вдруг, в будущем появится возможность группировки блоков

<key>foldingStartMarker</key>
<string>^(if|while|for|Функция|Процедура|Если|Пока|Для)</string>
<key>foldingStopMarker</key>
<string>(enddo|endif|КонецФункции|КонецПроцедуры|КонецЕсли|КонецЦикла)$</string>

из https://bitbucket.org/EvilBeaver/1script/issues/196/encoding

In progress...
Документация - https://code.visualstudio.com/docs/tools/vscecli

• Сделать README
• Сделать package.json
• Добавить скриншот
• Опубликовать

by @vsuh
Вот такая процедура у меня настрадалась:

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

by @bambr1975
Воспроизвести не получилось

by @nixel2007
Видимо, это проблемы именно VSC.

VSC как-то странно и очень жадно определяет токены. Если в

Если Ош.Причина ...

перед Ош поставить несколько пробелов, то он перестает их подкрашивать.
Тоже самое с раскраской строковых констант и комментариев - добавить пробелы и все ок.

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

Нужно переименовать 1c-scrypt судя по смыслу текста в 1c-syntax (по имени репо проекта) в CONTRIBUTING.md, если это опечатка (есть подозрение, что это так).

Ну и имена других реп в тексте отличаются от реальных имен.

Добавить возможность открывать список функций текущего файла или описать пакеты/настройки, которые позволят это сделать.

В Atom, например, при установке пакета https://atom.io/packages/goto и нажатии ctrl-r открывается список всех процедур и функций.
Помню, эту возможность хотел иметь @artbear

Появилось пожелание от коллеги:

Если набирается, например:

Запрос.Текст =
"ВЫБРАТЬ

и нажимается Enter, то на следующую строку надо добавлять символ |. Говорят, когда это показали на презенташке EDT, народ был очень доволен.

На первый взгляд, для разработки запускателя oscript под ST потребуется просто добавить пару конфиг-файлов в пакет.

Подробнее: http://docs.sublimetext.info/en/latest/reference/build_systems.html

Если добавить пробел после равно

Что удивительно, в ST отрабатывает нормально. В VSC проверить возможности нет, оно и так забаганное.

1. Сборку необходимо производить в отдельном каталоге build, добавить его в .gitignore
2. Необходимо отделить процедуры сборки и публикации пакета на 2 разных скрипта.
3. Выделить отдельные для каждого из пакетов команды публикации в отдельные подскрипты, вызываемые скриптом publish

Таким образом, публикация пакетов будет осуществляться командой (условно)
oscript build.os && oscript publish.os

Для отладки и разработки же будет достаточно просто oscript build.os

По мотивам переписки в задаче #43.

В Atom не срабатывает автодополнение (autocompletion) при вводе текста в файле *.os

By @vsuh

Отдельная история по code snippets.

Если мы решили присвоить языку OneScript код onescript и, соответственно, указали этот код в выражениях name, contributes.languages.id и contributes.grammars.language файла package.json

, то мы имеем полное право создать файл сниппетов onescript.json в каталоге %userprofile%\AppData\Roaming\Code\User\snippets\ который будет действовать в файлах с выбранным языком onescript примерно такого содержания, :

{
"Цикл для каждого": {
    "prefix": "дляк",
    "body": [
        "Для Каждого нн Из $1 Цикл",
        "    $2;",
        "КонецЦикла;"
    ],
    "description": "Цикл Для каждого нн Из..."
},
"Попытка с исключением": {
    "prefix": "попи",
    "body": [
        "Попытка",
        "   $1",
        "Исключение",
        "   Сообщить(ОписаниеОшибки());",
        "КонецИсключения;",
        "$2"
    ],
    "description": "попытка с исключением"
}
}

Раз в самой вики обсуждения нет, давайте здесь обсуждать.
Нужны ли еще две страницы с описанием ручной установки синтаксиса в Atom и Sublime text?
Или там будет только описание процедуры запуска установочных пакетов.

В Атоме и в VSC не работает функция GoTo definition.
В ST все штатно, на основании грамматики.

Сейчас есть набор проблем:

• неудобно собирать изменения для формирования changelog
• В описании релиза непонятно, что входит в релизы для разных редакторов.
• непонятен roadmap или хотя бы ближайшие планы на реализацию.

Например, @nixel2007 выпустил релиз https://github.com/xDrivenDevelopment/sublime-language-1c-bsl/releases/tag/v1.0.3
Как узнать, что в него вошло, изучая страницу релиза?

Для решения этих проблем предлагаю перейти на релизное управление, предлагаемое Github.
Используем milestone для наименования релиза и включения всех issue в релиз.
Потом удобно собирать/изучать/публиковать изменения.

@xDrivenDevelopment/1c-syntax что скажете?

Нужно пошаговое описание - как настроить окружение разработчика, который захочет внести правки в пакеты. Как собрать пакеты, как отладить и т.п.

Я сейчас использую пакет https://github.com/SublimeText/AAAPackageDev для SublimeText, который по Ctrl+B из файла YAML-tmLanguage делает tmLanguage.

Появляется человеческий фактор - забыл сделать билд, отредактировал через сайт только один файл и все такое прочее.
Надо подумать над инфраструктурой репозитариев, созданием пакетов для разных редакторов.

Думаю, стоит ли добавлять свойства глобального контекста.

И если стоит, то все, или некоторые (например, не добавлять менеджеры)

Мысли? @xDrivenDevelopment/1c-syntax @bambr1975

На досуге просматривал формат подвестки синтаксиса, который использует github.
В его основе лежит сторонняя библиотека, которая импортирует tmBundle с грамматикой.

Как поразительно соблазительную и даже относительно реальную можно поставить цель добавить поддержку синтаксиса 1С в сам GitHub. Мне кажется это будет оооочень круто.

Не совсем, правда, понятно, как к этому может отнестись сама 1С.

Сейчас определение параметров завязано на наличие "Знач".
Необходимо реализовать определение любых параметров.

По умолчанию пакеты для редакторов лицензируются под MIT.
Часть продуктов xDD лицензируется под Apache, vanessa-stack вообще под BSD (хотя это продукт silverbulleters и к организации xDD относится постольку-поскольку).

Что выберем?

Расстроила подсветка https://github-lightshow.herokuapp.com/?utf8=%E2%9C%93&scope=from-url&grammar_url=https%3A%2F%2Fgithub.com%2FxDrivenDevelopment%2Fvsc-language-1c-bsl%2Fblob%2Fmaster%2Fsyntaxes%2F1c.tmLanguage&grammar_text=&code_source=from-url&code_url=https%3A%2F%2Fgithub.com%2F1C-Company%2Fdt-demo-configuration%2Fblob%2Fmaster%2FDemoConfDT%2FCatalog.%25D0%2592%25D1%2585%25D0%25BE%25D0%25B4%25D1%258F%25D1%2589%25D0%25B8%25D0%25B5%25D0%259F%25D0%25B8%25D1%2581%25D1%258C%25D0%25BC%25D0%25B0.Form.%25D0%25A4%25D0%25BE%25D1%2580%25D0%25BC%25D0%25B0%25D0%25AD%25D0%25BB%25D0%25B5%25D0%25BC%25D0%25B5%25D0%25BD%25D1%2582%25D0%25B0.Form.Module.bsl&code=

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

@nixel2007 , что думаешь по этому поводу?

Сейчас требуется жестко "Функция|Процедура"
https://github.com/xDrivenDevelopment/1c-syntax/blob/master/1c.YAML-tmLanguage#L32
Необходимо доработать определение без учета регистра (конструкция (?i))

Привести README к более человеколюбивому виду.
Более подробно, что это за репозиторий, таблицу со ссылками повыше, добавить к таблице описание. Информацию, касающуюся только разработки перенести в Contributing.md (но минимальное упоминание про TextMate надо оставить).

README должно удовлетворять двум условиям:

1. Человек, который наткнулся на этот репо в поиске пакета для своего редактора, может быстро и понятно перейти в нужный ему репо/пакетный менеджер
2. Человек, который пришел сюда помогать с разработкой, может быстро понять, что к чему, и уйти читать Contributing.md

Типа вот такой

Последний комментарий в файле, если это последняя строка, не подсвечивается как комментарий, а должен.

Скриншот: https://yadi.sk/i/pwzfkTAlmdHUj

Если добавить еще одну строку (даже просто перевод строки), то комментарий подстветка комментария станет правильной.

In progress...

Документация по разработке пакетов:

• Sublime text
  • Официальная https://www.sublimetext.com/docs/3/packages.html
  • Неофициальная, с примерами http://code.tutsplus.com/tutorials/how-to-create-a-sublime-text-2-plugin--net-22685
  • Дистрибуция https://packagecontrol.io/docs/submitting_a_package