Caution

Tact grammar is deprecated; others are deemed legacy. Prefer TextMate grammars over Prism.js ones.

For up-to-date TextMate grammars, see the TON language server repository.

prism-ton

🔺 Set of TON blockchain programming language definitions for Prism.js:

• 💎 FunC — https://docs.ton.org/develop/func/overview
• 📚 Fift — https://docs.ton.org/develop/fift/overview
• 📄 TL-B — https://docs.ton.org/develop/data-formats/tl-b-language

▼ Deprecated:

• ⚡ Tact — https://github.com/tact-lang/tact

Initialization

Upon cloning this repo, invoke the following commands in order of appearance (but just once!):

1. yarn prism:init — initializes the prismjs/prism submodule and installes it's dependencies
2. yarn prism:links — creates all the necessary symbolic links from local files to the prismjs/prism submodule
3. yarn prism:build — builds all the grammars and everything there is in prismjs/prism

Layout

Grammar files are located in langs/X files, where X can be one of:

• prism-func.js — FunC grammar
• prism-fift.js — Fift grammar
• prism-tlb.js — TL-B grammar
• prism-tact.js — Tact grammar (deprecated)

Test files are located in tests/X folders, where X can be one of:

• func — FunC tests
• fift — Fift tests
• tlb — TL-B tests
• tact — Tact tests (deprecated)

Running tests

Once initialized, you'll be able to run tests for each language in this repo, namely:

• yarn test:func will run tests for FunC
• yarn test:fift will run tests for Fift
• yarn test:tlb will run tests for TL-B
• yarn test:tact will run tests for Tact (deprecated)

And yarn test runs all those tests in succession.

Workflow

The workflow looks like this:

1. Add changes to the grammar
2. Revise them by opening the .github/submodule-prism/test.html file in the browser
3. Add or update tests
4. Repeatedly execute and adjust tests until they pass
5. Commit & push
6. Make PRs to:

• https://github.com/TelegramMessenger/libprisma
• prismjs/prism (not being actively developed)
• ton-community/ton-docs (archived)

• Prism.js docs: https://prismjs.com/extending.html
• Awesome RegExp visualization tool: https://regex101.com

Credits

Based on The Open Network.

Made & maintained with 🤍 by Novus Nota.

License

MIT