Difference between revisions of "PubMan Func Spec Import/commons"

Latest revision as of 20:31, 29 July 2013

CoNE[edit]

If the stylesheet parameter CoNE is set to true, the template misc:make_person-person invokes a alghorithm to enrich the person's data with informations from CoNE.

If the stylesheet parameter misc:use-CoNE-organizations-only is set to true, all person's organizations from the input document are replaced by organizations retrieved from CoNE

For retrieving matching CoNE records, the stylesheet perfoms some CoNE queries in descending order of accuracy:

search CoNE by a persons CoNE ID (person:person/dc:identifier xsi:type="eterms:CONE")
search CoNE by all given IDs
search CoNE by family name, given name and organizations
search CoNE by family name and given name.

Results are taken from the first query that have results which refer only to one single person. If the results of all queries refer to multiple persons, the CoNE enrichment is skipped.

CoNE records refer to the same person,

if the persons CoNE IDs (rdf:RDF/rdf:Description/@rdf:about) are equal or
if persons given names (rdf:RDF/rdf:Description/foaf:givenname), surnames (rdf:RDF/rdf:Description/foaf:family_name) and first organizations ID (rdf:RDF/rdf:Description/eterms:position[1]/rdf:Description[1]/dc:identifier[1]) or first organizations name (rdf:RDF//rdf:Description/eterms:position[1]/rdf:Description[1]/eprints:affiliatedInstitution[1]) are equal

CoNE element	EScidoc/Pubman element	EScidoc/Pubman label	comment
cone	person:person	Person	This function enriches person:person records with informations retrieved from CoNE. In general, original informations from person:person are not replaced, but additional informations from CoNE may be added. Affilations/organizations are handled in dependence of the stylesheet's parameter misc:use-CoNE-organizations-only if $misc:use-CoNE-organizations-only is set to false(), organizations retrieved from CoNE are added if $misc:use-CoNE-organizations-only is set to true(), organizations from the source are replaced by organizations retrieved from CoNE. For more information about CoNE records see http://pubman.mpdl.mpg.de/cone/jquery/explain.
cone/rdf:RDF/rdf:Description/@rdf:about	person:person/dc:identifier[xsi:type="eterms:CONE"]	Identifier
cone/rdf:RDF/rdf:Description/dc:identifier	person:person/dc:identifier	Identifier
cone/rdf:RDF/rdf:Description/dc:title	person:person/eterms:complete-name	Complete Name	Since eterms:complete-name must not be empty, this enrichment will never happen.
cone/rdf:RDF/rdf:Description/dcterms:alternative	person:person/eterms:alternative-name	Alternative Name
cone/rdf:RDF/rdf:Description/eterms:degree	person:person/eterms:person-title	Title
cone/rdf:RDF/rdf:Description/eterms:position	person:person/organization:organization	Organization
cone/rdf:RDF/rdf:Description/eterms:position/ rdf:Description/dc:identifier	person:person/organization:organization/ dc:identifier	Identifier
cone/rdf:RDF/rdf:Description/eterms:position/ rdf:Description/eprints:affiliatedInstitution	person:person/organization:organization/ dc:title	Title
cone/rdf:RDF/rdf:Description/foaf:family_name	person:person/eterms:family-name	Family name	Since eterms:family-name must not be empty, this enrichment will never happen.
cone/rdf:RDF/rdf:Description/foaf:givenname	person:person/eterms:given-name	Given name

language codes[edit]

Pubman generally works with ISO 639-3 language codes. If a metadata formats needs or delivers ISO 639-2, the functions misc:iso-639-2_to_iso-639-3() and misc:iso-639-2_to_iso-639-3() are used to convert between the two standards. Essentially, the functions treat the different language codes, and return otherwise the ISO 639-2 value. Differences between ISO 639-2 and ISO 639-3 are listed in the table below. Language codes in ISO 639-3 that are not part of ISO 639-2 are not handled. Source: Wikipedia:List_of_ISO_639-2_codes

ISO 639-2 code	n/a	ISO 639-3 code	n/a	comment
alb		sqi
arm		hye
baq		eus
bur		mya
chi		zho
cze		ces
dut		nld
fre		fra
geo		kat
ger		deu
gre		ell
ice		isl
mac		mkd
mao		mri
may		msa
per		fas
rum		ron
slo		slk
tib		bod
wel		cym

Author Decoder[edit]

ESciDoc/Pubman provides a function called AuthorDecoder to parse complex author strings such as »Jang-Yen Wu, Stephen W Schaffer and Junichi Azuma«. This function takes a string and returns an XML tree with the results. The function has to be invoked explicitly.

Author Decoder element	EScidoc/Pubman element	EScidoc/Pubman label
Author/givenname	person:person/eterms:given-name	Given name
Author/prefix	person:person/eterms:complete-name	Complete Name
Author/familyname
Author/givenname
Author/prefix	person:person/eterms:family-name	Family name
Author/familyname	person:person/eterms:family-name	Family name
Author/title	person:person/eterms:person-title	Title

This page was automatically created from mapping_commons.xsl. It should not be changed. Please provide comments on the talk page.

Difference between revisions of "PubMan Func Spec Import/commons"

Latest revision as of 20:31, 29 July 2013

CoNE[edit]

language codes[edit]

Author Decoder[edit]

Navigation menu

Search

@@ Line 1: / Line 1: @@
-=== Author Decoder ===
+=== CoNE ===
-ESciDoc/Pubman provides a function called ''AuthorDecoder'' to parse complex author strings such as »Jang-Yen Wu, Stephen W Schaffer and Junichi Azuma«.
+If the stylesheet parameter ''CoNE'' is set to ''true'',
-This function takes a string and returns an XML tree with the results. The function has to be invoked explicitly.
+the template ''misc:make_person-person'' invokes a alghorithm to enrich the person's data with informations from CoNE.
-{| style="width:100%" class="wikitable" border="1"
-|- style="vertical-align:top;"
-! foreign
-! field description
-! EScidoc/Pubman
-! field description
-! comment
-|- style="vertical-align:top;"
-| Author/givenname
-|
-| person:person/eterms:given-name
-|
-|
-|- style="vertical-align:top;"
-| Author/prefix
-|
-| rowspan="3" | person:person/eterms:complete-name
-| rowspan="3" |
-| rowspan="3" |
-|- style="vertical-align:top;"
-| Author/familyname
-|
-|- style="vertical-align:top;"
-| Author/givenname
-|
-|- style="vertical-align:top;"
-| Author/prefix
-|
-| rowspan="2" | person:person/eterms:family-name
-| rowspan="2" |
-| rowspan="2" |
-|- style="vertical-align:top;"
-| Author/familyname
-|
-|- style="vertical-align:top;"
-| Author/title
-|
-| person:person/eterms:person-title
-|
-|
-|}
+If the stylesheet parameter ''misc:use-CoNE-organizations-only'' is set to ''true'', all person's organizations from the input document are replaced
+by organizations retrieved from CoNE
-=== CoNE ===
-If the stylesheet parameter ''CoNE'' is set to true,
-the template ''misc:make_person-person'' invokes a alghorithm to enrich the person's data with informations from CoNE.
 For retrieving matching CoNE records, the stylesheet perfoms some CoNE queries in descending order of accuracy:
 # search CoNE by a persons CoNE ID (''person:person/dc:identifier xsi:type="eterms:CONE"'')
@@ Line 68: / Line 23: @@
 {| style="width:100%" class="wikitable" border="1"
 |- style="vertical-align:top;"
-! foreign
+! CoNE element
-! field description
+! description
-! EScidoc/Pubman
+! EScidoc/Pubman element
-! field description
+! EScidoc/Pubman label
 ! comment
 |- style="vertical-align:top;"
@@ Line 77: / Line 32: @@
 |
 | person:person
-|
+| Person
-| ''person:person'' records are enriched with informations retrieved from CoNE.
+| This function enriches ''person:person'' records with informations retrieved from CoNE.
-This means that original informations from person:person are not replaced, but additional informations from CoNE may be added.
+In general, original informations from person:person are not replaced, but additional informations from CoNE may be added.
+Affilations/organizations are handled in dependence of the stylesheet's parameter ''misc:use-CoNE-organizations-only''
+* if ''$misc:use-CoNE-organizations-only'' is set to ''false()'', organizations retrieved from CoNE are added
+* if ''$misc:use-CoNE-organizations-only'' is set to ''true()'', organizations from the source are replaced by organizations retrieved from CoNE.
 For more information about CoNE records see [http://pubman.mpdl.mpg.de/cone/jquery/explain http://pubman.mpdl.mpg.de/cone/jquery/explain].
 |- style="vertical-align:top;"
@@ Line 85: / Line 45: @@
 |
 | person:person/dc:identifier[xsi:type="eterms:CONE"]
-|
+| Identifier
 |
 |- style="vertical-align:top;"
@@ Line 91: / Line 51: @@
 |
 | person:person/dc:identifier
-|
+| Identifier
 |
 |- style="vertical-align:top;"
@@ Line 97: / Line 57: @@
 |
 | person:person/eterms:complete-name
-|
+| Complete Name
 | Since eterms:complete-name must not be empty, this enrichment will never happen.
 |- style="vertical-align:top;"
@@ Line 103: / Line 63: @@
 |
 | person:person/eterms:alternative-name
-|
+| Alternative Name
 |
 |- style="vertical-align:top;"
@@ Line 109: / Line 69: @@
 |
 | person:person/eterms:person-title
-|
+| Title
 |
 |- style="vertical-align:top;"
@@ Line 115: / Line 75: @@
 |
 | person:person/organization:organization
-|
+| Organization
 |
 |- style="vertical-align:top;"
@@ Line 121: / Line 81: @@
 |
 | person:person/organization:organization/&#x2028;dc:identifier
-|
+| Identifier
 |
 |- style="vertical-align:top;"
@@ Line 127: / Line 87: @@
 |
 | person:person/organization:organization/&#x2028;dc:title
-|
+| Title
 |
 |- style="vertical-align:top;"
@@ Line 133: / Line 93: @@
 |
 | person:person/eterms:family-name
-|
+| Family name
 | Since eterms:family-name must not be empty, this enrichment will never happen.
 |- style="vertical-align:top;"
@@ Line 139: / Line 99: @@
 |
 | person:person/eterms:given-name
-|
+| Given name
 |
 |}
@@ Line 151: / Line 111: @@
 {| style="width:100%" class="wikitable" border="1"
 |- style="vertical-align:top;"
-! ISO 639-2b
+! ISO 639-2 code
-! field description
+! n/a
-! ISO 639-3
+! ISO 639-3 code
-! field description
+! n/a
 ! comment
 |- style="vertical-align:top;"
@@ Line 275: / Line 235: @@
 | cym
 |
+|
+|}
+=== Author Decoder ===
+ESciDoc/Pubman provides a function called ''AuthorDecoder'' to parse complex author strings such as »Jang-Yen Wu, Stephen W Schaffer and Junichi Azuma«.
+This function takes a string and returns an XML tree with the results. The function has to be invoked explicitly.
+{| style="width:100%" class="wikitable" border="1"
+|- style="vertical-align:top;"
+! Author Decoder element
+! description
+! EScidoc/Pubman element
+! EScidoc/Pubman label
+! comment
+|- style="vertical-align:top;"
+| Author/givenname
+|
+| person:person/eterms:given-name
+| Given name
+|
+|- style="vertical-align:top;"
+| Author/prefix
+|
+| rowspan="3" | person:person/eterms:complete-name
+| rowspan="3" | Complete Name
+| rowspan="3" |
+|- style="vertical-align:top;"
+| Author/familyname
+|
+|- style="vertical-align:top;"
+| Author/givenname
+|
+|- style="vertical-align:top;"
+| Author/prefix
+|
+| rowspan="2" | person:person/eterms:family-name
+| rowspan="2" | Family name
+| rowspan="2" |
+|- style="vertical-align:top;"
+| Author/familyname
+|
+|- style="vertical-align:top;"
+| Author/title
+|
+| person:person/eterms:person-title
+| Title
 |
 |}

ISO 639-2 code	n/a	ISO 639-3 code	n/a	comment
alb		sqi
arm		hye
baq		eus
bur		mya
chi		zho
cze		ces
dut		nld
fre		fra
geo		kat
ger		deu
gre		ell
ice		isl
mac		mkd
mao		mri
may		msa
per		fas
rum		ron
slo		slk
tib		bod
wel		cym

ISO 639-2 code	n/a	ISO 639-3 code	n/a	comment
alb		sqi
arm		hye
baq		eus
bur		mya
chi		zho
cze		ces
dut		nld
fre		fra
geo		kat
ger		deu
gre		ell
ice		isl
mac		mkd
mao		mri
may		msa
per		fas
rum		ron
slo		slk
tib		bod
wel		cym

ISO 639-2 code	n/a	ISO 639-3 code	n/a	comment
alb		sqi
arm		hye
baq		eus
bur		mya
chi		zho
cze		ces
dut		nld
fre		fra
geo		kat
ger		deu
gre		ell
ice		isl
mac		mkd
mao		mri
may		msa
per		fas
rum		ron
slo		slk
tib		bod
wel		cym