Differences

This shows you the differences between two versions of the page.

--- resources:cerl_thesaurus:editing:newinterface [2018/03/27 12:03] – [4.2 Using the Form Based Editor] jahnke
+++ resources:cerl_thesaurus:editing:newinterface [2018/03/27 12:26] – [4.4 Using the YAML Editor] jahnke
@@ Line 223: / Line 223: @@
 ==== 4.4 Using the YAML Editor ====
+{{ :resources:cerl_thesaurus:editing:editing5.png?300|yaml editor}}
+The YAML editor is the most powerfull of the available editing clients. It allows you to directly manipulate the internal data structure and you should use it only if you know exactly what you are doing.
+Internally records are stored in [[https://en.wikipedia.org/wiki/JSON|JSON]] - YAML is a way to represent JSON data structures in a conveniently readable form((actually, YAML can do more than that, but since we have to transform our record back to JSON to store and process them, we will limit ourselves to this aspect of it)), replacing all the curly brackets with indentations (use blanks, not tab stops!) and the square ones with hyphens. Before you are using this editing client, get familiar with the basic [[https://en.wikipedia.org/wiki/YAML#Syntax|YAML Syntax]].
+For longer records, you can switch the editor to full screen mode by pressing [F11] or clicking the yellow button labeled "Fullscreen". To return to normal mode press [F11] again or [ESC].
+If you are trying to save your record, but nothing happens, you have most likely made an error with the YAML-Syntax. Since the editor does not yet return a validation report, you may copying the record into an external validator (e.g. [[http://www.yamllint.com/]]) and see what went wrong.
 ==== 4.5 Deduplicating Records ====

resources/cerl_thesaurus/editing/newinterface.txt · Last modified: 2023/12/11 15:13 by jahnke