📣 Help Wanted - Looking for Maintainer: https://github.com/Glavin001/atom-beautify/issues/2572 | 💄 Universal beautification package for Atom editor (⚠️ Currently migrating to https://github.com/Unibeautify/ and have very limited bandwidth for Atom-Beautify Issues. Thank you for your patience and understanding ❤️ )
Go to file
Glavin Wiechert bae891091e See #375. Add Python, Pip, autopep8 installation to AppVeyor 2015-05-30 22:32:54 -03:00
appveyor See #375. Add Python, Pip, autopep8 installation to AppVeyor 2015-05-30 22:32:54 -03:00
examples Fixes #370. Nest EditorConfig options under _default namespace 2015-05-28 12:01:24 -03:00
keymaps Closes #178. Change commands' namespace from "beautify" to "atom-beautify" 2015-05-06 13:00:51 -03:00
menus Closes #178. Change commands' namespace from "beautify" to "atom-beautify" 2015-05-06 13:00:51 -03:00
spec Add check for when Language or Beautifier is not found in tests 2015-05-21 16:43:37 -03:00
src Fixes #370. Nest EditorConfig options under _default namespace 2015-05-28 12:01:24 -03:00
styles Fix incorrectly named directory for Stylesheets. 2015-02-02 12:42:33 -04:00
.csscomb.json Closes #209. Add CSScomb beautifier for CSS/LESS/SCSS/Sass languages. 2015-05-03 01:01:33 -03:00
.gitignore refactored package, added keymaps and menus 2014-03-04 08:07:45 +01:00
.jshintrc Closes #47. Switch Analytics from Google Analytics to Segment.io 2014-08-03 16:12:07 -04:00
.travis.yml Speed up Travis CI and run spec in Atom 1.0 preview mode 2015-05-28 14:57:26 -03:00
CHANGELOG.md Update CHANGELOG to v0.26.0 2015-05-03 02:07:57 -03:00
LICENSE.md See #282. Update README for new options and language requirements 2015-05-02 20:25:04 -03:00
README.md Closes #178. Change commands' namespace from "beautify" to "atom-beautify" 2015-05-06 13:00:51 -03:00
appveyor.yml See #375. Add Python, Pip, autopep8 installation to AppVeyor 2015-05-30 22:32:54 -03:00
build-package.sh Speed up Travis CI and run spec in Atom 1.0 preview mode 2015-05-28 14:57:26 -03:00
package.json Prepare 0.27.9 release 2015-05-28 12:03:36 -03:00

README.md

atom-beautify

Build Status Gitter chat donate

Beautify HTML (including Handlebars), CSS (including Sass and LESS), JavaScript, and much more in Atom.

Atom Package: https://atom.io/packages/atom-beautify

apm install atom-beautify

Or Settings/Preferences ➔ Packages ➔ Search for atom-beautify

Language Support

Usage

Open the Command Palette, and type Beautify.

It will only beautify selected text, if a selection is found - if not, the whole file will be beautified.

Shortcut

You can also type ctrl-alt-b as a shortcut or click Packages > Beautify in the menu.

Custom Keyboard Shortcuts

See Keymaps In-Depth for more details.

For example:

'.editor':
  'ctrl-alt-b': 'atom-beautify:beautify-editor'

Package Options

Each language and all of their respective beautifier's options are fully documented in Atom Beautify Package Settings Panel. There are much too many to document them all here. Here are a few key options that you may use:

  • beautifyOnSave (Default false) You can also choose to beautify on every file save.

  • beautifyEntireFileOnSave (Default true) Beautification will normally only beautify your selected text. However, when beautification occurs on save then it will be forced to beautify the entire file's contents, not just selected text.

  • muteUnsupportedLanguageErrors (Default false) Mute only unsupported language errors.

  • muteAllErrors (Default false) Do not show the Atom Beautify Error Messages panel for any of the errors occurring while beautifying.

  • analytics (Default true) There is Segment.io, which forwards the data to Google Analytics, to track what languages are being used the most and other stats. Everything is anonymized and no personal information, such as source code, is sent. See https://github.com/Glavin001/atom-beautify/issues/47 for more details.

Configuration

Edit your .jsbeautifyrc file in any of the following locations:

  • Atom Package Settings
    AtomPreferences ➔ Search for atom-beautify
  • Same directory as current file
  • Project root
    atom-beautify will recursively look up from the current file's directory to find .jsbeautifyrc.
  • Your User's Home directory

Note: Comments are supported in .jsbeautifyrc thanks to strip-json-comments.

See examples of both way inside examples/

Option table is available at the js-beautify repo.

Simple

See examples/simple-jsbeautifyrc/.jsbeautifyrc.

{
  "indent_size": 2,
  "indent_char": " ",
  "other": " ",
  "indent_level": 0,
  "indent_with_tabs": false,
  "preserve_newlines": true,
  "max_preserve_newlines": 2,
  "jslint_happy": true,
  "indent_handlebars": true
}

Nested

See examples/nested-jsbeautifyrc/.jsbeautifyrc.

{
  "html": {
    "brace_style": "collapse",
    "indent_char": " ",
    "indent_scripts": "normal",
    "indent_size": 6,
    "max_preserve_newlines": 1,
    "preserve_newlines": true,
    "unformatted": ["a", "sub", "sup", "b", "i", "u"],
    "wrap_line_length": 0
  },
  "css": {
    "indent_char": " ",
    "indent_size": 4
  },
  "js": {
    "indent_size": 2,
    "indent_char": " ",
    "indent_level": 0,
    "indent_with_tabs": false,
    "preserve_newlines": true,
    "max_preserve_newlines": 2,
    "jslint_happy": true
  },
  "sql": {
    "indent_size": 4,
    "indent_char": " ",
    "indent_level": 0,
    "indent_with_tabs": false
  }
}

Contributing

See all contributors on GitHub.

Please update the CHANGELOG.md, add yourself as a contributor to the package.json, and submit a Pull Request on GitHub.

License

MIT © Glavin Wiechert