Skip to content

Commit

Permalink
Merge branch 'master' into 1533-component-afterrender-trigger-option2
Browse files Browse the repository at this point in the history
Conflicts:
	spec/components/componentBindingBehaviors.js
  • Loading branch information
mbest committed Nov 4, 2017
2 parents d64df2e + 3d7cf10 commit fc2ff32
Show file tree
Hide file tree
Showing 75 changed files with 2,903 additions and 945 deletions.
37 changes: 23 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Knockout

**Knockout** is a JavaScript [MVVM](http://en.wikipedia.org/wiki/Model_View_ViewModel) (a modern variant of MVC) library that makes it easier to create rich, desktop-like user interfaces with JavaScript and HTML. It uses *observers* to make your UI automatically stay in sync with an underlying data model, along with a powerful and extensible set of *declarative bindings* to enable productive development.

##Getting started
## Getting started

[![Join the chat at https://gitter.im/knockout/knockout](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knockout/knockout?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Expand All @@ -11,40 +13,47 @@ For more details, see
* Documentation on [the project's website](http://knockoutjs.com/documentation/introduction.html)
* Online examples at [http://knockoutjs.com/examples/](http://knockoutjs.com/examples/)

##Downloading Knockout
## Downloading Knockout

You can [download released versions of Knockout](http://knockoutjs.com/downloads/) from the project's website.

For Node.js developers, Knockout is also available from [npm](https://npmjs.org/) - just run `npm install knockout`.

##Building Knockout from sources
## Building Knockout from sources

If you prefer to build the library yourself:

1. **Clone the repo from GitHub**
1. **Clone the repo from GitHub**

git clone https://github.com/knockout/knockout.git
cd knockout
```sh
git clone https://github.com/knockout/knockout.git
cd knockout
```

2. **Acquire build dependencies.** Make sure you have [Node.js](http://nodejs.org/) installed on your workstation. This is only needed to _build_ Knockout from sources. Knockout itself has no dependency on Node.js once it is built (it works with any server technology or none). Now run:
2. **Acquire build dependencies.**

npm install -g grunt-cli
npm install
Make sure you have [Node.js](http://nodejs.org/) installed on your workstation. This is only needed to _build_ Knockout from sources. Knockout itself has no dependency on Node.js once it is built (it works with any server technology or none). Now run:

The first `npm` command sets up the popular [Grunt](http://gruntjs.com/) build tool. You might need to run this command with `sudo` if you're on Linux or Mac OS X, or in an Administrator command prompt on Windows. The second `npm` command fetches the remaining build dependencies.
```sh
npm install -g grunt-cli
npm install
```

3. **Run the build tool**
The first `npm` command sets up the popular [Grunt](http://gruntjs.com/) build tool. You might need to run this command with `sudo` if you're on Linux or Mac OS X, or in an Administrator command prompt on Windows. The second `npm` command fetches the remaining build dependencies.

grunt
3. **Run the build tool**

Now you'll find the built files in `build/output/`.
```sh
grunt
```
Now you'll find the built files in `build/output/`.

## Running the tests

If you have [phantomjs](http://phantomjs.org/download.html) installed, then the `grunt` script will automatically run the specification suite and report its results.

Or, if you want to run the specs in a browser (e.g., for debugging), simply open `spec/runner.html` in your browser.

##License
## License

MIT license - [http://www.opensource.org/licenses/mit-license.php](http://www.opensource.org/licenses/mit-license.php)
4 changes: 3 additions & 1 deletion build/fragments/source-references.js
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ knockoutDebugCallback([
'src/subscribables/observableArray.changeTracking.js',
'src/subscribables/dependentObservable.js',
'src/subscribables/mappingHelpers.js',
'src/subscribables/observableUtils.js',
'src/binding/selectExtensions.js',
'src/binding/expressionRewriting.js',
'src/virtualElements.js',
Expand All @@ -43,8 +44,9 @@ knockoutDebugCallback([
'src/binding/defaultBindings/text.js',
'src/binding/defaultBindings/textInput.js',
'src/binding/defaultBindings/uniqueName.js',
'src/binding/defaultBindings/using.js',
'src/binding/defaultBindings/value.js',
'src/binding/defaultBindings/visible.js',
'src/binding/defaultBindings/visibleHidden.js',
// click depends on event - The order matters for specs, which includes each file individually
'src/binding/defaultBindings/click.js',
'src/templating/templateEngine.js',
Expand Down
Loading

0 comments on commit fc2ff32

Please sign in to comment.