OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-lightweight-dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [dita-lightweight-dita] Sample use case for the template-based specialization discussion


Of course, a transform exists that borrows on the use of @contentEditable directly, rather than a form. When you click on a button associated to a control, it reads the content out of the named elements and puts the values into POST variables which the server then uses, along with the @data-class values, to merge changed fields back into the original document. Mark Giffin, this is for you!

<article id="termdef_term">
<h4><span class="editable" data-class="tloterm" contenteditable="true">Structured Content</span></h4><div data-class="body"><div data-class="topicbody">
    <div class="sectionTitle section">What is it?</div><div class="sectionContent" contenteditable="true" data-class="tlowhat">
            <p>Content, whether in a textual, visual, or playable format, that conforms to structural and semantic rules that allow machine processing to meet specific business requirements.</p>
    </div>
    <div class="sectionTitle section">Why is it important?</div><div class="sectionContent" contenteditable="true" data-class="tlowhy">
            <p>Humans are much better than computers when it comes to understanding the nuances of content. Structuring content with semantic metadata allows computers to understand the content’s relationship to business processes. This enables better discovery, marketing, and user engagement.</p>
    </div>
    <div class="sectionTitle section">Why does a technical communicator need to know this?</div><div class="sectionContent" contenteditable="true" data-class="tloessy">
            <p>Readers understand the visual grammar of style in what they read in a browser or in print, but computers do not. Even for scanned pages converted into word processor files, the computer can only determine that something in a block of text is possibly a paragraph, but it cannot necessarily discern a paragraph from a note or a quotation. By indicating the order and intent of the parts of a document, writers ensure that publishing tools well into the future can usefully render that content, even if reading technologies change.</p>
            <p>Adding structure to content adds both present and future value, turning content from a single-use commodity into a long-term asset. Content can be structured in a number of ways, although most commonly it is done by applying descriptive, codified markup to it (Extensible Markup Language (XML) or other semantic markup) or by storing content in named fields in a database.</p>
            <p>Structured content clearly indicates not only the parts of the discourse (the titles, sections, lists, tables, and phrases that represent organization) but also the semantic intent of those containers. For example, paragraphs identified more specifically as quotations can be not only rendered differently for readers, but also made more easily discovered in searches for quotations or citations.</p>
    </div>
    <div class="sectionTitle section">Summary:</div><div class="sectionContent" contenteditable="true" data-class=""tlosummary>
        By structuring content appropriately, you can more easily turn information into knowledge, instructions into automation, concepts into lesson units, and more, thereby increasing its value to the business.
    </div>
  </div></div>
</article>

With appropriate CSS it looks like this (note that the field boundaries turn blue when you click a region to edit it):


--
Don R. Day
Founding Chair, OASIS DITA Technical Committee
LinkedIn: donrday   Twitter: @donrday
About.me: Don R. Day   Skype: don.r.day
"Where is the wisdom we have lost in knowledge?
Where is the knowledge we have lost in information?"
--T.S. Eliot



Avast logo

This email has been checked for viruses by Avast antivirus software.
www.avast.com




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]