No description, website, or topics provided.
XSLT Java HTML Shell CSS Perl Other
Pull request Compare This branch is 289 commits ahead, 1 commit behind Klortho:master.
Permalink
Failed to load latest commit information.
DtdAnalyzer XT-166: saving changes thus far to remote Sep 27, 2016
contextmodel Fix contextmodel make test target Aug 31, 2012
etc XT-166: modified dtd-information.dtd to match the output from the dtd… Jun 30, 2016
lib Removing dtdanalyzer jar file from the repo Dec 19, 2012
script XT-166: final XSL and scripts Nov 30, 2016
src/gov/ncbi/pmc Start working on adding dtdflatten utility Jul 13, 2015
test Tweaking the xml2json tests Jul 14, 2015
website Add a note about greadlink on Mac OS X Jul 17, 2015
xslt Made link back to main page Nov 30, 2016
.classpath Adding .gitignore and Eclipse project files May 1, 2012
.gitignore Updates for 0.2 release Dec 18, 2012
.project Adding .gitignore and Eclipse project files May 1, 2012
LICENSE.md published to npm, version 0.5.1 Mar 17, 2016
README.md Merge branch 'master' of github.com:ncbi/DtdAnalyzer Jul 20, 2015
ReleaseNotes.md published to npm, version 0.5.1 Mar 17, 2016
build.xml published to npm, version 0.5.1 Mar 17, 2016
dtd2xml2json Get command scripts to work on Mac OS X: use greadlink instead of rea… May 5, 2015
dtd2xml2json.bat Adding framework for stylesheet-generating stylesheet for convering X… Dec 6, 2012
dtdanalyzer Get command scripts to work on Mac OS X: use greadlink instead of rea… May 5, 2015
dtdanalyzer.bat Added a bunch of comments to the command-line scripts Oct 14, 2012
dtdcompare Get command scripts to work on Mac OS X: use greadlink instead of rea… May 5, 2015
dtdcompare.bat Started #5, got batch/shell scripts, start of a java class Nov 11, 2012
dtddocumentor Get command scripts to work on Mac OS X: use greadlink instead of rea… May 5, 2015
dtddocumentor.bat Added a bunch of comments to the command-line scripts Oct 14, 2012
dtdflatten Start working on adding dtdflatten utility Jul 13, 2015
dtdflatten.bat Start working on adding dtdflatten utility Jul 13, 2015
dtdschematron Get command scripts to work on Mac OS X: use greadlink instead of rea… May 5, 2015
dtdschematron.bat Integrating dtdschematron with shell scripts, etc. Dec 19, 2012
package.json published to npm, version 0.5.1 Mar 17, 2016

README.md

#DtdAnalyzer

DtdAnalyzer provides a set of tools:

  • dtdanalyzer - creates an XML representation (using elements and attributes) of an XML DTD
  • dtddocumentor - generates pretty HTML documentation, including annotations (if present) from specially-formatted comments of the DTD
  • dtdflatten - flattens a multi-file DTD into one big file. See also the Perl script script/dtdflatten.pl.
  • dtdcompare - compares two DTDs and generate a report of differences
  • dtd2xml2json - generates XSLT to convert instance documents into JSON format.
  • dtdschematron - generates a schematron file from the DTD, including extra schematron rules (if present) from specially-formatted comments of the DTD
  • scaffold.xsl - generates XSLT scaffolding that can be used as a starting point for writing a transform from one schema to another

Home page and documentation

The home page for this project is at http://dtd.nlm.nih.gov/ncbi/dtdanalyzer.

Detailed documentation is available on the GitHub wiki.

##Quick start

  • Download the latest release, either as a zip file: DtdAnalyzer-0.5.zip; or as a gzipped tar: DtdAnalyzer-0.5.tar.gz.

    Note: Do not use the "Zip" download button on the main GitHub page! That button downloads the source files, not the pre-built packages. They are different!

  • Unzip that file on your machine.

  • Open up a Windows command or a bash shell window. Add the path to the package root to your PATH environment variable.

    On Windows:

    set PATH=%PATH%;-path-to-dtdanalyzer-package-
    

    On Mac OS X or Unix:

    export PATH=$PATH:-path-to-dtdanalyzer-package-
    
  • Note for Mac OS X: This software depends on a utility called greadlink, which might not be installed on your system. To see whether or not it is, enter which greadlink at a terminal prompt. If it is not installed, then the easiest way to get it is with Homebrew. Install Homebrew, if necessary, and then enter brew install coreutils.

  • Try the following command (which analyzes the Journal Archiving and Interchange flavor of the NLM/NISO Journal Article Tag Suite, and writes the output to a file):

    dtdanalyzer http://jats.nlm.nih.gov/archiving/1.0/JATS-archivearticle1.dtd out.daz.xml
    
  • Check that you have sensible results in the output file, out.daz.xml.

  • As another example, the next command produces HTML documentation for that DTD. It should run for a little while and then announce that it's done, and that the documentation is in the doc subdirectory. (Enter all on one line).

    dtddocumentor http://jats.nlm.nih.gov/archiving/1.0/JATS-archivearticle1.dtd
      --exclude mml: --exclude-except mml:math
    
  • Open the doc/index.html file in a browser, and check that it looks good.

  • Run --help with any of the tools for more complete usage information, or continue by visiting the documentation pages on the GitHub wiki.

##Discussion forum / mailing list

This software is in beta stage.

Join the DtdAnalyzer Google group for discussions.

File bug reports at the GitHub issues page.

##Public domain

This work is in the public domain and may be reproduced, published or otherwise used without permission of the National Library of Medicine (NLM).

Although all reasonable efforts have been taken to ensure the accuracy and reliability of the software and data, the NLM and the U.S. Government do not and cannot warrant the performance or results that may be obtained by using this software or data. The NLM and the U.S. Government disclaim all warranties, express or implied, including warranties of performance, merchantability or fitness for any particular purpose.