Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shawntabrizi/docsify-slides

A docsify plugin for creating slideshow-like pages.
https://github.com/shawntabrizi/docsify-slides

Last synced: 4 days ago
JSON representation

A docsify plugin for creating slideshow-like pages.

Awesome Lists containing this project

README

        

# docsify-slides

A plugin for [`docsify`](https://docsify.js.org/) that allows you to write documentation which acts like a slideshow.

## Install

Simply include the plugin with your `docsify` project:

```html

```

> **NOTE:** This plugin works best in combination with [`docsify-pagination`](https://github.com/imyelo/docsify-pagination) plugin.
> Be sure to also enable this plugin on your docsify site for the full experience.

### Default Closed Sidebar

If you would like to have the docsify sidebar hidden by default, simply add the `class="close"` to your main `body` tag in your `index.html`.

```html
...
```

## What is it?

This is a simple plugin which gives you a flexible two-column layout via a custom markdown syntax.

Just add:

```html

```

or

```html

```

where `#` is the percent of the total width you want the left side of the slide to be. (i.e. ``)

Check out the [example](https://shawntabrizi.github.io/docsify-slides).

### Features

1. Responsive two column layout for your markdown pages.
2. Reduced margins and spacing to maximize presentation real estate.
3. Closed sidebar behavior is [fixed on mobile screens](https://github.com/docsifyjs/docsify/issues/442).

If you enable [`docsify-pagination`](https://github.com/imyelo/docsify-pagination):

4. Navigate between pages with `<-` and `->` keys.
5. [`docsify-pagination`](https://github.com/imyelo/docsify-pagination) acts as a sticky footer, so it is always visible on screen.