2014-05-05 02:42:45 +04:00
|
|
|
![Atom](https://cloud.githubusercontent.com/assets/72919/2874231/3af1db48-d3dd-11e3-98dc-6066f8bc766f.png)
|
2012-08-31 21:43:21 +04:00
|
|
|
|
2014-05-06 00:04:22 +04:00
|
|
|
Atom is a hackable text editor for the 21st century.
|
|
|
|
|
|
|
|
Atom is open source and built on top of [atom-shell](http://github.com/atom/atom-shell).
|
|
|
|
|
|
|
|
Atom is designed to be customizable, but also usable without needing to edit a config file.
|
|
|
|
|
|
|
|
Atom is modern, approachable, and hackable to the core.
|
|
|
|
|
2014-05-06 02:33:03 +04:00
|
|
|
Visit [atom.io](http://atom.io) to learn more.
|
2012-08-31 21:43:21 +04:00
|
|
|
|
2013-06-10 20:00:08 +04:00
|
|
|
## Installing
|
|
|
|
|
2013-11-27 22:59:11 +04:00
|
|
|
Download the latest [Atom release](https://github.com/atom/atom/releases/latest).
|
2013-06-10 20:00:08 +04:00
|
|
|
|
2013-11-27 22:59:11 +04:00
|
|
|
Atom will automatically update when a new release is available.
|
2013-06-10 20:00:08 +04:00
|
|
|
|
|
|
|
## Building
|
2012-09-25 20:24:50 +04:00
|
|
|
|
2014-05-06 02:33:20 +04:00
|
|
|
|
2014-05-07 02:01:59 +04:00
|
|
|
### OS X Requirements
|
2014-05-06 02:33:20 +04:00
|
|
|
* OS X 10.8 or later
|
|
|
|
* [node.js](http://nodejs.org/)
|
2014-05-06 03:13:53 +04:00
|
|
|
* Command Line Tools for [Xcode](https://developer.apple.com/xcode/downloads/) (Run `xcode-select --install`)
|
2014-05-06 02:33:20 +04:00
|
|
|
|
2014-05-06 04:15:59 +04:00
|
|
|
```sh
|
2014-05-06 19:42:18 +04:00
|
|
|
git clone https://github.com/atom/atom
|
2014-05-06 04:15:59 +04:00
|
|
|
cd atom
|
|
|
|
script/build # Creates application at /Applications/Atom.app
|
|
|
|
```
|
|
|
|
|
2014-05-07 02:01:59 +04:00
|
|
|
### Linux Requirements
|
2014-05-06 03:05:24 +04:00
|
|
|
* Ubuntu LTS 12.04 64-bit is the recommended platform
|
2014-05-07 01:52:22 +04:00
|
|
|
* OS with 64-bit architecture
|
2014-05-06 22:44:17 +04:00
|
|
|
* [node.js](http://nodejs.org/) v0.10.x
|
2014-05-06 23:04:12 +04:00
|
|
|
* [npm](http://www.npmjs.org/) v1.4.x
|
2014-05-06 03:05:24 +04:00
|
|
|
* `sudo apt-get install libgnome-keyring-dev`
|
2014-05-06 22:04:25 +04:00
|
|
|
* `npm config set python /usr/bin/python2 -g` to ensure that gyp uses Python 2
|
2014-05-06 02:49:29 +04:00
|
|
|
|
2014-05-06 04:15:59 +04:00
|
|
|
```sh
|
2014-05-06 19:42:18 +04:00
|
|
|
git clone https://github.com/atom/atom
|
2014-05-06 04:15:59 +04:00
|
|
|
cd atom
|
2014-05-06 04:37:38 +04:00
|
|
|
script/build # Creates application at /tmp/atom-build/Atom
|
|
|
|
sudo script/grunt install # Installs command to /usr/local/bin/atom
|
2014-05-06 04:15:59 +04:00
|
|
|
```
|
|
|
|
|
2014-05-07 02:01:59 +04:00
|
|
|
### Windows Requirements
|
2014-05-06 04:13:10 +04:00
|
|
|
* Windows 7 or later
|
2014-05-06 19:11:32 +04:00
|
|
|
* [Visual C++ 2010 Express](http://www.microsoft.com/visualstudio/eng/products/visual-studio-2010-express)
|
|
|
|
* [node.js - 32bit](http://nodejs.org/)
|
|
|
|
* [Python 2.7.x](http://www.python.org/download/)
|
|
|
|
* [GitHub for Windows](http://windows.github.com/)
|
2014-05-06 21:28:16 +04:00
|
|
|
* [Git for Windows](http://git-scm.com/download/win)
|
2014-05-06 21:35:53 +04:00
|
|
|
* Select the option **Use Git from the Windows Command Prompt** when installing (Git needs to be in your `PATH`)
|
2014-05-06 19:11:32 +04:00
|
|
|
* Clone [atom/atom](https://github.com/atom/atom/) to `C:\Users\<user>\github\atom\`
|
2014-05-06 03:18:32 +04:00
|
|
|
* Add `C:\Python27;C:\Program Files\nodejs;C:\Users\<user>\github\atom\node_modules\`
|
|
|
|
to your PATH
|
2014-05-06 04:15:59 +04:00
|
|
|
* Open the Windows GitHub shell
|
2014-05-06 04:37:38 +04:00
|
|
|
|
2014-05-06 18:43:08 +04:00
|
|
|
```bat
|
2014-05-06 04:15:59 +04:00
|
|
|
cd C:\Users\<user>\github\atom
|
2014-05-07 01:31:31 +04:00
|
|
|
script\build
|
2014-05-06 04:15:59 +04:00
|
|
|
```
|
2013-11-08 03:08:39 +04:00
|
|
|
|
2014-04-29 01:42:31 +04:00
|
|
|
## Developing
|
2014-05-06 19:29:37 +04:00
|
|
|
Check out the [guides](https://atom.io/docs/latest) and the [API reference](https://atom.io/docs/api).
|