From 44318f6e10559ea821e71559c7041d8653bbbcba Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Wed, 29 Mar 2023 11:37:04 -0500 Subject: [PATCH 1/2] Add xNAL doctypes oasis-tcs/dita#898 --- src/xnal/doctypes/catalog.xml | 5 + src/xnal/doctypes/dtd/catalog.xml | 12 + src/xnal/doctypes/dtd/xnalDomain.ent | 35 + src/xnal/doctypes/dtd/xnalDomain.mod | 475 ++++++++++++ src/xnal/doctypes/rng/catalog.xml | 16 + src/xnal/doctypes/rng/xnalDomain.rng | 1006 ++++++++++++++++++++++++++ 6 files changed, 1549 insertions(+) create mode 100644 src/xnal/doctypes/catalog.xml create mode 100644 src/xnal/doctypes/dtd/catalog.xml create mode 100644 src/xnal/doctypes/dtd/xnalDomain.ent create mode 100644 src/xnal/doctypes/dtd/xnalDomain.mod create mode 100644 src/xnal/doctypes/rng/catalog.xml create mode 100644 src/xnal/doctypes/rng/xnalDomain.rng diff --git a/src/xnal/doctypes/catalog.xml b/src/xnal/doctypes/catalog.xml new file mode 100644 index 0000000..dc16a96 --- /dev/null +++ b/src/xnal/doctypes/catalog.xml @@ -0,0 +1,5 @@ + + + + + \ No newline at end of file diff --git a/src/xnal/doctypes/dtd/catalog.xml b/src/xnal/doctypes/dtd/catalog.xml new file mode 100644 index 0000000..c932c63 --- /dev/null +++ b/src/xnal/doctypes/dtd/catalog.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/src/xnal/doctypes/dtd/xnalDomain.ent b/src/xnal/doctypes/dtd/xnalDomain.ent new file mode 100644 index 0000000..488af10 --- /dev/null +++ b/src/xnal/doctypes/dtd/xnalDomain.ent @@ -0,0 +1,35 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/xnal/doctypes/dtd/xnalDomain.mod b/src/xnal/doctypes/dtd/xnalDomain.mod new file mode 100644 index 0000000..c9c2bee --- /dev/null +++ b/src/xnal/doctypes/dtd/xnalDomain.mod @@ -0,0 +1,475 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/xnal/doctypes/rng/catalog.xml b/src/xnal/doctypes/rng/catalog.xml new file mode 100644 index 0000000..4fa6cb0 --- /dev/null +++ b/src/xnal/doctypes/rng/catalog.xml @@ -0,0 +1,16 @@ + + + + + + + + + + + + diff --git a/src/xnal/doctypes/rng/xnalDomain.rng b/src/xnal/doctypes/rng/xnalDomain.rng new file mode 100644 index 0000000..dc98ac9 --- /dev/null +++ b/src/xnal/doctypes/rng/xnalDomain.rng @@ -0,0 +1,1006 @@ + + + + + DITA XNAL Domain + +============================================================= + HEADER +============================================================= + MODULE: XNAL Domain + VERSION: 2.0 + DATE: [[[Release date]]] + PURPOSE: Define elements and specialization atttributes + for the XNAL Domain + +============================================================= + +============================================================= + PUBLIC DOCUMENT TYPE DEFINITION + TYPICAL INVOCATION + + Refer to this file by the following public identfier or an + appropriate system identifier +PUBLIC "-//OASIS//ELEMENTS DITA 2.0 XNAL Domain//EN" + Delivered as file "xnalDomain.mod" + +============================================================= + (C) Copyright OASIS Open 2006, 2009. + All Rights Reserved. + UPDATES: +============================================================= + + + elementdomain + xnal-d + + -//OASIS//ELEMENTS DITA XNAL Domain//EN + -//OASIS//ENTITIES DITA XNAL Domain//EN + urn:oasis:names:tc:dita:rng:xnalDomain.rng + + + +
+ DOMAIN EXTENSION PATTERNS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ ELEMENT DECLARATIONS +
+ LONG NAME: Author Information + + + + + + + + + + 20080128: Removed enumeration for @type for DITA 1.2 . Previous values: + creator, contributor, -dita-use-conref-target + + + + + + + + + + + + + + + + external + local + peer + -dita-use-conref-target + + + + + + + + + + element contains detailed information about the author or authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Name Details + + + + + + + + + + + + + + element contains information about the name of the author or the authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Organization Details + + + + + + + + + + + + + + + + + element contains information about the name of an authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Organization Name + + + + + + + + + + + + + + element contains name information about the authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Person Name + + + + + + + + + + + + + + + + + + + + + + + + + + element contains name information about the author. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Honorific + + + + + + + + + + + + + + + element contains the person's title, such as: Dr., Mr., Ms., HRH.. or Grand Exalted Wizard. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: First Name + + + + + + + + + + + + + + + element contains the person's first name. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Middle Name + + + + + + + + + + + + + + + element contains the person's middle name or initial. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Last Name + + + + + + + + + + + + + + + element contains the person's last name. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Generation Identifier + + + + + + + + + + + + + + + element contains information about the person's generation, such as: Jr, III, or VIII. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Other Information + + + + + + + + + + + element contains other name information about the author or authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Address Details + + + + + + + + + + + + + + + + + + + + element contains information about the address of the author or authoring group. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Locality + + + + + + + + + + + + + + + + + + element contains information about the city and postal or ZIP code. It can contain the information directly, or by acting as a wrapper for and . + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Locality Name + + + + + + + + + + + + + + element contains the name of the locality or city. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Administrative Area + + + + + + + + + + + + + + element contains information about a county, state, or province. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Thoroughfare + + + + + + + + + + + + + + element contains information about the thoroughfare - for example, the street, avenue, or boulevard - on which an address is located. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Postal Code + + + + + + + + + + + + + + + + + + element contains information about the postal code or the ZIP code. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Country + + + + + + + + + + + + + + + + + + element contains the name of a country. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Person Information + + + + + + + + + + + + + + + + + + + + element is a wrapper containing all relevant data about a person, including name, address, and contact information. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Organization Information + + + + + + + + + + + + + + + + + + + + + + + element contains detailed information about an authoring organization. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Contact Numbers + + + + + + + + + + + element contains a list of telephone and fax numbers. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Contact Number + Note: set the type of number using @type + + + + + + + + + + + + + + + element contains a telephone number. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Email Addresses + + + + + + + + + + + element contains a list of e-mail addresses. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: Email Address + + + + + + + + + + + element contains an e-mail address. + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: URLs + + + + + + + + + + + element contains a list of Uniform Resource Locators (URLs). + Category: xNAL elements + ]]> + + + + + + + +
+
+ LONG NAME: URL + + + + + + + + + + + element contains a Uniform Resource Locator (URL). + Category: xNAL elements + ]]> + + + + + + + +
+
+
+ SPECIALIZATION ATTRIBUTE DECLARATIONS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ From 5d9ce747dbec057d6178afbb1ebfd6f7b10d85ac Mon Sep 17 00:00:00 2001 From: Robert D Anderson Date: Wed, 29 Mar 2023 11:37:32 -0500 Subject: [PATCH 2/2] Add xNAL specification docs oasis-tcs/dita#898 --- src/xnal/specification/README.md | 8 ++ src/xnal/specification/containers/xnal-d.dita | 32 ++++++++ .../technicalContent/addressdetails.dita | 53 +++++++++++++ .../technicalContent/administrativearea.dita | 51 ++++++++++++ .../technicalContent/authorinformation.dita | 49 ++++++++++++ .../technicalContent/contactnumber.dita | 53 +++++++++++++ .../technicalContent/contactnumbers.dita | 52 +++++++++++++ .../technicalContent/country.dita | 52 +++++++++++++ .../technicalContent/emailaddress.dita | 52 +++++++++++++ .../technicalContent/emailaddresses.dita | 52 +++++++++++++ .../technicalContent/firstname.dita | 56 ++++++++++++++ .../generationidentifier.dita | 52 +++++++++++++ .../technicalContent/honorific.dita | 53 +++++++++++++ .../technicalContent/lastname.dita | 52 +++++++++++++ .../technicalContent/locality.dita | 52 +++++++++++++ .../technicalContent/localityname.dita | 56 ++++++++++++++ .../technicalContent/middlename.dita | 52 +++++++++++++ .../technicalContent/namedetails.dita | 55 +++++++++++++ .../technicalContent/organizationinfo.dita | 52 +++++++++++++ .../technicalContent/organizationname.dita | 52 +++++++++++++ .../organizationnamedetails.dita | 53 +++++++++++++ .../technicalContent/otherinfo.dita | 71 +++++++++++++++++ .../technicalContent/personinfo.dita | 52 +++++++++++++ .../technicalContent/personname.dita | 54 +++++++++++++ .../technicalContent/postalcode.dita | 76 ++++++++++++++++++ .../technicalContent/thoroughfare.dita | 77 +++++++++++++++++++ .../specification/technicalContent/url.dita | 75 ++++++++++++++++++ .../specification/technicalContent/urls.dita | 74 ++++++++++++++++++ .../xnal-domain-elements.ditamap | 33 ++++++++ 29 files changed, 1551 insertions(+) create mode 100644 src/xnal/specification/README.md create mode 100644 src/xnal/specification/containers/xnal-d.dita create mode 100644 src/xnal/specification/technicalContent/addressdetails.dita create mode 100644 src/xnal/specification/technicalContent/administrativearea.dita create mode 100644 src/xnal/specification/technicalContent/authorinformation.dita create mode 100644 src/xnal/specification/technicalContent/contactnumber.dita create mode 100644 src/xnal/specification/technicalContent/contactnumbers.dita create mode 100644 src/xnal/specification/technicalContent/country.dita create mode 100644 src/xnal/specification/technicalContent/emailaddress.dita create mode 100644 src/xnal/specification/technicalContent/emailaddresses.dita create mode 100644 src/xnal/specification/technicalContent/firstname.dita create mode 100644 src/xnal/specification/technicalContent/generationidentifier.dita create mode 100644 src/xnal/specification/technicalContent/honorific.dita create mode 100644 src/xnal/specification/technicalContent/lastname.dita create mode 100644 src/xnal/specification/technicalContent/locality.dita create mode 100644 src/xnal/specification/technicalContent/localityname.dita create mode 100644 src/xnal/specification/technicalContent/middlename.dita create mode 100644 src/xnal/specification/technicalContent/namedetails.dita create mode 100644 src/xnal/specification/technicalContent/organizationinfo.dita create mode 100644 src/xnal/specification/technicalContent/organizationname.dita create mode 100644 src/xnal/specification/technicalContent/organizationnamedetails.dita create mode 100644 src/xnal/specification/technicalContent/otherinfo.dita create mode 100644 src/xnal/specification/technicalContent/personinfo.dita create mode 100644 src/xnal/specification/technicalContent/personname.dita create mode 100644 src/xnal/specification/technicalContent/postalcode.dita create mode 100644 src/xnal/specification/technicalContent/thoroughfare.dita create mode 100644 src/xnal/specification/technicalContent/url.dita create mode 100644 src/xnal/specification/technicalContent/urls.dita create mode 100644 src/xnal/specification/xnal-domain-elements.ditamap diff --git a/src/xnal/specification/README.md b/src/xnal/specification/README.md new file mode 100644 index 0000000..c7cdf4f --- /dev/null +++ b/src/xnal/specification/README.md @@ -0,0 +1,8 @@ +# xNAL domain + +This directory contains specification documents related to +the xNAL vocabulary. These are provided for reference only; they +contain the latest specification files as of the time this domain +was withdrawn from the specification. The content will not build +on its own (it reliese on keys from the technical content specification), +but may be useful for the examples and element descriptions. \ No newline at end of file diff --git a/src/xnal/specification/containers/xnal-d.dita b/src/xnal/specification/containers/xnal-d.dita new file mode 100644 index 0000000..b04f533 --- /dev/null +++ b/src/xnal/specification/containers/xnal-d.dita @@ -0,0 +1,32 @@ + + + +xNAL domain +The xNAL domain elements represent a subset of the Extensible +Name and Address Standard. It is used to encode information about +the author or authors of DITA information. The domain can be included +in any DITA document type shell that requires additional metadata +for names and addresses, although the implementations provided by +OASIS only include it in the bookmap document type. + +Domains elementsxNAL domain +xNAL elements + + +
+ General question about elements in this + section:
    +
  • Should many of the examples just be referring to the example in <authorinformation>, + rather than repeating? If yes - need to make the update; if no - need to add prose around the + samples, and bold the relevant elements.
    • +
  • Short descriptions often refer to "the person" or "the author" or "the organization" but + that rarely makes sense in the context of a single element definition. Should it be a person / + an author / etc? See for specific + example
    • +
+

+

+ + + diff --git a/src/xnal/specification/technicalContent/addressdetails.dita b/src/xnal/specification/technicalContent/addressdetails.dita new file mode 100644 index 0000000..a73dc42 --- /dev/null +++ b/src/xnal/specification/technicalContent/addressdetails.dita @@ -0,0 +1,53 @@ + + + + <xmlelement>addressdetails</xmlelement> + The addressdetails element specifies information about the + address of an author or authoring group. + + + + addressdetailsxNAL + elementsaddressdetails + + + + +
Specialization hierarchy +

The addressdetails element is specialized from + ph. It is defined in the XNAL domain module.

+
Attributes +

+

+ Example + Can this and most of the XNAL examples + just be a link to authorinformation? +

The following code sample shows how the addressdetails element can + be used to provide detailed information about the address of an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + + diff --git a/src/xnal/specification/technicalContent/administrativearea.dita b/src/xnal/specification/technicalContent/administrativearea.dita new file mode 100644 index 0000000..71d75eb --- /dev/null +++ b/src/xnal/specification/technicalContent/administrativearea.dita @@ -0,0 +1,51 @@ + + + + <xmlelement>administrativearea</xmlelement> + The administrativearea element specifies information about a + county, state, or province. + + + + xNAL + elementsadministrativearea + administrativearea + + + + +
Specialization hierarchy +

The administrativearea element is specialized from + ph. It is defined in the XNAL domain module.

+
Attributes +

+

The following code sample shows how the administrativearea + element can be used to provide detailed information about a county, state, or + province:

+
+ Example + <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/authorinformation.dita b/src/xnal/specification/technicalContent/authorinformation.dita new file mode 100644 index 0000000..9c37857 --- /dev/null +++ b/src/xnal/specification/technicalContent/authorinformation.dita @@ -0,0 +1,49 @@ + + + + <xmlelement>authorinformation</xmlelement> + The authorinformation element specifies detailed information + about an author or authoring organization. + + + + authorinformation + xNAL + elementsauthorinformation + + + + +
Specialization hierarchy +

The authorinformation element is specialized from + author. It is defined in the XNAL domain module.

+
Attributes
+ Example +

The following code sample shows how the authorinformation element + can be used to provide detailed information about an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/contactnumber.dita b/src/xnal/specification/technicalContent/contactnumber.dita new file mode 100644 index 0000000..47c9da8 --- /dev/null +++ b/src/xnal/specification/technicalContent/contactnumber.dita @@ -0,0 +1,53 @@ + + + + <xmlelement>contactnumber</xmlelement> + The contactnumber element specifies a contact number for an + author or authoring organization, such as a telephone number. + + + + contactnumberxNAL + elementscontactnumber + + + + +
+ Specialization hierarchy +

The contactnumber element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the contactnumber element can + be used to provide a contact number for an author or authoring organization, such as a + telephone number:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/contactnumbers.dita b/src/xnal/specification/technicalContent/contactnumbers.dita new file mode 100644 index 0000000..f55ce71 --- /dev/null +++ b/src/xnal/specification/technicalContent/contactnumbers.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>contactnumbers</xmlelement> + The contactnumbers element provides a list of contact + numbers. + + + + contactnumbersxNAL + elementscontactnumbers + + + + +
+ Specialization hierarchy +

The contactnumbers element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the contactnumbers element can + be used to provide a list of contact numbers:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/country.dita b/src/xnal/specification/technicalContent/country.dita new file mode 100644 index 0000000..72b5ac1 --- /dev/null +++ b/src/xnal/specification/technicalContent/country.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>country</xmlelement> + The country element specifies the name of a + country. + + + + countryxNAL + elementscountry + + + + +
+ Specialization hierarchy +

The country element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the country element can be + used to specify the name of a country:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/emailaddress.dita b/src/xnal/specification/technicalContent/emailaddress.dita new file mode 100644 index 0000000..5ff4383 --- /dev/null +++ b/src/xnal/specification/technicalContent/emailaddress.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>emailaddress</xmlelement> + The emailaddress element specifies an e-mail address for an + author or authoring organization. + + + + xNAL elementsemailaddress + emailaddress + + + + +
+ Specialization hierarchy +

The emailaddress element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the emailaddress element can + be used to provide an email address for an author or authoring organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/emailaddresses.dita b/src/xnal/specification/technicalContent/emailaddresses.dita new file mode 100644 index 0000000..d39747f --- /dev/null +++ b/src/xnal/specification/technicalContent/emailaddresses.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>emailaddresses</xmlelement> + The emailaddresses element provides one or more e-mail + addresses for an author or authoring organization. + + + + xNAL elementsemailaddresses + emailaddresses + + + + +
+ Specialization hierarchy +

The emailaddresses element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the emailaddresses element can + be used to provide one or more email addresses for an author or authoring organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/firstname.dita b/src/xnal/specification/technicalContent/firstname.dita new file mode 100644 index 0000000..271c4e2 --- /dev/null +++ b/src/xnal/specification/technicalContent/firstname.dita @@ -0,0 +1,56 @@ + + + + <xmlelement>firstname</xmlelement> + The firstname element specifies the first name of an + author.Question about all of these … + should it be "the person" or "a person"? "The person" only seems to make sense if we are + already talking about a person, but the short description for this element does not have that + context. It seems like when defining the element on its own, it should be "a + person". + + + + firstnamexNAL + elementsfirstname + + + + +
+ Specialization hierarchy +

The firstname element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the firstname element can be + used to specify the first name of an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/generationidentifier.dita b/src/xnal/specification/technicalContent/generationidentifier.dita new file mode 100644 index 0000000..4cabc64 --- /dev/null +++ b/src/xnal/specification/technicalContent/generationidentifier.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>generationidentifier</xmlelement> + The generationidentifier element specifies information about + the generation of an author's name, for example Jr, III, or VIII. + + + + generationidentifierxNAL + elementsgenerationidentifier + + + + +
+ Specialization hierarchy +

The generationidentifier element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the generationidentifier + element can be used to provide information about the generation of an author's name:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/honorific.dita b/src/xnal/specification/technicalContent/honorific.dita new file mode 100644 index 0000000..d081749 --- /dev/null +++ b/src/xnal/specification/technicalContent/honorific.dita @@ -0,0 +1,53 @@ + + + + <xmlelement>honorific</xmlelement> + The honorific element specifies an author's title, such as + Dr., Mr., or Ms.. + + + + honorificxNAL + elementshonorific + + + + +
+ Specialization hierarchy +

The honorific element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the honorific element can be + used to specify a title for an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <honorific>Dr.</honorific> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/lastname.dita b/src/xnal/specification/technicalContent/lastname.dita new file mode 100644 index 0000000..468efbc --- /dev/null +++ b/src/xnal/specification/technicalContent/lastname.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>lastname</xmlelement> + The lastname element specifies the last name of an + author. + + + + lastnamexNAL + elementslastname + + + + +
+ Specialization hierarchy +

The lastname element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the lastname element can be + used to specify the last name of an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/locality.dita b/src/xnal/specification/technicalContent/locality.dita new file mode 100644 index 0000000..b32404d --- /dev/null +++ b/src/xnal/specification/technicalContent/locality.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>locality</xmlelement> + The locality element specifies information about a city, + postal code, or ZIP code. + + + + xNAL elementslocality + locality + + + + +
+ Specialization hierarchy +

The locality element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the locality element can be + used to provide detailed information about a city, postal code, or ZIP code:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/localityname.dita b/src/xnal/specification/technicalContent/localityname.dita new file mode 100644 index 0000000..b584184 --- /dev/null +++ b/src/xnal/specification/technicalContent/localityname.dita @@ -0,0 +1,56 @@ + + + + <xmlelement>localityname</xmlelement> + The localityname element specifies the name of a locality or + city. + + + + xNAL elementslocalityname + localityname + + + + +
+ Specialization hierarchy +

The localityname element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the localityname element can + be used to provide information about the name of a locality or city:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/middlename.dita b/src/xnal/specification/technicalContent/middlename.dita new file mode 100644 index 0000000..9792631 --- /dev/null +++ b/src/xnal/specification/technicalContent/middlename.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>middlename</xmlelement> + The middlename element specifies information about the middle + name or middle initial of an author. + + + + middlenamexNAL + elementsmiddlename + + + + +
+ Specialization hierarchy +

The middlename element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the middlename element can be + used to specify the middle name or middle initial of an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/namedetails.dita b/src/xnal/specification/technicalContent/namedetails.dita new file mode 100644 index 0000000..e671bb9 --- /dev/null +++ b/src/xnal/specification/technicalContent/namedetails.dita @@ -0,0 +1,55 @@ + + + + <xmlelement>namedetails</xmlelement> + The namedetails element specifies detailed information about + the name of an author or authoring organization. + + + + namedetailsxNAL + elementsnamedetails + + + + +
+ Specialization hierarchy +

The namedetails element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the namedetails element can be + used to specify detailed information about the name of an author or authoring + organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails> + <personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/organizationinfo.dita b/src/xnal/specification/technicalContent/organizationinfo.dita new file mode 100644 index 0000000..af96e7c --- /dev/null +++ b/src/xnal/specification/technicalContent/organizationinfo.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>organizationinfo</xmlelement> + The organizationinfo element specifies detailed information + about an authoring organization. + + + + organizationinfoxNAL + elementsorganizationinfo + + + + +
+ Specialization hierarchy +

The organizationinfo element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the organizationinfo element + can be used to provide detailed information about an authoring organization:

+ <bookmeta> + <authorinformation> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>'Best wizard in Oz'</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/organizationname.dita b/src/xnal/specification/technicalContent/organizationname.dita new file mode 100644 index 0000000..e12be2f --- /dev/null +++ b/src/xnal/specification/technicalContent/organizationname.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>organizationname</xmlelement> + The organizationname element specifies information about the + name of an authoring organization. + + + + organizationnamexNAL + elementsorganizationname + + + + +
+ Specialization hierarchy +

The organizationname element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the organizationname element + can be used to provide detailed information about the authoring organization:

+ <bookmeta> + <authorinformation> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>'Best wizard in Oz'</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/organizationnamedetails.dita b/src/xnal/specification/technicalContent/organizationnamedetails.dita new file mode 100644 index 0000000..36dfe88 --- /dev/null +++ b/src/xnal/specification/technicalContent/organizationnamedetails.dita @@ -0,0 +1,53 @@ + + + + <xmlelement>organizationnamedetails</xmlelement> + The organizationnamedetails element specifies detailed + information about the name of an authoring organization. + + + + organizationnamedetailsxNAL + elementsorganizationnamedetails + + + + +
+ Specialization hierarchy +

The organizationnamedetails element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the organizationnamedetails + element can be used to provide detailed information about the name of an authoring + organization:

+ <bookmeta> + <authorinformation> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>'Best wizard in Oz'</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/otherinfo.dita b/src/xnal/specification/technicalContent/otherinfo.dita new file mode 100644 index 0000000..b1bf75a --- /dev/null +++ b/src/xnal/specification/technicalContent/otherinfo.dita @@ -0,0 +1,71 @@ + + + + <xmlelement>otherinfo</xmlelement> + The otherinfo element specifies additional detailed + information about the name of an author or authoring organization. + + + + otherinfoxNAL + elementsotherinfo + + + + +
+ Specialization hierarchy +

The otherinfo element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the otherinfo element can be + used to provide detailed information about the name of an author + (personinfo) or the name of an authoring organization + (organizationinfo):

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>'Best wizard in Oz'</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/personinfo.dita b/src/xnal/specification/technicalContent/personinfo.dita new file mode 100644 index 0000000..9c23bc4 --- /dev/null +++ b/src/xnal/specification/technicalContent/personinfo.dita @@ -0,0 +1,52 @@ + + + + <xmlelement>personinfo</xmlelement> + The personinfo element specifies detailed information about an + author, including name, address, and contact information. + + + + personinfoxNAL + elementspersoninfo + + + + +
+ Specialization hierarchy +

The personinfo element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the personinfo element can be + used to provide detailed information about an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/personname.dita b/src/xnal/specification/technicalContent/personname.dita new file mode 100644 index 0000000..7f7ea15 --- /dev/null +++ b/src/xnal/specification/technicalContent/personname.dita @@ -0,0 +1,54 @@ + + + + <xmlelement>personname</xmlelement> + The personname element specifies detailed information about + the name of an author. + + + + personnamexNAL + elementspersonname + + + + +
+ Specialization hierarchy +

The personname element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the personname element can be + used to provide detailed information about the name of an author:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails> + <personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality>Emerald City</locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/postalcode.dita b/src/xnal/specification/technicalContent/postalcode.dita new file mode 100644 index 0000000..084b40a --- /dev/null +++ b/src/xnal/specification/technicalContent/postalcode.dita @@ -0,0 +1,76 @@ + + + + <xmlelement>postalcode</xmlelement> + The postalcode element specifies information about a postal + code or ZIP code for an author or authoring organization. + + + + xNAL elementspostalcode + postalcode + + + + +
+ Specialization hierarchy +

The postalcode element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the postalcode element can be + used to provide information about a postal code or ZIP code for an author or authoring + organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>'Best wizard in Oz'</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/thoroughfare.dita b/src/xnal/specification/technicalContent/thoroughfare.dita new file mode 100644 index 0000000..710ad3d --- /dev/null +++ b/src/xnal/specification/technicalContent/thoroughfare.dita @@ -0,0 +1,77 @@ + + + + <xmlelement>thoroughfare</xmlelement> + The thoroughfare element specifies for an author or authoring + organization information about the thoroughfare, for example the street, avenue, or boulevard on + which an address is located. + + + + xNAL elementsthoroughfare + thoroughfare + + + + +
+ Specialization hierarchy +

The thoroughfare element is specialized from + ph. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the thoroughfare element can + be used to provide detailed information about a thoroughfare, for example the street, + avenue, or boulevard on which an address is located:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>noted psychologist</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/url.dita b/src/xnal/specification/technicalContent/url.dita new file mode 100644 index 0000000..3ca2c51 --- /dev/null +++ b/src/xnal/specification/technicalContent/url.dita @@ -0,0 +1,75 @@ + + + + <xmlelement>url</xmlelement> + The url element specifies a Uniform Resource Locator (URL) for + an authoring organization. + + + + xNAL elementsurl + url + + + + +
+ Specialization hierarchy +

The url element is specialized from data. + It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the url element can be used to + specify a Uniform Resource Locator (URL) for an authoring organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>noted psychologist</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/technicalContent/urls.dita b/src/xnal/specification/technicalContent/urls.dita new file mode 100644 index 0000000..0197580 --- /dev/null +++ b/src/xnal/specification/technicalContent/urls.dita @@ -0,0 +1,74 @@ + + + + <xmlelement>urls</xmlelement> + The urls element specifies one or more Uniform Resource + Locators (URLs) for an authoring organization. + + + + urlsxNAL elementsurls + + + + +
+ Specialization hierarchy +

The urls element is specialized from + data. It is defined in the XNAL domain module.

+
+
+ Attributes +

+

+ + Example +

The following code sample shows how the urls element can be used + to list one or more Uniform Resource Locators (URLs) for an authoring organization:

+ <bookmeta> + <authorinformation> + <personinfo> + <namedetails><personname> + <firstname>Derek</firstname> + <middlename>L.</middlename> + <lastname>Singleton</lastname> + <generationidentifier>Jr.</generationidentifier> + <otherinfo>noted psychologist</otherinfo> + </personname></namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + </personinfo> + <organizationinfo> + <namedetails> + <organizationnamedetails> + <organizationname>WizardWorks, Inc.</organizationname> + <otherinfo>noted psychologist</otherinfo> + </organizationnamedetails> + </namedetails> + <addressdetails> + <thoroughfare>123 Yellow Brick Road</thoroughfare> + <locality> + <localityname>Emerald City</localityname> + <postalcode>66780</postalcode> + </locality> + <administrativearea>Kansas</administrativearea> + <country>USA</country> + </addressdetails> + <contactnumbers><contactnumber>123-555-4678</contactnumber></contactnumbers> + <emailaddresses><emailaddress>wizard@example.org</emailaddress></emailaddresses> + <urls><url>www.wizardworks.example.org</url></urls> + </organizationinfo> + </authorinformation> +</bookmeta> + + diff --git a/src/xnal/specification/xnal-domain-elements.ditamap b/src/xnal/specification/xnal-domain-elements.ditamap new file mode 100644 index 0000000..cf5ae36 --- /dev/null +++ b/src/xnal/specification/xnal-domain-elements.ditamap @@ -0,0 +1,33 @@ + + + + XNAL domain elements + + + + + + + + + + + + + + + + + + + + + + + + + + + + +