Next in thread →
Next in month →
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
This email has been checked for viruses by Avast antivirus software.
www.avast.com
Next in thread →
Next in month →