W3C home > Mailing lists > Public > public-schemaorg@w3.org > June 2016

RE: schema.org Markup for DITA XML-based Technical Documentation

From: John Walker <john.walker@semaku.com>
Date: Wed, 22 Jun 2016 13:04:34 +0000
To: Keith Schengili-Roberts <keith.roberts@ixiasoft.com>, Martynas Jusevièius <martynas@graphity.org>
CC: "public-schemaorg@w3.org" <public-schemaorg@w3.org>, Colin Maudry <colin@maudry.com>
Message-ID: <VI1PR02MB16793C0F0EC60EC20CBE46999A2C0@VI1PR02MB1679.eurprd02.prod.outlook.com>
Hi Keith,

Could you elaborate on what kind of (meta)data you would want to expose and the sort of use cases you would want to support?

For example is it to:

1.       annotate the HTML output (in which case schema.org already has quite broad coverage)

2.       give some insights to the 'underlying' DITA resources (maps, topics, references between them, etc.) to, for example, better analyze re-use and other metrics

3.       improve SEO by describing the subject matter of the content (for example what product or subject the content is about)

An existing class such as http://schema.org/TechArticle might already map well to certain DITA concepts.
Alternatively is there some way to classify/type DITA content according to some external classification scheme (more specific than SubjectScheme in that it should assert the rdf:type of the content resource).

Regards,

John Walker
Principal Consultant & co-founder
Semaku B.V.
SFJ 4.009, Torenallee 20, 5617 BC Eindhoven
Mobile: +31 6 475 22030
Email: john.walker@semaku.com
Skype: jaw111
Web: http://semaku.com/

KvK: 58031405
BTW: NL852842156B01
IBAN: NL94 INGB 0008 3219 95

From: Keith Schengili-Roberts [mailto:keith.roberts@ixiasoft.com]
Sent: Wednesday, June 22, 2016 2:25 PM
To: Martynas Jusevièius <martynas@graphity.org>
Cc: public-schemaorg@w3.org; Colin Maudry <colin@maudry.com>
Subject: Re: schema.org Markup for DITA XML-based Technical Documentation


Thanks for mentioning that. I have been in contact with Colin Maudry about this already, and I can see how it might be a stepping stone towards getting Schema.org readable data from DITA.



I am still doing research into the feasibility of the whole thing, so am not clear as what you mean with your "shoehorn" comment.



Cheers!

-

Keith Schengili-Roberts
DITA Information Architect / DITA Specialist

IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel  + 1 514 279-4942<tel:%2B%201%20514%20279-4942>  /  toll free + 1 877 279-4942<tel:%2B%201%20877%20279-4942>
robertsk@ixiasoft.com<mailto:robertsk@ixiasoft.com>  /  www.ixiasoft.com<http://cp.mcafee.com/d/FZsS83gArhohhoh76zBN4TsSCztdBNV5xMSCztdBNVZUsrjhKCOUYyMedETo7n79EzCjpkDYqJxUa9RDVWN-SZ3oG_jBPpeI_fmfSTEr5nWsKrus7fnjovW_8TuKyqeuLsKCONvAQm4T6emKDp55mVEVvVkffGhBrwqrhdECXYDuZXTLuZPtPo0agvbqltDO-6P_QDO7GOfBk5i3VriHI-ndFEKc8L6MQ1wQg60MbwAQg1eDNd40Bm3LN-5Ld40Qp-4Ph07vfp7QdIL6Y11Q5gJZM7na>

[1457643010967_UC2016-logo.jpg]

Interested in attending? Visit our event website<http://www.ixiasoft.com/en/news-and-events/ixiasoft-user-conference-2016> for more information.
________________________________
From: Martynas Jusevièius <martynas@graphity.org<mailto:martynas@graphity.org>>
Sent: Tuesday, June 21, 2016 5:18:36 PM
To: Keith Schengili-Roberts
Cc: public-schemaorg@w3.org<mailto:public-schemaorg@w3.org>; Colin Maudry
Subject: Re: schema.org Markup for DITA XML-based Technical Documentation

If you want to use DITA in RDF, there is this effort by Colin Maudry: http://colin.maudry.com/dita-rdf/#concept/welcome.html

If you for some reason want to shoehorn it into schema.org<http://schema.org> specifically, then it sounds like a bad idea.

On Fri, Jun 17, 2016 at 8:46 PM, Keith Schengili-Roberts <keith.roberts@ixiasoft.com<mailto:keith.roberts@ixiasoft.com>> wrote:

Hello there:



I am wondering if there's the possibility of coming up with a Schema.org format for content produced using the DITA XML structured format? It is primarily (but not exclusively) used by technical writing departments to produce content. It is estimated to be used by somewhere between 5-10% of all technical writing groups, mainly with medium- to large-firms. The standard is open, and is managed by OASIS (https://www.oasis-open.org/committees/dita/).



DITA is topic based, with the latest standard (DITA 1.3) having six topic types: a generic "topic" type, then more specific concept, task, reference, glossary and troubleshooting types. Best Practices suggests that each topic come with a short description, so it is possible to easily identify the type of topic and what it describes.



XHTML output from DITA currently uses Dublin Core descriptive metadata, but it could just as easily use something that Schema.org could recognize, likely using either the RDFa or Microdata formats.



Is there interest in helping devise a bridge between DITA-based output and something that Schema.org could use? I am happy to be an expert on the DITA end of things if there is someone willing to help guide me through the process as to what's needed on the Schema.org end of things.


Cheers!
-

Keith Schengili-Roberts
DITA Information Architect / DITA Specialist

IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel  + 1 514 279-4942<tel:%2B%201%20514%20279-4942>  /  toll free + 1 877 279-4942<tel:%2B%201%20877%20279-4942>
robertsk@ixiasoft.com<mailto:robertsk@ixiasoft.com>  /  www.ixiasoft.com<http://cp.mcafee.com/d/FZsS83gArhohhoh76zBN4TsSCztdBNV5xMSCztdBNVZUsrjhKCOUYyMedETo7n79EzCjpkDYqJxUa9RDVWN-SZ3oG_jBPpeI_fmfSTEr5nWsKrus7fnjovW_8TuKyqeuLsKCONvAQm4T6emKDp55mVEVvVkffGhBrwqrhdECXYDuZXTLuZPtPo0agvbqltDO-6P_QDO7GOfBk5i3VriHI-ndFEKc8L6MQ1wQg60MbwAQg1eDNd40Bm3LN-5Ld40Qp-4Ph07vfp7QdIL6Y11Q5gJZM7na>

[1457643010967_UC2016-logo.jpg]

Interested in attending? Visit our event website<http://www.ixiasoft.com/en/news-and-events/ixiasoft-user-conference-2016> for more information.




image001.jpg
(image/jpeg attachment: image001.jpg)

Received on Wednesday, 22 June 2016 13:05:23 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 22 June 2016 13:05:25 UTC