summaryrefslogtreecommitdiff
path: root/Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md')
-rw-r--r--Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md b/Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md
new file mode 100644
index 00000000000..c4e43da23f9
--- /dev/null
+++ b/Build/source/texk/gregorio/gregorio-4.0.0-beta2/contrib/README.md
@@ -0,0 +1,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.