Slides over SSH

You will be able to access the presentation hosted over SSH! You can use this to present with slides from a computer that doesn't have slides installed, but does have ssh. Or, let your viewers have access to the slides on their own computer without needing to download slides and the presentation file. (Thanks to @ivantsepp!)

slides serve <file>

And then ssh into your presentation with:

ssh 127.0.0.1 -p 53531

What's Changed

• Add ssh server functionality by @ivantsepp in https://github.com/maaslalani/slides/pull/150
• feat: ensure that date strings are not interpreted as January 2, 2006 formatted strings by @maaslalani in https://github.com/maaslalani/slides/pull/170
• Feat: Yank Code Blocks by @maaslalani in https://github.com/maaslalani/slides/pull/173
• Code Comments to hide verbose code by @maaslalani in https://github.com/maaslalani/slides/pull/174
• feat: add support for java code execution by @mfathi91 in https://github.com/maaslalani/slides/pull/184

New Contributors

• @ivantsepp made their first contribution in https://github.com/maaslalani/slides/pull/150
• @mfathi91 made their first contribution in https://github.com/maaslalani/slides/pull/184

Full Changelog: https://github.com/maaslalani/slides/compare/v0.8.0...v0.9.0

What's Changed

• fix: do not get stderr when preprocessing slides by @maaslalani in https://github.com/maaslalani/slides/pull/145
• Respect GLAMOUR_STYLE if environment variable set by @maaslalani in https://github.com/maaslalani/slides/pull/146
• Slides Tutor by @maaslalani in https://github.com/maaslalani/slides/pull/147

Changelog

• Bump lots of dependencies
• Get rid of lots of dependencies (Removed over 600 lines from go.sum)

Full Changelog: https://github.com/maaslalani/slides/compare/v0.7.2...v0.7.3

Changelog

What's Changed

• Improvements to Search (using bubbles#TextInput component) in slides by @darmiel in https://github.com/maaslalani/slides/pull/119

Changelog

Changes

• Added Page Up and Page Down navigation by @Janszczyrek in https://github.com/maaslalani/slides/pull/115
• Improvements to exit code handling & virtual text reset

Bug Fixes

• Fixed bug with executing the same code block multiple times.

Changelog

Search Functionality

To quickly jump to the right slide, you can use the search functionality.

Press /, enter your search term, and press Enter.
(The search term is interpreted as a regular expression. The /i flag causes case-insensitivity.).

Press ctrl+n after a search to go to the next search result.

Thanks to @darmiel!

Changelog

4dd723d Remove some language tests to remove build dependencies on NixOS

Changelog

• Ability to run multiple code blocks in a single slide (thanks to @linw1995).
• Word wrapping support (thanks to @gsol10).
• Ability to use custom date format YYYY-MM-DD for date formatting in metadata (thanks to @cuducos).
• Vim-like navigation (5G: go to slide 5, gg: go to first slide, G: go to last slide) (thanks to @stoovon).
• Added rust support to code execution (thanks to @darmiel)

Changelog

Slides Customization

slides allows you to customize your presentation's look and feel with metadata at the top of your slides.md. (thanks to @cuducos)

This section is entirely optional, slides will use sensible defaults if this section or any field in the section is omitted.

---
theme: ./path/to/theme.json
author: Gopher
date: January 2, 2006
paging: Slide %d / %d
---

theme: Path to json file containing a glamour theme, can also be a link to a remote json file which slides will fetch before presenting.
author: A string to display on the bottom-left corner of the presentation view. Defaults to the OS current user's full name. Can be empty to hide the author.
date: A string that is used to format today's date in the form 2006-01-02. If the date is not a valid form of 2006-01-02 the contents of the string will be displayed. Defaults to 2006-01-02.
paging: A string that contains 0 or more %d directives. The first %d will be replaced with the current slide number and the second %d will be replaced with the total slides count. Defaults to Slide %d / %d.

Other changes

• Added: lua support to code blocks execution
• Bug fix: Ordered lists now respect the first number as a starting point.

Changelog

• Bug fix: Custom themes now work (Thanks to @itmecho)
• Bug fix: Slides will not crash with small slides (<= 1)
• Feature: Support for perl code execution

Changelog

Pre-processing

slides now has the ability to have commands run and executed before presenting slides (pre-processing).
To use this feature, you must:

• Use a file for your slides (no stdin, for security reasons)
• chmod +x file.md, change file permissions to be able to execute code on slides (for security reasons)

In your slides.md, you can write a code block with this structure (use tildes ~). When you go to present slides (that are executable, chmod +x slides.md), slides will parse the code block and run the command to run and pass in the text inside the code block as stdin to the command. The entire code block will then be replace by the stdout of the command you want to run.

~~~command to run
stdin
~~~

This allows you to:

• Import text from other files with

~~~xargs cat
examples/import.md
~~~

• Render GraphViz graphs with graph-easy

~~~graph-easy --as=boxart
[ A ] -> [ B ]
~~~

• A lot more...

(If you come up with useful pre-processing commands/examples, please contribute to https://github.com/maaslalani/slides/blob/main/examples/preprocess.md)

Other changes

• slides added to nixpkgs-unstable @ v0.3.0
• Added support for javascript code execution (using node)
• Added support for elixir code execution (thanks to @suzaku)
• ✋ Breaking: Removed ~~~ as a slide delimiter (for pre-processing), use --- always instead.
• Code block execution results are no longer rendered as Markdown. (thanks to @suzaku)
• Fix bug to be able to parse code blocks without trailing new lines. (thanks to @suzaku)

Changelog

Live Slides Update

If given a filename: slides file.md, Slides will automatically watch the file for changes and update your presentation live (thanks to @sibprogrammer)

Code Block Execution

When there is a code block on the current slide, you can press ctrl+e to execute it and the output will display as virtual text on the slide at the end.
Supported languages are:

• bash
• ruby
• python
• go

Changelog

User customizable themes:
Slides allows you to customize your presentation's theme (thanks to @brittonhayes).

In your presentation.md file prepend the following configuration.

---
theme: dark
---

theme can be any one of the following:

• dark
• light
• ascii
• notty
• ./theme.json
  You can pass a path to a JSON file that specifies your theme. Check out the default theme.json to use as a base for your custom theme.

Changelog

42c7a73 Merge pull request #17 from maaslalani/stdin
3da7238 Documentation: stdin and curling remote slides
58d4b02 Read slides from stdin
f68b802 Use chroma theme: dracula
5d89bf2 Fix #14: go vet ./... Redefinition
906add1 Merge pull request #12 from sibprogrammer/bugfix-modification-date-format
3126301 Fix #11 Correct date format

Changelog

0e97b0a Merge pull request #10 from meowgorithm/bump-libs
5e39ade Update deprecated method of entering the altscreen
e90da58 Update bubbletea/bubbles/glamour/lipgloss dependencies
6672f28 Update README.md
93ccd25 Internal API

Changelog

22b6fa2 go 1.16
6699e8a Create goreleaser.yml
95634ae Merge pull request #6 from sibprogrammer/bugfix-slide-separator
2489fac Merge pull request #8 from sibprogrammer/bugfix-slide-numbers
4e94e57 Merge pull request #4 from sibprogrammer/bugfix-makefile-errors
a108f30 Fix #7 Display the correct number of slides and current one
0a15388 Fix #5 Allow to use triple dashes as a slide separator
adb8dba Fix Makefile errors
47d2a87 embed styles
9b249b6 Revert "no need for user to specify theme.json"
7af1081 no need for user to specify theme.json
e90002f Merge pull request #3 from angristan/render-error
17a5ed7 Show markdown rendering error to user
cb40fa9 pr template
9480b07 Create CONTRIBUTING.md
9be3b16 Update issue templates
59326ce add space as next slides, swap down & up keys
1c6b5df Add credits
0f1ebff remove double import
ffca702 moar
eceb2c4 lil more error handling
44cfcf6 Remove hardcoded values
babdab1 Move demo to top
6ed3fe6 Add readme.md
0c87800 Create makefile
1cf7d3f Create license
debbccc theme.json
20c68ad JoinVertical
5bcb013 progress
d27e870 WIP
39df02c Markdown
6fc439b Initial commit