Docs as Code section - Formats

briandominick / codewriting

Source for Codewriting (book) and the Codewriting/Code the Docs (site/blog)

Other

50 stars 13 forks source link

Docs as Code section - Formats #19

Open lief-erickson opened 6 years ago

lief-erickson commented 6 years ago

Besides the obvious PDF and HTML formats, content can be published as e-book formats, JSON objects, Unix man pages, even slide decks for presentations — whatever the situation calls for.

reveal.js FTW For the truly adventurous who want to involve their marketing friends, then a transform that converts to IDML (InDesign Markup Language) allows super fancy layout in tools they're comfortable with...for white papers.

briandominick commented 6 years ago

I definitely want to look into IDML. I've used InDesign pretty extensively, but not on converted source. Maybe post-LaTeX, but nothing I was involved in directly.

Is reveal.js somehow a content format? Wouldn't JSON cover that, since we're talking about content formats?

briandominick commented 6 years ago

Oh brainfart I was thinking of Angular. Asciidoctor has a Reveal.js backend that I've merely played with. https://asciidoctor.org/docs/asciidoctor-revealjs/

I usually us the term "slide decks" since there are a few backend output formats. I need to spend more time with Reveal.