newsdev / ai2html

A script for Adobe Illustrator that converts your Illustrator artwork into an html page.
http://ai2html.org
Other
897 stars 145 forks source link

Linting and code styles #110

Open zzolo opened 5 years ago

zzolo commented 5 years ago

Wonderful project, thanks so much for sharing with the world.

This pull requests adds some linting and code style consistency support, which, for neurotic people like me, makes it easier to contribute. I think code styles are great, but I don't want to be preachy about it.

This adds two things:

  1. eslint which will enforce code style while helping to identify errors.
    • Configuration is managed in .eslintrc.json. It builds off the recommended linting from the eslint module, and adds just a couple differences that I think align with the current styles.
    • It also adds an es5 plugin, as I think Illustrator uses an older version of a Javascript engine, but I can't find very definitive documentation about this.
    • Basic checking can be done with npm run lint, which will lint the main ai2html.js and the JS files in tests/.
    • You can also fix in place with npm run lintFix. This will update the files, but will also error, as there are some code that just needs to be updated to pass.
  2. editorconfig which is a low-level configuration around code editors. The main thing it does that is helpful is define spacing, such as two spaces (vs. tabs). See below for how this can be very helpful.

Future considerations

mbloch commented 5 years ago

Hi, thanks for this contribution! I'll try to review it soon. Meanwhile, I'm interested in whether you've been using ai2html at the Star Tribune. It sounds like you're interested in contributing, do you have some thoughts about improving the tool, other than coding style? Cheers, mbloch