A Community-led Hyper-Hackable Text Editor
Go to file
Nathan Sobo 106621e161 Deprecate automatic assignment of autoHeight for text editors
Previously, we attempted to automatically determine whether the editor’s
height should be based on the editor’s content or the height of its
container. Unfortunately, DOM APIs are insufficient to make this
determination in a complete way, leading to unpredictable behavior.

This PR deprecates the automatic determination of this behavior. By
default, editors base their height on their content. If an editor has
an explicit height assigned via its style or is positioned absolute with
an explicit top and bottom, we disable the content-based autoHeight and
log a deprecation warning telling the user to assign autoHeight
explicitly.

This paves the way to add an autoWidth setting, which will default to
false.
2016-08-17 15:52:51 -06:00
apm ⬆️ atom-package-manager to fix asar-require issues 2016-07-26 11:09:35 -06:00
build Restore all suites in spec-task.coffee 2016-08-12 12:08:45 -06:00
docs Update linux build instructions 2016-08-03 10:47:49 -06:00
dot-atom Replace OS X and Mac OS with macOS 2016-06-18 15:33:08 +02:00
exports Rewrite exports/atom.coffee as JS 2016-08-06 17:20:46 -07:00
keymaps Add Ctrl+F4 keybinding for Linux 2016-04-21 13:36:50 -07:00
menus #12386 Splitting panes using the menu gives me an empty panel 2016-08-12 14:40:37 +05:30
resources Merge pull request #11284 from jonmast/master 2016-08-06 09:06:34 -07:00
script Export ATOM_RESOURCE_PATH in Gruntfile.coffee if unset 2016-07-27 11:51:57 +02:00
spec Deprecate automatic assignment of autoHeight for text editors 2016-08-17 15:52:51 -06:00
src Deprecate automatic assignment of autoHeight for text editors 2016-08-17 15:52:51 -06:00
static Merge branch 'master' into brumm-master 2016-08-02 15:39:57 -06:00
vendor Allow elements to be passed to toContain matcher 2015-09-18 20:48:52 -06:00
.coffeelintignore Remove mentions of benchmarks from the build, command palette 2015-09-18 20:48:50 -06:00
.gitattributes Optimize bash Windows, force LF line endings 2016-05-16 13:01:10 -07:00
.gitignore add out/ to gitignore 2016-03-01 15:06:33 -08:00
.npmrc Try just setting the target? 2015-12-28 16:50:00 -05:00
.pairs Add Daniel to pairs file 2014-06-26 14:25:40 -07:00
.python-version use nodejs v0.10.33 and python 2.7.6 2014-12-08 21:40:31 +02:00
.travis.yml Revert "Revert "Use apm@1.12.2 with Node v4 and npm v3 \o/"" 2016-07-26 10:29:25 -06:00
appveyor.yml Revert "Revert "Use apm@1.12.2 with Node v4 and npm v3 \o/"" 2016-07-26 10:29:25 -06:00
atom.sh Make cli atom --wait work on Cygwin 2016-03-07 14:01:05 -08:00
CHANGELOG.md 🔥 CHANGELOG.md 2016-01-11 12:17:08 -05:00
circle.yml Fight the screen saver on CircleCI 2016-08-13 13:12:23 -06:00
CODE_OF_CONDUCT.md 📝 Update to v1.4 of Contributor Covenent Code of Conduct 2016-05-05 13:37:10 -07:00
coffeelint.json 🔥 Remove newlines_after_classes rule 2015-05-22 20:08:29 -04:00
CONTRIBUTING.md Update object spread guideline in JS styleguide [ci skip] 2016-08-06 17:25:36 -07:00
Dockerfile Revert "Revert "Use apm@1.12.2 with Node v4 and npm v3 \o/"" 2016-07-26 10:29:25 -06:00
ISSUE_TEMPLATE.md Correctly link the safe mode section 2016-07-21 14:49:16 +03:00
LICENSE.md Update license year to 2016 2016-01-16 13:21:11 +05:30
package.json Merge branch 'master' into ns-mb-detangle-editor 2016-08-15 11:17:07 -07:00
README.md Put back Travis badge for Linux build status 2016-07-27 10:29:37 +02:00

Atom

macOS Build Status Linux Build Status Windows Build Status Dependency Status Join the Atom Community on Slack

Atom is a hackable text editor for the 21st century, built on Electron, and based on everything we love about our favorite editors. We designed it to be deeply customizable, but still approachable using the default configuration.

Visit atom.io to learn more or visit the Atom forum.

Follow @AtomEditor on Twitter for important announcements.

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to atom@github.com.

Documentation

If you want to read about using Atom or developing packages in Atom, the Atom Flight Manual is free and available online. You can find the source to the manual in atom/flight-manual.atom.io.

The API reference for developing packages is also documented on Atom.io.

Installing

Prerequisites

macOS

Download the latest Atom release.

Atom will automatically update when a new release is available.

Windows

Download the latest AtomSetup.exe installer.

Atom will automatically update when a new release is available.

You can also download an atom-windows.zip file from the releases page. The .zip version will not automatically update.

Using chocolatey? Run cinst Atom to install the latest version of Atom.

Debian Linux (Ubuntu)

Currently only a 64-bit version is available.

  1. Download atom-amd64.deb from the Atom releases page.
  2. Run sudo dpkg --install atom-amd64.deb on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Red Hat Linux (Fedora 21 and under, CentOS, Red Hat)

Currently only a 64-bit version is available.

  1. Download atom.x86_64.rpm from the Atom releases page.
  2. Run sudo yum localinstall atom.x86_64.rpm on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Fedora 22+

Currently only a 64-bit version is available.

  1. Download atom.x86_64.rpm from the Atom releases page.
  2. Run sudo dnf install ./atom.x86_64.rpm on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Archive extraction

An archive is available for people who don't want to install atom as root.

This version enables you to install multiple Atom versions in parallel. It has been built on Ubuntu 64-bit, but should be compatible with other Linux distributions.

  1. Install dependencies (on Ubuntu): sudo apt install git gconf2 gconf-service libgtk2.0-0 libudev1 libgcrypt20 libnotify4 libxtst6 libnss3 python gvfs-bin xdg-utils libcap2
  2. Download atom-amd64.tar.gz from the Atom releases page.
  3. Run tar xf atom-amd64.tar.gz in the directory where you want to extract the Atom folder.
  4. Launch Atom using the installed atom command from the newly extracted directory.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Building