X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=help%2Fhtml%2FwebServices%2Furllinks.html;fp=help%2Fhtml%2FwebServices%2Furllinks.html;h=da5d7ddd42c76bd03bfaf89e4c44881834b4a91e;hb=c437fc72420baf7b045d417fb6cabcebe87987c5;hp=088a5398aabaf90acca304e88852dce3ee7efaf4;hpb=ede54837349adde8f7265c6d8fa58d14165ee215;p=jalview.git diff --git a/help/html/webServices/urllinks.html b/help/html/webServices/urllinks.html index 088a539..da5d7dd 100644 --- a/help/html/webServices/urllinks.html +++ b/help/html/webServices/urllinks.html @@ -23,42 +23,55 @@

-

Opening URLs from Jalview
Both the applet and the desktop application are able to open URLs as 'popups' in - your web browser.
Double-clicking on the ID of a sequence - will open the first URL that can be generated from its sequence ID. + your web browser.

+

Double-clicking on the ID of a sequence + will open whichever URL is selected for 'popups' in the "Links" tab of the Jalview desktop + preferences. This is by default the EMBL-EBI site, but you can easily configure your own sequence URL links.

- Other links for a sequence either derived from any other configured + Other links for a sequence, either derived from any other configured URL links, or imported from the sequence's annotation, are accessed by right clicking to open the sequence pop-up menu, and selecting from the Links submenu.

Configuring URL Links
URL - links are defined in the "Connections" tab of the Jalview desktop + links are defined in the "Links" tab of the Jalview desktop preferences, or specified as applet - parameters.
By default the item "EMBL-EBI Search" is added - to this link menu. This link will show a web page in your default - browser with the selected sequence id as part of the URL.
- In the preferences dialog box, click new to add a - new link, and edit to modify an existing link, or delete - to remove it.
You can name the link, this will be displayed - on a new menu item under the "Link" menu when you right - click on a sequence id.
The URL string must contain a - token that can be replaced with a sequence ID or DB accession ID. The simplest token is - "$SEQUENCE_ID$", which will be replaced by the chosen - sequence id when you click on it. + parameters.

+

+ Default Link Settings
The "EMBL-EBI Search" + link is the default link shown in the "Link" submenu, and + opened when double-clicking on a sequence ID. When clicked, this + link will show a web page in your default browser with the selected + sequence ID as part of the URL. +

+

+ Adding additional links
You can configure your own + links via the Jalview Preferences + dialog. Jalview also provides persistent URLs for many common + bioinformatics databases. These links are downloaded by Jalview from + the identifiers.org website, and the names and URLs are not + user editable.

- eg.
UniRef100 = - http://www.ebi.uniprot.org/uniprot-srv/uniRefView.do?proteinAc=$SEQUENCE_ID$&library=uniref100
- Swissprot = http://www.expasy.org/uniprot/$SEQUENCE_ID$

+ Creating your own URL link URL links are specified as a + template containing special tokens that Jalview will replace with + the Sequence ID or Database Accession of the sequence when you + double click on its ID or open it's Link submenu. + Link URL templates must contain at least one token. +

+ eg.
 UniRef100 =
+    http://www.ebi.uniprot.org/uniprot-srv/uniRefView.do?proteinAc=$SEQUENCE_ID$&library=uniref100
+ Swissprot = http://www.expasy.org/uniprot/$SEQUENCE_ID$
+

Links will also be made for any database cross references associated with the sequence where the database name exactly matches a URL link name. In this case, the $DB_ACCESSION$ string will be replaced with @@ -83,33 +96,29 @@

Regular Expression Substitution
A url may contain a string of the form $SEQUENCE_ID=/regular - expression/=$ or $DB_ACCESSION=/regular expression/=$. - In this case, the regular expression will be - applied to the full sequence ID or DB accession ID string and the resulting match will + expression/=$ or $DB_ACCESSION=/regular expression/=$. In + this case, the regular expression will be applied to the full + sequence ID or DB accession ID string and the resulting match will be inserted into the URL. Groups of parentheses can be used to specify which regions of the regular expression will be used to generate the URL: +

-

-

+ Please Note: +
Many Thanks to Bernd Brandt of the Free University of + Amsterdam for testing the regular-expression expansion feature!