1 #!./slides.py
   2 
   3 # Slides Demo
   4 
   5 *by Bruce Hill*
   6 
   7 **slides** is a terminal slide presenter.
   8 
   9 You can see the slide number in the bottom left corner.
  10 
  11 Slides are separated by three or more dashes on a line: `---`
  12 
  13 To advance to the next slide, press **Right** or **Space** or **J**.
  14 
  15 ---------------------------------------------------------
  16 
  17 # Slide Navigation
  18 
  19 You can go back a slide by pressing **Left** or **Backspace** or **K**.
  20 
  21 You can go to the *first* slide by pressing **Home** or **H**.
  22 
  23 You can go to the *last* slide by pressing **End** or **L**.
  24 
  25 You can also type in a slide number and hit **Enter** to go to that slide.
  26 
  27 ---------------------------------------------------------
  28 
  29 # Basic Features
  30 
  31 This is **italic**, *bold*, and `inline code`
  32 The paragraph continues on line two.
  33 
  34 - A list
  35 - With items
  36 
  37 1. and
  38 2. some
  39 3. numbered ones
  40 
  41 > Block quote
  42 > that spans multiple lines
  43 
  44 Here's a shell example:
  45 
  46 ```run
  47 ls --color=auto
  48 ```
  49 
  50 ---------------------------------------------------------
  51 
  52 # Demos
  53 
  54 For runnable demos, you can use ```` ```demo ````
  55 and press **Enter** to run the demo
  56 
  57 ```demo
  58 seq 1000 | less
  59 ```
  60 
  61 Another demo:
  62 
  63 ```demo
  64 for i in `seq 5`; do
  65     echo "$i"
  66     sleep 1
  67 done
  68 echo "DONE"
  69 ```
  70 
  71 ---------------------------------------------------------
  72 
  73 # Syntax Highlighting
  74 
  75 Some code:
  76 
  77 ```Python
  78 def sing_bottles(n:int):
  79     for i in reversed(range(n)):
  80         if i > 1:
  81             print(f"{i} bottles of beer on the wall,")
  82             print(f"{i} bottles of beer!")
  83             print("Take one down, pass it around...")
  84         elif i == 1:
  85             print("One bottle of beer on the wall,")
  86             print("One bottle of beer!")
  87             print("Take it down, pass it around...")
  88         else:
  89             print("No more bottles of beer on the wall!")
  90             print("Go to the store, buy some more...")
  91             sing_bottles(n)
  92 ```
  93 
  94 ```markdown
  95 This is some *markdown* text with **asterisks**.
  96 ```
  97 
  98 ```
  99 Some basic emojis: 🌎💨🔥
 100 They do render correctly with appropriate box size
 101 (But your mileage may vary, depending on how your
 102 terminal renders emojis and what font you use)
 103 ```
 104 
 105 ---------------------------------------------------------
 106 
 107 # Embedding files
 108 
 109 You can embed files with the syntax `![title](./file.txt)`:
 110 
 111 You can scroll up/down with **Up**/**Down**, the **mouse wheel**, or **Ctrl-U**/**Ctrl-D**.
 112 
 113 ![Tale of Genji](genji.txt)
 114 
 115 ![The source for this presentation](sample.md)
 116 
 117 ---------------------------------------------------------
 118 
 119 # Images
 120 
 121 ![](thumbsup.jpg)
 122 
 123 Supported! (kinda)
 124 
 125 ---------------------------------------------------------
 126 
 127 # Re-running Code
 128 
 129 You can re-run code by pressing **Ctrl-R** or **R**.
 130 
 131 It is currently:
 132 
 133 ```run
 134 date
 135 ```
 136 
 137 Some random numbers:
 138 
 139 ```run
 140 openssl rand -hex 16
 141 ```
 142 
 143 ```run
 144 hexdump -n 128 /dev/urandom
 145 ```
 146 
 147 ---------------------------------------------------------
 148 
 149 # Inspecting the Source
 150 
 151 You can inspect a slide's code at any point using
 152 the **Backtick** key `` ` ``
 153 
 154 ```run
 155 hexdump -n 128 /dev/urandom
 156 ```
 157 
 158 ---------------------------------------------------------
 159 
 160 # Get the Code
 161 
 162 You can get the source code [at the github repo](https://github.com/bruce-hill/slides)
 163 
 164 (links are `[link text](url)`, press **Enter** to launch)
 165 
 166 ---------------------------------------------------------
 167 
 168 # The End
 169 
 170 Thanks for your time!