1
0
Fork 0
mirror of https://github.com/Oreolek/raconteur-scaffold.git synced 2024-04-29 23:49:21 +03:00
raconteur-scaffold/README.md

65 lines
2.5 KiB
Markdown
Raw Normal View History

2015-04-13 06:08:06 +03:00
# Raconteur Development Template
2015-04-13 09:06:32 +03:00
A scaffold for [Raconteur] projects.
2015-04-13 06:08:06 +03:00
## Installation
You'll need [Node.js] and [Gulp] installed.
git clone [this repository]
cd raconteur-template
npm install
## Pieces
Raconteur is designed to be used with a toolchain made of several powerful web development tools.
2015-04-13 09:06:32 +03:00
- [Node.js]
- [npm]
- [Gulp]
- [Browserify]
- [CoffeeScript]
- [Less]
- Numerous Gulp-related and Node packages; see the package.json file
2015-04-13 06:08:06 +03:00
## File Structure
Inside the scaffold, you will find:
```
.
|-- game
| `-- main.coffee
|-- html
| `-- index.html
|-- img
|-- less
| |-- main.less
| `-- mobile.less
|-- Gulpfile.js
`-- package.json
```
- `game/main.coffee`: The main entry point for your game. Contains a skeleton of a Raconteur story.
- `html/index.html`: The html page for your story.
- `img/`: This directory holds all of your game's image assets. Anything with the .png or .jpeg extensions, in this folder (including subfolders), will be copied over to `build/img/` or `dist/img/` when you build your game, so that the relative path for all of your images will be `img/image.png` and so on.
- `less/`: Holds your Less files. `less/main.less` is the entry point for Less; all other files have to be imported by this file. `less/mobile.less` has mobile-specific definitions, but you're free to reorganise these files as you like.
- `Gupfile.js`: The Gulpfile is the configuration file for the build system. Ideally, you won't have to edit this unless you want to change your folder organisation or build setup.
- `package.json`: This barebones package.json file only holds a list of dependencies to install, so that `npm install` will install dependencies automagically.
## Usage
This scaffold comes prepped for usage with Gulp as a build system, Less for CSS preprocessing, Browserify for bundling JavaScript, and CoffeeScript as a JS transpiler.
2015-04-13 09:06:32 +03:00
Running `gulp` will build your game in the `build/` directory. `gulp serve` will build and then start up a local server with live reload, so you can point your browser. `gulp dist` will make a distribution-ready copy of your game in `dist/`, with minified JavaScript and CSS. `gulp zip` will make a distribution-ready copy in `dist/` and then make a `dist.zip` file that is ready to be uploaded to [Itch.io] or sent by email.
[Raconteur]: http://github.com/sequitur/raconteur/
[Node.js]: http://nodejs.org/
[npm]: http://npmjs.com/
[Gulp]: http://gulpjs.com/
[Browserify]: http://browserify.org/
[CoffeeScript]: http://coffeescript.org/
[Less]: http://lesscss.org/
[Itch.io]: http://itch.io/