atom-config

These (power)shell scripts let the Plain Plain Text community install popular and useful packages to Atom, the hackable text editor. It also changes the configuration file to enable autosave, which is disabled by default in Atom.

Installation and Usage

These instructions presume that you have Atom already installed.

MacOS

1. Ensure apm is installed, by opening Atom, going to the “Atom” menu, and choosing “Install Shell Commands.” Do so (typing in your password when prompted) until you see “The shell commands atom and apm are installed.”
2. Save the file atom-setup.sh as a file to your desktop.
3. Open up Terminal.app (located in Applications/Utilities)
4. In Terminal.app, type in: sh ~/Desktop/setup-atom.sh and hit “return.”

Linux

Just like the MacOS instructions, more or less. For now.

Windows

1. Save atom-setup.ps1 as a file to your desktop by right-clicking on the link and choosing “Save Link As...”
2. Right click on the file and choose “Run with PowerShell” in the drop-down menu.
3. Several screens will popup and then disappear, suggesting the process has executed.

If you do not see the “Run with PowerShell” command or get an error about a “PSSecurityException,”:

1. Open the DOS prompt by typing “cmd” in the search window in the taskbar or Start Menu. Choose the first result.
2. Type in powershell -ExecutionPolicy Unrestricted and hit “Enter.” The prompt (the part ending in >) should change and have a PS at the start.
3. Type ~\Desktop\setup-atom.ps1 and hit “Enter.”
4. A warning about running scripts will appear. Type r for “Run Once” and hit “Enter.”
5. Several windows will popup and disappear, suggesting the process has executed.

Packages

Usability Packages

• file-icons: Adds pretty icons
• platformio-ide-terminal: Creates interactive shells executing scripts within atom.
• wordcount: Adds a wordcount report

Linting Packages

Linter is a package that helps find errors in code or syntax in Atom. You can add additional linter layers above it for whatever language or markup you are using. We offer a few base linter languages that the Plain Plain Text community is likely to need.

• linter: The base package

• busy-signal: A dependency

• intentions: A dependency

• linter-ui-default: A dependency

• linter-markdown: Markdown

• linter-js-yaml: YAML

• linter-eslint: ESLint for JavaScript

• linter-ruby: Ruby

• linter-pylint: Pylint for Python

Configuration

For the time being, our shell scripts only make one configuration change. They enable autosave, which is disabled by default.