Sublime Unicon

Sublime Text 4 syntax support for the Unicon programming language.

• https://github.com/tajmone/Sublime-Unicon

By Tristano Ajmone, January 2022, MIT License.

Table of Contents

• About
  • Sublime Text 3 Support
  • Recommended Settings
• License
• Credits

About

Sublime Unicon provides syntax highlighting for Unicon source files. Files with the .icn extension are automatically associated with the Unicon syntax.

This package is derived from the Unicon syntax for Sublime Text 3 found at the Unicon repository. It features some improvements to the original syntax definition, along with other package specific features like comments definitions, etc.

My main goal was to create a full-fledged package that end users can install via Package Control and benefit from future package updates thanks to the self-updating functionality. This alone might prompt other Unicon users to contribute to the package's growth.

Furthermore, I wanted to focus on a package specifically targeting Sublime Text 4, which introduces some new syntax features which are rather cool and powerful, and fixes various bugs from Sublime Text 3 syntax definitions. Therefore, the Unicon syntax in this package contains the version: 2 key to enable the new syntax engine of Sublime Text 4, at the cost of breaking backward compatibility.

The long term goals for this package are to improve the syntax semantics and provide further functionality, like completions, build systems, symbols indexing, etc. Contributions are welcome.

For questions, feedback and suggestions, reach out via Discussions. For bug reports and feature requests, open an Issue instead.

Sublime Text 3 Support

This package is designed to take advantage of the new features of Sublime Text 4. If you're using Sublime Text 3, you should download the original unicon.sublime-syntax from the Unicon repository and copy it inside your Sublime Text 3 <data_path>/Packages/User/ folder (see Sublime Text Packages documentation).

Recommended Settings

Although the Unicon compiler supports source files that use both tabs and spaces for indentation, and either CRLF or LF line-endings under Windows, it's strongly recommended to abide to the recommended code styles conventions:

• Indentation: 3 spaces.
• Line-endings: Unix-style (LF).

Adopting these conventions in your Unicode source files will provide a better collaborative experience in version-controlled cross-platform projects.

To enforce the above settings, create an Unicon syntax-specific settings file in your Packages/User/ directory:

• <data_path>/Packages/User/Unicon.sublime-settings

then copy and paste the following settings into it:

{
    "translate_tabs_to_spaces": true,
    "tab_size": 3,
    "default_line_ending": "unix",
}

License

• LICENSE

MIT License

Copyright (c) 2021 Tristano Ajmone

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Credits

This package was built around the original unicon.sublime-syntax taken from the Unicon repository (commit a26ccbc):

• https://github.com/uniconproject/unicon/blob/master/config/editor/unicon.sublime-syntax

Explicit permission was granted to reuse the unicon.sublime-syntax file in this package under MIT License:

• uniconproject/unicon#261