https://github.com/msoedov/hacker-slides

A small UI for building presentation slides from markdown markup
https://github.com/msoedov/hacker-slides

docker hacker-slides markdown reveal-js revealjs-server slide slides slideshow

Last synced: 5 days ago
JSON representation

A small UI for building presentation slides from markdown markup

• Host: GitHub
• URL: https://github.com/msoedov/hacker-slides
• Owner: msoedov
• License: mit
• Archived: true
• Created: 2016-03-05T10:17:09.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-05-12T00:35:01.000Z (over 3 years ago)
• Last Synced: 2024-06-20T09:15:00.597Z (5 months ago)
• Topics: docker, hacker-slides, markdown, reveal-js, revealjs-server, slide, slides, slideshow
• Language: Go
• Homepage: https://murmuring-sierra-54081.herokuapp.com/
• Size: 4.8 MB
• Stars: 347
• Watchers: 10
• Forks: 67
• Open Issues: 19
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-markdown - hacker-slides - Minimal UI for building presentation slides from markdown. ![Mac OS X][macosx] ![Linux][linux] (Tools / Presentations)

README

        
## Hacker Slides

[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/msoedov/hacker-slides/blob/master/LICENSE)

[![Build Status](https://travis-ci.org/msoedov/hacker-slides.svg?branch=master)](https://travis-ci.org/msoedov/hacker-slides)

[![](https://images.microbadger.com/badges/image/msoedov/hacker-slides:latest.svg)](https://microbadger.com/images/msoedov/hacker-slides "Hacker slides image")

[![Open Source Helpers](https://www.codetriage.com/msoedov/hacker-slides/badges/users.svg)](https://www.codetriage.com/msoedov/hacker-slides)

Hacker Slides is a self hosted reveal.js presentations editor form markdown files.

#### Features:

- Reach ui editor

- Markdown markup

- Live reload

- Color schemes

- Pdf print

- [Demo version](https://murmuring-sierra-54081.herokuapp.com)

- Tiny 10 Mb docker image

- Optional Basic auth

| Edit mode | Published  |

| --- | --- |

| ![1st](https://sc-cdn.scaleengine.net/i/520e2f4a8ca107b0263936507120027e.png) | ![1st](https://sc-cdn.scaleengine.net/i/7ae0d31a40b0b9e7acc3f131754874cf.png) |

|![2nd](https://sc-cdn.scaleengine.net/i/5acba66070e24f76bc7f20224adc611e.png) | ![2nd](https://sc-cdn.scaleengine.net/i/fee3e1374cb13b1d8c292becb7f514ae.png) |

This repo is a reworked version of Sandstorm Hacker Slides which features easy set up run outside of Sandstorm and without vagrant-spk. Likewise you can publish and edit your previous markdown slides which is not supported in the original version.

Run from docker image

-----

```shell

docker run -it -p 8080:8080 -v $(pwd)/slides:/app/slides msoedov/hacker-slides

```

Build locally

----

To build and run it locally

```go

go get

go run main.go

[GIN-debug] Listening and serving HTTP on :8080

```

And then you can just open [http://127.0.0.1:8080](http://127.0.0.1:8080) and it's ready to use with sample slides.

Run with docker

```shell

docker run -it -p 8080:8080 -v $(pwd)/slides:/app/slides msoedov/hacker-slides

```

Protect slides with password

----

Basic auth (disabled by default)

```shell

USER=bob PASSWORD=password1 go run main.go

[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.

 - using env:	export GIN_MODE=release

 - using code:	gin.SetMode(gin.ReleaseMode)

WARN[0000] Auth mode enabled

WARN[0000] Visit http://bob:[email protected]:8080

```

```shell

docker run -it -p 8080:8080 -e USER=bob -e PASSWORD=password1 -v $(pwd)/slides:/app/slides msoedov/hacker-slides

```

Use local images

----

Store pictures you want to use in the images subfolder, slides/images/ and reference them in the editor as Markdown:

```

![demoPicture](/images/demo.png)

```

or as HTML:

```



```

Getting Help

------------

For **feature requests** and **bug reports**  submit an issue

to the GitHub issue tracker