Update the tooling page to include pyReact, react-rails and react-page
Vjeux committed
Aug 26, 2013 at 23:00 UTC
a90c463abe9b280207623a34c7389b35ff347c15
1 file changed
+15
-7
docs/docs/08-tooling-integration.md
+15
-7
@@ -9,18 +9,20 @@ next: reference.html
9
10
Every project uses a different system for building and deploying JavaScript. We've tried to make React as environment-agnostic as possible.
11
12
+## React
13
13
-## CDN-hosted React
14
+### CDN-hosted React
15
16
We provide CDN-hosted versions of React [on our download page](/react/downloads.html). These prebuilt files use the UMD module format. Dropping them in with a simple `<script>` tag will inject a `React` global into your environment. It should also work out-of-the-box in CommonJS and AMD environments.
17
18
18
-## Using master
19
+### Using master
20
21
We have instructions for building from `master` [in our GitHub repository](https://github.com/facebook/react). We build a tree of CommonJS modules under `build/modules` which you can drop into any environment or packaging tool that supports CommonJS.
22
23
+## JSX
24
23
-## In-browser JSX Transform
25
+### In-browser JSX Transform
26
27
If you like using JSX, we provide an in-browser JSX transformer for development [on our download page](/react/downloads.html). Simply include a `<script type="text/jsx">` tag to engage the JSX transformer. Be sure to include the `/** @jsx React.DOM */` comment as well, otherwise the transformer will not run the transforms.
28
@@ -29,16 +31,22 @@ If you like using JSX, we provide an in-browser JSX transformer for development
31
> The in-browser JSX transformer is fairly large and results in extraneous computation client-side that can be avoided. Do not use it in production — see the next section.
32
33
32
-## Productionizing: Precompiled JSX
34
+### Productionizing: Precompiled JSX
35
36
If you have [npm](http://npmjs.org/), you can simply run `npm install -g react-tools` to install our command-line `jsx` tool. This tool will translate files that use JSX syntax to plain JavaScript files that can run directly in the browser. It will also watch directories for you and automatically transform files when they are changed; for example: `jsx --watch src/ build/`. Run `jsx --help` for more information on how to use this tool.
37
38
37
-## Helpful Open-Source Projects
39
+### Helpful Open-Source Projects
40
41
The open-source community has built tools that integrate JSX with several build systems.
42
41
-* [reactify](https://github.com/andreypopp/reactify) - use JSX with [browserify](http://browserify.org/).
43
+* [reactify](https://github.com/andreypopp/reactify) - use JSX with [browserify](http://browserify.org/)
44
* [grunt-react](https://github.com/ericclemmons/grunt-react) - [grunt](http://gruntjs.com/) task for JSX
45
* [require-jsx](https://github.com/seiffert/require-jsx) - use JSX with [require.js](http://requirejs.org/)
44
-* [reactapp](https://github.com/jordwalke/reactapp) - a sample project to get up-and-running with React quickly
46
+* [pyReact](https://github.com/facebook/react-python) - use JSX with [Python](http://www.python.org/)
47
+* [react-rails](https://github.com/facebook/react-rails) - use JSX with [Ruby on Rails](http://rubyonrails.org/)
48
+
49
+
50
+## React Page
51
+
52
+To get started on a new project, you can use [react-page](https://github.com/facebook/react-page/), a complete React project creator. It supports both server-side and client-side rendering, source transform and packaging JSX files using CommonJS modules, and instant reload.