ember-tools - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #llm #golang #android #machine-learning #rust #macos #kubernetes #ios #mcp #openai #open-source

ember-tools

(★ 867)

Generators and build tools for Ember applications

파일 탐색기

최종 버전 다운로드 (.zip)

- ember
- ember-data.js
- ember.js
- handlebars.js
- jquery.js
- localstorage_adapter.js
- - build.js
  - create.js
  - generate.js
  - index.js
  - precompile.js
  - update.js
- - component.js
  - component_template.js
  - controller.js
  - helper.js
  - index.js
  - mixin.js
  - model.js
  - route.js
  - scaffold.js
  - template.js
  - view.js
- - appDirs.js
  - config.js
  - fs.js
  - inflector.js
  - message.js
  - parseGeneratorCommand.js
  - precompile.js
  - prompt.js
- - browser.js
  - build.spec.js
  - create.spec.js
  - generators.spec.js
  - precompile.spec.js
  - update.spec.js
- - helpers.js
- mocha.opts
- testem.json
- ember-template-compiler.js
.gitignore
.travis.yml
package.json
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ryanflorence/ember-tools

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd ember-tools

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다.

npm install -g ember-tools

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install -g ember-tools

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Ember Tools
-----------

**NOTICE**: ember-tools is not currently maintained. If you want to maintain the project, contact @fivetanley or @rpflorence, if there is any interest. If you're starting a new project, using Ember CLI is recommended instead.

[![Build Status](https://travis-ci.org/rpflorence/ember-tools.png)](https://travis-ci.org/rpflorence/ember-tools)

![demo](http://cl.ly/image/2G0x323u150m/ember.gif)

## Installation

`npm install -g ember-tools`

Don't have node or npm? Visit http://nodejs.org.

## Features

- prescribed file organization for sanity
- scaffolding for learning curve mitigation
- template precompilation for performance
- single file application build for convenience
- generators for faster application development
- commonjs (node-style) modules

## Version Information

**Current Version: 0.2.7**

Package versions:

- ember v1.0.0
- ember-data v0.13
- handlebars v1.0.0
- jQuery 1.9.1

## Quickstart

```
npm install -g ember-tools
ember create my-app
cd my-app
ember generate --scaffold person name:string age:number
ember build
open index.html # Mac OS
xdg-open index.html # Linux
start index.html # Windows
# visit #/people
```

The first place to get started is configuring a route in
`config/routes.js` and then adding a template for the route.

## Usage

You can always run `ember --help` or `ember [command] --help` to get
usage information.

```
  Usage: ember [command] [options]

Command-Specific Help

ember [command] --help

Commands:

create [options]       creates a new ember application at [dir]
    build [options]        compiles templates and builds the app
    generate [options]     generates application files
    precompile [options]   precompile templates from src dir to target dir
    update [version]       Update ember.js from ember's s3 build service to [version].
             Versions are latest(built from master, bleeding edge) and stable.
             Default version is stable.
  Options:

-h, --help     output usage information
    -V, --version  output the version number
```

## Guide

### Creating Stand-Alone Browser Apps

If you are creating a stand-alone browser application (no server, or
communication is through some api service) then use:

`ember create my-app`

- javascript assets created in `my-app/js`
- ember commands run from `my-app` root

Or if you already have the `my-app` directory, `cd` into it and call
ember create bare:

`ember create`

- javascript assets created in `./js`
- ember commands run from `./` root

There is nothing magical about the `index.html` file. Feel free to
replace it with your own (you probably should). Just make sure you
include a script tag pointing to `js/application.js`

### Creating Browser Apps as Part of Express or Rails (etc.)

If you are creating an ember app as part of a server-side framework like
express or ruby on rails use the `--js-path` option.

```sh
cd my-server-app
ember create --js-path public/javascripts
```

- javascript assets created in `my-server-app/public/javascripts`
- ember commands run from `my-server-app` root

Running `ember build` will create a file at
`public/javascripts/application.js`. Require that in your server-app's
template, no other files are required.

### Building Your App

The build command pre-compiles all the templates to simple functions,
assigns all your modules to the `App` object based on their file names,
and then creates a single, concatenated file to be included in your app.

`ember build`

This build step makes adding new modules to your app as simple as
creating a file with the generate command. It will convert the file path
to an object, ie: `controllers/recipe -> App.RecipeController`,
`routes/recipes/index -> App.RecipesIndexRoute`.

To build when files in your app change, use the `--watch` option:

`ember build -w`

If you want to inspect the objects being assigned to the `App` object
you can build without cleanup using the `--no-cleanup, -c` option and
then opening up the `index.js` file it creates:

`ember build -c`

You can also specify the path of the resulting application file to save
it somewhere other than the default path.

`ember build --out-file public/whatever.js`

Of course, you can combine any of these options:

`ember build -wc --out-file public/whatever.js`

### Scaffolding

I am not super proud of the scaffolding, but it gets your feet wet with
ember really quickly, so use it for fun, not profit :P

`ember generate --scaffold time_sheet description:string minutes:number`

### Generators

Ember tools provides generators for the different ember objects your app
will use. Basic usage is:

`ember generate [options] [name]`

So creating a recipe route would look like:

`ember generate --route recipe`

Or the shorter version:

`ember generate -r recipe`

If you have a route, you probably want a template too; you can combine
generator options:

`ember generate -rt recipe`

Below is a list of all generator commands the the files and objects they
create.

### Generator Examples

| options | object name | file |
| --------|-------------|------|
| `--model, -m burrito` | `Burrito` | `models/burrito.js` |
| `--view, -v burrito` | `BurritoView` | `views/burrito_view.js` |
| `--controller, -c post/comments` | `PostCommentsController` | `controllers/post/comments_controller.js` |
| `--template, -t post/comments` | n/a | `templates/post/comments.handlebars` |
| `--route, -r taco_cart` | `TacoCartRoute` | `routes/taco_cart_route.js` |
| `--mixin, -x tacoable` | `Tacoable` | `mixins/tacoable.js` |
| `--helper, -l all_caps` | `allCaps` | `helpers/all_caps.js` |
| `--component, -p my-widget` | `MyWidgetComponent` | `components/my_widget_component.js` <br>`templates/components/my-widget.hbs` |
| `-mvcrt tacos` | `Taco` <br>`TacosView` <br>`TacosController` <br>`TacosRoute` | `models/taco.js` <br>`views/tacos_view` <br>`controllers/tacos_controller.js` <br>`routes/taco_route.js` <br>`templates/tacos.handlebars`|

_Notes:_

- Models will always be singular.
- Sub-directories will be created for you if they don't exist.
- Components must have a dash per web component standards.

### Precompiling Handlebars Templates for Ember

The build command already pre-compiles your templates, but you can use
the precompile command outside of the rest of ember-tools. To precompile
a bunch of templates found at `views/jst` to
`assets/javascripts/templates.js` run this command:

`ember precompile -d views/jst -f assets/javascripts/templates.js`

This will register each template on `Ember.TEMPLATES` with file paths
for keys.

## Upgrading from 0.1.x to 0.2.x

1. Rename `.ember` to `ember.json`
2. Edit `ember.json` to point to the right `jsPath`, should look
   something like:
    ```js
    {
      "jsPath": "js",
      "modules": "cjs"
    }
    ```
3. Move `routes.js`, `app.js`, and `store.js` to `config/<filename>.js`
4. Add dependencies to `config/app.js`, it should look something like this:
   ```js
   require('../vendor/jquery');
   require('../vendor/handlebars');
   require('../vendor/ember');
   require('../vendor/ember-data');

var App = Ember.Application.create();
   App.Store = require('./store');

module.exports = App;
   ```

That should do it.

## License and Copyright

[MIT Style License](http://opensource.org/licenses/MIT)

Copyright &copy; 2013 [Ryan Florence](http://ryanflorence.com)

## Contributing

Run tests with:

`npm test`

and the browser sanity tests:

`npm run-script browser`

Its usually easiest to create a branch and send a pull request against that branch instead of master. Single commits are preferred (no big deal though, I can squash and cherry-pick).

Thanks for using ember-tools!