[IDE] Getting started with Atom

Discussion for ongoing CM development. Visible to Donors.
Post Reply
User avatar
Rahlzel
Donor
Donor
Posts: 1160
Joined: 14 Dec 2014, 16:17
Location: USA

[IDE] Getting started with Atom

Post by Rahlzel » 15 Jan 2016, 01:31

Atom is a text editor made by the creators of Github, and it's starting to gain a lot of momentum. Though a common complaint is that it's not as fast as Sublime Text or Notepad++, it's versatile, extensible, clean, feature-rich, and has built-in Github integration:

Image

I'm able to open a project, do some work, and then compile it immediately and directly from within Atom instead of needing to switch over to Dream Maker. I can also set a sound to make it beep when it's done compiling. For those of us that compile frequently (read: all of us), having a notification sound can be extremely handy.

Here's how to get it working:
  1. Download and install Atom
  2. At the starting screen (Welcome Guide), click "Install a Package" and then "Open Installer"
  3. Search for the package named "Build" and install it
  4. Place a .atom-build.json file inside your repository's root directory (beside the .dme)
  5. Fill it with the following:

Code: Select all

{
  "cmd": "C:/path/to/Byond/bin/dm.exe",
  "args": [ "C:/path/to/ColonialMarinesALPHA/ColonialMarinesALPHA.dme" ],
  "sh": false,
  "errorMatch": [
        "\n(?<file>[\\\\\/0-9a-zA-Z\\._]+):(?<line>\\d+).*"
    ]
}
To get Atom to beep when it's done compiling (it's off by default):
File > Settings > Packages > "build" package settings >
Image

Make sure to restart Atom. It will pick up on the .json right away:

Image

Hit F9 to build the project and test it.

For compile errors, press F4 to scroll through them, opening each file on the line number that failed so you can fix it quickly.

Other useful packages

User avatar
Rahlzel
Donor
Donor
Posts: 1160
Joined: 14 Dec 2014, 16:17
Location: USA

Re: [Code] Getting started with Atom - A better IDE

Post by Rahlzel » 20 Jan 2016, 12:55

Updated the .atom-build.json with error hyperlinking to quickly jump to file+line number of error.

User avatar
Rahlzel
Donor
Donor
Posts: 1160
Joined: 14 Dec 2014, 16:17
Location: USA

Re: [Code] Getting started with Atom - A better IDE

Post by Rahlzel » 25 Jul 2016, 23:41

Topic revamped to include all of my current packages and some new instruction about how to turn on the beep sound when compiling is done.

If you're using the "language-dm" package, get rid of it. "atomic-dreams" is much better.

Post Reply