Beautify: Difference between revisions

Line 1:

Code is sometimes ugly. You want to make it look pretty. [http://jsbeautifier.org/ JS-beautify] is one such tool.

For PHP, JavaScript and CSS, '''[https://github.com/PHPCSStandards/PHP_CodeSniffer PHP Code Sniffer]''' (phpcs) and its counterpart PHP Code Beautifier (phpcbf) work to ensure your code adheres to standards. ~~For using phpcs in MediaWiki, see [[mw:Manual:Coding_conventions/~~PHP~~]]. PHPCS~~ is ~~enabled in ~89% of repositories hosted by WMF<ref>https://phpcs.toolforge.org/</ref> '''[~~https://github.com/~~wikimedia~~/~~mediawiki-tools-codesniffer MediaWiki Code Sniffer]''' is the set of rules (or ruleset to be more precise) that defines the standards for the MediaWiki project.~~

For [[PHP]], [[JavaScript]] and [[CSS]], '''[https://github.com/PHPCSStandards/PHP_CodeSniffer PHP Code Sniffer]''' (<code>phpcs</code>) and its counterpart '''PHP Code Beautifier''' (<code>phpcbf</code>) work to ensure your code adheres to standards. Project Documentation for PHP CodeSniffer is at https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki

~~Suffice it to say~~, ~~you can~~ <~~code~~>~~composer~~ phpcs</~~code~~> to ~~run~~ the ~~tool from~~ the project ~~root~~. ~~For more on how to run it, see [[mw:Continuous_integration/PHP_CodeSniffer]]~~

For using phpcs in MediaWiki, see [[mw:Manual:Coding_conventions/PHP|Manual:Coding_conventions/PHP]]. phpcs is enabled in ~89% of repositories hosted by WMF<ref>https://phpcs.toolforge.org/</ref> '''[https://github.com/wikimedia/mediawiki-tools-codesniffer MediaWiki Code Sniffer]''' is the '''set of rules''' (or ruleset to be more precise) that defines the standards for the MediaWiki project.

~~Project Documentation for PHP_CodeSniffer is at https:/~~/~~github~~.~~com~~/~~PHPCSStandards~~/PHP_CodeSniffer~~/wiki~~

You can <code>composer phpcs</code> to run the tool from the project root. For more on how to run it, see [[mw:Continuous_integration/PHP_CodeSniffer|Continuous_integration/PHP_CodeSniffer]]

You can list the standards available in the MediaWiki project using the -i option. The standard you want to enforce/use is ''''MediaWiki'''<nowiki/>'

You can list the standards available in the MediaWiki project using the <code>-i</code> option. The standard you want to enforce/use is ''''MediaWiki'''<nowiki/>'

<code>php ./vendor/bin/phpcs -i</code>

The installed coding standards are MySource, PEAR, PSR1, PSR2, PSR12, Squiz, Zend, MediaWiki, Modernize, NormalizedArrays, Universal and PHPCSUtils

<poem>

The installed coding standards are

MySource,

PEAR,

PSR1,

PSR2,

PSR12,

Squiz,

Zend,

'''MediaWiki''',

Modernize,

NormalizedArrays,

Universal and

PHPCSUtils

</poem>

== Configuration ==

@@ Line 1: / Line 1: @@
 Code is sometimes ugly.  You want to make it look pretty.  [http://jsbeautifier.org/ JS-beautify] is one such tool.
-For PHP, JavaScript and CSS, '''[https://github.com/PHPCSStandards/PHP_CodeSniffer PHP Code Sniffer]''' (phpcs) and its counterpart PHP Code Beautifier (phpcbf) work to ensure your code adheres to standards. For using phpcs in MediaWiki, see [[mw:Manual:Coding_conventions/PHP]]. PHPCS is enabled in ~89% of repositories hosted by WMF<ref>https://phpcs.toolforge.org/</ref>  '''[https://github.com/wikimedia/mediawiki-tools-codesniffer MediaWiki Code Sniffer]''' is the set of rules (or ruleset to be more precise) that defines the standards for the MediaWiki project.
+For [[PHP]], [[JavaScript]] and [[CSS]], '''[https://github.com/PHPCSStandards/PHP_CodeSniffer PHP Code Sniffer]''' (<code>phpcs</code>) and its counterpart '''PHP Code Beautifier''' (<code>phpcbf</code>) work to ensure your code adheres to standards. Project Documentation for PHP CodeSniffer is at https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki
-Suffice it to say, you can <code>composer phpcs</code> to run the tool from the project root. For more on how to run it, see [[mw:Continuous_integration/PHP_CodeSniffer]]
+For using phpcs in MediaWiki, see [[mw:Manual:Coding_conventions/PHP|Manual:Coding_conventions/PHP]]. phpcs is enabled in ~89% of repositories hosted by WMF<ref>https://phpcs.toolforge.org/</ref>  '''[https://github.com/wikimedia/mediawiki-tools-codesniffer MediaWiki Code Sniffer]''' is the '''set of rules''' (or ruleset to be more precise) that defines the standards for the MediaWiki project.
-Project Documentation for PHP_CodeSniffer is at https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki
+You can <code>composer phpcs</code> to run the tool from the project root. For more on how to run it, see [[mw:Continuous_integration/PHP_CodeSniffer|Continuous_integration/PHP_CodeSniffer]]
-You can list the standards available in the MediaWiki project using the -i option. The standard you want to enforce/use is ''''MediaWiki'''<nowiki/>'
+You can list the standards available in the MediaWiki project using the <code>-i</code> option. The standard you want to enforce/use is ''''MediaWiki'''<nowiki/>'
 <code>php ./vendor/bin/phpcs -i</code>
- The installed coding standards are MySource, PEAR, PSR1, PSR2, PSR12, Squiz, Zend, MediaWiki, Modernize, NormalizedArrays, Universal and PHPCSUtils
+<poem>
+The installed coding standards are
+MySource,
+PEAR,
+PSR1,
+PSR2,
+PSR12,
+Squiz,
+Zend,
+'''MediaWiki''',
+Modernize,
+NormalizedArrays,
+Universal and
+PHPCSUtils
+</poem>
 == Configuration ==