Äîêóìåíò âçÿò èç êýøà ïîèñêîâîé ìàøèíû. Àäðåñ îðèãèíàëüíîãî äîêóìåíòà : http://monkey.belozersky.msu.su/npidb/jmol/LEAME.txt Äàòà èçìåíåíèÿ: Fri Nov 21 00:24:04 2008 Äàòà èíäåêñèðîâàíèÿ: Mon Oct 1 19:31:14 2012 Êîäèðîâêà:

==============================================================================
=== Jmol ===
==============================================================================


Jmol es un visor de molÈculas y un editor; es de cÑdigo abierto y estÀ
escrito en Java.

Toda la informaciÑn estÀ disponible en http://www.jmol.org/

Las preguntas o comentarios relativos a su uso deben enviarse a
jmol-users@lists.sourceforge.net (en inglÈs)

Las preguntas, comentarios y sugerencias relativos a su desarrollo deben
enviarse a jmol-developers@lists.sf.net (en inglÈs)


Lista de archivos incluidos:
--------------------

- LEAME.txt
Este archivo.

- README.txt
La versiÑn en inglÈs de este archivo.

- COPYRIGHT.txt
InformaciÑn sobre los derechos de copia.

- LICENSE.txt
Los tÈrminos de uso y distribuciÑn de Jmol (licencia GNU LGPL).

- Jmol.jar
El archivo ejecutable de la aplicaciÑn Jmol (un programa escrito en
Java). Funciona como cualquier otro programa: se abre en su
propia ventana, se puede redimensionar o minimizar, se puede arrastrar
y soltar archivos sobre Èl, tiene una barra superior de menÇ, puede
abrir y grabar archivos, etc. Puede ejecutarse desde la lÌnea de comandos
(particularmente, usando los archivos por lotes que se describen a
continuaciÑn) pero, si Java estÀ correctamente configurado en tu
sistema, normalmente basta con hacer doble clic en este archivo.

- jmol
(Un tipo de archivo por lotes para iniciar la aplicaciÑn Jmol)

- jmol.bat
Archivo por lotes para iniciar la aplicaciÑn en Windows.

- jmol.mac
(Un tipo de archivo por lotes para iniciar la aplicaciÑn Jmol)

- jmol.sh
Un archivo de instrucciones para iniciar la aplicaciÑn Jmol en
sistemas de tipo Unix, por ejemplo Linux, BSD, Solaris o
Cygwin para Windows.

- JmolApplet.jar
La miniaplicaciÑn ("applet"), es decir, una versiÑn del programa
que sÑlo funciona cuando estÀ incrustada en una pÀgina web.
Se trata en este caso de un archivo "todo en uno" o "monolÌtico"
que se mantiene principalmente por compatibilidad con pÀginas
antiguas que lo invoquen explÌcitamente. El mÈtodo recomendado
actualmente es el uso de la versiÑn subdividida (JmolApplet0.jar etc.,
descrita mÀs abajo). En particular, Jmol.js utiliza la versiÑn subdividida.
Te puede interesar utilizar este archivo si quieres mantener
sencillo tu sitio web, o si sÑlo quieres actualizar un archivo jar
cuando lleguen versiones nuevas de Jmol. Sin embargo, este Jmol se
cargarÀ algo mÀs lentamente que las versiones subdivididas, puesto
que es preciso que se descargue al equipo del usuario el programa
completo, con todos sus componentes, antes de que se pueda mostrar
una estructura.
Para llamar a JmolApplet.jar desde Jmol.js:
a) ponlo en la misma carpeta que contiene la pÀgina HTML que lo
requiere y no uses jmolInitialize()
o bien
b) identifÌcalo explÌcitamente en jmolInitialize(), por ejemplo:
jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolApplet.jar")

- JmolAppletSigned.jar
Una versiÑn equivalente de la miniaplicaciÑn, pero en este caso
es una miniaplicaciÑn "firmada" o "confiable" (terminologÌa de seguridad
en el lenguaje Java). Esto significa que para ejecutarse debe previamente
ser autorizada por el usuario visitante de la pÀgina web y, de ser asÌ,
habrÀ menos restricciones de seguridad para el acceso a archivos. Por
ejemplo, podrÀ acceder a archivos en cualquier parte del ordenador del
usuario y en cualquier otro servidor web.
Habitualmente, los usuarios recibirÀn un aviso prguntÀndoles si quieren
"aceptar el certificado" o si "confÌan" en la miniaplicaciÑn; sin embargo,
esta prestaciÑn de seguridad no siempre estÀ activada. Si decides usar
JmolAppletSigned.jar, debes tener esto en cuenta.
Aparte de la lectura de archivos, Jmol no utiliza ninguna otra capacidad
de las miniaplicaciones firmadas, como acceder al portapapeles del sistema
o grabar archivos. Usa la miniaplicaciÑn firmada sÑlo si sabes lo que estÀs
haciendo y has tenido en cuenta las cuestiones de seguridad.
Para llamar a JmolAppletSigned.jar desde Jmol.js:
jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolAppletSigned.jar")

- Jmol.js
Esta es la bilioteca de funciones, escrita en el lenguaje JavaScript,
que ayuda en la preparaciÑn de pÀginas web que usen la miniaplicaciÑn
Jmol sin necesidad de conocer y escribir cÑdigo detallado especÌfico
para la miniaplicaciÑn.
Esta biblioteca usa por defecto la versiÑn subdividida de la
miniaplicaciÑn (firmada o no).
EstÀ documentada en detalle en http://jmol.org/jslibrary/

- JmolApplet0.jar y
JmolApplet0(diversosSufijos).jar
La miniaplicaciÑn se divide en varios trozos de acuerdo con su
funcionalidad, de modo que si una pÀgina no precisa determinado
componente, Èste no se descargarÀ desde el servidor. Aun asÌ, se
recomienda que pongas todos los archivos JmolApplet0*.jar en el
servidor, incluso si tus pÀginas no usan sus prestaciones, pues
tanto el menÇ emergente como la consola permiten a los usuarios
acceder a funciones de Jmol que tÇ no hayas previsto.
El conjunto de todos estos archivos es equivalente al archivo
Çnico JmolApplet.jar.
Esta versiÑn subdividida es la que se usa de forma predeterminada
si utilizas Jmol.js. Para ello, basta usar la forma mÀs simple de
jmolInitialize(), indicando sÑlo la carpeta que contiene el conjunto
de archivos jar:
jmolInitialize("carpeta-que-contiene-los-archivos-jar")
por ejemplo,
jmolInitialize(".")
(si los archivos jar estÀn en la misma carpeta que la pÀgina web)
jmolInitialize("../jmol")
(si los archivos jar estÀn en una carpeta paralela, llamada 'jmol')

- JmolAppletSigned0.jar y
JmolAppletSigned0(diversosSufijos).jar
La versiÑn firmada de la miniaplicaciÑn subdividida. Esta versiÑn
permite que el usuario acceda a archivos en cualquier parte de su
ordenador y en cualquier servidor web.
Habitualmente, los usuarios recibirÀn un aviso pidiÈndoles que acepten
el certificado para **cada uno** de los archivos jar que se pueden cargar
(actualmente, 16). Por esta razÑn, es probable que esta versiÑn no
sea de uso habitual.
El conjunto de todos estos archivos es equivalente al archivo
Çnico JmolAppletSigned.jar.
Para llamar a esta versiÑn desde Jmol.js:
a) jmolInitialize("carpeta-que-contiene-los-archivos-jar", true)
o bien
b) jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolAppletSigned0.jar")

---------------------------
Teniendo en cuenta las descripciones anteriores, observarÀs que el paquete
de distribuciÑn de Jmol contiene 4 copias completas de la miniaplicaciÑn
(firmada or no, subdividida o no).
---------------------------