Konfiguration des Kekulé-Editors (JACK3)

Der web-basierte Editor für die studentische Eingabe im Aufgabwentyp "Molekül" kann umfangreich konfiguriert werden, um Studierenden möglichst genau die Funktionen zur Verfügung zu stellen, die sie zur Bearbeitung der Aufgabe benötigen.

Die Konfiguration kann dabei entweder durch einen Administrator zentral für die gesamte JACK-Instanz oder durch Lehrende individuell pro Aufgabe erfolgen.

Einstellungen für den Editor für Studierende

Einstellung für die allgemeinen Tool-Buttons

Diese Einstellungen legen fest, welche Buttons in der oberen Leiste des Editors verfügbar sind, also z. B. Laden, Speichern, Undo und Redo.

Um eine individuelle Konfiguration pro Aufgabe anzulegen, wählen Lehrende "Angepasst" und erstellen einen Eintrag der folgenden Form im Textfeld:

["newDoc", "undo", "redo", "copy", "cut", "paste"]

Die verfügbaren Namen der einzelnen Buttons können der Demo-Seite des Kekulé-Editors entnommen werden: http://partridgejiang.github.io/Kekule.js/demos/demoLauncher.html?id=composerCustomization

Um die Standardeinstellung der gesamten JACK-Instanz zu ändern, legen Administratoren im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekule_commonToolButtons" und einem Wert der folgenden Form an:

{
  "default" : ["newDoc", "undo", "redo", "copy", "cut", "paste"]
}

Der Eintrag default ist dabei fest vorgesehen für die Änderung der Standardeinstellung. Es können weitere Voreinstellungen mit frei gewählten Namen angelegt werden:

{
  "default" : ["newDoc", "undo", "redo", "copy", "cut", "paste"],
  "minimal" : ["undo", "copy", "cut", "paste"]
}

Diese können von Lehrenden dann alternativ zur Standardeinstellung und der Anpassung pro Aufgabe gewählt werden. Wird vom Administrator kein Eintrag für default hinterlegt, gilt die Standardeinstellung des Editors.

Unabhängig von den gewählten Einstellung zeigt JACK ab Version 0.10.0 für Studierende niemand die Editor-Buttons zum Ändern der Einstellungen und zum Öffnen des Objekt-Inspektors an.

Einstellungen für die chemischen Tool-Buttons

Diese Einstellungen legen fest, welche Buttons in der linken und unteren Leiste des Editors verfügbar sind, also z. B. zum Erstellen von Bindungen und Atomen.

Um eine individuelle Konfiguration pro Aufgabe anzulegen, wählen Lehrende "Angepasst" und erstellen einen Eintrag der folgenden Form im Textfeld:

[
	{
		"name": "manipulate",
		"attached": [ "manipulateMarquee", "manipulateLasso", "manipulateAncestor", "dragScroll", "toggleSelect" ]
	},
	"erase",
	{
		"name": "bond",
		"attached": [ "bondSingle",	"bondDouble", "bondTriple", "bondWedgeUp", "bondWedgeDown", "chain", "trackInput" ]
	},
	{
		"name": "atomAndFormula",
		"attached": [ "methane", "atom" ]
	},
	{
		"name": "ring",
		"attached": [ "ring3", "ring4", "ring5", "ring6", "flexRing", "ringAr6" ]
	},
	{
		"name": "charge",
		"attached": [ "chargeClear", "chargePositive", "chargeNegative" ]
	}
]

Die verfügbaren Namen der einzelnen Buttons können der Demo-Seite des Kekulé-Editors entnommen werden: http://partridgejiang.github.io/Kekule.js/demos/demoLauncher.html?id=composerCustomization

Um die Standardeinstellung der gesamten JACK-Instanz zu ändern, legen Administratoren im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekule_chemToolButtons" und einem Wert der folgenden Form an:

{
  "default" : [
	{
		"name": "manipulate",
		"attached": [ "manipulateMarquee", "manipulateLasso", "manipulateAncestor", "dragScroll", "toggleSelect" ]
	},
	"erase",
	{
		"name": "bond",
		"attached": [ "bondSingle",	"bondDouble", "bondTriple", "bondWedgeUp", "bondWedgeDown", "chain", "trackInput" ]
	},
	{
		"name": "atomAndFormula",
		"attached": [ "methane", "atom" ]
	},
	{
		"name": "ring",
		"attached": [ "ring3", "ring4", "ring5", "ring6", "flexRing", "ringAr6" ]
	},
	{
		"name": "charge",
		"attached": [ "chargeClear", "chargePositive", "chargeNegative" ]
	}
]}

Der Eintrag default ist dabei fest vorgesehen für die Änderung der Standardeinstellung. Wie bei den allgemeinen Buttons können weitere Voreinstellungen mit frei gewählten Namen angelegt werden, die dann von Lehrenden alternativ zur Standardeinstellung und der Anpassung pro Aufgabe gewählt werden können. Wird vom Administrator kein Eintrag für default hinterlegt, gilt die Standardeinstellung des Editors.

Einstellungen für die verfügbaren Object Modifier

Diese Einstellungen legen fest, welche zusätzlichen Buttons in der unteren Leiste des Editors verfügbar sind, wenn ein Element im Editor ausgewählt ist.

Um eine individuelle Konfiguration pro Aufgabe anzulegen, wählen Lehrende "Angepasst" und erstellen einen Eintrag der folgenden Form im Textfeld:

["general", "chemStruct", "glyph", "style", "misc"]

Die verfügbaren Namen der einzelnen Buttons können der Demo-Seite des Kekulé-Editors entnommen werden: http://partridgejiang.github.io/Kekule.js/demos/demoLauncher.html?id=composerCustomization

Um die Standardeinstellung der gesamten JACK-Instanz zu ändern, legen Administratoren im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekule_allowedObjModifierCategories" und einem Wert der folgenden Form an:

{
  "default" : ["general", "chemStruct", "glyph", "style", "misc"]
}

Der Eintrag default ist dabei fest vorgesehen für die Änderung der Standardeinstellung. Wie bei den allgemeinen Buttons können weitere Voreinstellungen mit frei gewählten Namen angelegt werden, die dann von Lehrenden alternativ zur Standardeinstellung und der Anpassung pro Aufgabe gewählt werden können. Wird vom Administrator kein Eintrag für default hinterlegt, gilt die Standardeinstellung des Editors.

Einstellungen für verfügbare Bindungsformen

Diese Einstellungen legen fest, welche Bindungsformen in den zusätzlichen Buttons in der unteren Leiste des Editors verfügbar sind. Bei Bindungsformen, die eigenen Buttons haben, müssen ggf. auch deren Einstellungen (siehe oben) konfiguriert werden. Dasselbe gilt für die Verfügbarkeit von Bindungen über Hotkeys (siehe unten).

Um eine individuelle Konfiguration pro Aufgabe anzulegen, wählen Lehrende "Angepasst" und erstellen einen Eintrag der folgenden Form im Textfeld:

{
    "single": true,
    "double": true,
    "triple": false,
    "quad": false,
    "explicitAromatic": true,
    "up": true,
    "upInverted": true,
    "down": true,
    "downInverted": true,
    "upOrDown": true,
    "eOrZ": true,
    "closer": false,
    "ionic": false,
    "coordinate": false,
    "metallic": false,
    "hydrogen": false,
    "transition": false
}

Diese Auflistung enthält alle verfügbaren Namen von Bindungen, die jeweils über true oder false aktiviert bzw. deaktiviert werden können.

Um die Standardeinstellung der gesamten JACK-Instanz zu ändern, legen Administratoren im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekule_availableBondForms" und einem Wert der folgenden Form an:

{
  "default" : {
    "single": true,
    "double": true,
    "triple": false,
    "quad": false,
    "explicitAromatic": true,
    "up": true,
    "upInverted": true,
    "down": true,
    "downInverted": true,
    "upOrDown": true,
    "eOrZ": true,
    "closer": false,
    "ionic": false,
    "coordinate": false,
    "metallic": false,
    "hydrogen": false,
    "transition": false
    }
}

Der Eintrag default ist dabei fest vorgesehen für die Änderung der Standardeinstellung. Wie bei den allgemeinen Buttons können weitere Voreinstellungen mit frei gewählten Namen angelegt werden, die dann von Lehrenden alternativ zur Standardeinstellung und der Anpassung pro Aufgabe gewählt werden können. Wird vom Administrator kein Eintrag für default hinterlegt, gilt die Standardeinstellung des Editors.

Einstellungen für verfügbare nicht-atomare Strukturelemente

Diese Einstellungen legen fest, welche zusätzlichen Strukturelemente außer Atomen in den zusätzlichen Buttons in der unteren Leiste des Editors verfügbar sind. Bei Elementen, die auch über Hotkeys gesetzt werden können, müssen ggf. auch deren Einstellungen (siehe unten) konfiguriert werden.

Um eine individuelle Konfiguration pro Aufgabe anzulegen, wählen Lehrende "Angepasst" und erstellen einen Eintrag der folgenden Form im Textfeld:

{
    "RGroup": true,
    "pseudoatomDummy": true,
    "pseudoatomHetero": true,
    "pseudoatomAny": true,
    "variableAtomList": false,
    "variableAtomNotList": false
}

Diese Auflistung enthält alle verfügbaren Namen von nicht-atomaren Elementen, die jeweils über true oder false aktiviert bzw. deaktiviert werden können.

Um die Standardeinstellung der gesamten JACK-Instanz zu ändern, legen Administratoren im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekule_availableNonAtomTypes" und einem Wert der folgenden Form an:

{
  "default": {
    "RGroup": true,
    "pseudoatomDummy": true,
    "pseudoatomHetero": true,
    "pseudoatomAny": true,
    "variableAtomList": false,
    "variableAtomNotList": false
  }
}

Der Eintrag default ist dabei fest vorgesehen für die Änderung der Standardeinstellung. Wie bei den allgemeinen Buttons können weitere Voreinstellungen mit frei gewählten Namen angelegt werden, die dann von Lehrenden alternativ zur Standardeinstellung und der Anpassung pro Aufgabe gewählt werden können. Wird vom Administrator kein Eintrag für default hinterlegt, gilt die Standardeinstellung des Editors.

Standard für die Anzeige von Wasserstoffatomen

Diese Einstellung legt fest, ob alle Wasserstoffatome angezeigt werden oder die Standardeinstellung des Editors verwendet wird, die Wasserstoffatome nur in bestimmten Fällen anzeigt. Die Festlegung kann nur pro Aufgabe getroffen werden und nicht durch einen Administrator für die gesamte JACK-Instanz.

Einstellungen für alle Editoren

Hotkeys

Administratoren können die Liste der verfügbaren Hotkeys für alle Editoren (d. h. sowohl für Studierende als auch Lehrende) ändern. Sie legen dazu im Bereich "Verwaltung -> Konfiguration" einen Eintrag mit Schlüssel "kekuleHotkeys" und einem Wert der folgenden Form an:

[
  { "key": "c", "action": "atom_C" },
  { "key": "h", "action": "atom_H" },
  { "key": "o", "action": "atom_O" },
  { "key": "n", "action": "atom_N" },
  { "key": "p", "action": "atom_P" },
  { "key": "s", "action": "atom_S" },
  { "key": "f", "action": "atom_F" },
  { "key": "Shift+C", "action": "atom_Cl" },
  { "key": "b", "action": "atom_Br" },
  { "key": "i", "action": "atom_I" },
  { "key": "Shift+B", "action": "atom_B" },
  { "key": "k", "action": "atom_K" },
  { "key": "Shift+N", "action": "atom_Na" },
  { "key": "d", "action": "atom_D" },
  { "key": "m", "action": "subgroup_methyl" },
  { "key": "e", "action": "subgroup_ethyl" },
  { "key": "t", "action": "subgroup_TMS" },
  { "key": "Shift+P", "action": "subgroup_phenyl" },
  { "key": "Shift+T", "action": "subgroup_OTs" },
  { "key": "Shift+E", "action": "subgroup_COOCH3" },
  { "key": "a", "action": "atom_any" },
  { "key": "q", "action": "atom_hetero" },
  { "key": "l", "action": "atom_variable" },
  { "key": "r", "action": "subgroup_R" },
  { "key": "1", "action": "bond_single" },
  { "key": "2", "action": "bond_double" },
  { "key": "3", "action": "bond_triple" },
  { "key": "4", "action": "bond_quad" },
  { "key": "b", "action": "bond_closer" },
  { "key": "w", "action": "bond_up" },
  { "key": "h", "action": "bond_down" },
  { "key": "Shift+W", "action": "bond_down" },
  { "key": "y", "action": "bond_upOrDown" },
  { "key": "Ctrl+A", "action": "selectAll" },
  { "key": "Ctrl+C", "action": "copy" },
  { "key": "Ctrl+X", "action": "cut" },
  { "key": "Ctrl+V", "action": "paste" },
  { "key": "Ctrl+Z", "action": "undo" },
  { "key": "Ctrl+Shift+Z", "action": "redo" },
  { "key": "+", "action": "zoomIn" },
  { "key": "-", "action": "zoomOut" },
  { "key": "Delete", "action": "eraseSelection" },
  { "key": "Backspace", "action": "eraseSelection" }
]

Diese Auflistung enthält alle verfügbaren Namen von Aktionen, denen ein Hotkey zugewiesen werden kann. Einträge können weggelassen werden, wenn die entsprechende Aktion nicht per Hotkey verfügbar sein soll.