electron/README.md

77 lines
3.2 KiB
Markdown
Raw Normal View History

[![Electron Logo](http://electron.atom.io/images/electron-logo.svg)](http://electron.atom.io/)
2015-04-23 20:46:48 +00:00
2015-04-23 20:50:43 +00:00
[![Build Status](https://travis-ci.org/atom/electron.svg?branch=master)](https://travis-ci.org/atom/electron)
[![devDependency Status](https://david-dm.org/atom/electron/dev-status.svg)](https://david-dm.org/atom/electron#info=devDependencies)
2015-06-29 23:46:22 +00:00
[![Join the Electron Community on Slack](http://atom-slack.herokuapp.com/badge.svg)](http://atom-slack.herokuapp.com/)
:zap: *Formerly known as Atom Shell* :zap:
2015-04-20 18:22:50 +00:00
2015-04-08 17:16:10 +00:00
The Electron framework lets you write cross-platform desktop applications
2015-11-03 17:13:48 +00:00
using JavaScript, HTML and CSS. It is based on [Node.js](https://nodejs.org/) and
2014-05-05 18:56:35 +00:00
[Chromium](http://www.chromium.org) and is used in the [Atom
editor](https://github.com/atom/atom).
2013-04-12 01:46:58 +00:00
2015-04-24 00:00:04 +00:00
Follow [@ElectronJS](https://twitter.com/electronjs) on Twitter for important
announcements.
This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md).
By participating, you are expected to uphold this code. Please report unacceptable
behavior to atom@github.com.
2015-07-08 20:29:24 +00:00
2014-05-04 12:58:59 +00:00
## Downloads
2013-04-12 01:46:58 +00:00
2015-10-31 02:30:18 +00:00
Prebuilt binaries and debug symbols of Electron for Linux, Windows and OS X can
be found on the [releases](https://github.com/atom/electron/releases) page.
You can also use [`npm`](https://docs.npmjs.com/) to install prebuilt electron
binaries:
```sh
# Install the `electron` command globally in your $PATH
npm install electron-prebuilt -g
# Install as a development dependency
npm install electron-prebuilt --save-dev
```
2015-01-19 14:30:33 +00:00
### Mirrors
2015-05-10 08:15:12 +00:00
- [China](https://npm.taobao.org/mirrors/electron)
2015-01-19 14:30:33 +00:00
2014-05-05 18:56:35 +00:00
## Documentation
2013-04-12 01:46:58 +00:00
Guides and the API reference are located in the
[docs](https://github.com/atom/electron/tree/master/docs) directory. It also
contains documents describing how to build and contribute to Electron.
2014-05-14 18:32:24 +00:00
2015-08-23 15:19:37 +00:00
## Documentation Translations
2015-09-04 14:52:27 +00:00
- [Brazilian Portuguese](https://github.com/atom/electron/tree/master/docs-translations/pt-BR)
- [Korean](https://github.com/atom/electron/tree/master/docs-translations/ko-KR)
2015-08-23 15:19:37 +00:00
- [Japanese](https://github.com/atom/electron/tree/master/docs-translations/jp)
- [Spanish](https://github.com/atom/electron/tree/master/docs-translations/es)
- [Simplified Chinese](https://github.com/atom/electron/tree/master/docs-translations/zh-CN)
- [Traditional Chinese](https://github.com/atom/electron/tree/master/docs-translations/zh-TW)
2015-12-02 21:02:04 +00:00
- [Ukrainian](https://github.com/atom/electron/tree/master/docs-translations/uk-UA)
2015-11-27 19:32:45 +00:00
- [Russian](https://github.com/atom/electron/tree/master/docs-translations/ru-RU)
- [French](https://github.com/atom/electron/tree/master/docs-translations/fr-FR)
2015-08-23 15:19:37 +00:00
2015-10-19 22:52:02 +00:00
## Quick Start
Clone and run the [`atom/electron-quick-start`](https://github.com/atom/electron-quick-start)
repository to see a minimal Electron app in action.
2014-05-14 18:32:24 +00:00
## Community
2015-10-03 05:42:34 +00:00
You can ask questions and interact with the community in the following
locations:
2015-11-03 05:16:12 +00:00
- [`electron`](http://discuss.atom.io/c/electron) category on the Atom
forums
- `#atom-shell` channel on Freenode
- [`Atom`](http://atom-slack.herokuapp.com/) channel on Slack
2015-12-02 15:27:23 +00:00
- [`electron-br`](https://electron-br.slack.com) *(Brazilian Portuguese)*
2016-01-20 10:05:35 +00:00
- [`electron-kr`](http://www.meetup.com/electron-kr/) *(Korean)*
2015-05-16 15:03:19 +00:00
2015-10-03 05:42:34 +00:00
Check out [awesome-electron](https://github.com/sindresorhus/awesome-electron)
for a community maintained list of useful example apps, tools and resources.