DITA CSS Documentation Projects

This repo contains documentation related to writing grid layouts in HTML and CSS. The documentation is written in DITA (Darwin Information Type Architecture) and serves as an example repo for the Reusable Content project in the University of Minnesota-Twin Cities course: Writing with Digital Technologies (WRIT 4662w).

Building DITA Transformations

See the DITA-OT user guide about how to generate output: http://www.dita-ot.org/2.1/getting-started/using-dita-command.html

Sample DITA Commands

Command for dita command help:

username@computername:~/dita-ot-2.1.1$ dita --help

/* DITA options and arguments */

-f == dita output format
-i == dita input map file
-o == dita output directory
-D<property>=<value> == add custom args
    with particular values to dita transformation
-filter <file> == filter and flagging file

Create an HTML5 site:

dita -f html5 -i 'url/to/your/wanted.ditamap' \
  -o 'url/to/your/output/folder' \

Create an HTML5 site with a custom CSS file:

dita -f html5 -i 'url/to/your/wanted.ditamap' \
  -o 'url/to/your/output/folder' \
  -Dargs.cssroot='url/to/your/assets/folder' \
  -Dargs.css='${cssroot}/your-custom-css-file.css' \
  -Dargs.csspath='css' \
  -Dargs.copycss='yes'

Create a PDF:

dita -f pdf -i 'url/to/your/wanted.ditamap' \
  -o 'url/to/your/output/folder' \