Successfully reported this slideshow.

Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator

1

Share

Upcoming SlideShare
Code igniter
Code igniter
Loading in …3
×
1 of 14
1 of 14

Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator

1

Share

Download to read offline

A short story about how (Balsamiq) we were able to include content from one markdown file inside another by using the features of our Static Site Generator, Hugo. Prepared as a lightning talk for a Write The Docs SF meetup.

A short story about how (Balsamiq) we were able to include content from one markdown file inside another by using the features of our Static Site Generator, Hugo. Prepared as a lightning talk for a Write The Docs SF meetup.

More Related Content

Related Books

Free with a 14 day trial from Scribd

See all

Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator

  1. 1. Bending Markdown to Your Will With Your Static Site Generator Leon Barnard, Balsamiq
  2. 2. Anyone Else Have This Problem?
  3. 3. The Customer's Problem
  4. 4. What We Wanted
  5. 5. The Problems with Markdown
  6. 6. The Dilemma How do we write content that can show up in multiple places?
  7. 7. The Solution * Hidden from search and other links
  8. 8. Limitations • Can't include partial content. All or nothing (except front matter). • Requires duplicate empty "placeholder" files to insert content into. • Standard issues with "single source" models (see, e.g., http://idratherbewriting.com/2016/02/11/the-problem-with- single-source-publishing/) • Working around some of these though
  9. 9. Wins • Provides a flexible framework for future product versions • Allows us to continue to write only (mostly) markdown for the content (no code needed for includes)
  10. 10. Thanks!

×