📣 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
kamontat abaf1e76e1 update 2017-07-15 21:38:10 +07:00
.github Create no-response.yml 2017-05-27 19:07:52 -03:00
appveyor See #375. Add Python, Pip, autopep8 installation to AppVeyor 2015-05-30 22:32:54 -03:00
docs Add goimports beautifier for Go language 2017-06-20 01:27:36 +00:00
examples Fixes #1725. Improve PHP-CS-Fixer support with handling script path 2017-06-19 02:36:42 -03:00
keymaps Closes #178. Change commands' namespace from "beautify" to "atom-beautify" 2015-05-06 13:00:51 -03:00
menus See #213. Disable `Beautify Directory` command from menus 2015-06-11 21:58:43 -03:00
script Switch elm-format to using Executables 2017-06-04 02:43:02 -03:00
spec Improve command not found error message 2017-06-21 22:42:57 -03:00
src Merge branch 'master' of github.com:Glavin001/atom-beautify 2017-07-14 09:39:53 -03:00
styles Fix incorrectly named directory for Stylesheets. 2015-02-02 12:42:33 -04:00
.codeclimate.yml Update and rename codeclimate.yml to .codeclimate.yml 2017-02-09 12:08:19 -05:00
.codoopts See #596. Add source code documentation to docs/code/ 2016-03-03 20:24:13 -04:00
.csscomb.json Closes #209. Add CSScomb beautifier for CSS/LESS/SCSS/Sass languages. 2015-05-03 01:01:33 -03:00
.gitignore Fixes #1601 and #1598. Remove src/options.json from gitignore 2017-04-15 22:00:49 -03:00
.jshintrc Closes #47. Switch Analytics from Google Analytics to Segment.io 2014-08-03 16:12:07 -04:00
.mention-bot Add package.json to mention-bot file blacklist 2016-03-03 18:54:03 -04:00
.npmignore See #596. Add source code documentation to docs/code/ 2016-03-03 20:24:13 -04:00
.travis.yml Switch Atom Beta build from Mac to Linux for Travis CI 2017-06-21 21:33:06 -03:00
CHANGELOG.md update CHANGELOG and package.json 2017-07-15 21:33:22 +07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2017-06-15 17:30:25 -03:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-01-11 10:42:15 -04:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md 2017-01-11 10:40:51 -04:00
LICENSE.md See #282. Update README for new options and language requirements 2015-05-02 20:25:04 -03:00
PULL_REQUEST_TEMPLATE.md Update changelog 2017-05-06 16:52:19 -03:00
README-template.md See #1687. Update README, remove note about Executables now that it is supported 2017-06-17 16:21:37 -03:00
README.md See #1726. Add Docker image for goimports executable 2017-06-21 21:30:17 -03:00
ROADMAP.md Add very rough ROADMAP 2016-08-26 01:32:43 -03:00
appveyor.yml Update uncrustify install for AppVeyor 2017-06-11 16:40:36 -03:00
build-package.sh Update Travis CI scripts and config 2016-05-14 13:53:15 -03:00
coffeelint.json Beautify all src/ files to pass linting with Coffeelint 2015-06-11 22:57:03 -03:00
package.json update 2017-07-15 21:38:10 +07:00

README.md

💄 atom-beautify

Greenkeeper badge GitHub issues GitHub stars Gitter Bountysource Paypal Donations

Mac OS and
Travis CI: Travis branch AppVeyor: AppVeyor branch

Throughput Graph

Beautify HTML, CSS, JavaScript, PHP, Python, Ruby, Java, C, C++, C#, Objective-C, CoffeeScript, TypeScript, Coldfusion, SQL, and more in Atom

Before After
Original HTML Beautified HTML
image image

Table of Contents

Installation

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

apm install atom-beautify

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

Important Notice: Analytics

Atom-Beautify respects the core.telemetryConsent configuration option from Atom editor. If you do not wish to have usage data sent to Google Analytics then please set core.telemetryConsent to no or undecided option before using Atom-Beautify. See Anonymous Analytics section of docs for details. Thank you.

On Atom Load Change Setting Later
image image

Next Version: Unibeautify

Atom-Beautify is going to be completely rewritten with Unibeautify at its core! See unibeautify branch for work in progress and Issue #1174.

Beautifiers

Some of the supported beautifiers are developed for Node.js and are automatically installed when Atom-Beautify is installed. However, other beautifiers are command-line interface (CLI) applications and require you to manually install them.

Beautifier Preinstalled 🐳 Docker Installation
align-yaml 👌 Not necessary 😃 Nothing!
autopep8 ⚠️ 2 executables ⚠️ Only 1 of 2 executables 🐳 With Docker:
1. Install autopep8 (autopep8) with docker pull unibeautify/autopep8

📑 Manually:
1. Install autopep8 (autopep8) by following https://github.com/hhatto/autopep8#installation
2. Install isort (isort) by following https://github.com/timothycrosley/isort#installing-isort
beautysh ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install beautysh (beautysh) with docker pull unibeautify/beautysh

📑 Manually:
1. Install beautysh (beautysh) by following https://github.com/bemeurer/beautysh#installation
clang-format ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install ClangFormat (clang-format) with docker pull unibeautify/clang-format

📑 Manually:
1. Install ClangFormat (clang-format) by following https://clang.llvm.org/docs/ClangFormat.html
cljfmt 👌 Not necessary 😃 Nothing!
Coffee Formatter 👌 Not necessary 😃 Nothing!
coffee-fmt 👌 Not necessary 😃 Nothing!
Crystal ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install Crystal (crystal) with docker pull unibeautify/crystal

📑 Manually:
1. Install Crystal (crystal) by following https://crystal-lang.org/docs/installation/
CSScomb 👌 Not necessary 😃 Nothing!
dfmt ⚠️ 1 executable No Docker support 📑 Manually:
1. Install Dfmt (dfmt) by following https://github.com/dlang-community/dfmt#building
elm-format ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install elm-format (elm-format) with docker pull unibeautify/elm-format

📑 Manually:
1. Install elm-format (elm-format) by following https://github.com/avh4/elm-format#installation-
erl_tidy ⚠️ Manual installation 🚧 Not an executable 📄 Go to http://erlang.org/doc/man/erl_tidy.html and follow the instructions.
ESLint Fixer 👌 Not necessary 😃 Nothing!
formatR ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install Rscript (rscript) with docker pull unibeautify/rscript

📑 Manually:
1. Install Rscript (rscript) by following https://github.com/yihui/formatR
Fortran Beautifier ⚠️ 1 executable No Docker support 📑 Manually:
1. Install Emacs (emacs) by following https://www.gnu.org/software/emacs/
Gherkin formatter 👌 Not necessary 😃 Nothing!
gofmt ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://golang.org/cmd/gofmt/ and follow the instructions.
goimports ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install goimports (goimports) with docker pull unibeautify/goimports

📑 Manually:
1. Install goimports (goimports) by following https://godoc.org/golang.org/x/tools/cmd/goimports
hh_format ⚠️ Manual installation 🚧 Not an executable 📄 Go to http://hhvm.com/ and follow the instructions.
HTML Beautifier ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/threedaymonk/htmlbeautifier and follow the instructions.
JS Beautify 👌 Not necessary 😃 Nothing!
JSCS Fixer 👌 Not necessary 😃 Nothing!
Latex Beautify ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/cmhughes/latexindent.pl and follow the instructions.
Lua beautifier 👌 Not necessary 😃 Nothing!
Marko Beautifier 👌 Not necessary 😃 Nothing!
Nginx Beautify 👌 Not necessary 😃 Nothing!
ocp-indent ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://www.typerex.org/ocp-indent.html and follow the instructions.
Perltidy ⚠️ Manual installation 🚧 Not an executable 📄 Go to http://perltidy.sourceforge.net/ and follow the instructions.
PHP-CS-Fixer ⚠️ 2 executables ⚠️ Only 1 of 2 executables 🐳 With Docker:
1. Install PHP-CS-Fixer (php-cs-fixer) with docker pull unibeautify/php-cs-fixer

📑 Manually:
1. Install PHP (php) by following http://php.net/manual/en/install.php
2. Install PHP-CS-Fixer (php-cs-fixer) by following https://github.com/FriendsOfPHP/PHP-CS-Fixer#installation
PHPCBF ⚠️ 2 executables ⚠️ Only 1 of 2 executables 🐳 With Docker:
1. Install PHPCBF (phpcbf) with docker pull unibeautify/phpcbf

📑 Manually:
1. Install PHP (php) by following http://php.net/manual/en/install.php
2. Install PHPCBF (phpcbf) by following https://github.com/squizlabs/PHP_CodeSniffer#installation
Pretty Diff 👌 Not necessary 😃 Nothing!
Pug Beautify 👌 Not necessary 😃 Nothing!
puppet-lint ⚠️ Manual installation 🚧 Not an executable 📄 Go to http://puppet-lint.com/ and follow the instructions.
pybeautifier ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/guyskk/pybeautifier and follow the instructions.
Remark 👌 Not necessary 😃 Nothing!
Rubocop ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/bbatsov/rubocop and follow the instructions.
Ruby Beautify ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/erniebrodeur/ruby-beautify and follow the instructions.
rustfmt ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/nrc/rustfmt and follow the instructions.
SassConvert ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install SassConvert (sass-convert) with docker pull unibeautify/sass-convert

📑 Manually:
1. Install SassConvert (sass-convert) by following http://sass-lang.com/documentation/file.SASS_REFERENCE.html#syntax
sqlformat ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/andialbrecht/sqlparse and follow the instructions.
stylish-haskell ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/jaspervdj/stylish-haskell and follow the instructions.
Tidy Markdown 👌 Not necessary 😃 Nothing!
TypeScript Formatter 👌 Not necessary 😃 Nothing!
Uncrustify ⚠️ 1 executable 💯% of executables 🐳 With Docker:
1. Install Uncrustify (uncrustify) with docker pull unibeautify/uncrustify

📑 Manually:
1. Install Uncrustify (uncrustify) by following https://github.com/uncrustify/uncrustify
Vue Beautifier 👌 Not necessary 😃 Nothing!
yapf ⚠️ Manual installation 🚧 Not an executable 📄 Go to https://github.com/google/yapf and follow the instructions.

Language Support

See all supported options in the documentation at docs/options.md.

Language Grammars File Extensions Supported Beautifiers
Apex Apex .cls, .trigger Uncrustify
Arduino Arduino .ino, .pde Uncrustify
Bash Shell Script .bash, .sh beautysh
C C, opencl .h, .c, .cl Uncrustify, clang-format
Coldfusion html .cfm, .cfml, .cfc Pretty Diff
Clojure Clojure .clj, .cljs, .edn cljfmt
CoffeeScript CoffeeScript .coffee coffee-fmt, Coffee Formatter
C++ C++ .h, .hh, .cc, .cpp, .cxx, .C, .cu, .c++, .hpp, .hxx, .h++, .cuh Uncrustify, clang-format
Crystal Crystal .cr Crystal
C# C# .cs Uncrustify
CSS CSS .css JS Beautify, CSScomb, Pretty Diff, SassConvert
CSV CSV .csv Pretty Diff
D D .d Uncrustify, dfmt
EJS EJS, JavaScript Template, HTML (Angular) .ejs JS Beautify, Pretty Diff
Elm Elm .elm elm-format
ERB HTML (Ruby - ERB), HTML (Rails) .erb Pretty Diff, HTML Beautifier
Erlang Erlang .erl erl_tidy
Fortran Fortran - Modern .f90, .F90, .f95, .F95, .f03, .F03, .f08, .F08 Fortran Beautifier
gherkin Gherkin .feature Gherkin formatter
GLSL C, opencl, GLSL .vert, .frag clang-format
Go Go .go gofmt, goimports
Golang Template HTML (Go), Go Template .gohtml Pretty Diff
Handlebars Handlebars, HTML (Handlebars) .hbs, .handlebars JS Beautify, Pretty Diff
Haskell Haskell .hs stylish-haskell
HTML HTML .html JS Beautify, Pretty Diff
Jade Jade, Pug .jade, .pug Pug Beautify
Java Java .java Uncrustify
JavaScript JavaScript .js JS Beautify, ESLint Fixer, JSCS Fixer, Pretty Diff
JSON JSON .json JS Beautify, Pretty Diff
JSX JSX, JavaScript (JSX), Babel ES6 JavaScript, JavaScript with JSX .jsx, .js Pretty Diff, JS Beautify
LaTeX BibTeX, LaTeX, TeX .bib, .tex, .sty, .cls, .dtx, .ins, .bbx, .cbx Latex Beautify
LESS LESS .less Pretty Diff, CSScomb
Lua Lua .lua Lua beautifier
Markdown GitHub Markdown .markdown, .md Tidy Markdown, Remark
Marko Marko .marko Marko Beautifier
Mustache HTML (Mustache) .mustache JS Beautify, Pretty Diff
Nginx nginx .conf Nginx Beautify
Nunjucks Nunjucks, Nunjucks Templates, HTML (Nunjucks Templates) .njk, .nunjucks Pretty Diff
Objective-C Objective-C, Objective-C++ .m, .mm, .h Uncrustify, clang-format
OCaml OCaml .ml ocp-indent
Pawn Pawn Uncrustify
Perl Perl, Perl 6 .pl, .PL, .pm, .pod, .t Perltidy
PHP PHP .php, .module, .inc PHP-CS-Fixer, PHPCBF, hh_format
Puppet Puppet .pp puppet-lint
Python Python .py autopep8, pybeautifier, yapf
R R .r, .R formatR
Riot.js Riot.js, HTML (Riot Tag) .tag Pretty Diff
Ruby Ruby, Ruby on Rails .rb Rubocop, Ruby Beautify
Rust Rust .rs, .rlib rustfmt
Sass Sass .sass SassConvert
SCSS SCSS .scss Pretty Diff, CSScomb, SassConvert
Spacebars Spacebars Pretty Diff
SQL SQL (Rails), SQL .sql sqlformat
SVG SVG .svg Pretty Diff
Swig HTML (Swig), SWIG .swig Pretty Diff
TSS TSS .tss Pretty Diff
Twig HTML (Twig) .twig Pretty Diff
TypeScript TypeScript .ts TypeScript Formatter
UX Markup UX .ux Pretty Diff
Vala Vala .vala, .vapi Uncrustify
Visualforce Visualforce .page Pretty Diff
Vue Vue Component .vue Vue Beautifier
XML SLD, XML, XHTML, XSD, XSL, JSP, GSP .sld, .xml, .xhtml, .xsd, .xsl, .jsp, .gsp, .plist, .recipe, .config Pretty Diff, JS Beautify
XTemplate XTemplate .xtemplate Pretty Diff
YAML YAML .yml, .yaml align-yaml

Usage

Command Palette

Open the Command Palette, type Beautify, and run Beautify Editor.

image

Beautify a Specific Language

You can use the Command Palette to beautify the editor for a specific language. The commands are in the form Atom Beautify: Beautify Language {NAME} (i.e. atom-beautify:beautify-language-{NAME} for keyboard shortcuts). For example, you may want to beautify JavaScript code within a HTML file.

atom-beautify-language-commands

Selection of Code

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

Selection of Code Beautify Selection of Code Beautify Entire File
Select code in Atom editor Only that selection is beautified Without a selection all code is beautified
image image image

Beautify On Save

Beautify On Save can be enabled for each language individually.

For example, for language HTML go into Atom-Beautify's package settings (AtomPreferences ➔ Search for atom-beautify), find HTML, and toggle the Beautify On Save option.

atom-beautify-setup-beautify-on-save

Keyboard 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'

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 ways inside examples/

See all supported options in the documentation at docs/options.md.

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
}

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
  }
}

Troubleshooting

See docs/troubleshooting.md.

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