Version at: 04/05/2013, 16:35

##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. They typically are written and tested to work with the Mozilla Firefox browser, but can work with other browsers as well. You will need to install the Greasemonkey add-on. See next section for more details.

##Greasemonkey
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. Some scripts require editing for customization.

##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 (in alphabetical order)

 - [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 Linker](http://userscripts.org/scripts/show/99149) (author: Zifre) adds a box for entering the number of a sentence to be linked to the main sentence on a page. (Note that linking can only be performed by those with "advanced contributor" status and above. To request an upgrade in status, send a private message to alexmarcelo.) This is especially useful in a workflow in which you have previously gone to a sentence that you will want to link and copied its URL (for example, by right-clicking it and selecting the "Copy Link Location" function). Then you simply need to visit the main sentence, paste the URL into the field, and strip out everything but the sentence number at the end.

 - [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.

 - [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (author: jakov/jakovo) With this script we can easily link sentences which are totally apart, i.e. make them translations of each other. There are two alternative ways to do that. Pick one and you are good to go.

    First one is **Shopping cart** method.

    Go to the *Sentence A* you would like to link and click on the shopping cart icon above the sentence (![][1]). Now the sentence is in your shopping cart and it goes wherever you go.
    Go to the *Sentence B* you would like to link to. If everything is right, you should be seeing the *Sentence A* at the end of the translations, as if it is an indirect translation. Click the chain icon (![][2]) to link *A* to *B*. It is that simple.

    The second one is **Manual** method. If you already know the sentence number of  *Sentence A*, this method could be faster.

    Go to the *Sentence B* (you would like to link to)
Click on the form area icon next to the shopping cart (![][3]). You should be seeing a form area at the end of translations.
    Type the sentence number here and click on the socket icon (![][4]). Now you should be seeing the sentence itself.
    Click the chain icon (![][5]) to link A to B. Again, it is that simple.

    If you want to empty the shopping cart, simply double click the shopping cart icon. If you want to remove a sentence from your cart, click on the cart icon (![][6]) on the right of the sentence.

##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
  [5]: http://imageshack.us/a/img580/4288/linkpr.png
  [6]: http://imageshack.us/a/img713/1825/removeu.png

version at: 05/05/2013, 16:41

##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. They typically are written and tested to work with the Mozilla Firefox browser, but can work with other browsers as well. You will need to install the Greasemonkey add-on. See next section for more details.

##Greasemonkey
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. Some scripts require editing for customization.

##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 (in alphabetical order)

 - [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 Flexible Linker](http://userscripts.org/scripts/show/166702) (author: AlanF_US) adds a box below the main sentence with a "show" button and a "link" button 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" button will visit the other sentence, while clicking on the "link" button will link it to the one above. This is especially useful in a workflow in which you have previously copied the URL of a sentence (for example, by right-clicking it and selecting the "Copy Link Location" option). (Note that linking can only be performed by those with "advanced contributor" status and above. To request an upgrade in status, send a private message to alexmarcelo.) It is an updated version of Zifre's [Tatoeba Linker](http://userscripts.org/scripts/show/99149), which is no longer actively maintained.

 - [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.

 - [Tatoeba Visual Linker](http://userscripts.org/scripts/show/118538) (author: jakov/jakovo) With this script we can easily link sentences which are totally apart, i.e. make them translations of each other. There are two alternative ways to do that. Pick one and you are good to go.

    First one is **Shopping cart** method.

    Go to the *Sentence A* you would like to link and click on the shopping cart icon above the sentence (![][1]). Now the sentence is in your shopping cart and it goes wherever you go.
    Go to the *Sentence B* you would like to link to. If everything is right, you should be seeing the *Sentence A* at the end of the translations, as if it is an indirect translation. Click the chain icon (![][2]) to link *A* to *B*. It is that simple.

    The second one is **Manual** method. If you already know the sentence number of  *Sentence A*, this method could be faster.

    Go to the *Sentence B* (you would like to link to)
Click on the form area icon next to the shopping cart (![][3]). You should be seeing a form area at the end of translations.
    Type the sentence number here and click on the socket icon (![][4]). Now you should be seeing the sentence itself.
    Click the chain icon (![][5]) to link A to B. Again, it is that simple.

    If you want to empty the shopping cart, simply double click the shopping cart icon. If you want to remove a sentence from your cart, click on the cart icon (![][6]) on the right of the sentence.

##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
  [5]: http://imageshack.us/a/img580/4288/linkpr.png
  [6]: http://imageshack.us/a/img713/1825/removeu.png

Note

The lines in green are the lines that have been added in the new version. The lines in red are those that have been removed.