Definition of relatinship
caar at loc.gov
Thu Dec 31 15:13:06 CET 2015
Happy New Year!
There are certainly problems with many of the Terms and Definitions. Way back, Rex made a pass through them to try and make sure that they followed the (new?) editorial guidelines. However, he did not use any Notes, which I believe are (a) allowed and (b) often useful, particularly to relate abstract concepts to concrete OOXML terminology. I had been assuming we would do a complete pass through the Terms and Definitions at some point.
However, I have some concerns about your rewrite, which tries to define terms that are never used and in my view makes the collection of definitions more confusing. I went back to the published terms and definitions in Part 2 rather than starting with the WD. Then I focused on the same terms defined there – since they are certainly used in the text. Note that I have assumed that “source” and “target” are words that do not need definition. And I have assumed that the Internal/External TargetMode issue is covered in the spec. I have changed some occurrences of “the” to “a” to address your concerns C and D.
Here is my attempt:
package relationship — A relationship whose target is a part and whose source is the package as a whole.
(Note: Package relationships are found in the package relationships part named “/_rels/.rels”.)
relationship —A connection between a source, which may be a part in the package or the package as a whole and a target, which may be a part in a package or an external resource.
(Note: A relationship is represented by a Relationship element in a relationships part.)
relationships part — A part containing an XML representation of relationships.
(Note: a relationships part has the media type "application/vnd.openxmlformats-package.relationships
relationship type — An absolute IRI used to identify the nature of a relationship.
(Note: a relationship type is indicated in the Type attribute of a Relationship element)
source part — A part from which a connection is established by a relationship.
target part — A part referenced by the “Target” attribute of a relationship.
I hope this helps.
From: eb2mmrt at gmail.com [mailto:eb2mmrt at gmail.com] On Behalf Of MURATA Makoto
Sent: Wednesday, December 23, 2015 9:29 PM
Subject: Definition of relatinship
Here is my present for you. I thought OOXML experts might like it.
I am reviewing the definition of relationships in OPC. Let me report
A) Circular definitions
"source part" and "target part" are defined using "relationship", but
"relationship" is defined using them.
B) Relationships and package relationships
In the definition of "relationship", the source is always a part. But
"package relationship" is defined as a special case of "relationship".
C) source is not always a part
In the case of a package relationship, the source is not a part but
rather a package.
D) target is not always a part
When the relationship mode is external, the target of a relationship
is not a part but rather any external resource.
E) Some terms are abstract, while others are XMLish
"relationship" is defined as a connection, which I call abstract.
Other terms "source part", "target part", and "package relationship"
are also abstract. But "relationships part" is defined as an XML
Here is the definitions extracted from the current WD.
relationship whose target is a part and whose source is the package as a whole
connection between a source part and a target part in a package
absolute IRI for identifying a relationship
part containing an XML representation of relationships
part from which a connection is established by a relationship
part to which a connection is established by a relationship
I would like to propose a rewrite. Am I too worried?
a part of the media type "application/vnd.openxmlformats-package.relationships+xml"
source of a relationship part
a part or an entire package with which the relationship part is associated by
a file name convention.
a Relationship element in a relationship part
source of a relationship
the source of the relationship part containing the relationship
target mode of a relationship
either "Interal" or "External" as specified by the value of the
TargetMode attribute of the relationship
target of a relationship
the resource referenced by the Target attribute of the relationship
(Note: when the targe mode is internal, the target is a part)
relationship type of a relationship
the IRI value of the Type attribute of a relationship
a relationsip part shall conform to the schema .... after MVC preprocessing
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the sc34wg4