DITA: Difference between revisions
m (using an external editor) |
m (using an external editor) |
||
Line 121: | Line 121: | ||
(needs some addition, and moving articles to references) | (needs some addition, and moving articles to references) | ||
=== General === | |||
* [http://www-106.ibm.com/developerworks/xml/library/x-dita3/index.html DITA - XML-based Darwin Information Typing Architecture FAQ] | * [http://www-106.ibm.com/developerworks/xml/library/x-dita3/index.html DITA - XML-based Darwin Information Typing Architecture FAQ] | ||
* [http:// | |||
* [http://www | * [http://dita.xml.org/ DITA.xml.org] | ||
* | |||
* The [http://tecfa.unige.ch/proj/seed/catalog/net/catalog-eng.pdf Tecfa SEED Catalog] (A local example of a text writting with DITA) | |||
* [http://xml.coverpages.org/dita.html Darwin Information Typing Architecture (DITA XML)] Cover page index. | |||
* [http://www.travelthepath.com/structure3.html Adobe Systems Speaks Out on DITA: Internal use of FrameMaker, CMS, and DITA] | |||
=== Specifications === | |||
* [http://docs.oasis-open.org/dita/v1.0/langspec/ditaref-type.toc.html DITA Language specification] | |||
* [http://docs.oasis-open.org/dita/v1.0/archspec/ditaspec.toc.html DITA Architectural Specification] | |||
== References == | == References == | ||
* Kravogel, Christian and Boris Horner (2005). DITA - Getting Started, ''XTech 2005: XML, the Web and beyond'', [http://idealliance.org/proceedings/xtech05/papers/04-02-02/ HTML]. | |||
* Benetos, Kalliopi (2006), ''Computer-Supported Argumentative Writer An authoring tool with built-in scaffolding and self-regulation for novice writers of argumentative texts'', Master thesis, TECFA, University of Geneva. [http://tecfa.unige.ch/staf/staf-k/benetos/thesis/doc/kalli_benetos_memoire.pdf PDF] | * Benetos, Kalliopi (2006), ''Computer-Supported Argumentative Writer An authoring tool with built-in scaffolding and self-regulation for novice writers of argumentative texts'', Master thesis, TECFA, University of Geneva. [http://tecfa.unige.ch/staf/staf-k/benetos/thesis/doc/kalli_benetos_memoire.pdf PDF] | ||
* Day, Don; Erik Hennum, John Hunt, Michael Priestley, David Schell, and Nancy Harrison (2004), An XML Architecture for Technical Documentation: The Darwin Information Typing Architecture, ''WinWriters, Inc.'', [http://www.winwriters.com/articles/DITA/index.html HTML] retrieved 16:12, 4 November 2006 (MET). | |||
* Day, Don; Michael Priestley and David Schell (2001), | |||
Introduction to the Darwin Information Typing Architecture, IBM developerWorks article. [http://www-106.ibm.com/developerworks/xml/library/x-dita1/index.html HTML] | |||
* Hunt, John P. and Robert Bernard (2005), An XML-based information architecture for learning content, Part 1: A DITA content pilot, ''IBM developerWorks article'', [http://www-128.ibm.com/developerworks/xml/library/x-dita9b HTML]. | |||
* Hunt, John P. and Robert Bernard (2005), An XML-based information architecture for learning content, Part 1: A DITA specialization design, ''IBM developerWorks article'', [http://www-128.ibm.com/developerworks/xml/library/x-dita9a HTML]. | * Hunt, John P. and Robert Bernard (2005), An XML-based information architecture for learning content, Part 1: A DITA specialization design, ''IBM developerWorks article'', [http://www-128.ibm.com/developerworks/xml/library/x-dita9a HTML]. | ||
* | * Priestley, Michael (2001), Specialization in the Darwin Information Typing Architecture, IBM developerWorks article [http://www-106.ibm.com/developerworks/xml/library/x-dita2/index.html HTML] (This is mandatory reading if you wish to extend DITA) | ||
* Schneider | * Schneider Daniel & Paraskevi Synteta (2005). Conception and implementation of rich pedagogical scenarios through collaborative portal sites, in Senteni,A. Taurisson,A. Innovative Learning & Knowledge Communities / les communautés virtuelles: apprendre, innover et travailler ensemble", ICOOL 2003 & Colloque de Guéret 2003 selected papers, a University of Mauritius publication, under the auspices of the UNESCO, ISBN-99903-73-19-1. [http://tecfa.unige.ch/proj/seed/catalog/docs/schneider-icool-final.pdf PDF Preprint] | ||
* Schneider, Daniel with Paraskevi Synteta, Catherine Frété, Fabien Girardin, Stéphane Morand (2003) Conception and implementation of rich pedagogical scenarios through collaborative portal sites: clear focus and fuzzy edges. ICOOL International Conference on Open and Online Learning, December 7-13, 2003, University of Mauritius. [http://tecfa.unige.ch/proj/seed/catalog/docs/icool03-schneider.pdf PDF]. | * Schneider, Daniel with Paraskevi Synteta, Catherine Frété, Fabien Girardin, Stéphane Morand (2003) Conception and implementation of rich pedagogical scenarios through collaborative portal sites: clear focus and fuzzy edges. ICOOL International Conference on Open and Online Learning, December 7-13, 2003, University of Mauritius. [http://tecfa.unige.ch/proj/seed/catalog/docs/icool03-schneider.pdf PDF]. | ||
* Schneider Daniel & | * Schneider, Daniel. (2005) "Gestaltung kollektiver und kooperativer Lernumgebungen" in Euler & Seufert (eds.), E-Learning in Hochschulen und Bildungszentren. Gestaltungshinweise für pädagogische Innovationen, München: Oldenbourg. [http://tecfa.unige.ch/proj/seed/catalog/docs/Beitrag_17_Schneider.pdf Preprint in PDF] | ||
[[Category: XML]] | [[Category: XML]] | ||
[[Category: Standards]] | [[Category: Standards]] |
Revision as of 16:12, 4 November 2006
Definition
- DITA is an XML document standard (vocabulary) for authoring modular text.
- “The Darwin Information Typing Architecture (DITA) is an XML-based, end-to-end architecture for authoring, producing, and delivering technical information. This architecture consists of a set of design principles for creating "information-typed" modules at a topic level and for using that content in delivery modes such as online help and product support portals on the Web.” (Introduction to the Darwin Information Typing Architecture, retrieved 12:27, 3 November 2006 (MET)).
Dita was originally developed at IBM by Don R. Day, Michael Priestley and others. It now is a OASIS standard. Its general architecture may be quite interesting for education, because it (1) accommodates for topic-oriented organization and reuse (as opposed to long documents), (2) allows specialization and (3) therefore supports semantic markup (as opposed to Docbook which is typographic basically).
DITA summary
DITA is a topics-based information architecture. "Darwin information typing architecture" can be summarized as:
- Darwin: DITA utilizes principles of inheritance for specialization
- Information Typing: DITA was originally designed for technical information based on an information architecture of Concept, Task and Reference
- Architecture: DITA is a model for extension both of design and of processes
Topics can be physically or logically embedded. The general architecture of a topic is:
- Title
- Prolog (author, metadata, small description, etc.)
- Body (sections that are structured according to each topic type)
- Tail (embedded topics)
Here is picture (from Don Day PPT reproduced without permission) showing the specialization principle by putting side-by side the generic topic and the "task" topic:
New topics can be defined as autonomous nodes (or better) as nodes that inherit properties from a parent.
DITA in education
DSchneider believes that DITA could play a role in education.
Here are some quickly made up use case examples:
Pedagogical knowledge management and document production
Educators and associated communities of practice are sometimes engaged in knowledge management tasks and thus constitute a knowledge-building community. In addition, there exist many organizational structures financed to provide educators and other experts with information through web sites. Here are a few examples of what one can find there:
- pedagogical scenarios
- Smaller learning activities
- Lesson plans
- Descriptions of texts (reference managers) and/or texts (documentation databases)
- Feature lists of various technologies (as different as for example microworlds, LMSs, cognitive tools
- Websites like this wiki (e.g. pages that describe theories, concepts, methods, technology, etc.) and that are interlinked and categorized.
- Searching
This kind of information is characterized by being structured and it would be nice if it could be searched by "kinds of information". In theory this could be implemented with SQL. However, our experience shows that building SQL tables for each kind of information is very time consuming and not very flexible. The opposite alternative is unstructuredness, e.g. like a Wiki. Wikis allow to enter data very quickly, but have the disadvantage that one can't easily produce text on demands (it's not easy to make a wiki book) and that full text search has its limits once the wiki starts growing. In addition, Wiki engines don't produce text, but the spit back page names plus the search context. E.g. you can't say something like "let's have a list of all the references on pages that belong to the category "instructional design modeling".
DITA can address some of the needs for flexible information retrieval architectures, in particular if combined with a XML database web application like eXist.
- Flexible document production
Lets image that being engaged in teacher training. For a given course we wish to hand out some training materials that is appropriate. Learners engaged in projects may want to read and print all information related to some topic, e.g. how to design inquiry-based learning. DITA would allow to create print or web documents on the fly, on a per needed bases.
- Authoring
In some cases, it is desired that information entered be complete according to some standards. A typical example would be lesson plans. In order to share these plans it would be nice to this through an online application. A flexible TTW DITA-based editor coupled to an on-line XML database could address this issue. (However DSchneider admits that XML editing is not easy and user must receive some initial training).
- A test case
DSchneider made some DITA extensions to have a writing tool to author the TECFA SEED catalog, an inventory of various learning activities and tools that can support these.
The DITA + TECFA extensions DTD included the following new topics:
- card: generic node inherited by the others
- c3msbrick: topic to describe conceptually plugins/modules for C3MS portals
- c3mssoft: topic to describe software for plugins/modules
- learnactivity: topic to describe learning activities (i.e. small scenarios)
- learnact: topic to describe elementary learning activities
This project is now dead, but from an information management point of view, DSchneider thinks that the document produced was interesting. It contained both very structured information and "loose" text and it was heavily crossindexed. Because we don't have the resources to put it into a database, I then decided to use this wiki to launch a larger project in the same spirit. Now if we had a DITA wiki ....
e-Learning objects
It may be an interesting idea to investigate how DITA could enhance or replace simple content-based standards like IMS Content Packaging / SCORM based learning objects. Hunt and Bernard (2005) demonstrated that DITA XML can be extended to develop reusable learning content.
DSchneider's opinion: Such an enterprise may be interesting since DITA content has the obvious advantage of being modular and semantically structured. In contrast, curent e-learning bascially means to assemble html pages and other formats into a content package. On the other hand, IMS/SCORM is now a firmly established standard in low-level training bonth in industry and higher education.
Now cctors who engage in more advanced training don't care much about content-driven standards, since their designs are always activity-based (see the next use case). So who may be interested by Hunt and Bernard's proposal ? People who care about authoring and assembly of modular well-structured contents into either large documents or customized on-line e-learning sequences. As opposed to SCORM/IMS Content Packaging (which is a simple structured assembly of non-structured contents), DITA could provide an overall information architecture for learning content and export assembled documents to various formats (including IMS content packs) and as such it may be of interest to real distance universities that still work rather with high quality print tutorials and limit screen work to more interactive work and communication.
Educational modelling languages
The purpose of more advanced modelling languages is to outline pedagogical scenarios in terms of learner activities, to exchange learning units, and to define executable scenarios. DITA certainly has been built as a text-centric vocabulary, but there is no reason why extensions couldn't describe machine-readable contents of various sorts and would "compile" not juste into screen-readable text and quizzing but more differentiated on-line activities.
Again, there exist standards like IMS Learning Design (LD) or IMS Simple Sequencing, but as it stands today, each of these languages only cover parts of our needs. Therefore, discussion about educational modelling languages is in no ways closed. Current simple SCORM-based e-learning "standards" don't fit the needs of school and advanced industry training and there is need for a lot of experimentation. In other words, there are two open roads: Either reimplement some SCORM/IMS standards (including exporting to these formats) or do something better.
An other idea is to use DITA to sketch out scenarios as text documents and then translate (e.g. via XSLT like Hunt and Bernard suggest for IMS/Scorm content packs) to a vocabulary like IMS Learning Design for which there ought to be engines within the nearer future. In a similar spirit, DITA could act as a container for executable activity descriptions (e.g. why not adopt LD scenarios within DITA ?). Could there be foreign "data islands" in DITA ?
DITA to support learner activities
DITA could be a cognitive tool for writing activities or a component for a such a tool.
DITA extensions could be built to help students with writing strongly structured texts. A typical example is what DSchneider and Paraskevy Synteta did in their C3MS project-based learning model. Students had to use a special purpose project tool named ePBL, which stands for « Project-Based e-learning and had to define research plans with a specially made XML grammar.
Some vocabularies may need a special authoring tool. A nice example is Benetos (2006) Computer-supported argumentative writer based on her ArgEssML defined as Relax NG grammar. So DITA in the same ways as IMS standards should think about executability.
Discussion
What could we gain by writing vocabularies as DITA extensions ?
DITA has some advantages over "home-made" schemas
- There is no initial need to write stylesheets (contents of extensions displays).
- One can reuse existing DITA topics (modules).
- The modular architecture engages to think documents in terms of dynamically created objects.
DSchneider thinks of two main avenues for development:
(1) Structured portions of text could be integrated with others kinds of text, both very loose "title + body" formatting that is supporting by the generic basic DITA topic or strongly typed ones. This would lead to a fine "tutorial/manual production" framework and is more document centric than current screen-centric SCORM/IMS standards. No one likes to read longer texts on the screen, in particular students don't. DSchneider doesn't either (despite having a 1200x3500 "workspace").
In this spirit, DITA also could be the basis of a new generation Wiki. E.g. there is no reason why a web site as this one could not be implemented with a DITA/XML database/TTW combo. We'd get the huge avantage of getting structured text (instead of those awful macros that proliferate on Wikipedia) and a really cool way to produce printed books.
(2) Now for some dreaming: The shortly sketched use cases above could be at the heart of a document-centric learning and teaching environment, e.g. see instructional design models like writing-to-learn and Knowledge-building community model. What the DITA e-learning community should take into account is that many modern instructional design models engage learners in writing activities.
These activities need scaffolding and a schema can help with that. Furthermore, teachers need tools to engage students in collective and collaborative activities. E.g. a teacher (whether in classroom or a distance) ought to be able to say: "Now let's look at the the list of <goals> in your productions which I extracted to page XYZ. "
On the negative side: DITA ain't easy and XML database server scripting even less :(
Links
(needs some addition, and moving articles to references)
General
- The Tecfa SEED Catalog (A local example of a text writting with DITA)
- Darwin Information Typing Architecture (DITA XML) Cover page index.
Specifications
References
- Kravogel, Christian and Boris Horner (2005). DITA - Getting Started, XTech 2005: XML, the Web and beyond, HTML.
- Benetos, Kalliopi (2006), Computer-Supported Argumentative Writer An authoring tool with built-in scaffolding and self-regulation for novice writers of argumentative texts, Master thesis, TECFA, University of Geneva. PDF
- Day, Don; Erik Hennum, John Hunt, Michael Priestley, David Schell, and Nancy Harrison (2004), An XML Architecture for Technical Documentation: The Darwin Information Typing Architecture, WinWriters, Inc., HTML retrieved 16:12, 4 November 2006 (MET).
- Day, Don; Michael Priestley and David Schell (2001),
Introduction to the Darwin Information Typing Architecture, IBM developerWorks article. HTML
- Hunt, John P. and Robert Bernard (2005), An XML-based information architecture for learning content, Part 1: A DITA content pilot, IBM developerWorks article, HTML.
- Hunt, John P. and Robert Bernard (2005), An XML-based information architecture for learning content, Part 1: A DITA specialization design, IBM developerWorks article, HTML.
- Priestley, Michael (2001), Specialization in the Darwin Information Typing Architecture, IBM developerWorks article HTML (This is mandatory reading if you wish to extend DITA)
- Schneider Daniel & Paraskevi Synteta (2005). Conception and implementation of rich pedagogical scenarios through collaborative portal sites, in Senteni,A. Taurisson,A. Innovative Learning & Knowledge Communities / les communautés virtuelles: apprendre, innover et travailler ensemble", ICOOL 2003 & Colloque de Guéret 2003 selected papers, a University of Mauritius publication, under the auspices of the UNESCO, ISBN-99903-73-19-1. PDF Preprint
- Schneider, Daniel with Paraskevi Synteta, Catherine Frété, Fabien Girardin, Stéphane Morand (2003) Conception and implementation of rich pedagogical scenarios through collaborative portal sites: clear focus and fuzzy edges. ICOOL International Conference on Open and Online Learning, December 7-13, 2003, University of Mauritius. PDF.
- Schneider, Daniel. (2005) "Gestaltung kollektiver und kooperativer Lernumgebungen" in Euler & Seufert (eds.), E-Learning in Hochschulen und Bildungszentren. Gestaltungshinweise für pädagogische Innovationen, München: Oldenbourg. Preprint in PDF