Documentation miss how to install new textmate grammars

[Popolon]

Documentation issue

There is no information about adding new textmate grammars.

Summary

As instructions about adding non pre-included textmate grammars are missing I don't manage to add new one.

Included syntaxes, that was a bit challenging to use too, already work.

Proposed solution

Explain it a bit.

As an example, I tried to add 6502 assembly syntax. Default assembly only manage x86, should be extended to popular RISC-V, z80, 6502, 68k, arm64, etc.

I found a grammar here https://github.com/Elektron72/6502-generic-grammar

put the 6502.cson file in syntaxes/ subdir (as that was the case before Giallo).

In my config.toml:

[markdown.highlighting]
error_on_missing_language = true
theme = "ayu-dark"
extra_syntaxes_and_themes = ['syntaxes', "highlight_themes"]

The header start with this:

scopeName: 'source.assembly.6502'
name: '6502 Assembly'

I tried 6502 Assembly (as previous syntax) and 6502, nothing work. As instructions are totally missing, I'm not sure about which one of these names are used or if something else was wrong.

[Keats]

It's mentioned in https://www.getzola.org/documentation/content/syntax-highlighting/ and in https://www.getzola.org/documentation/getting-started/configuration/

Search for extra_

.cson is not supported though, only JSON. Never even heard of cson

[RedCMD]

CSON is used in Atom
and GitHub supports it

just any online cson to json converter