v1 and v2 snippets and templates

[fade2gray]

Finally figured how to create a custom v2 template as prescribed here, and adjusted the template name in the settings.

{
    "AhkV2Template": {
        "prefix": "#TEMPLATEv2",
        "body": [
            "#Requires AutoHotkey v2.0",
            "#SingleInstance Force",
            "SendMode 'Input'",
            "SetWorkingDir A_ScriptDir",
            "",
            ""
        ]
    }
}

But, wouldn't it be possible to just add the ability to open and edit the default template/snippets files from the AHKpp settings?
...\.vscode\extensions\mark-wiemer.vscode-autohotkey-plus-plus-5.0.3\language\snippetsV1.json
...\.vscode\extensions\mark-wiemer.vscode-autohotkey-plus-plus-5.0.3\language\snippetsV2.json

[mark-wiemer]

How exactly are you opening the picker that you screenshotted? For me, the default user snippets look like this:

The name of the file shouldn't matter, just the name of the snippet itself. Would you mind experimenting without changing the file name and changing the name of your snippet? You should use a snippet name different than AhkV2Template for best results--by default the extension will see that it's the default snippet name and use the default snippet :/

[mark-wiemer]

The "redundant?" snippet files you mention are necessary: they load the pre-built snippets for library functions--you can see them at https://github.com/mark-wiemer-org/ahkpp/tree/main/language

[mark-wiemer]

Oops, the snippet files you screenshotted here are not the main/language files, they're instead files that hold user-defined snippets that will only work in those languages. They're not redundant files, just similarly named ones.

[fade2gray]

OK, I can see where I went wrong now. I selected New Global Snippets file... instead of the ahk2 option, because when selecting either the ahk or ahk2 options I thought they may have been redundant artefacts, because they didn't include the default templates (which I have since discovered are in snippetsV1.json and snippetsV2.json).

In my defence, though, I think the Readme could be a little clearer, e.g. ...

---

You can customize the template snippet to fit your needs:

1. In VS Code, open the command palette (F1) and go to "Snippets: Configure User Snippets".
2. From the option picker, select ahk for a V1 template, or ahk2 for a V2 template.
3. Create a new template snippet with a unique name, for example:

    "CustomAhkTemplate": {
        "body": [
            "; My new script with no directives",
            "; Here is a second comment line",
            ""
        ]
    }

Update your VS Code settings for AHK > File > "Template snippet name" to the name of your snippet (CustomAhkTemplate)

[mark-wiemer]

Hm, I know where I went wrong: I created a New Global Snippets file years ago and forgot that I had taken that action. I thought everyone had a global snippets file by default! I'll update the README, thanks for this :)

[mark-wiemer]

Ref #410