Frequently Asked Questions (FAQ)
Q: The toast notification for my completion message covers up some of my terminal area so you can't see the bottom right corner. Is it possible to move the notification?
Completion messages are always optional, but when they are included they show up as those toast notifications you pointed out. I would recommend just removing the completion message. Let's say the didact command includes a "completion" element. Something like:
didact://?commandId=vscode.didact.sendNamedTerminalAString&text=NamedTerminal$$ping%20localhost&completion=Send%20a%20ping%20message
In this example, you'll see it in the lower right corner like your example when we click on the link:
Unfortunately, at this time we can't change the location. About the only other thing we can do is make them modal, which I think is a lot worse because they have to be closed before the user can do anything else in the IDE. Here's an example:
Now... If you want to provide some additional information to the user on the link, you can provide some text that shows up in the tooltip like this:
([^Execute this](didact://?commandId=vscode.didact.sendNamedTerminalAString&text=NamedTerminal$$ping%20localhost "Call ping localhost in the terminal window called 'NamedTerminal'"){.didact})
In this case, the string after the url is the tooltip. The other part is the the {.didact} code just changes the pointer to a + instead of a normal pointer to indicate that it's a different kind of link.
Hopefully that helps!
Yes, but the task label must not have spaces. You can use the "runTask" command:
[Kick off a task](didact://?commandId=workbench.action.tasks.runTask&text=start.task)
The parameters passed is the "label" of the task.