Skip to content

Latest commit

 

History

History
201 lines (144 loc) · 4.99 KB

example.md

File metadata and controls

201 lines (144 loc) · 4.99 KB

Hacker's Tiny Slide Deck

(Or HTSD in short)

A feature demonstration

Press ➡️ (right arrow) or swipe left to go to the next slide.

9th Dec 2019


Keyboard shortcuts

⬅️ (left arrow) or swipe right gesture to show the previous slide

➡️ (right arrow) or swipe left gesture to show the next slide

Home to show the first slide

End to show the last slide

Shift+F to toggle fullscreen


Code snippet

An implementation in JavaScript to calculate the Fibonacci number, to demonstrate syntax highlighting with Prism.js:

/* iterative implementation */
function fibonacci(n) {
  let a = 1
  let b = 0
  let temp

  while (n >= 0) {
    temp = a
    a = a + b
    b = temp
    n -= 1
  }

  return b
}

(You might have to scroll to reach here, and that's intentional.)


Usage

  1. Prepare a Markdown document, like the example you're looking at currently. Separate content between intended slides with --- (three dashes, these become as <hr> tags in the html conversion).

  2. Append a <script> tag linking the HTSD JavaScript bundle to the end of the Markdown document.

  3. Turn the Markdown document into html using a general-purpose markdown-to-html converter (such as marked).


How it works

The <script> tag makes the browser to load the HTSD JavaScript bundle, which transforms the html document into a slideshow. The transformation happens in-browser, with these steps:

  1. The script injects an inline CSS <style> tag into the <head> of the document. The styles are used to display <div class="htsd-slide"> tags (created next) as slides.

  2. The script looks for <hr> tags that are direct childs of the <body> tag, and wraps the contents between the <hr>s into <div class="htsd-slide"> tags.

  3. Then, the script installs means for the user to navigate the slides. This includes keyboard shortcuts, gestures, and keeping the hash in the browser location in sync with he current slide.


Styling customization

HTDS comes with a selection of CSS custom properties (variables) that affect slide looks globally. You may override their values by using a <style> at the end of your Markdown document.

For example, to set the font family for your slide deck:

<style type="text/css" media="screen">
@import url(https://fonts.googleapis.com/css?family=Roboto:400,400i,700);
:root {
  --htsd-sans-font-family: 'Roboto', sans-serif;
}
</style>

Styling customization, code snippets

Highlight code with Prism.js by appending the following line to the end of the Markdown document (as in the example you're looking at):

<script type="text/javascript"
        src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.17.1/prism.min.js">
</script>

We use the following CSS to make the font-size in the code snippets of this slide smaller:

/* select the html code block in the 7th slide */
.htsd-slide:nth-of-type(7) pre code {
  font-size: 0.6rem;
}

…but instead of relying on slide numbers in building CSS selectors, there's a better way (see the next slide).


Styling customization, generated ids

HTSD generates id attributes for each slide from the highest header level contained in the slide. This makes styling selected slides easier.

Let's paint the <div> below red:

#htsd-slide--styling-customization--generated-ids .red-block {
  margin-top: 1em;
  width: 5em;
  height: 2em;
  background-color: red;
}

Other customizations

See the bottom of the Markdown source of this slide deck and the README.

Being tiny, you can easily hack the implementation for your own needs!


End

Thank you!

The code is available at GitHub:
hackers-tiny-slide-deck

<style type="text/css" media="screen"> @import url(https://fonts.googleapis.com/css?family=Roboto:400,400i,700|Roboto+Mono:400,700); :root { --htsd-sans-font-family: 'Roboto', sans-serif; --htsd-mono-font-family: 'Roboto Mono', monospace; } #htsd-slide--how-it-works li { font-size: 0.8rem; } #htsd-slide--styling-customization pre code, .htsd-slide:nth-of-type(7) pre code { font-size: 0.6rem; } #htsd-slide--styling-customization--generated-ids .red-block { margin-top: 1em; width: 5em; height: 2em; background-color: red; } </style> <script type="text/javascript" src="htsd.min.js"></script> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.17.1/prism.min.js"></script>