https://github.com/gkapfham/pygotham2018-presentation
:notebook: Slides for a Technical Presentation Given at the PyGotham 2018 Conference
https://github.com/gkapfham/pygotham2018-presentation
javascript presentation-slides react spectacle
Last synced: 8 months ago
JSON representation
:notebook: Slides for a Technical Presentation Given at the PyGotham 2018 Conference
- Host: GitHub
- URL: https://github.com/gkapfham/pygotham2018-presentation
- Owner: gkapfham
- Created: 2018-10-09T18:58:48.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-09T19:14:12.000Z (about 7 years ago)
- Last Synced: 2025-01-01T01:32:22.426Z (10 months ago)
- Topics: javascript, presentation-slides, react, spectacle
- Language: JavaScript
- Homepage:
- Size: 5.17 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# pygotham2018-presentation
[](https://travis-ci.com/gkapfham/pygotham2018-presentation) [](https://github.com/FormidableLabs/spectacle)
This repository contains the HTML source code and additional resources for a
presentation that I, [Gregory M.
Kapfhammer](https://www.gregorykapfhammer.com/), gave during at the 2018
edition of the PyGotham conference. The presentation's source code uses the
[Spectacle](https://github.com/FormidableLabs/spectacle) framework to control
the display of each slide. I have developed a custom theme for the slides that
manages the formatting, color scheme, and the use of icons. All of the colors
in the presentation come from the Material Design color palette. Finally, the
presentation uses icons from [Font Awesome](https://fontawesome.com/) and
customized versions of the [Spectacle
Code](https://github.com/jamiebuilds/spectacle-code-slide) and [Spectacle
Terminal](https://github.com/elijahmanor/spectacle-terminal) plugins.
## Installation Instructions
You can type the following command if you want to clone this repository:
```shell
git clone https://github.com/gkapfham/pygotham2018-presentation.git
```
Now you should install of all of the packages needed for the presentation:
```shell
npm install
```
Finally, you may need to ensure the correct version of the Babel loader. This
command was suggested in the issue tracker for Spectacle; it sometimes resolved
a problem that I was experiencing when I tried to build and display the
presentation. Please consider trying this command if the presentation does not
build and display correctly.
```shell
npm install babel-loader@next
```
Please note that this `package.json` file will lead to the installation of a
wide variety of Node modules, including required for the use of Font Awesome and
the Socket.io server needed to ensure that the display and presenter modes can
communicate correctly. These installation instructions were tested on an Ubuntu
16.04 workstation running the 3.9.5 version of `npm`.
## Displaying and Giving the Presentation
To start the rendering and display of the presentation type the command `npm
start` in your terminal window. If you want to display the presentation to your
audience, you can go the [audience-mode site](http://localhost:3000/#/). If you
want to see the presentation slides in a presenter mode, you can go to the
[presenter-mode site](http://localhost:3000/#/?presenter&timer).
## Debugging the Presentation
Since these slides are implemented in the
[Spectacle](https://github.com/FormidableLabs/spectacle) framework, you may need
to use Chrome or Firefox Developer Tools, augmented with the React Developer
Plugin, to resolve errors that prevent the slides from displaying correctly. In
my experience, it is also important to use Developer Tools to check the slides
at different simulated resolutions so as to ensure that they display properly
when connected to a projector.
## Problems or Praise
If you have any problems with installing or displaying this presentation, then
please raise an issue associated with this Git repository using the "Issues"
link at the top of this site. I will do everything that I can to resolve your
issue and ensure that the presentation works correctly.