forked from gregorio-project/gregorio-project.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
installation-mac.html
118 lines (90 loc) · 5.49 KB
/
installation-mac.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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<!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>Installing Gregorio under Mac OSX</h1>
<h2>The TeX distribution</h2>
<p>The first step to make Gregorio work is to have a TeX distribution: MacTeX or TeXLive. See the <a href="http://tug.org/mactex/">official site</a> for instructions.</p>
<h2>The installer</h2>
<p>An installer has been created for some Mac systems. It is available from the <a href="https://github.com/gregorio-project/gregorio/releases">download page</a>, meant for systems running OS X versions 10.5 or later.</p>
<h2>Compiling from sources</h2>
<h3>Development environment installation</h3>
<p>To be able to compile Gregorio, you must first install an installation environment. Here are the main guidelines:</p>
<ol>
<li>download XCode (free) from the Apple Mac App Store</li>
<li>lauch it, it will first want to install a device manager, install it</li>
<li>under Preferences, click on Downloads and install the Command Line Tools</li>
<li>download and install <a href="http://www.macports.org/">MacPorts</a> (free)</li>
<li>once installed, in the TERMINAL, do <code>sudo port selfupdate</code> to get the latest sources packages</li>
<li>do <code>sudo port install libtool autoconf automake flex bison libxml2</code>.</li>
</ol>
<p>Once all this is done, you should be able to compile Gregorio.</p>
<p>If you want to compile fonts (to modify them, or when building directly from git), do <code>sudo port install fontforge +python27</code>.</p>
<h3>Source downloading</h3>
<p>You have a choice between versions of Gregorio. To obtain the sources of the stable version, you just need to download the sources from the <a href="https://github.com/gregorio-project/gregorio/releases">download page</a>, and decompress the archive.</p>
<p>To get the git version, that is, the version in development (more functionalities, but might contain more bugs), you will have to create a local copy of the git repository of the project, with the command:</p>
<div class="commandline">
<code>$ git clone --depth 1 -b develop https://github.com/gregorio-project/gregorio.git gregorio-git</code>
</div>
<h3>Compilation</h3>
<p>Once the sources are downloaded, carry out the following commands in the directory containing the source files:</p>
<div class="commandline">
<code>$ ./build.sh --arch=x86_64 --enable-all-static --disable-shared --enable-static-ltdl</code><br/>
<code>$ sudo ./install.sh</code><br/>
</div>
<p><b>Nota bene:</b> Technically speaking, only the first argument is required for <code>build.sh</code>, the others are optional (indeed, in the most recent versions of develop they will be unrecognized as valid options). However they will reduce the number of files installed on your machine by making the command line tool self contained, rather than using linked libraries. This will make upgrading easier as we are currently reworking the source code to eliminate the linked libraries structure.</p>
<h3>Update</h3>
<p>To update your git version, you just need to go into the directory containing the source files (assuming you kept it), run <code>git pull</code> and recompile with the same instructions as the previous <em>Compilation</em> section. If you deleted that directory after install, then just repeat the steps above starting at the <code>git clone</code> command.</p>
<h3>Next steps</h3>
<p>It can be very helpful to <a href="configuration-texshop.html">configure TeXShop for Gregorio</a>. Once you have done so, refer to the <a href="introduction-editor.html">introduction page</a> to start using Gregorio !</p>
<!-- footer -->
</div>
<div class="bottom">
</div>
<script>initialize_menu();</script>
</body>
</html>