Difference between revisions of "Contributing"

From Apertium
Jump to navigation Jump to search
(stub)
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
There are many ways to contribute to Apertium, from sending us lists of words or phrases you find that are incorrectly translated, to getting involved in creating a new language pair or programming on tools or user interfaces.
There are many ways to contribute to Apertium, from sending us lists of words or phrases you find that are incorrectly translated, to getting involved in creating a new language pair or programming on tools or user interfaces.


Regardless of the kind of contribution you want to do, the two things to start with are to subscribe to the mailing list [https://lists.sourceforge.net/lists/listinfo/apertium-stuff apertium-stuff], which is where most of the discussion goes on. Also, come and idle on the [[IRC|IRC channel]] <code>#apertium</code> on <code>irc.oftc.net</code>.
==For non-programmers==

If you have some words that are unknown in a certain language pair, you can help out by simply writing list of words and their translations, e.g.
To decide what you want to contribute, take a look at ''[[Development]]'' and ''[[Projects]]'' for some ideas we've had around programming, extending the engine, and have a look at the ''[[Incubator]]'' if you're interested in linguistic issues. If you can't find anything that interests you or piques your interest, just send an email or ask someone on IRC and they'll be happy to help.

==Adding/fixing unknown words==
If you have some words that are unknown in a certain language pair, you can help out by simply writing a list of words and their translations, e.g.
<pre>
<pre>
house; noun; casa; noun f
house; noun; casa; noun f
Line 9: Line 13:


into a file, and sending that to the [[mailing list]]. Most likely you want to send to the one called "apertium-stuff"; [https://lists.sourceforge.net/lists/listinfo/apertium-stuff subscribe here], then attach the file and send it to apertium-stuff@lists.sourceforge.net.
into a file, and sending that to the [[mailing list]]. Most likely you want to send to the one called "apertium-stuff"; [https://lists.sourceforge.net/lists/listinfo/apertium-stuff subscribe here], then attach the file and send it to apertium-stuff@lists.sourceforge.net.

You can also send a spreadsheet file, if you prefer that.

==Contribute language knowledge==
The [[Indirect contribution guide]] has some tips on how to contribute your knowledge of a language to create resources that we use in Apertium, such as
* Writing contrastive analyses
* Cataloguing resources
* Hand-translating text
* Converting dictionaries
* Contributing to related projects


==Getting more involved==
==Getting more involved==
The first thing you should do if you want to get more involved is to introduce yourself on the [[mailing list]] and hang out on our [[IRC]] channel. Then you might want to take a look at one of these guides:
The first thing you should do if you want to get more involved is to introduce yourself on the [[mailing list]] and hang out on our [[IRC]] channel. There is also a [[list of Apertium mentors]].

Next, you should [[Installation|install apertium, lttoolbox, and some language pairs]] to play around with.

If you want to create or contribute to a language pair, go through the [[New language pair HOWTO]]. This is required reading for anyone who wants to get involved with developing Apertium language pairs. Also, take a look at [[Contributing to an existing pair]], meant for those who want to contribute to existing language pairs. You can improve the quality of the translation for an existing pair by correcting errors in the dictionaries. You will find some hints on the page [[Finding_errors_in_dictionaries]].

Next up, the [https://www.abumatran.eu/wp-content/uploads/2014/12/abumatran-apertium-workshop-data-guide.pdf Apertium EU Workshop site] is a comprehensive guide to rule based machine translation with Apertium (originally made for a four-day course on Apertium for people with little background in machine translation); print this out and read it on the bus/train/boat

If you're a student, [[Google Summer of Code]] (or [https://codein.withgoogle.com/ Google Code-In] for high-school students) is a good way to get involved with Apertium, and the ideas page there has lots of project tips if you're more interested in programming than linguistics/language pairs.


[[Category:Documentation in English]]
* [[New language pair HOWTO]] – required reading for anyone who wants to get involved with developing Apertium language pairs
* [[Contributing to an existing pair]] – as above, for those who want to contribute to existing language pairs
* [http://wiki.apertium.eu/index.php/Programme_overview Apertium EU Workshop] a comprehensive guide to rule based machine translation with Apertium (originally made for a four-day course on Apertium for people with little background in machine translation)
* [[Google Summer of Code]] – a good way to get involved with Apertium if you're a college/university level student
** Google Code-In is an alternative for high-school students

Latest revision as of 09:17, 26 May 2021

There are many ways to contribute to Apertium, from sending us lists of words or phrases you find that are incorrectly translated, to getting involved in creating a new language pair or programming on tools or user interfaces.

Regardless of the kind of contribution you want to do, the two things to start with are to subscribe to the mailing list apertium-stuff, which is where most of the discussion goes on. Also, come and idle on the IRC channel #apertium on irc.oftc.net.

To decide what you want to contribute, take a look at Development and Projects for some ideas we've had around programming, extending the engine, and have a look at the Incubator if you're interested in linguistic issues. If you can't find anything that interests you or piques your interest, just send an email or ask someone on IRC and they'll be happy to help.

Adding/fixing unknown words[edit]

If you have some words that are unknown in a certain language pair, you can help out by simply writing a list of words and their translations, e.g.

house; noun; casa; noun f
dog; noun; perro; noun m

into a file, and sending that to the mailing list. Most likely you want to send to the one called "apertium-stuff"; subscribe here, then attach the file and send it to apertium-stuff@lists.sourceforge.net.

You can also send a spreadsheet file, if you prefer that.

Contribute language knowledge[edit]

The Indirect contribution guide has some tips on how to contribute your knowledge of a language to create resources that we use in Apertium, such as

  • Writing contrastive analyses
  • Cataloguing resources
  • Hand-translating text
  • Converting dictionaries
  • Contributing to related projects

Getting more involved[edit]

The first thing you should do if you want to get more involved is to introduce yourself on the mailing list and hang out on our IRC channel. There is also a list of Apertium mentors.

Next, you should install apertium, lttoolbox, and some language pairs to play around with.

If you want to create or contribute to a language pair, go through the New language pair HOWTO. This is required reading for anyone who wants to get involved with developing Apertium language pairs. Also, take a look at Contributing to an existing pair, meant for those who want to contribute to existing language pairs. You can improve the quality of the translation for an existing pair by correcting errors in the dictionaries. You will find some hints on the page Finding_errors_in_dictionaries.

Next up, the Apertium EU Workshop site is a comprehensive guide to rule based machine translation with Apertium (originally made for a four-day course on Apertium for people with little background in machine translation); print this out and read it on the bus/train/boat

If you're a student, Google Summer of Code (or Google Code-In for high-school students) is a good way to get involved with Apertium, and the ideas page there has lots of project tips if you're more interested in programming than linguistics/language pairs.