Quelltext der Seite Jmol-Wiki-Extension

In diesem Artikel wird beschrieben wie die '''[[Jmol]]-Extension''' für die Wiki-Software verwendet werden kann.

Man kann damit zum Beispiel cml-Dateien dynamisch hier auf einer Wiki-Seite anzeigen, und das Molekül von allen Seiten betrachten. Hochgeladene CML-Dateien sind hier im Wiki in der Kategorie [[:Kategorie:CML-Datei]] zu finden.

{{Kurzregel|'''UPDATE:''' Die Jmol-Wiki-Extensino wurde durch die Jsmol-Extension ersetzt. Dies macht die Zeichnungen auch auf Tablets und anderen mobilen Geräten nutzbar. Und man ist nicht mehr von Java und dessen Sicherheitsproblemen abhängig. Allerdings führte das dazu, dass auf Seiten mit mehr als einem Bild nur das erste zu sehen ist. Das wird mit einer neueren Version vermutlich besser werden.}}

== Wie man ein Bild anzeigt ==

Ein Beispiel:

{|
|- 
|<jmol>
 <jmolApplet>
 <size>300</size>
 <uploadedFileContents>CisDecen.cml</uploadedFileContents>
 </jmolApplet>
</jmol>
||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;||

Links ist nun eine interaktive 3D-Zeichung eingebettet, das Molekül lässt sich mit der '''linken Maustaste festhalten und drehen'''. Mit dem '''Mausrad kann man das Bild vergrößern oder verkleinern'''.

Um die Zeichnung links zu erhalten, muss man folgendes im Code stehen haben:

 <nowiki><jmol></nowiki>
  <nowiki><jmolApplet></nowiki>
   <nowiki><size>300</size></nowiki>
   <nowiki><uploadedFileContents>CisDecen.cml</uploadedFileContents></nowiki>
  <nowiki></jmolApplet></nowiki>
 <nowiki></jmol></nowiki>

Kopieren Sie also diesen Code einfach und fügen es auf Ihrer Wiki-Seite ein. Bisher gibt es nur die Möglichkeit quadratische Zeichnungen einzubinden, die Größe/Breite der Zeichnung in Pixel wird <code><size>300</size></code> bestimmt. 

Bei diesem Aufruf wird immer die Voreinstellung zur Darstellung verwendet, nämlich ein Kugel-Stab-Modell. Weitere Einstellungen sind über ein Script möglich, dass in diesen Bereich eingefügt wird. Wie das geht wird auf einer Extra-Seite (siehe unten - Scripting) erklärt.

|}

Um '''ein anderes Molekül darzustellen''', zeichnen Sie es in einem Programm wie [[Avogadro]], speichern es als cml-Datei ab, laden es hier hoch und tragen dann den Namen der Datei ein. Im Beispiel-Code für dieses Beispiel müssen Sie also <code>CisDecen.cml</code> ersetzen. Allerdings wurden schon einige Dateien hochgeladen, die man in der Übersicht zur [[:Kategorie:CML-Datei]] findet. Merken Sie sich den Namen des Moleküls/der Datei und verwenden ihn im Code oben.

== Scripting ==
Um die Darstellung im Jmol-Bild zu verändern, oder per Knopf eine Änderung der Darstellung zu ermöglichen, kann Scripting genutzt werden.

Auf [[Frau_Lachner/Oberstufe/Testseite_zu_Darstellung_von_Orbitalen|dieser Test-Seite]] wurden einige Knöpfe und auch Checkboxen ausprobiert. Zu einer besseren Darstellung müssen die Bedienelemente nicht im gleichen <nowiki><jmol></nowiki>-Tag eingebaut werden sondern können davon getrennt eingebaut werden. Das ermöglicht es, zwischen einzelnen Schaltelementen auch Text und statische Bilder einzufügen um zusätzliche Erklärungen zu geben.


Auf [http://wiki.jmol.org/index.php/MediaWiki/ExtensionV3 dieser Seite] gibt es Informationen dazu, wie man Knöpfe und andere Formular-Elemente einbauen. Beispielseiten sind [http://wiki.jmol.org/index.php/Jmol_MediaWiki_Extension hier] und [http://wiki.jmol.org/index.php/User:Bduke hier mit ein paar mehr Beispielen]. 

Informationen zu Scripting zu Jmol allgemein gibt es auf diesen Seiten:
* [http://www.bioc.uzh.ch/plueckthun/nanowelt/Jmol/ Deutsches Tutorial] mit einigen interaktiven Beispielen zur Anwendung von Scripten.
* [http://jmol.sourceforge.net/docs/surface/ Seite speziell zu Oberflächen], aber nicht so gut erklärt.
* [http://chemapps.stolaf.edu/jmol/docs/?ver=14.2 Gesamte Dokumentation zu Jmol]
** Abschnitt speziell zu [http://chemapps.stolaf.edu/jmol/docs/?ver=14.2#lcaocartoon LCAoCartoon] 
* [http://chemapps.stolaf.edu/jmol/docs/examples-11/lcao.htm Beispiel-Seite] zum LCAOCartoon-Befehl in der JmolDokumentation.
* Englisches Video zum[https://www.youtube.com/watch?v=nnar8ozhPbc Zeichnen, zur Darstellung von Atomorbitalen und Orbitalen in Molekülen].

Vermutlich ist es sinnvoll, pro Seite nur eine Jsmol-Zeichnung einzubinden, damit es möglich flott ist und nicht zu sehr ruckelt.

{{Kurregel|'''Eine ausführliche Anleitung für das Scripting mit Jmol''' - was nicht nur für die Wiki-Extension sondern auch im alleine laufenden Jmol nutzbar ist - ist auf [[Scripting mit Jmol|dieser Seite]] verfügbar.}}

== Weitere Informationen auf dem Jmol-Wiki ==

* http://wiki.jmol.org/index.php/MediaWiki


[[Kategorie:Software]][[Kategorie:Hilfe-Seiten]][[Kategorie:Wiki-Hilfe-Seiten]]
[[Kategorie:Jmol]]