Once upon a midnight dreary, while I coded, weak and weary,

In many a strange and curious file of forgotten lore—
While I pondered, blaming Nacin, my notifications suddenly awakened,
As of someone quietly DMing;—DMing me, I can’t ignore.
“’Tis some contributor,” I muttered, “DMing me an idea or four—
            Only this and nothing more.”

Ah, distinctly I remember, at WordCamp US, last December;
A mad proposal nearly laid me—down out cold—upon the floor.
Curious, I listened closely;—to a plan I agreed with, mostly—
A way to make our JavaScript—JavaScript which was a chore—
Maintainable, extendable, for the future, is what I saw.
            Guten-ready for evermore.

Open here I switch to Slack, when, with many a patch and hack,
In there stepped Omar, a JavaScript developer hardcore;
Pronouncing all the changes fit; ready now to be commit;
“There’s nothing else for us to do,” DMing me, “It’s done!” he swore—
“No longer random guessing at which file need next be explored—
            Let’s move on, we’re all aboard.”

Moved all together, grouped and managed, in folders all is packaged,
The code had all been cleaned and tidied, important parts moved to the fore,
“Though this change be useful here,” I said, “it is too large, I fear,
We couldn’t manage such a patch, we’ve done nothing like this before—
Tell me where doth go this change, change to make our codebase soar!”
            Quoth Omar, “In WordPress Core.”

Props omarreis for shepherding this significant change.
Props adamsilverstein, aduth, atimmer, dingo_bastard, frank-klein, gziolo, herregroen, jaswrks, jeremyfelt, jipmoors, jorbin, netweb, ocean90, pento, tjnowell, and youknowriad for testing, feedback, discussion, encouragement, commiserations, etc.
I make no apologies for this commit message.
Fixes #43055.



git-svn-id: https://develop.svn.wordpress.org/trunk@43309 602fd350-edb4-49c9-b593-d223f7449a82

src/index.php

@@ -1,17 +1,49 @@
 <?php
-/**
- * Front to the WordPress application. This file doesn't do anything, but loads
- * wp-blog-header.php which does and tells WordPress to load the theme.
- *
- * @package WordPress
- */
 
 /**
- * Tells WordPress to load the WordPress theme and output it.
- *
- * @var bool
+ * Note: this file exists only to remind developers to run WordPress from the
+ * build directory. For the real index.php that gets built and boots WordPress,
+ * please refer to _index.php.
  */
-define( 'WP_USE_THEMES', true );
 
-/** Loads the WordPress Environment and Template */
-require( dirname( __FILE__ ) . '/wp-blog-header.php' );
+/** Define ABSPATH as this file's directory */
+if ( ! defined( 'ABSPATH' ) ) {
+	define( 'ABSPATH', dirname( __FILE__ ) . '/' );
+}
+
+define( 'WPINC', 'wp-includes' );
+require_once( ABSPATH . WPINC . '/load.php' );
+
+// Standardize $_SERVER variables across setups.
+wp_fix_server_vars();
+
+require_once( ABSPATH . WPINC . '/functions.php' );
+define( 'WP_CONTENT_DIR', ABSPATH . 'wp-content' );
+require_once( ABSPATH . WPINC . '/version.php' );
+
+wp_check_php_mysql_versions();
+wp_load_translations_early();
+
+// Die with an error message
+$die  = sprintf(
+		/* translators: %1$s: WordPress, %2$s: src, %3$s: build */
+			__( 'You seem to be running %1$s from the %2$s directory. %1$s needs to be built and run from the %3$s directory before we can get started.' ),
+			'WordPress',
+			'<code>src</code>',
+			'<code>build</code>'
+		) . '</p>';
+$die .= '<p>' . sprintf(
+	/* translators: %s: WordPress */
+		__( 'You can build %s by running:' ),
+		'WordPress'
+	) . '</p>';
+$die .= '<p><code>npm install && grunt build</code></p>';
+$die .= '<p>' . sprintf(
+	/* translators: %1$s: NPM URL, %2$s: Grunt URL */
+		__( 'This requires <a href="%1$s">NPM</a> and <a href="%2$s">Grunt</a>. <a href="%3$s">Read more about setting up your local development environment</a>.' ),
+		'https://www.npmjs.com/',
+		'https://gruntjs.com/',
+		__( 'https://codex.wordpress.org/' )
+	) . '</p>';
+
+wp_die( $die, __( 'WordPress &rsaquo; Error' ) );