diff --git a/configuration-vscode.html b/configuration-vscode.html new file mode 100644 index 0000000..f76d9f5 --- /dev/null +++ b/configuration-vscode.html @@ -0,0 +1,97 @@ + + + + + + + Gregorio project website + + + + + + + + + + + + + +
+ + +
+
+
+ +
+   + +
+ + + +

Configuring VSCode for Gregorio

+ +

Automatic score compilation

+ +

A feature of Gregorio version 3.0 and later is the automatic compilation of gabc scores when needed to complete a LaTeX document. For this feature to work, lualatex must be able to launch the gregorio program during compilation.

+ +

VSCode can be configured (using the LaTeX-workshop extension) to do this by creating a new tool and a new recipie for compilation.

+ +

To create it, open up the JSON user preferences and add the following under "latex-workshop.latex.tools"

+ + + { + "name": "lualatex", + "command": "lualatex.exe", + "args": [ + "%DOC%" + ] + }, + + +

And add the following under "latex-workshop.latex.recipes"

+ + + { + "name": "LuaLaTex", + "tools": ["lualatex"] + }, + + +

This has been tested using LaTeXLive 2023 and Gregorio 6.0.0.

+ +

You should now be able to open up the extension commands and run the "LuaLaTex" recipe on your root file.

+ +

Using VSCode

+ +

Once VSCode is ready, refer to the introduction page to start using Gregorio!

+ + +
+
+
+ + + diff --git a/introduction-editor.html b/introduction-editor.html index ec24ed7..954ff55 100644 --- a/introduction-editor.html +++ b/introduction-editor.html @@ -53,10 +53,10 @@

Using Gregorio in TeXShop

-

This page describes how Gregorio is used with a TeX editor such as TeXworks or TeXShop. If you are used to TeX compilation and know the command line tools, you can refer to the command line introduction.

+

This page describes how Gregorio is used with a TeX editor such as TeXworks or TeXShop or VSCode. If you are used to TeX compilation and know the command line tools, you can refer to the command line introduction.

-

The editor must be correctly configured according to the instructions for TeXworks or TeXShop. These instructions can be easily adapted for other tools using TeXShop markup, such as the LaTeX Tools for SublimeText.

+

The editor must be correctly configured according to the instructions for TeXworks or TeXShop or VSCode. These instructions can be easily adapted for other tools using TeXShop markup, such as the LaTeX Tools for SublimeText.

Overall, producing a score involves these steps: