[Feature] Add `.tesf` support for Shiki

[SnowCutieOwO]

Pre-Request Checklist

• I have checked that I am on the latest version of Terra.
• I have searched github for similar features requests, including closed
  ones, and found none.
• I believe this is within the scope of Terra.
• This feature request is for all of Terra, and isn't something that
  should be implemented by a pack or addon.

Feature Description

Add code highlight for Shiki.

What Problem Does This Solve?

Documentation doesn't have a correct highlight for .tesf file, I think there's a need for achieving this.

A Solution You'd Like

Just add a code highlight for Shiki... or something else like VSCode.

Alternative Solutions

Since it's special, I don't think there's something alternative for use.

Additonal Context

N/A

[solonovamax]

this should probably be moved over to TerraDocs

also, I don't believe that the docs website is using shiki. I'm pretty sure it's using pygments, for which we'd need to add a lexer and then add it to sphinx

[SnowCutieOwO]

this should probably be moved over to TerraDocs

also, I don't believe that the docs website is using shiki. I'm pretty sure it's using pygments, for which we'd need to add a lexer and then add it to sphinx

VitePress using this by default and I'm trying translate the whole wiki into Chinese. :3

[solonovamax]

it looks like it's possible to have localized documentation using sphinx, however you need to butcher your docs and shove everything into a bunch of .po files which kinda sucks

[SnowCutieOwO]

it looks like it's possible to have localized documentation using sphinx, however you need to butcher your docs and shove everything into a bunch of .po files which kinda sucks

Another reason for not putting the docs into main website is actually I also translated other docs of plugins, it's hard for me to put all them to where they from

[solonovamax]

Another reason for not putting the docs into main website is actually I also translated other docs of plugins, it's hard for me to put all them to where they from

it would just be nice if it were all in the same repo, because then other languages could be added as well, like I could probably do a french translation

[SnowCutieOwO]

Another reason for not putting the docs into main website is actually I also translated other docs of plugins, it's hard for me to put all them to where they from

it would just be nice if it were all in the same repo, because then other languages could be added as well, like I could probably do a french translation

agree, but i almost done all the translation, which will be quite a hard job for change the format to adopt original wiki, if i could maybe its possible, but for now i may just put them in my repo :/

[neutrino84]

If anyone wants it, I created a pretty decent VS Code 'highlighter' extension for 'tesf' -> works pretty well so far

[Bloeckchengrafik]

@neutrino84 Have you published it yet? If yes, i'd love to add a link to the CodeTool repo for folks preferring VSCode!

[neutrino84]

@neutrino84 Have you published it yet? If yes, i'd love to add a link to the CodeTool repo for folks preferring VSCode!

Its not yet published and very much in "pre-alpha" state, but I will publish it eventually. For those that don't want to wait, here are the configurations - VS Code can load this as a "local" extension.

File: /ionpluginsmc/.vscode/extensions/ion-terrascript-syntax/package.json

{
  "name": "terrascript-syntax",
  "displayName": "TerraScript (TESF)",
  "description": "Language support for TerraScript (.tesf) structure generation files.",
  "version": "1.0.0",
  "engines": {
    "vscode": "^1.70.0"
  },
  "categories": [
    "Programming Languages"
  ],
  "contributes": {
    "languages": [
      {
        "id": "terrascript",
        "aliases": [
          "TerraScript",
          "Terra Script",
          "TESF"
        ],
        "extensions": [
          ".tesf"
        ],
        "configuration": "./language-configuration.json"
      }
    ],
    "grammars": [
      {
        "language": "terrascript",
        "scopeName": "source.terrascript",
        "path": "./syntaxes/terrascript.tmLanguage.json"
      }
    ]
  }
}

File: /ionpluginsmc/.vscode/extensions/ion-terrascript-syntax/language-configuration.json

{
  "comments": {
    "lineComment": "//",
    "blockComment": [ "/*", "*/" ]
  },
  "brackets": [
    ["{", "}"],
    ["[", "]"],
    ["(", ")"]
  ],
  "autoClosingPairs": [
    { "open": "{", "close": "}" },
    { "open": "[", "close": "]" },
    { "open": "(", "close": ")" },
    { "open": "\"", "close": "\"", "notIn": ["string"] }
  ],
  "surroundingPairs": [
    { "open": "{", "close": "}" },
    { "open": "[", "close": "]" },
    { "open": "(", "close": ")" },
    { "open": "\"", "close": "\"" }
  ],
  "wordPattern": "((?:\\d+(?:_\\d+)*)?\\.(?:\\d+(?:_\\d+)*)(?:[eE][+-]?\\d+)?|\\d+(?:_\\d+)*(?:\\.(?:\\d+(?:_\\d+)*)?)?(?:[eE][+-]?\\d+)?)|([^\\`\\~\\!\\@\\#\\%\\^\\&\\*\\(\\)\\-\\=\\+\\[\\{\\]\\}\\\\\\|\\;\\:\\'\\\"\\,\\.\\<\\>\\/\\?\\s]+)",
  "folding": {
    "markers": {
      "start": "^\\s*//\\s*#?region\\b",
      "end": "^\\s*//\\s*#?endregion\\b"
    }
  }
}

File: /ionpluginsmc/.vscode/extensions/ion-terrascript-syntax/syntaxes/terrascript.tmLanguage.json

{
  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
  "name": "TerraScript",
  "scopeName": "source.terrascript",
  "patterns": [
    { "include": "#comments" },
    { "include": "#strings" },
    { "include": "#keywords" },
    { "include": "#storage-types" },
    { "include": "#constants" },
    { "include": "#built-in-functions" },
    { "include": "#operators" },
    { "include": "#identifiers" },
    { "include": "#punctuation" }
  ],
  "repository": {
    "comments": {
      "patterns": [
        {
          "name": "comment.line.double-slash.terrascript",
          "match": "//.*$"
        },
        {
          "name": "comment.block.terrascript",
          "begin": "/\\*",
          "end": "\\*/",
          "patterns": [
            { "match": "." }
          ]
        }
      ]
    },
    "strings": {
      "patterns": [
        {
          "name": "string.quoted.double.terrascript",
          "begin": "\"",
          "end": "\"",
          "patterns": [
            {
              "name": "constant.character.escape.terrascript",
              "match": "\\\\."
            }
          ]
        }
      ]
    },
    "keywords": {
      "patterns": [
        {
          "name": "keyword.control.conditional.terrascript",
          "match": "\\b(if|else)\\b"
        },
        {
          "name": "keyword.control.loop.terrascript",
          "match": "\\b(while|for|continue|break)\\b"
        },
        {
          "name": "keyword.control.flow.terrascript",
          "match": "\\b(return)\\b"
        },
        {
          "comment": "Fail is a unique exception state in TerraScript",
          "name": "keyword.control.flow.terrascript",
          "match": "\\b(fail)\\b"
        }
      ]
    },
    "storage-types": {
      "patterns": [
        {
          "name": "storage.type.terrascript",
          "match": "\\b(num|str|bool)\\b"
        }
      ]
    },
    "constants": {
      "patterns": [
        {
          "name": "constant.language.boolean.terrascript",
          "match": "\\b(true|false)\\b"
        },
        {
          "name": "constant.numeric.terrascript",
          "match": "(?<!\\w)(?:\\d+(?:_\\d+)*(?:\\.(?:\\d+(?:_\\d+)*)?)?|\\.\\d+(?:_\\d+)*)(?:[eE][+-]?\\d+)?(?!\\w|\\.)"
        }
      ]
    },
    "built-in-functions": {
      "patterns": [
        {
          "comment": "Functions registered in StructureScript.java",
          "match": "\\b(block|debugBlock|structure|randomInt|recursions|setMark|getMark|pull|loot|entity|getBiome|getBlock|state|setWaterlog|originX|originY|originZ|rotation|rotationDegrees|print|abs|pow2|pow|sqrt|rsqrt|floor|ceil|log|round|sin|cos|tan|asin|acos|atan|max|min)\\b(?=\\s*\\()",
          "captures": {
            "1": { "name": "support.function.terrascript" }
          }
        }
      ]
    },
    "punctuation": {
      "patterns": [
        {
          "name": "punctuation.terminator.statement.terrascript",
          "match": ";"
        },
        {
          "name": "punctuation.separator.argument.terrascript",
          "match": ","
        },
        {
          "name": "punctuation.section.block.begin.terrascript",
          "match": "\\{"
        },
        {
          "name": "punctuation.section.block.end.terrascript",
          "match": "\\}"
        },
        {
          "name": "punctuation.section.group.begin.terrascript",
          "match": "\\("
        },
        {
          "name": "punctuation.section.group.end.terrascript",
          "match": "\\)"
        }
      ]
    },
    "operators": {
      "patterns": [
        {
          "name": "keyword.operator.logical.terrascript",
          "match": "&&|\\|\\||!"
        },
        {
          "name": "keyword.operator.comparison.terrascript",
          "match": "==|!=|>=|<=|>|<"
        },
        {
          "name": "keyword.operator.arithmetic.terrascript",
          "match": "\\+|-|\\*|/|%"
        },
        {
          "name": "keyword.operator.assignment.terrascript",
          "match": "="
        }
      ]
    },
    "identifiers": {
      "patterns": [
        {
          "name": "variable.other.readwrite.terrascript",
          "match": "\\b[a-zA-Z_][a-zA-Z0-9_]*\\b"
        }
      ]
    }
  }
}