Skip to content
This repository has been archived by the owner on Dec 30, 2023. It is now read-only.

Latest commit

 

History

History
94 lines (62 loc) · 2.81 KB

README.md

File metadata and controls

94 lines (62 loc) · 2.81 KB

presenting.vim

This repo is archived. Use presenting.nvim instead.

presenting.vim is a vim plugin that turns your markup into presentable slides (in vim).

It is a clone of present.vim which is a clone of presen.vim. In contrast to its predecessors, presenting.vim:

  • has support for common markup languages,
  • can be extended, and
  • is documented

Great, hey?

Demonstrations

Here is what the examples/PresentingDemo.rst file looks like when presented.

presenting.vim RST demo

Markdown files are rendered a bit more fancifully. Be sure to read the help file. Here is the examples/PresentingDemo.markdown being presented.

presenting.vim Markdown demo

Installation

Use pathogen or vundle to install presenting.vim.

Configuration

Simply write your presentation in your favorite markup language. Every slide is separated by a markup language specific marker.

Filetype Slide Separator
markdown # heading
rst ~~~~
orgmode #----
GoLang slide * title

These can be overridden or extended by setting b:presenting_slide_separator for your preferred filetype in your .vimrc. For example, set the .rst slide separator to ~~~~ via:

au FileType rst let b:presenting_slide_separator = '\v(^|\n)\~{4,}'

Usage

When you want to start presenting, execute

:PresentingStart

It is possible to have multiple presentations running at the same time. Just run the command in each source document, and each slide show will be displayed in its own tab.

Once presenting, slide navigation is accomplished via these keys:

Key Action
n next slide
p previous slide
q quit

Examples

For examples of presenting.vim presentations, see:

Of course you can configure the slide separators.

Contributing

The code and issue tracker are on github. Pull requests are welcome!