Dokumentation für den menschlichen Gebrauch DDML

Dokumentation für den menschlichen GebrauchDDML sofern ein Beispiel dafür, wie man eine HTML-Vokabular verwenden, um für Menschen lesbare Informationen in ein XML-Dokument hinzuzufügen, sondern die Notwendigkeit einer solchen Schreibweise oft weit über die eher formellen Situation von Normen und Schema-Schöpfung. Obwohl XML bietet einen Mechanismus für das Hinzufügen von Notizen, die dazu bestimmt sind, für Menschen lesbare Informationen in XML-Dokumente, die durch die Anwendung (Kommentare) ignoriert wird, ermöglichen, die Grenzen dieses Mechanismus geben HTML ein weiteres gutes Gebiet für die Anreicherung von XML zu arbeiten. Kommentare (die allgegenwärtigen ) Sind sehr nützlich, in manchen Situationen, aber sie haben einige deutliche Nachteile. Kommentare können oder nicht, um die Anwendung aus dem XML-Parsing-Prozess übertragen werden, und viele XML-Anwendungen werden ihre Inhalte außer Acht lassen, auch wenn sie die Informationen erhalten. XML-Parser behandeln die gespeicherten Informationen innerhalb von Kommentaren als Nur-Text-und HTML-Browser in der Regel ignorieren, wenn es auch in HTML enthalten.

  

Entwickler, die wollen oder müssen, für Menschen lesbare Dokumentation in ihrem Dokument Strukturen sind (im Gegensatz zu schweben in den Kommentaren entgegen) müssen an Orten, wo Dokument Autoren können anspruchsvolle Menschen lesbare Informationen zu erzeugen. Während Sie Ihr eigenes Format, dies zu tun (oder verwenden Sie ein XML-Format wie DocArticle erstellen können), stellt XHTML eine bekannte und gut unterstützt Vokabular für diese Arbeit. Möglicherweise müssen Sie XHTML zu ändern, wie im vorigen Artikel beschrieben, um die Verwendung der eigene Markup innerhalb der XHTML-Unterstützung. Allerdings kann XHTML einen einfachen Rahmen bieten für diese Arbeit.

Zum Beispiel, eine Rechnung für die automatisierte Verarbeitung vor allem bedeutete, könnte ein Abschnitt Kommentare enthalten. Anstatt einen formellen Vokabular für einen relativ Freiform-Bereich, lassen den Anwendern zählen XHTML in diesem Bereich. Das macht sie zu einigen kritischen Möglichkeiten wie handhaben können:

- Hinzufügen von zusätzlichen Schwerpunkt auf eine Bestellung, die unbedingt geliefert werden über Nacht

- Bereitstellung von Tabellen, Diagrammen und Grafiken zu erklären, was der Inhalt der damit verwendet werden (für Fälle, in denen technische Hilfe notwendig sein kann)

- Extra Schriftsatz in der Sendung schicken, obwohl die letzten drei Zahlungen nicht klar

- Anträge auf zusätzliche Ermäßigungen

- Vielen Dank für den früheren exzellenten Service

Einige von ihnen scheinen mag frivol, aber alle von ihnen stellen außergewöhnliche Umstände, die relativ häufig vorkommen, in der realen Welt. Keiner von ihnen können leicht durch die formalen Strukturen meisten Dokument Designer verwenden, um den "Kern-Aufnahme"-Informationen auf einer Rechnung, wie Lieferadresse und Mechanismen, Zahlungsinformationen und die angeforderten Materialien erfasst. Automatisierte Bestellung Systeme sind ähnlich schlecht im Umgang mit dieser Art von Informationen. Auf der anderen Seite sind diese alle Umstände, die auf einer ziemlich regelmäßig, wenn Formulare verwendet werden, geschehen - die Leute sind sehr gut im kritzeln solche Dinge am Rande oder auf der Rechnung, in der Erwartung anderer Menschen zu lesen und wirken auf sie. Da die Informationen wirklich gemeint ist die Mensch-zu-Mensch-Kontakt zu vertreten, es ist ein sehr guter Kandidat für XHTML. XHTML bietet die Strukturen müssen die Menschen diese Art von Informationen zu kommunizieren, liefert Tabellen, Bilder, und die Betonung. Programme soll menschliche Schöpfung dieser Formen unterstützen kann ein XHTML-Editor-Komponente verwenden zu schreiben, die XHTML, während der Empfänger Ende des Kommentars Inhalte auf Papier oder auf dem Bildschirm mit HTML-oder XHTML-Browser-Komponenten zeigen kann. Während einige es auch sein mag Maschine interpretiert, ein Großteil davon ist wahrscheinlich Situationen, die ein gewisses Maß an menschlicher Eingriffe.

Document ContainerXML kann sehr nützlich sein, als ein Container-Format, so dass Entwickler-Paket und gibt Informationen zu verteilen. In diesem Fall stellt ein XHTML-Format für die "echten" Inhalt der Dokumente - die XML-Strukturen erlauben es, durch die Verarbeitung von XML-Infrastruktur zu erhalten und ein Teil des Pakets, aber die HTML-Wortschatz ist nur relevant, bis zu ihrer endgültigen Empfänger, nicht auf die Verarbeitung auf dem Weg. Dokument-Sets können als eine einzige, große XML-Dokumente, komplett mit Header beschreibt die Menge und die einzelnen Dokumente, die sie enthalten, montiert werden. Damit können Sie für einfache Projekte wie Momentaufnahmen von Websites oder komplexere Projekte wie den Verkauf und den Handel zwischen den Seiten Dokumente.

HinweisDie Verwendung von Binär-Formate für Bilder und andere Website-Inhalt ist der Nutzen dieser Technik zu einem gewissen Grad zu begrenzen, aber es kann für Situationen geeignet, in denen der Text ist von zentraler Bedeutung oder Grafiken werden vertreten durch textliche Formate wie Scalable Vector Graphics (SVG ). Der Container-Dokument kann ein Präfix für ihre eigenen Elemente zu nutzen und lassen Sie den Standard-Namespace Schwarzarbeit und ließ alle enthaltenen Dokumente erklären, es für sich. Dies bietet ein Maximum an Flexibilität und machte gleichzeitig deutlich den Unterschied zwischen der XML-Elemente, die Teil des Behälters und dem XHTML-Browser (oder andere) Dokumente werden getrennt. Zum Beispiel könnte ein einfacher Container wie folgt aussehen:

 Ausrangierte Dateien  Simon St. Laurent  Simon St. Laurent  Revolutionären Traditionen  04202000  Inhalt des Dokuments Frühjahrstagung der "Friendly Dog  Kibble Revisited  04202000  Inhalt des Dokuments Simon St. Laurent  Traditionelle Revolutionen  04202000  Inhalt des Dokuments
   
   
 

Handelspapier Verpackungssysteme bieten mehr fortschrittlichen Metadaten-und Content-Management, aber die grundlegende Struktur wahrscheinlich ähnlich. Ein Problem ergibt sich beträchtliche mit diesem Ansatz jedoch. DOCTYPE-Deklarationen kann nur an der Spitze eines XML-Dokuments angezeigt wird, nicht in der Mitte, so dass Sie nicht in vollem Umfang übertragen konforme XHTML Dokumente auf diese Weise. Ein leichtes transfor-mation, dass die DOCTYPE-Deklaration in Elemente umwandelt und dann wieder zu einer DOCTYPE-Deklaration könnte der Festsetzung dieses werden können, aber jetzt ist es ein erschwerender Faktor.

TippXML-Schemas verwenden Sie keine DOCTYPE-Deklarationen. Wenn sie auftreten, kann ein Weg sein, Schemas, um dieses Problem, weil XHTML-Dokumente, die vollständig auf die Menge der XML-Schema-konforme Module sind noch nicht auf die DOCTYPE-Deklarationen zu verwenden. Die XHTML-Spezifikation kann sie verlangen, aber - es ist zu früh, um zu wissen.

Ein Artikel eingereicht von Albert Lichtblau


Disclaimer:Unsere Website ist nicht verantwortlich für den Inhalt dieses Artikels. Webarticles ist eine kostenlose Informationsquelle.
Wichtig: Dieser Artikel "Dokumentation für den menschlichen Gebrauch DDML" wurde durch ein automatisches Software übersetzt. Wir fühlen uns leid für alle Rechtschreibfehler, die möglicherweise aufgetreten sind. Vielen Dank für Ihr Verständnis.


Online: 159 users browsing the articles directory   


  

|