Auto merge of #4457 - behnam:book-pub, r=alexcrichton

[doc] Publish book to gh-pages

Export mdBook into `target/doc/book/`, to make it accessible at <http://doc.crates.io/book/>

I have tested the changes on my repo (but when I had this commit on top of the other PR) locally. The result is at <http://code.behnam.es/rust-cargo/book/>.

Tracker: <#4040>

Author: bors

.travis.yml

@@ -21,6 +21,8 @@ matrix:
     - env: TARGET=x86_64-unknown-linux-gnu
            ALT=i686-unknown-linux-gnu
       rust: nightly
+      install:
+        - cargo install mdbook
       script:
         - cargo test
         - cargo doc --no-deps
@@ -31,7 +33,7 @@ matrix:
         [ $(uname -s) = Linux ] &&
         pip install ghp-import --user &&
         $HOME/.local/bin/ghp-import -n target/doc &&
-        git push -qf https://${GH_TOKEN}@github.com/${TRAVIS_REPO_SLUG}.git gh-pages 2>&1 > /dev/null
+        git push -qf https://${GH_TOKEN}@github.com/${TRAVIS_REPO_SLUG}.git gh-pages 2>&1 >/dev/null
 
   exclude:
     - rust: stable

src/ci/dox.sh

@@ -26,3 +26,8 @@ for doc in $DOCS; do
     -o target/doc \
     src/doc/$doc.md
 done
+
+# Temporary preview for mdBook docs
+cd src/doc/book
+$HOME/.cargo/bin/mdbook build --no-create --dest-dir ../../../target/doc/book
+cd ../../../

src/doc/MIGRATION_MAP

@@ -2,7 +2,7 @@ index.md book/src/SUMMARY.md book/src/getting-started.md book/src/getting-starte
 guide.md book/src/guide.md book/src/guide/*.md
 build-script.md book/src/reference/build-scripts.md
 config.md book/src/reference/config.md
-crates-io.md book/src/reference/crates-io.md
+crates-io.md book/src/reference/publishing.md
 environment-variables.md book/src/reference/environment-variables.md
 external-tools.md book/src/reference/external-tools.md
 manifest.md book/src/reference/manifest.md

src/doc/book/src/SUMMARY.md

@@ -22,7 +22,7 @@
     * [Configuration](reference/config.md)
     * [Environment Variables](reference/environment-variables.md)
     * [Build Scripts](reference/build-scripts.md)
-    * [Publishing on crates.io](reference/crates-io.md)
+    * [Publishing on crates.io](reference/publishing.md)
     * [Package ID Specifications](reference/pkgid-spec.md)
     * [Source Replacement](reference/source-replacement.md)
     * [External Tools](reference/external-tools.md)

src/doc/book/src/reference.md

@@ -10,7 +10,7 @@ The reference covers the details of various areas of Cargo.
 * [Configuration](reference/config.html)
 * [Environment Variables](reference/environment-variables.html)
 * [Build Scripts](reference/build-scripts.html)
-* [Publishing on crates.io](reference/crates-io.html)
+* [Publishing on crates.io](reference/publishing.html)
 * [Package ID Specifications](reference/pkgid-spec.html)
 * [Source Replacement](reference/source-replacement.html)
 * [External Tools](reference/external-tools.html)

src/doc/book/src/reference/crates-io.md renamed to src/doc/book/src/reference/publishing.md

@@ -1,5 +1,7 @@
 % Cargo, Rust’s Package Manager
 
+# Installing
+
 ### Install Stable Rust and Cargo
 
 The easiest way to get Cargo is to get the current stable release of [Rust] by