forked from gregorio-project/gregorio-project.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathconfiguration-texshop.html
82 lines (67 loc) · 3.82 KB
/
configuration-texshop.html
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<!--
Gregorio web site.
Copyright (C) 2007-2015 The Gregorio project
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
-->
<title>Gregorio project website</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="description" content="Free software for typesetting Gregorian chant" lang="en">
<meta name="keywords" content="Gregorian chant, gregorio, gabc, gregoriotex" lang="en">
<meta name="author" content="The Gregorio project">
<link rel="shortcut icon" href="/illus/fav.ico">
<link rel="icon" href="/illus/fav.ico">
<link rel="stylesheet" href="/style.css" type="text/css" title="default">
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
<script type="text/javascript" src="gregorio-menu.js"></script>
<script>
var context = 'gregorio';
var title = 'Gregorio project website'
</script>
</head>
<body>
<div id="ban">
<img src="/illus/harpedroite.png" title="" class="hd" alt="" />
<a id="haut" name="haut"></a>
<div id="banniere">
</div>
</div>
<script>write_gre_menu();</script>
<div class="flux">
<!-- IE patch-->
<div class="text">
<!-- End of header -->
<!-- header -->
<h1>Configuring TeXShop for Gregorio</h1>
<h3>Automatic score compilation</h3>
<p>Gregorio needs a <code>lualatex</code> engine that is able to launch the <code>gregorio</code> program during compilation in order to compile gabc scores automatically (i.e. the engine has to have the <code>--shell-escape</code> option active). Unfortunately, TeXShop does not come with such an engine configured by default.</p>
<p>To make life easier, we've included an engine which is set up correctly, in the contributed add-ons which were installed as part of Gregorio: <code>LuaLaTeX+se.engine</code>. You can find it in <code>/Users/Shared/Gregorio/contrib/TeXShop</code> if you used the installer or in <code>#/gregorio-git/contrib/TeXShop</code> if you cloned the repository (where <code>#</code> is the directory you cloned the repository to). Simply copy this file to <code>~/Library/TeXShop/Engines</code> and the engine should show up in the drop down list the next time you start TeXShop.</p>
<p>The name <code>LuaLaTeX+se</code> is arbitrary, but it's important to use it, so that everyone can have the same scores. This will also serve to differentiate it from the normal LuaLaTeX engine where the shell escape option is not active (TeXShop comes with this engine in its Inactive folder).</p>
<h3>Ease of use of .gabc files (optional)</h3>
<p>If you want to be able to filter files with <code>.gabc</code> extensions in the file dialogs of TeXShop, open a Terminal window (it's in <code>Applications/Utilities</code>) and enter the following command:</p>
<div class="commandline">
<code>defaults write TeXShop OtherTeXExtensions -array-add "gabc"</code>
</div>
<h3>Using TeXShop</h3>
<p>Once TeXShop is ready, refer to <a href="introduction-editor.html">the introduction page</a> to start using Gregorio!</p>
<!-- footer -->
</div>
<div class="bottom">
</div>
<script>initialize_menu();</script>
</body>
</html>