Merge pull request #2231 from esthor/patch-1
bring install instructions to top, as is tradition
This commit is contained in:
commit
c35cce54a5
108
README.md
108
README.md
|
@ -8,6 +8,10 @@ reveal.js comes with a broad range of features including [nested slides](https:/
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
|
||||||
- [Online Editor](#online-editor)
|
- [Online Editor](#online-editor)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Basic setup](#basic-setup)
|
||||||
|
- [Full setup](#full-setup)
|
||||||
|
- [Folder Structure](#folder-structure)
|
||||||
- [Instructions](#instructions)
|
- [Instructions](#instructions)
|
||||||
- [Markup](#markup)
|
- [Markup](#markup)
|
||||||
- [Markdown](#markdown)
|
- [Markdown](#markdown)
|
||||||
|
@ -48,10 +52,6 @@ reveal.js comes with a broad range of features including [nested slides](https:/
|
||||||
- [Client presentation](#client-presentation)
|
- [Client presentation](#client-presentation)
|
||||||
- [Socket.io server](#socketio-server)
|
- [Socket.io server](#socketio-server)
|
||||||
- [MathJax](#mathjax)
|
- [MathJax](#mathjax)
|
||||||
- [Installation](#installation)
|
|
||||||
- [Basic setup](#basic-setup)
|
|
||||||
- [Full setup](#full-setup)
|
|
||||||
- [Folder Structure](#folder-structure)
|
|
||||||
- [License](#license)
|
- [License](#license)
|
||||||
|
|
||||||
#### More reading
|
#### More reading
|
||||||
|
@ -67,6 +67,56 @@ reveal.js comes with a broad range of features including [nested slides](https:/
|
||||||
Presentations are written using HTML or Markdown but there's also an online editor for those of you who prefer a graphical interface. Give it a try at [https://slides.com](https://slides.com?ref=github).
|
Presentations are written using HTML or Markdown but there's also an online editor for those of you who prefer a graphical interface. Give it a try at [https://slides.com](https://slides.com?ref=github).
|
||||||
|
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
The **basic setup** is for authoring presentations only. The **full setup** gives you access to all reveal.js features and plugins such as speaker notes as well as the development tasks needed to make changes to the source.
|
||||||
|
|
||||||
|
### Basic setup
|
||||||
|
|
||||||
|
The core of reveal.js is very easy to install. You'll simply need to download a copy of this repository and open the index.html file directly in your browser.
|
||||||
|
|
||||||
|
1. Download the latest version of reveal.js from <https://github.com/hakimel/reveal.js/releases>
|
||||||
|
2. Unzip and replace the example contents in index.html with your own
|
||||||
|
3. Open index.html in a browser to view it
|
||||||
|
|
||||||
|
### Full setup
|
||||||
|
|
||||||
|
Some reveal.js features, like external Markdown and speaker notes, require that presentations run from a local web server. The following instructions will set up such a server as well as all of the development tasks needed to make edits to the reveal.js source code.
|
||||||
|
|
||||||
|
1. Install [Node.js](http://nodejs.org/) (4.0.0 or later)
|
||||||
|
|
||||||
|
1. Clone the reveal.js repository
|
||||||
|
```sh
|
||||||
|
$ git clone https://github.com/hakimel/reveal.js.git
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Navigate to the reveal.js folder
|
||||||
|
```sh
|
||||||
|
$ cd reveal.js
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Install dependencies
|
||||||
|
```sh
|
||||||
|
$ npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Serve the presentation and monitor source files for changes
|
||||||
|
```sh
|
||||||
|
$ npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Open <http://localhost:8000> to view your presentation
|
||||||
|
|
||||||
|
You can change the port by using `npm start -- --port=8001`.
|
||||||
|
|
||||||
|
### Folder Structure
|
||||||
|
|
||||||
|
- **css/** Core styles without which the project does not function
|
||||||
|
- **js/** Like above but for JavaScript
|
||||||
|
- **plugin/** Components that have been developed as extensions to reveal.js
|
||||||
|
- **lib/** All other third party assets (JavaScript, CSS, fonts)
|
||||||
|
|
||||||
|
|
||||||
## Instructions
|
## Instructions
|
||||||
|
|
||||||
### Markup
|
### Markup
|
||||||
|
@ -1252,56 +1302,6 @@ Reveal.initialize({
|
||||||
Read MathJax's documentation if you need [HTTPS delivery](http://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn) or serving of [specific versions](http://docs.mathjax.org/en/latest/configuration.html#loading-mathjax-from-the-cdn) for stability.
|
Read MathJax's documentation if you need [HTTPS delivery](http://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn) or serving of [specific versions](http://docs.mathjax.org/en/latest/configuration.html#loading-mathjax-from-the-cdn) for stability.
|
||||||
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
The **basic setup** is for authoring presentations only. The **full setup** gives you access to all reveal.js features and plugins such as speaker notes as well as the development tasks needed to make changes to the source.
|
|
||||||
|
|
||||||
### Basic setup
|
|
||||||
|
|
||||||
The core of reveal.js is very easy to install. You'll simply need to download a copy of this repository and open the index.html file directly in your browser.
|
|
||||||
|
|
||||||
1. Download the latest version of reveal.js from <https://github.com/hakimel/reveal.js/releases>
|
|
||||||
2. Unzip and replace the example contents in index.html with your own
|
|
||||||
3. Open index.html in a browser to view it
|
|
||||||
|
|
||||||
### Full setup
|
|
||||||
|
|
||||||
Some reveal.js features, like external Markdown and speaker notes, require that presentations run from a local web server. The following instructions will set up such a server as well as all of the development tasks needed to make edits to the reveal.js source code.
|
|
||||||
|
|
||||||
1. Install [Node.js](http://nodejs.org/) (4.0.0 or later)
|
|
||||||
|
|
||||||
1. Clone the reveal.js repository
|
|
||||||
```sh
|
|
||||||
$ git clone https://github.com/hakimel/reveal.js.git
|
|
||||||
```
|
|
||||||
|
|
||||||
1. Navigate to the reveal.js folder
|
|
||||||
```sh
|
|
||||||
$ cd reveal.js
|
|
||||||
```
|
|
||||||
|
|
||||||
1. Install dependencies
|
|
||||||
```sh
|
|
||||||
$ npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
1. Serve the presentation and monitor source files for changes
|
|
||||||
```sh
|
|
||||||
$ npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
1. Open <http://localhost:8000> to view your presentation
|
|
||||||
|
|
||||||
You can change the port by using `npm start -- --port=8001`.
|
|
||||||
|
|
||||||
### Folder Structure
|
|
||||||
|
|
||||||
- **css/** Core styles without which the project does not function
|
|
||||||
- **js/** Like above but for JavaScript
|
|
||||||
- **plugin/** Components that have been developed as extensions to reveal.js
|
|
||||||
- **lib/** All other third party assets (JavaScript, CSS, fonts)
|
|
||||||
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
MIT licensed
|
MIT licensed
|
||||||
|
|
Loading…
Reference in New Issue