summaryrefslogtreecommitdiff
path: root/Build/source/texk/gregorio/gregorio-src/contrib/README.md
blob: c4e43da23f9a8f3bd029247e9c04e1552abc8e19 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# Third party scripts

This repository contains various small scripts or modules for third-party softwares to use Gregorio.

## Scribus

Gregorio can be used in [Scribus](http://wiki.scribus.net/canvas/Scribus) using three files:

 * `gregorio-scribus.lua`
 * `gregorio.png`
 * `900_gregorio.xml`

To install Gregorio support in Scribus:

 * copy the three files in the editorconfig folder of scribus (`/usr/share/scribus/editorconfig` under Linux, `C:\Program Files\Scribus\share\editorconfig`
under Windows).
 * read the comments in `900_gregorio.xml` and change some variables accordingly
 * in Scribus:
   * go in `File->Preferences->External Tools`
   * click `Add` in the `Render Frames`
   * select the file `900_gregorio.xml`

After that you can insert a render frame using Gregorio, and simply 
typing gabc (`right-click->edit sources`).

For more details see [the website](http://home.gna.org/gregorio/scribus).

## Kde editors (Kate, Kedit)

You can use `gabc.xml` for syntax highlighting in kate (and Kedit, etc.). To 
install it, copy the file in `/usr/share/apps/katepart/syntax`. This path
may vary according to your distribution.

## Gnome editors (Gedit)

You can use `gabc.lang` for syntax highlighting in GtkSourceView (Gedit, etc.). To 
install it, copy the file in `/usr/share/gtksourceview-3.0/language-specs`. This path
may vary according to your distribution.

## Emacs

To use gregorio in [Emacs](https://www.gnu.org/software/emacs/), see [this script](https://github.com/cajetanus/gregorio-mode.el).

## Vim

To get gabc syntax highlighting in [Vim](http://www.vim.org/):

 * copy `gabc.vim` in `/usr/share/vim/vimcurrent/syntax` 
 * add the line `au BufNewFile,BufRead *.gabc setf gabc`
somewhere near lines of the same type (near line 100 for example) in
`/usr/share/vim/vimcurrent/filetype.vim`. This will autodetect the filetypes.

## BBedit and TextWrangler (OSX only)

To get gabc syntax highlight in [BBedit](http://www.barebones.com/products/bbedit/) or [TextWrangler](http://www.barebones.com/products/textwrangler/), copy `gabc-syntax.plist` into `~/Library/Application Support/TextWrangler/Language Modules/` and restart BBEdit or TextWrangler.

## Script to process gabc score

`gprocess` is a perl script to instantly compile and show the result of a gabc
file. You can modify some variables directly into the script.