Translation Plans for FirstGlance in Jmol (FGiJ)
Local Operation for Testing
FGiJ can be operated from a local copy (instead of from an http server). Local
operation provides an easy way to test modifications, such as translation.
Ask for help if anything below is not clear!
- Check with
to coordinate efforts, and to find out where to get the current
version. Ideally, you would not be translating while the English
versions of the same texts are being updated!
-
Download the current version of FGiJ.
-
It would be wise to keep an unmodified copy of the version of FGiJ that
you will work on. This could come in very handy later.
-
Decompress the FGiJ filetree.
Open the file fgij/index.htm in the Firefox browser.
-
Go to pdb.org and enter a PDB code, such as 1d66. At the page on 1d66,
click on Display Files, then PDB file. In January, 2010, these links were at
the upper right of the window. You should see the text of the PDB file in
Firefox. Copy the URL to the PDB file. In January, 2010, it was
http://www.pdb.org/pdb/files/1D66.pdb
-
At fgij/index.htm, click on Enter a molecule's URL, then paste the
URL into the slot, and Submit.
-
Click OK to use the signed Jmol applet, then give it permission to run.
FGiJ should start and display the molecule. (The signed applet is required
because you are asking
the applet to get a PDB file from an external source.)
-
If you want to display a different molecule, simply change the PDB code
at the end of the above URL.
Updating a Previous Translation
Suppose that a translated version exists, but meanwhile, a newer version of FGiJ
has been released. Here is a suggestion on how to identify the portions of
text that need updated translation.
-
Download the newer version of FGiJ. We'll call it the New English Version.
-
Make a duplicate copy of the New English Version. It may be very handy to
have an unmodified copy later.
-
Obtain the previous version of FGiJ, that was translated, in English. We'll call it
the Old English Version.
-
Compare the New English Version with the Old English Version, file by file.
The only program we know about that is fully satisfactory for this purpose
is a Windows program called Beyond Compare from
scootersoftware.com. It will show
you exactly which files differ, and exactly which lines in each file differ.
-
Knowing which lines differ in which files, you can decide what is the simplest
way to update each translated file.