Difference between revisions of "Apertium-get"

From Apertium
Jump to navigation Jump to search
(s/SVN/Github/)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''apertium-get''' is a little script to fetch and compile language data, with monolingual dependencies, from SVN.
+
'''apertium-get''' is a little script to fetch and compile language data, with monolingual dependencies, from Github.
   
It assumes you've already got the core tools installed (apertium, cg, hfst; or the apertium-all-dev package), see [[Installation]] if you haven't already.
+
It is installed by the core apertium package and assumes you've already got the regular core tools installed (apertium, cg, hfst; or simply the <code>apertium-all-dev</code> package), see [[Installation]] if you haven't already.
   
  +
==Usage==
Then, to get your language pair/module downloaded and compiled, just go to the directory where you want your apertium data to be, and run
+
After installing the core apertium package (e.g. <code>sudo apt-get install apertium-all-dev</code>), you can get your language pair/module downloaded and compiled by just going to the directory where you want your language data to be, and running
 
<pre>
 
<pre>
 
apertium-get fie-bar
wget https://raw.githubusercontent.com/unhammer/apertium-get/master/apertium-get
 
chmod +x apertium-get
 
./apertium-get fie-bar
 
 
</pre>
 
</pre>
   
(If you run the command twice, it just does an "svn up" and "make" instead of rebuilding everything, so it's also a quick way to ''update'' your data including dependencies.)
+
(If you run the command twice from the same folder, it just does an "svn up" and "make" instead of rebuilding everything, so it's also a quick way to ''update'' your data including dependencies.)
   
   
You can also make it list available language data with <code>./apertium-get -l</code>, perhaps filtering by SVN module like <code>./apertium-get -l trunk</code> or <code>./apertium-get -l languages</code>.
+
You can also make it list available language data with <code>apertium-get -l</code>, perhaps filtering by SVN module like <code>apertium-get -l trunk</code> or <code>apertium-get -l languages</code>.
   
It'll also handle apertiumised data dependencies from Giellatekno, e.g. it'll compile giella-sme when compiling apertium-sme-nob, and you can install the sme monolingual package explicitly with <code>./apertium-get giella-sme</code>.
+
It'll also handle apertiumised data dependencies from Giellatekno, e.g. it'll compile giella-sme when compiling apertium-sme-nob, and you can install the sme monolingual package explicitly with <code>apertium-get giella-sme</code>.
  +
 
If there's some monolingual dependency where you don't need the source available, and you want to avoid the compilation, you can exclude it with -x. This assumes you've installed the dependency through e.g. apt-get (or dnf, or something else in your PKG_CONFIG_PATH). So <code>apertium-get -x nno -x nob nno-nob</code> will download and compile apertium-nno-nob from SVN, but assume you've installed both apertium-nno and apertium-nob through apt-get, while <code>apertium-get -x sme sme-nob</code> will download and compile apertium-sme-nob (and apertium-nob) from SVN, but assume you've installed giella-sme through apt-get.
  +
  +
  +
==External links==
  +
* https://github.com/unhammer/apertium-get/ upstream repo, tests and issue tracker (used as svn external in SVN trunk/apertium/apertium)
  +
  +
==See also==
  +
* [[Installation]]
   
If there's some monolingual dependency where you don't need the source available, and you want to avoid the compilation, you can exclude it with -x. This assumes you've installed the dependency through e.g. apt-get (or dnf, or something else in your PKG_CONFIG_PATH). So <code>./apertium-get -x nno -x nob nno-nob</code> will download and compile apertium-nno-nob from SVN, but assume you've installed both apertium-nno and apertium-nob through apt-get, while <code>./apertium-get -x sme sme-nob</code> will download and compile apertium-sme-nob (and apertium-nob) from SVN, but assume you've installed giella-sme through apt-get.
 
   
 
[[Category:Tools]]
 
[[Category:Tools]]
 
[[Category:Installation]]
 
[[Category:Installation]]
  +
[[Category:Documentation in English]]

Latest revision as of 20:45, 23 March 2019

apertium-get is a little script to fetch and compile language data, with monolingual dependencies, from Github.

It is installed by the core apertium package and assumes you've already got the regular core tools installed (apertium, cg, hfst; or simply the apertium-all-dev package), see Installation if you haven't already.

Usage[edit]

After installing the core apertium package (e.g. sudo apt-get install apertium-all-dev), you can get your language pair/module downloaded and compiled by just going to the directory where you want your language data to be, and running

apertium-get fie-bar

(If you run the command twice from the same folder, it just does an "svn up" and "make" instead of rebuilding everything, so it's also a quick way to update your data including dependencies.)


You can also make it list available language data with apertium-get -l, perhaps filtering by SVN module like apertium-get -l trunk or apertium-get -l languages.

It'll also handle apertiumised data dependencies from Giellatekno, e.g. it'll compile giella-sme when compiling apertium-sme-nob, and you can install the sme monolingual package explicitly with apertium-get giella-sme.

If there's some monolingual dependency where you don't need the source available, and you want to avoid the compilation, you can exclude it with -x. This assumes you've installed the dependency through e.g. apt-get (or dnf, or something else in your PKG_CONFIG_PATH). So apertium-get -x nno -x nob nno-nob will download and compile apertium-nno-nob from SVN, but assume you've installed both apertium-nno and apertium-nob through apt-get, while apertium-get -x sme sme-nob will download and compile apertium-sme-nob (and apertium-nob) from SVN, but assume you've installed giella-sme through apt-get.


External links[edit]

See also[edit]