Home | Resources | Services | Hosting | Publications | Collaboration | Joining CERL | About CERL |

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
resources:cerl_thesaurus:editing:newinterface [2018/03/27 12:25] – [4.4 Using the YAML Editor] jahnkeresources:cerl_thesaurus:editing:newinterface [2018/03/27 14:32] – [4.3 Using the CT Internal Format Editor] jahnke
Line 220: Line 220:
  
 ==== 4.3 Using the CT Internal Format Editor ==== ==== 4.3 Using the CT Internal Format Editor ====
 +
 +{{ :resources:cerl_thesaurus:editing:editing6.png?300|FLC Editor}}
 +
 +The "Internal Format" editor allows to edit the CERL Thesaurus data in the same Unimarc based field format as it has been the case in the old Avanti environment. It's called "Internal Format" since this has been the internal format in the old system and is still used for a ingesting and update, although the actual internal format is quite different now (JSON). 
 +
 +The format description and input conventions can be found [[format|here]]. Different from the old WinADH client, the Internal Format editor is used for editing records only - for merging duplicate records there is now a different editor available (see below).
 +
 +In comparison to the form based editor, the display of the information stored in a record is much more compact and easiert to grasp at first glance. For experienced editors typing field numbers and subfields is probably faster than handling a complex form.
 +
 +There is also no input validation implemented yet, any invalid fields, indicator positions or subfields will be silently ignored when the data is converted to JSON, so make sure to check from the record's full display if all information has been entered correctly.
 +
  
 ==== 4.4 Using the YAML Editor ==== ==== 4.4 Using the YAML Editor ====
Line 229: Line 240:
 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]]. 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].+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.+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 try copying the record into an external validator (e.g. [[http://www.yamllint.com/]]) to see what went wrong.
 ==== 4.5 Deduplicating Records ==== ==== 4.5 Deduplicating Records ====
 resources/cerl_thesaurus/editing/newinterface.txt · Last modified: 2023/12/11 15:13 by jahnke

 

 

Recent changes RSS feed Valid XHTML 1.0 Driven by DokuWiki