Version at: 30/04/2014, 18:57
#User scripts
##Overview
User scripts are relatively short pieces of code that can be installed, enabled, and disabled by individual users in order to modify the behavior of the Tatoeba user interface. These scripts can serve an important role in streamlining tasks that you do frequently and adding functionality that has not yet been incorporated into the main codebase. Some scripts require editing for customization. They require an add-on to work with a browser.
##Add-ons
On Mozilla Firefox, Greasemonkey is required to run user scripts. Visit the [Greasemonkey add-on page](https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/) to install Greasemonkey. The [userscripts.org Greasemonkey guide](http://userscripts.org/about/installing) provides additional information.
On Google Chrome, [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en) serves the same purpose.
See the [Wikipedia page on Greasemonkey](https://en.wikipedia.org/wiki/Greasemonkey) for add-ons for other browsers.
##Finding scripts
At the moment, the best way of finding a current, comprehensive list of Tatoeba-related scripts is to search the website [userscripts.org](http://userscripts.org) for [scripts tagged "Tatoeba"](http://userscripts.org/scripts/search?q=Tatoeba&submit=Search). To see a discussion of individual scripts, see the next section.
Also see [a4esl.com/temporary/tatoeba/userscripts/](http://a4esl.com/temporary/tatoeba/userscripts/)
(Someone should eventually add all of these to these page.)
##Description of selected scripts
### Scripts for linking sentences
As described in [Introduction to linking](http://userscripts.org/scripts/show/118538), users with "advanced contributor" status or higher can link multiple sentences to a single translation, but the native default Tatoeba interface does not provide a way to link sentences that are not already indirectly linked. That need is addressed by the following user script. (Note that you may alternatively use a [bookmarklet](bookmarklets), which works in any browser without the use of an add-on.)
- [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (author: jakov/jakovo) This script offers two alternative ways to link sentences.
**Shopping Cart** method.
Go to the sentence you would like to link (*Sentence A*) and click on the "add to shopping cart" icon next to the sentence (![][1]). Now the sentence is in your shopping cart and it goes wherever you go.
Go to the sentence you would like to link to (*Sentence B*). If everything is right, you should be seeing *Sentence A* at the end of the translations, as if it were an indirect translation. Click the chain icon (![][2]) to link *A* to *B*.
When you want to remove a sentence from the shopping cart, click on the "remove from shopping cart" icon next to the sentence.
The second one is the **Manual** method. If you already know the sentence number of *Sentence A*, this method could be faster.
Go to the sentence you would like to link to (*Sentence B*). Click on the form area icon next to the shopping cart (![][3]). You should see a form area at the end of the translations.
Type the sentence number here and click on the socket icon (![][4]). Now you should see the sentence itself.
Click the chain icon (![][2]) to link A to B.
If you want to remove a sentence from your cart, click on the cart icon (![][6]) on the right of the sentence.
### Other scripts
- [Tatoeba Default Languages](http://userscripts.org/scripts/show/152983) (author: FlamingTofu) moves your desired languages to the top of the language drop-down lists. You need to edit the script once to list the languages you desire.
- [Tatoeba Search Language Switcher](http://userscripts.org/scripts/show/151698) (author: Pandark) replaces the single-headed arrow between the two language fields at the top of the screen with a double-headed arrow. Clicking on the double-headed arrow swaps the values in the "From" and "To" fields. The script does not require any editing.
- [Tatoeba Sentence Timeline](http://userscripts.org/scripts/show/121207) (author: jakov, known as jakovo at userscripts.org) places log entries and tags chronologically between the comments on a sentence. The script does not require any editing.
- [Tatoeba Symbol Insert Helper](http://userscripts.org/scripts/show/102000) (author: jakov/jakovo) adds links for inserting special characters into the Tatoeba translation boxes. It can optionally be edited in order to remove unwanted character sets from the list, add new ones to the list, or modify the order in which they appear.
- [htmlTatoebaQuiz](http://userscripts.org/scripts/show/170945) (author: marcelostockle/Marcelo Stöckle) quizzes the user. It uses Tatoeba's "light" view (tatoeba.org/s/s/*sentence_number*).
- [Tatoeba Suggest Tags of Siblings](http://userscripts.org/scripts/show/104647) (author: jakov/jakovo) lists the tags which have already been added to direct translations (in green, like: ![][7]) and indirect translations (in grey, like: ![][8]), so that you can easily pick one for the active sentence. When you hover on a tag added to the active sentence, it also makes it possible to see the **name** of the contributor who added it. For tags added to direct and indirect translations, hovering will highlight the related sentence. Similarly hovering on a sentence number in the logs will highlight the sentence with this ID. The script will add a control panel on your profile for determining preferences.
##Making requests
For the time being, place requests involving creation or modification of scripts on the page [User script requests](user-script-requests). Eventually, we can use a more sophisticated tracking system.
[1]: http://imageshack.us/a/img687/5684/cartmd.png
[2]: http://imageshack.us/a/img580/4288/linkpr.png
[3]: http://imageshack.us/a/img201/3862/manqn.png
[4]: http://imageshack.us/a/img14/3164/looklh.png
[6]: http://imageshack.us/a/img713/1825/removeu.png
[7]: http://imageshack.us/a/img24/2804/spx8.png
[8]: http://imageshack.us/a/img62/9312/gefo.png
##Deprecated scripts
- [Tatoeba Flexible Linker](http://userscripts.org/scripts/show/166702) (author: AlanF_US) adds a box below the main sentence with a "show" arrow and a "link" button (![][2]) and an empty text field. The user can type (or copy) the number (e.g., '10000000') or URL (e.g., 'http://tatoeba.org/eng/sentences/show/10000000') of a sentence into the field. After this, clicking on the "show" arrow will visit the other sentence, while clicking on the "link" button will link it to the one above. It is an updated version of Zifre's [Tatoeba Linker](http://userscripts.org/scripts/show/99149), which is no longer actively maintained. However, enabling it tends to disable certain important links, such as "unlink" icons. The author recommends using [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (described above), or a [bookmarklet](bookmarklets) instead.
version at: 30/04/2014, 18:58
#User scripts
##Overview
User scripts are relatively short pieces of code that can be installed, enabled, and disabled by individual users in order to modify the behavior of the Tatoeba user interface. These scripts can serve an important role in streamlining tasks that you do frequently and adding functionality that has not yet been incorporated into the main codebase. Some scripts require editing for customization. They require an add-on to work with a browser.
##Add-ons
On Mozilla Firefox, Greasemonkey is required to run user scripts. Visit the [Greasemonkey add-on page](https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/) to install Greasemonkey. The [userscripts.org Greasemonkey guide](http://userscripts.org/about/installing) provides additional information.
On Google Chrome, [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en) serves the same purpose.
See the [Wikipedia page on Greasemonkey](https://en.wikipedia.org/wiki/Greasemonkey) for add-ons for other browsers.
##Finding scripts
At the moment, the best way of finding a current, comprehensive list of Tatoeba-related scripts is to search the website [userscripts.org](http://userscripts.org) for [scripts tagged "Tatoeba"](http://userscripts.org/scripts/search?q=Tatoeba&submit=Search). To see a discussion of individual scripts, see the next section.
Also see [a4esl.com/temporary/tatoeba/userscripts/](http://a4esl.com/temporary/tatoeba/userscripts/)
(Someone should eventually add all of these to these page.)
##Description of selected scripts
### Scripts for linking sentences
As described in [Introduction to linking](http://userscripts.org/scripts/show/118538), users with "advanced contributor" status or higher can link multiple sentences to a single translation, but the native Tatoeba interface does not provide a way to link sentences that are not already indirectly linked. That need is addressed by the following user script. (Note that you may alternatively use a [bookmarklet](bookmarklets), which works in any browser without the use of an add-on.)
- [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (author: jakov/jakovo) This script offers two alternative ways to link sentences.
**Shopping Cart** method.
Go to the sentence you would like to link (*Sentence A*) and click on the "add to shopping cart" icon next to the sentence (![][1]). Now the sentence is in your shopping cart and it goes wherever you go.
Go to the sentence you would like to link to (*Sentence B*). If everything is right, you should be seeing *Sentence A* at the end of the translations, as if it were an indirect translation. Click the chain icon (![][2]) to link *A* to *B*.
When you want to remove a sentence from the shopping cart, click on the "remove from shopping cart" icon next to the sentence.
The second one is the **Manual** method. If you already know the sentence number of *Sentence A*, this method could be faster.
Go to the sentence you would like to link to (*Sentence B*). Click on the form area icon next to the shopping cart (![][3]). You should see a form area at the end of the translations.
Type the sentence number here and click on the socket icon (![][4]). Now you should see the sentence itself.
Click the chain icon (![][2]) to link A to B.
If you want to remove a sentence from your cart, click on the cart icon (![][6]) on the right of the sentence.
### Other scripts
- [Tatoeba Default Languages](http://userscripts.org/scripts/show/152983) (author: FlamingTofu) moves your desired languages to the top of the language drop-down lists. You need to edit the script once to list the languages you desire.
- [Tatoeba Search Language Switcher](http://userscripts.org/scripts/show/151698) (author: Pandark) replaces the single-headed arrow between the two language fields at the top of the screen with a double-headed arrow. Clicking on the double-headed arrow swaps the values in the "From" and "To" fields. The script does not require any editing.
- [Tatoeba Sentence Timeline](http://userscripts.org/scripts/show/121207) (author: jakov, known as jakovo at userscripts.org) places log entries and tags chronologically between the comments on a sentence. The script does not require any editing.
- [Tatoeba Symbol Insert Helper](http://userscripts.org/scripts/show/102000) (author: jakov/jakovo) adds links for inserting special characters into the Tatoeba translation boxes. It can optionally be edited in order to remove unwanted character sets from the list, add new ones to the list, or modify the order in which they appear.
- [htmlTatoebaQuiz](http://userscripts.org/scripts/show/170945) (author: marcelostockle/Marcelo Stöckle) quizzes the user. It uses Tatoeba's "light" view (tatoeba.org/s/s/*sentence_number*).
- [Tatoeba Suggest Tags of Siblings](http://userscripts.org/scripts/show/104647) (author: jakov/jakovo) lists the tags which have already been added to direct translations (in green, like: ![][7]) and indirect translations (in grey, like: ![][8]), so that you can easily pick one for the active sentence. When you hover on a tag added to the active sentence, it also makes it possible to see the **name** of the contributor who added it. For tags added to direct and indirect translations, hovering will highlight the related sentence. Similarly hovering on a sentence number in the logs will highlight the sentence with this ID. The script will add a control panel on your profile for determining preferences.
##Making requests
For the time being, place requests involving creation or modification of scripts on the page [User script requests](user-script-requests). Eventually, we can use a more sophisticated tracking system.
[1]: http://imageshack.us/a/img687/5684/cartmd.png
[2]: http://imageshack.us/a/img580/4288/linkpr.png
[3]: http://imageshack.us/a/img201/3862/manqn.png
[4]: http://imageshack.us/a/img14/3164/looklh.png
[6]: http://imageshack.us/a/img713/1825/removeu.png
[7]: http://imageshack.us/a/img24/2804/spx8.png
[8]: http://imageshack.us/a/img62/9312/gefo.png
##Deprecated scripts
- [Tatoeba Flexible Linker](http://userscripts.org/scripts/show/166702) (author: AlanF_US) adds a box below the main sentence with a "show" arrow and a "link" button (![][2]) and an empty text field. The user can type (or copy) the number (e.g., '10000000') or URL (e.g., 'http://tatoeba.org/eng/sentences/show/10000000') of a sentence into the field. After this, clicking on the "show" arrow will visit the other sentence, while clicking on the "link" button will link it to the one above. It is an updated version of Zifre's [Tatoeba Linker](http://userscripts.org/scripts/show/99149), which is no longer actively maintained. However, enabling it tends to disable certain important links, such as "unlink" icons. The author recommends using [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (described above), or a [bookmarklet](bookmarklets) instead.