Skip to main content

Home/ DITA XML/ Group items tagged resources

Rss Feed Group items tagged

Jason Owen

Using Dublin Core - 0 views

  • The linkage between a metadata record and the resource it describes may take one of two forms: elements may be contained in a record separate from the item, as in the case of the library's catalog record; or the metadata may be embedded in the resource itself.
  • The Dublin Core metadata standard is a simple yet effective element set for describing a wide range of networked resources. The Dublin Core standard includes two levels: Simple and Qualified. Simple Dublin Core comprises fifteen elements; Qualified Dublin Core includes three additional elements (Audience, Provenance and RightsHolder), as well as a group of element refinements (also called qualifiers) that refine the semantics of the elements in ways that may be useful in resource discovery.
  • Another way to look at Dublin Core is as a "small language for making a particular class of statements about resources". In this language, there are two classes of terms -- elements (nouns) and qualifiers (adjectives) -- which can be arranged into a simple pattern of statements.
  • ...4 more annotations...
  • Dublin Core can be seen as a "metadata pidgin for digital tourists": easily grasped, but not necessarily up to the task of expressing complex relationships or concepts.
  • Each element is optional and may be repeated.
  • In general Dublin Core metadata describes one manifestation or version of a resource, rather than assuming that manifestations stand in for one another. For instance, a jpeg image of the Mona Lisa has much in common with the original painting, but it is not the same as the painting.
  • Dublin Core was originally developed with an eye to describing document-like objects
Jason Owen

DITA's New Keys and the 80/20 Rule - 1 views

  • Keys provide a way for authors to create addresses to resources through the use of a named identifier rather thanto a specific URI pointer. In other words, I can create an easy-to-remember key, like “ms-word-functions” that actually resolves to a URL “http://support.microsoft.com/kb/211982” and link to this URL using the key name in my DITA topic.
  • Any time a topic makes use of a key reference, that topic is explicitly binding itself to a map (or many maps), meaning that a topic is no longer a unit of information that is completely independent of any particular context in which it is assembled into. You could make the argument that any reference defined in a topic to an external resource (e.g., an image or a cross-reference to another topic) by definition creates a dependency on that topic. And arguably, the referenced (the endpoint) resource is unaware of the object that is referencing it, regardless of whether it's a topic reference or a cross-reference. But there is an additional dependency in the case of keys: Any map that references a topic with a key reference must define the key. So in a sense, not only does the map (or an ancestor map) need to know about the topic, it needs to discover what the topic is about, specifically related to any key references it points to. Consequently, somewhere along the line, at least one map must define the keys used by a topic.  Did you get all that?  Imagine what your XML authoring tools, CMS systems, and rendering platforms will need to do to manage this.
  • there are potential downsides too.  Keys and key references add another layer of complexity to planning the authoring, deployment and management of DITA content.  
Jason Owen

DITA Wiki - resources with discussions and comments by DITA Wiki users - Main Page - 0 views

  •  
    Resources with discussions and comments by DITA Wiki users
Jason Owen

DITA World - Comprehensive List of DITA Resources - 0 views

  •  
    Full list of DITA (Darwin Information Typing Architecture) resources including official documents, articles, XML / DITA editors user groups
Jason Owen

Survey: Information resources about DITA - 0 views

You are invited to participate in a survey study about the selection of information resources for information about DITA. Participation in this study should take about five minutes of your time. Pa...

started by Jason Owen on 25 Jul 11 no follow-up yet
Jason Owen

Minimalism Revisited: An Interview with John Carroll - 0 views

  • people need to act, they need to be engaged
  • they need to struggle
  • The minimalist idea, the way I think of it, is to minimize the extent to which the system and the information get in the way of what the user’s really interested in.
  • ...5 more annotations...
  • the impulse to end up with Louis XIV, with decoration, and extras, and so forth, is something you always have to struggle against.
  • do like the term “learner.” “User” is passive, to me—you’ve been handed something, use it—whereas I think what people are doing is much more actively a matter of ownership and appropriation and coming to control a new tool in a new environment. And it is a matter of learning. It’s a matter of problem-solving. Besides being cumbersomely long—you could call them “problem-solvers….”
  • eally just a fundamental truth about learning. People need to act. We are, after all, talking about skill learning. We’re not talking about pondering abstract concepts or definitions or conceptual information, declarative information. It’s mostly skill learning and you learn skills by doing.
  • I would say that brevity is more a consequence of minimalism than a principle of minimalism. If you go back to what I was saying earlier about trying to facilitate the learner’s initiative and goals and aspirations and impede them less, you will most likely end up with a briefer design, or it might be layered. I was alluding earlier to David Farkas’s contribution to minimalism in the book Beyond the Nurnberg Funnel which had to do with layered designs. This was a way in his work of getting the information design out of the learner’s way, making the information layered so that it was available on demand, but not necessarily an impediment if the learner didn’t choose to look at it at that time.
  • we realized these people did have goals and they were experts, but they weren’t experts with the Displaywriter or the IBM PC. They were experts in office work, and they knew a lot about work practices, and processes, and objectives, and quality standards, and they knew more than we did. And we came to see that prior knowledge as an important resource that needed to be leveraged in the design of information, the design of training materials, and the design of user interfaces.
  •  
    "Minimalism Revisited: An Interview with John Carroll"
Jason Owen

DITA Community Resources - 1 views

  •  
    Samples for DITA files and plugins.
Jason Owen

Metadata Principle 5 | framework.niso.org - 0 views

shared by Jason Owen on 21 Apr 10 - Cached
  • Administrative metadata is information intended to facilitate the management of resources. It includes information such as when and how an object was created, who is responsible for controlling access to or archiving the content, what processing activities have been performed in relation to it, and what restrictions on access or use apply.
  • Technical metadata and preservation metadata are particular types of administrative metadata. Technical metadata describes digital files and includes capture information, format, file size, checksum, sampling frequencies, and similar characteristics.
  • Structural metadata relates the pieces of a compound object together and/or bundles related objects into a package. For example, if a book is digitized as individual page images, structural metadata can record information concerning the order of files (page numbering) and how they relate to the logical structure of the book (table of contents) is also required.
Jason Owen

Subject classification with DITA and SKOS - 4 views

  • In a topic-oriented architecture such as DITA, content is authored in small, independent units that are assembled to provide help systems, books, courses, and other deliverables. Each unit of information answers a single question for a specific purpose. That is, each topic has specific, independent subject matter
  • Because each topic has a specific meaning, DITA topics are tailor-made for semantic processing. However, current semantic processors can't read the text of a topic to find out what it means. What's missing is a formal declaration of the topic's subject matter that a semantic processor can understand
  • Simple Knowledge Organization System (SKOS) provides a standard for indicating the subject matter of content. SKOS lets you define the subjects for a particular subject matter area (organizing these subjects as a taxonomy if desired) and then classify each piece of content to indicate its subject. For instance, using SKOS, you could define configuration and security as subjects, and classify the three example topics that relate to those subjects so that users could browse the subjects to find the content regardless of whether the words "configuration" or "security" actually appear in the text.
  • ...16 more annotations...
  • SKOS is expressed with Resource Description Framework (RDF), the fundamental language of the Semantic Web.
  • DITA has a natural fit with SKOS in solutions where DITA topics are classified with subjects that are expressed in SKOS for runtime processing.
  • Formal subjects are often defined by glossary topics or other topics that already exist within the published information set.
  • Even if you don't include the subject definitions in your published information, you can use your standard content tools for your subject definitions. For instance, you can author the subject definitions with your XML editor, and archive and version the subject definitions along with your content in your content management or version control system.
  • Subject classification is as much a part of the information architecture of your content as the navigational organization.
  • The DITA topic specifies the subject with a specialized section element that includes the following kinds of information:Default labels, including synonyms and denotative imagesNotes on the definition and on the scope of coverage for the subjectListing 1 shows an example of the definition for the Configuring subject:
  • Because the meaning of a formal topic should never vary based on its use, these fields should be part of the topic.
  • You can have multiple schemes for the same subjects. For instance, different audiences might be interested in a different subset of the taxonomy.This approach of imposing alternative organizational structures on subjects fits well with the standard use of DITA maps for separating context from content, allowing different organizations to be imposed on the same content. That is, the scheme can be considered a special kind of context for subject definition topics.
  • Schemes can use non-DITA subject definitions (such as publicly-defined SKOS, OWL, or TopicMaps subjects). You cite the public identifier of the subject with the subjectdef element and identify the subject definition format with the format attribute. This allows you to incorporate publicly-defined subjects into your schemes, or to integrate a formal ontology maintained by your organization with concepts that are specific to your content.
  • To classify content, another map specialization associates formal subjects with topics (see Figure 4).
  • Inside the topicref element that references and contains references to the classified content, you nest a topicsubject element to specify the subjects of the content. You can identify a primary subject with the href attribute of the topicsubject element, which also contains subjectref elements for the secondary subjects. If no subject is primary, the topicsubject element should be a container without the href attribute.
  • In the same way that subject schemes can cite public non-DITA subjects, you can classify DITA content with SKOS, OWL, or TopicMaps subjects by citing the public URI identifiers with the subjectref element and setting the format attribute.
  • The central circle represents a conceptual topic (such as Security), which:Has a broader relationship to a subject (perhaps System Concerns) within a schemeIs classified by two other subjects (perhaps the Background type and the Novice User role)Contributes to the classification of one topic (such as Web Security)Occupies the second position in a navigation sequence (perhaps under a Glossary heading)
  • Because subjects are defined by special topics, you can include the subject definition in the content and use it for classification. For instance, the subject topic for Security can both classify content about security and describe security within the Web site or help system content. Figure 5 illustrates this scenario:
  • Because the classification map is distinct from the scheme map, you can apply multiple schemes to the same classification without requiring changes to the classification. To combine the scheme and classification maps for a deliverable, a higher-level map can refer to both maps using a DITA map reference (see Figure 6).
  • You might process a single map to generate both an HTML representation of the content and a SKOS representation of the subjects and classification.
  •  
    Use a DITA specialization to manage the subject matter of your document content -- that is, identify and process your content based on what each topic is about. With the approach outlined in this article, you can take advantage of the technologies of the
1 - 11 of 11
Showing 20 items per page