Integrating reading-level calculators

<oXygen/> general issues.
Posts: 4

Integrating reading-level calculators

Sat Sep 16, 2017 12:45 am

For various reasons that I won't go into here, we need to generate reading levels for our publications. This has to be done at the map level as there needs to be enough text to get a "reliable" score. I see that it's possible to integrate external tools via Tools >External Tools > Configure...

Has anyone integrated an external reading-level calculator using this approach or some other?

Thanks in advance.
Bill Burns
Content Architect | Healthwise |
208.331.6917 (office) | 208.345.1897 (fax)

Healthwise helps people make better health decisions.
Posts: 5867

Re: Integrating reading-level calculators

Mon Sep 18, 2017 10:37 am

Hi Bill,

Interesting, honestly did not know that such tools existed.
The problem would be that the external tool would have access to the DITA Map but it would need access to a resolved DITA Map, with all conrefs and topicrefs expanded.
How about if on the DITA Map root element you set the chunk="to-content" attribute and then publish the XHTML so that a single very large HTML document is obtained? After this you can open the HTML in a web browser and copy the content from it...
Or at some point Jarno Elovirta created a plugin which outputs plain text from a DITA Map com.github.dita-ot-plugins.plaintext:

So I think it would be feasible to creating a DITA Open Toolkit plugin which first obtains all the text from the DITA Map and then calls an external process to score it. For example I created some time ago a DITA OT plugin which generates a single merged DITA file from the original DITA project:

Applying an XSLT stylesheet which only extracts the text from that file and then calling an external process to score the text should work.

What scoring tool were you planning to use?

Radu Coravu
<oXygen/> XML Editor

Return to “Other Issues”

Who is online

Users browsing this forum: No registered users and 2 guests