Skip to content

author_10_notes_more_info

cspayne edited this page Aug 4, 2023 · 2 revisions

Notes

Language tags

  • xml:lang attribute values: RDF language tags will be pulled from property sets as-is, so lang tags should be taken from the IANA Language Subtag Registry
    • For English-language text (for example, when providing default literal values) use "en".
    • For literal values without linguistic content (for example, when providing a default date or numeric value), use "zxx", or use the language_suppressed element (see entering configuration information for a property for more).

Using GitHub Desktop

Github Desktop makes working with repositories simpler. To use this workflow, you will be cloning the map_storage repository and eventually committing and pushing edited files back to GitHub to sync your work with the remote repository.

Cloning repositories

Committing and pushing files

Using Oxygen XML Editor

Keyboard shortcuts

Oxygen XML Editor includes numerous shortcut keys. Two in particular are very helpful:

CTRL + SPACE (for Windows) - content completion

See Content Completion Assistant in Text Mode for more information about content completion* in the Oxygen XML Editor.

Oxygen content completion suggesting elements
Entering a new line and left angle bracket in the Oxygen XML editor is one way to access content-completion prompts

Oxygen content completion suggesting textual content
Entering the first few letters of element content and then pressing CTRL + SPACE is another way to access content-completion prompts

* UW staff: Contact Benjamin Riesenberg if you need assistance using content completion while editing

CTRL + SHIFT + T (for Windows) - run transformation scenario

The Oxygen XML Editor project file in the map_storage repository (map_storage.xpr) provides some needed settings for transforming prop_set instances. Be sure to open this project file When editing a prop_set.

Working from the project file will allow use of the CTRL+SHIFT+T keyboard shortcut to quickly run two transformation scenarios while authoring resource templates in prop_set instances:

  • 001_localid_implementation_set.xsl, generating @localid_implementation_set attribute values which are required to validate the instances
  • 003_02_add_toolkit_URLs.xsl, adding links for the RDA Toolkit page for a given property
  • ⚠️ IMPORTANT: SAVE CHANGES prior to running these transformation scenarios. Following the transformation, Oxygen XML Editor will notify you that the file has been changed, and ask if you want to reload the file content from disk. Select 'Yes' or hit ENTER. @localid_implementation_set and toolkit @url values will be added to the data, but any unsaved changes will be lost.