md2slides

README

md2slides

Converts a Markdown file into a sequence of HTML5 slides.

• Use Markdown to write your presentation in one file
• Separate slides by a new line, -- and another new line (e.g. \n versus \r\n)
• Apply the simple default template or use your own
• Control Layout and display with HTML5 and CSS

Releases and cross compilation

The script mk-release.sh cross compiles md2slides for Windows, Max OS X, Linux (amd64) and Raspberry Pi (Raspbian/ARM6 and ARM7). It places all the resulting executable programs in the dist folders.

windows issues

md2slides has very limited Windows testing done. md2slides.exe presumes the Unix style new line only and not the old DOS/Windows CR/LF type endings.

Documentation

Overview

md2slides.go - A simple command line utility that uses Markdown to generate a sequence of HTML5 pages that can be used for presentations.

@author R. S. Doiel, <rsdoiel@gmail.com>

Copyright (c) 2016, R. S. Doiel All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Index

• Constants
• Variables
• func MakeSlide(wr io.Writer, tmpl *template.Template, slide *Slide) error
• func MakeSlideFile(tmpl *template.Template, slide *Slide) error
• func MakeSlideString(tmpl *template.Template, slide *Slide) (string, error)
• type Slide
  • func MarkdownToSlides(fname string, title string, cssPath string, src []byte) []*Slide

Constants

const (
	// Version of md2slides package
	Version = "v0.0.4"
)

Variables

var (
	// The default HTML provided by md2slides package, you probably want to override this...
	DefaultTemplateSource = `` /* 1847-byte string literal not displayed */

)

Functions

func MakeSlide

func MakeSlide(wr io.Writer, tmpl *template.Template, slide *Slide) error

MakeSlide this takes a io.Writer, a template and slide and executes the template.

func MakeSlideFile

func MakeSlideFile(tmpl *template.Template, slide *Slide) error

MakeSlideFile this takes a template and slide and renders the results to a file.

func MakeSlideString

func MakeSlideString(tmpl *template.Template, slide *Slide) (string, error)

MakeSlideString this takes a template and slide and renders the results to a string

Types

type Slide

type Slide struct {
	CurNo   int
	PrevNo  int
	NextNo  int
	FirstNo int
	LastNo  int
	FName   string
	Title   string
	Content string
	CSSPath string
}

Slide is the metadata about a slide to be generated.

func MarkdownToSlides

func MarkdownToSlides(fname string, title string, cssPath string, src []byte) []*Slide

MarkdownToSlides turns a markdown file into one or more Slide using the fname, title and cssPath provided