Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 1.13 KB

CONTRIBUTING.adoc

File metadata and controls

33 lines (25 loc) · 1.13 KB
Raw

Contributing

Updating The Grammar

This package now uses the Atom language package to generate a grammar.

This can be updated manually using the following process:

  1. Install the cson npm package

    npm install --global cson

  2. Retrieve and convert the grammar:

    curl https://raw.githubusercontent.com/asciidoctor/atom-language-asciidoc/master/grammars/language-asciidoc.cson | cson2json > ./syntaxes/Asciidoctor.json

  3. Now manually edit and change the scope name from:

    "scopeName": "source.asciidoc",

    to

    "scopeName": "text.asciidoc",

Because this package has diverged slightly from upstream it may be best to cherry-pick commits after the original conversion or do before/after comparisons and account for each change.

Where possible it is recommended to do PRs upstream and then use that result here.