Unlimited Slideshows



The PITCHME.md convention guarantees that any PITCHME.md markdown file found within any directory on any branch within your repository can be turned into a GitPitch slideshow presentation.

This guide explains how you can create, manage, and share an unlimited number of slideshow presentations within a single Git repository branch.


Working with the default Slideshow Presentation within a Branch

The PITCHME.md found in the root directory of any branch is known as the default slideshow presentation. The corresponding directory structure and files within a branch for the default slideshow presentation are as follows:

.
├── PITCHME.md
├── PITCHME.yaml

The PITCHME.yaml properties file is optional. When present, it can be used to activate custom settings for your slideshow presentation.

The default slideshow presentation is made available at the following URL:

SLIDESHOW-URL

Where you must substitute the corresponding Git account name, repository, and branch for $user, $repo, and $branch respectively.



Working with additional Slideshow Presentations within a Branch

There are no limits to the number of slideshow presentations you can create within a single branch in a Git repository.

All slideshow presentations found within a sub-directory below root within the branch are made available at the following URL:

SLIDESHOW-URL-CONFERENCE

The value of $directory must identify a directory path within the branch that contains a PITCHME.md markdown file.



Example: Conference Slideshow Presentation URL

Assuming a branch has the following directory structure and files:

.
├── PITCHME.md
├── PITCHME.yaml
│
├── conference
│   └── PITCHME.md

The Conference slideshow presentation URL is created as follows:

SLIDESHOW-URL-CONFERENCE



Example: New York Meetup Slideshow Presentation URL

Assuming a branch has the following directory structure and files:

.
├── PITCHME.md
├── PITCHME.yaml
│
├── conference
│   └── PITCHME.md
│
├── meetups
|   |
│   ├── newyork
│   │   ├── PITCHME.md
|   |
│   ├── berlin
│   │   ├── PITCHME.md
│   │   ├── PITCHME.yaml
|   |
│   ├── tokyo
│   │   ├── PITCHME.md
│   │   ├── PITCHME.yaml

The New York Meetup slideshow presentation URL is created as follows:

SLIDESHOW-URL-MEETUP