Kendo UI for Angular: Localization

A starter repository for Kendo UI Angular components, which provides the basic directory structure and dependencies.

WARNING

The current test setup is extremely brittle and (mostly) based on the AngularClass starter repository. There are several very ugly things, we hope that these will be gradually cleared as the framework matures.

• Overview
• Basic Usage and Installation
• Gulp Tasks

Overview

• The src directory contains the component source code. All files should have the .ts extensions so that the build scripts can pick them.
• The src/main.ts file should import and re-export all public entities of the package. It is used for the build-cdn task. It is also the main entry point for the NPM package (as specified by the package.json). The build-npm-package transpiles it to dist/npm/js/main.js.
• The src/kendo-component.ts file is the actual sample component implementation.
• The src/util.ts is an optional example of an additional file. If unnecessary, remove it.
• The examples directory hosts the demos for the component. As a bare minimum, the component should have a Basic Usage and a CDN example. The CDN example should work as expected after the build-cdn task has been run.
• The test directory contains the component tests. They are transpiled just like the source code itself and run with Jasmine in Karma (PhantomJS).
• The e2e directory contains the end-to-end tests. They are transpiled and run with Jasmine in Karma (Google Chrome).
• The docs directory contains markdown files that document the specifics of the component.

Basic Usage and Installation

1. Fork the repository to an appropriately named new one.
2. Change the package name/description in package.json. Change the reference to the theme package.
3. Change the library name in gulpfile.js.
4. Change the name of the src/kendo-component.ts file to something more meaningful.
5. Delete the current contents and put something nice in README.md.

Gulp Tasks

Remember to run npm install and npm run typings before using the Gulp tasks.

• build-npm-package—Builds the scripts and styles in dist/npm in a CommonJS format.
• build-cdn—Builds the scripts and styles in dist/cdn in a UMD format.
• start—Starts the webpack-dev-server. It is suitable for example previews, development, and testing. Accessible on http://localhost:3000.
• docs—Starts the documentation site for the current component. Accessible on http://localhost:8082
• test—Runs the tests with Jasmine in Karma/PhantomJS.
• watch-test—Runs the tests in the watch mode.
• e2e—Runs the e2e tests with Jasmine in Karma/Google Chrome.