1 / 14

eTextbook Authoring tools for OpenDSA

eTextbook Authoring tools for OpenDSA. Life is uncertain. What should we ( OpenDSA ) author in? HTML5 looks to be promising But what authoring tool chain should we use?. What is HTML5?. Technically: HTML CSS JavaScript Functionally: Content Layout style Interactive activities.

jeff
Download Presentation

eTextbook Authoring tools for OpenDSA

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. eTextbook Authoring tools for OpenDSA

  2. Life is uncertain • What should we (OpenDSA) author in? • HTML5 looks to be promising • But what authoring tool chain should we use?

  3. What is HTML5? Technically: • HTML • CSS • JavaScript Functionally: • Content • Layout style • Interactive activities

  4. Authoring Tools Principles • Physical layout vs. Semantic representation • This is a section header • This is 15 point bold font • Prefer to author at the semantic level • Presentation representation vs. authoring representations • PDF vsLaTeX or MS Word • HTML5 has elements of both

  5. Document Processing • The relative characteristics of: • LaTeX • MS Word

  6. Binary vs. ASCII formats • Binary formats are often proprietary, and often can only be to presentation formats. • If you choose wrong, you are unlikdely to be able to reuse or convert your materials. • Many ASCII formats are interchangeable, and hand conversion is practical • Pandoc will convert between many ASCII formats

  7. Mathematics • Raw HTML • Math ML • LaTeX • Mathjax

  8. XML • Lots of tools for parsing, validating, editing, etc. • Many authoring formats are XML-based • Not necessarily convenient for writing in directly • DocBook • DITA • EPub

  9. Lightweight Markup • Designed to be “easy” to use by authors • Convert to a presentation format • Markdown • reStructuredText • AsciiDoc

  10. OpenDSA Requirements • ASCII format • Passthrough to JavaScript for visualizations • Mathematics (prefer LaTeX format) • Extensible – define our own tags • Cross references • Navigation • Glossary, index, etc. • Themes

  11. Try #1: Raw HTML5 with Preprocessor

  12. reStructuredText (reST) • Python community’s standard for documentation • Sphinx compiler will convert to various presentation formats • HTML • LaTeX • ePub • PDF

  13. Try #2: reST version • Used Haiku theme

  14. Source example: Shellsort module

More Related