"Extra Syntax Highlighting" plugin for Eclipse

Feedback and high-quality pull requests are highly welcome!

1. About
2. What is it?
3. Installation
4. Building from Sources
5. License

What is it?

This EclipseⓇ plug-in adds syntax highlighting support for the following languages/file formats utilizing TM4E:

• Apache HTTP configuration files - https://httpd.apache.org/docs/current/configuring.html
• Astro - https://astro.build/
• C / C++
• C# (*.cs) - https://docs.microsoft.com/en-us/dotnet/csharp/
• Dart - https://dart.dev
• Eclipse External null Annotations (*.eea) - https://wiki.eclipse.org/JDT_Core/Null_Analysis/External_Annotations#File_format
• Entity-Relationship Diagram (*.er) - https://github.com/BurntSushi/erd
• GLSL (OpenGL Shading Language) - https://registry.khronos.org/OpenGL/index_gl.php#apispecs
• GraphQL - https://graphql.org/
• Graphviz Dot (*.dot) - https://graphviz.org/doc/info/lang.html
• HashiCorp HCL (*.hcl) - https://github.com/hashicorp/hcl (e.g. used by HasiCorp Packer)
• HashiCorp Sentinel (*.sentinel) - https://www.hashicorp.com/sentinel
• HashiCorp Terraform (*.tf) - https://www.terraform.io/
• Haxe - https://haxe.org
• INI Files - https://en.wikipedia.org/wiki/INI_file
• Jinja Templates - https://jinja.palletsprojects.com/
• Kotlin - https://kotlinlang.org/
• LDIF - https://en.wikipedia.org/wiki/LDAP_Data_Interchange_Format
• Lua - https://www.lua.org/
• Make - https://www.gnu.org/software/make/
• Mako Templates (*.mako) - https://www.makotemplates.org/
• Markdown (*.md) - https://daringfireball.net/projects/markdown/
• Nushell (*.nu) - https://github.com/nushell/nushell
• PHP - https://www.php.net/
• PlantUML (*.pu) - https://plantuml.com/
• PowerShell - https://github.com/PowerShell/PowerShell
• Prisma - https://www.prisma.io/
• Svelte - https://svelte.dev/
• Swift - https://developer.apple.com/swift/
• TOML - https://toml.io/en/
• Visual Basic- https://docs.microsoft.com/en-us/dotnet/visual-basic/

For the following languages/file formats you can install one of the listed Eclipse plug-ins:

• HTML, CSS, SCSS, SASS, LESS, JavaScript, TypeScript, JSON, YAML (incl. Kubernetes schema validation), XML, XSL, XSD, DTD, ESLint, Angular React (JSX, TSX), Vue.js: Wild Web Developer
• AsciiDoc: Asciidoctor Editor
• Bash Scripts: ShellWax or Bash Editor
• Dockerfile: Eclipse Docker Tooling
• Groovy: Groovy Development Tools
• Jenkins Pipelines (Jenkinsfile): Jenkins Editor
• Python: PyDev - Python IDE for Eclipse
• SQL: SQL Editor or DBeaver or PL/SQL Workbench
• Windows Batch Files (*.bat, *.cmd): Batch Editor
• JSON: JSON Editor Plugin or Hi(speed)JSON Editor or Wild Web Developer
• YAML: YAML Editor or Wild Web Developer

Installation

To install the plugin into an existing Eclipse installation do:

1. Within Eclipse go to: Help -> Install New Software...
2. Enter the following update site URL: https://raw.githubusercontent.com/sebthom/extra-syntax-highlighting-eclipse-plugin/updatesite
3. Select the Extra Syntax Highlighting feature to install.
4. Ensure that the option Contact all update sites during install to find required software is enabled.
5. Click Next twice.
6. Read/accept the license terms and click Finish.
7. Eclipse will now download the necessary files in the background.
8. When the download has finished, Eclipse will ask about installing unsigned content. You need to accept if you want to
9. After installation you will be prompted for a restart of Eclipse, which is recommended.

Building from Sources

To ensure reproducible builds this Maven project inherits from the vegardit-maven-parent project which declares fixed versions and sensible default settings for all official Maven plug-ins.

The project also uses the maven-toolchains-plugin which decouples the JDK that is used to execute Maven and it's plug-ins from the target JDK that is used for compilation and/or unit testing. This ensures full binary compatibility of the compiled artifacts with the runtime library of the required target JDK.

To build the project follow these steps:

1. Download and install a Java 17 SDK, e.g. from:

   • https://adoptium.net/releases.html?variant=openjdk17
   • https://www.azul.com/downloads/?version=java-17-lts&architecture=x86-64-bit&package=jdk

2. Download and install the latest Maven distribution.

3. In your user home directory create the file .m2/toolchains.xml with the following content:

   <?xml version="1.0" encoding="UTF8"?>
   <toolchains>
      <toolchain>
         <type>jdk</type>
         <provides>
            <version>17</version>
            <vendor>default</vendor>
         </provides>
         <configuration>
            <jdkHome>[PATH_TO_YOUR_JDK_17]</jdkHome>
         </configuration>
      </toolchain>
   </toolchains>

   Set the [PATH_TO_YOUR_JDK_17] parameter accordingly.

4. Checkout the code using one of the following methods:

   • git clone https://github.com/sebthom/extra-syntax-highlighting-eclipse-plugin
   • `svn co https://github.com/sebthom/extra-syntax-highlighting-eclipse-plugin extra-syntax-highlighting-eclipse-plugin

5. Run mvn clean verify in the project root directory. This will execute compilation, unit-testing, integration-testing and packaging of all artifacts.

License

If not otherwise specified (see below), files in this repository fall under the Eclipse Public License 2.0.

Individual files contain the following tag instead of the full license text:

SPDX-License-Identifier: EPL-2.0

This enables machine processing of license information based on the SPDX License Identifiers that are available here: https://spdx.org/licenses/.

An exception is made for:

1. files in readable text which contain their own license information, or
2. files in a directory containing a separate LICENSE.txt file, or
3. files where an accompanying file exists in the same directory with a .LICENSE.txt suffix added to the base-name of the original file. For example foobar.js is may be accompanied by a foobar.LICENSE.txt license file.