tmdinosaurcenter
/
dwc
mirror of https://github.com/tdwg/dwc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix links to .xsd files

This commit is contained in:
Peter Desmet 2018-08-27 11:33:19 +12:00
parent f8089c7c33
commit 67ea1d22ea
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/guides/xml/index.md
View File

@ -99,11 +99,11 @@ Do not use an empty string - an element with no content:
### 2.6 Simple Darwin Core
The _Simple Darwin Core_ [[SIMPLEXMLSCHEMA](../../../xsd/tdwg_dwc_simple.xsd)] most closely models the "flat" nature of many data sets. It is a ready-made schema for sharing information with no structure beyond properties of a _record_ (equivalent to fields in a table, or columns in a spreadsheet). It is meant to accommodate all properties except those that require further structure to be meaningful (auxilliary terms in the classes [ResourceRelationship](../../index.htm#ResourceRelationship) and [MeasurementOrFact](../../index.htm#MeasurementOrFact). The schema has no required terms and no term is repeated within a given _record_. Refer to the _Simple Darwin Core_ page [[SIMPLEDWC](../../simple/index.htm)] for the rationale behind this schema.
The _Simple Darwin Core_ [[SIMPLEXMLSCHEMA](tdwg_dwc_simple.xsd)] most closely models the "flat" nature of many data sets. It is a ready-made schema for sharing information with no structure beyond properties of a _record_ (equivalent to fields in a table, or columns in a spreadsheet). It is meant to accommodate all properties except those that require further structure to be meaningful (auxilliary terms in the classes [ResourceRelationship](../../index.htm#ResourceRelationship) and [MeasurementOrFact](../../index.htm#MeasurementOrFact). The schema has no required terms and no term is repeated within a given _record_. Refer to the _Simple Darwin Core_ page [[SIMPLEDWC](../../simple/index.htm)] for the rationale behind this schema.
The term [dcterms:type](../../index.htm#type) (which is controlled by the _Dublin Core Type Vocabulary_ [[DCMI-TYPE](http://dublincore.org/documents/dcmi-type-vocabulary/)]), gives the basic category of object (PhysicalObject, StillImage, MovingImage, Sound, or Text) the record is about. The term [basisOfRecord](../../index.htm#basisOfRecord), which has a controlled vocabulary distinct from that of _dcterms:type_, shows the name of the Darwin Core class (e.g., LivingSpecimen, PreservedSpecimen, FossilSpecimen, HumanObservation, MachineObservation, Taxon) the record is about.
Following is a brief example of an XML document for a single specimen complying with the _Simple Darwin Core Schema_ [[SIMPLEXMLSCHEMA](../../../xsd/tdwg_dwc_simple.xsd)]. The Simple Darwin Core XML example document [[SIMPLEXMLEXAMPLE](../../../examples/xml/example_simple.xml)] (if this link shows a blank page in your browser, use the View Source option to see the XML document) shows detail for a single record having a more complete set of elements.
Following is a brief example of an XML document for a single specimen complying with the _Simple Darwin Core Schema_ [[SIMPLEXMLSCHEMA](tdwg_dwc_simple.xsd)]. The Simple Darwin Core XML example document [[SIMPLEXMLEXAMPLE](../../../examples/xml/example_simple.xml)] (if this link shows a blank page in your browser, use the View Source option to see the XML document) shows detail for a single record having a more complete set of elements.
```XML
<?xml version="1.0"?>
@ -134,10 +134,10 @@ Following is a brief example of an XML document for a single specimen complying
Many Darwin Core terms (_properties_) are defined as being associated with another term (a _class_). For example, [scientificName](../../index.htm#ScientificName) and [Taxon](../../index.htm#Taxon) are both Darwin Core terms, but _scientificName_ is a property associated with the _Taxon_ class. When constructing schemas that take advantage of classes in structures, implementors are encouraged to maintain the property/class relationships defined by the terms whenever possible (refer to the _Class_ attribute of the term as given in the _Quick Reference Guide_ [[TERMS](../../index.htm)]) or the attribute _dwcattributes:organizedInClass_ in the term declaration in the [dcterms.rdf](../../../rdf/dcterms.rdf) file. To promote reuse, Darwin Core provides a set of xml schemas to use as the basis of additional schemas:
- [[TERMSXMLSCHEMA](../../../xsd/tdwg_dwcterms.xsd)] - property term definitions as typed global elements and named groups for all terms for a given class to be referenced. The schema makes use of substitution groups anyClass, anyProperty, anyIdentifier and anyXYZTerm for each class, e.g. anyTaxonTerm. This is the schema upon which the _Simple Darwin Core XML Schema_ [[SIMPLEXMLSCHEMA](../../../xsd/tdwg_dwc_simple.xsd)] is based.
- [[CLASSTERMSXMLSCHEMA](../../../xsd/tdwg_dwc_class_terms.xsd)] - class term definitions as typed global elements with subelements referencing all corresponding property terms via their substitution group.
- [[TERMSXMLSCHEMA](tdwg_dwcterms.xsd)] - property term definitions as typed global elements and named groups for all terms for a given class to be referenced. The schema makes use of substitution groups anyClass, anyProperty, anyIdentifier and anyXYZTerm for each class, e.g. anyTaxonTerm. This is the schema upon which the _Simple Darwin Core XML Schema_ [[SIMPLEXMLSCHEMA](tdwg_dwc_simple.xsd)] is based.
- [[CLASSTERMSXMLSCHEMA](tdwg_dwc_class_terms.xsd)] - class term definitions as typed global elements with subelements referencing all corresponding property terms via their substitution group.
It is encouraged to use classes in a normalized way to avoid deep nesting. A _Darwin Core Tools and Applications_ wiki page [[TOOLS](https://github.com/tdwg/dwc-documentation/blob/master/documentation/resources.md)] has been created as an index to example schemas for the purpose of community discussions and development. An XML schema [[CLASSXMLSCHEMA](../../../xsd/tdwg_dwc_classes.xsd)] is provided to freely mix any Darwin Core Class in a global list and allow them to reference each other using the respective class identifier terms. Following is an example of using normalized classes to represent two related specimen occurrences (one of which has had a second identification) at one location following this class-based schema. Note that you can reuse the location definition here by referring to it via locationID:
It is encouraged to use classes in a normalized way to avoid deep nesting. A _Darwin Core Tools and Applications_ wiki page [[TOOLS](https://github.com/tdwg/dwc-documentation/blob/master/documentation/resources.md)] has been created as an index to example schemas for the purpose of community discussions and development. An XML schema [[CLASSXMLSCHEMA](tdwg_dwc_classes.xsd)] is provided to freely mix any Darwin Core Class in a global list and allow them to reference each other using the respective class identifier terms. Following is an example of using normalized classes to represent two related specimen occurrences (one of which has had a second identification) at one location following this class-based schema. Note that you can reuse the location definition here by referring to it via locationID:
```XML
<?xml version="1.0"?>