aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/install.md
diff options
context:
space:
mode:
authorGravatar Googler <noreply@google.com>2015-04-30 21:38:04 +0000
committerGravatar Han-Wen Nienhuys <hanwen@google.com>2015-05-01 22:22:55 +0000
commit3fb27ca6770ba3239955ab7c37fad979d0df04e2 (patch)
tree4f0eaea74cf96950a3f87a0a6748e53d3aec8f59 /site/docs/install.md
parent59682ac224651eafb52c0804159c072ff2bd43ab (diff)
Improvements to bazel.io.
* Move sidebar nav on docs and community pages to left side so that the sidebar shows at the top of the page in mobile. Improve appearance of sidebar nav. * Highlight navbar link depending on current page. * Switch Markdown renderer to Redcarpet to enable Pygments highlighting of fenced code blocks (```python etc.) such as on Skylark Cookbook page. * Change ```build to ```python on Skylark cookbook page. * Minor aesthetic tweaks to Install page * Make style of Feedburner widget consistent with rest of page. * Remove use of site_root from layouts and pages since it is no longer necessary after kchodorow@ added JS to redirect from github.google.com/bazel to bazel.io -- MOS_MIGRATED_REVID=92494349
Diffstat (limited to 'site/docs/install.md')
-rw-r--r--site/docs/install.md120
1 files changed, 60 insertions, 60 deletions
diff --git a/site/docs/install.md b/site/docs/install.md
index 37775bcc05..cb4461238a 100644
--- a/site/docs/install.md
+++ b/site/docs/install.md
@@ -30,105 +30,105 @@ $ git clone https://github.com/google/bazel/
To build Bazel on Ubuntu:
-1. Install JDK 8:
+#### 1. Install JDK 8:
- * **Ubuntu Trusty (14.04 LTS).** OpenJDK 8 is not available on Trusty. To
- install Oracle JDK 8:
+**Ubuntu Trusty (14.04 LTS).** OpenJDK 8 is not available on Trusty. To
+install Oracle JDK 8:
- ```
- $ sudo add-apt-repository ppa:webupd8team/java
- $ sudo apt-get update
- $ sudo apt-get install oracle-java8-installer
- ```
+```
+$ sudo add-apt-repository ppa:webupd8team/java
+$ sudo apt-get update
+$ sudo apt-get install oracle-java8-installer
+```
- * **Ubuntu Utopic (14.10).** To install OpenJDK 8:
+**Ubuntu Utopic (14.10).** To install OpenJDK 8:
- ```
- $ sudo apt-get install openjdk-8-jdk
- ```
+```
+$ sudo apt-get install openjdk-8-jdk
+```
-2. Set the `JAVA_HOME` environment variable.
+#### 2. Set the `JAVA_HOME` environment variable.
- First, check to see if it's already set:
+First, check to see if it's already set:
- ```
- $ echo $JAVA_HOME
- ```
+```
+$ echo $JAVA_HOME
+```
- If this prints the path to the JDK 8 root directory, proceed to the next
- step. Otherwise, find the Java `bin` directory using `which javac` and use
- `javac -version` to verify that you have the right JDK version. Then set
- the `JAVA_HOME` environment variable to the `bin` directory parent.
+If this prints the path to the JDK 8 root directory, proceed to the next
+step. Otherwise, find the Java `bin` directory using `which javac` and use
+`javac -version` to verify that you have the right JDK version. Then set
+the `JAVA_HOME` environment variable to the `bin` directory parent.
- For example, if the path is `/usr/lib/jvm/jdk1.8.0/bin/javac`, set the
- `JAVA_HOME` variable to `/usr/lib/jvm/jdk1.8.0`:
+For example, if the path is `/usr/lib/jvm/jdk1.8.0/bin/javac`, set the
+`JAVA_HOME` variable to `/usr/lib/jvm/jdk1.8.0`:
- ```
- $ export JAVA_HOME=/usr/lib/jvm/jdk1.8.0
- ```
+```
+$ export JAVA_HOME=/usr/lib/jvm/jdk1.8.0
+```
- You can also add this line to your `~/.bashrc` file.
+You can also add this line to your `~/.bashrc` file.
-3. Install required packages:
+#### 3. Install required packages:
- ```
- $ sudo apt-get install libarchive-dev pkg-config zip g++ zlib1g-dev
- ```
+```
+$ sudo apt-get install libarchive-dev pkg-config zip g++ zlib1g-dev
+```
-4. Build Bazel:
+#### 4. Build Bazel:
- ```
- $ cd bazel
- $ ./compile.sh
- ```
+```
+$ cd bazel
+$ ./compile.sh
+```
### Building Bazel on OS X
Bazel on Mac OS X requires:
-* The Xcode command line tools. Xcode can be downloaded from the
- [Apple Developer Site](https://developer.apple.com/xcode/downloads/).
+* The Xcode command line tools. Xcode can be downloaded from the
+ [Apple Developer Site](https://developer.apple.com/xcode/downloads/).
-* MacPorts or Homebrew for installing required packages.
+* MacPorts or Homebrew for installing required packages.
-* An installation of JDK 8.
+* An installation of JDK 8.
-* For `objc_*` and `ios_*` rule support, you must have Xcode 6.1 or later with
- iOS SDK 8.1 installed on your system.
+* For `objc_*` and `ios_*` rule support, you must have Xcode 6.1 or later with
+ iOS SDK 8.1 installed on your system.
To build Bazel on Mac OS X:
-1. Install the required packages:
+#### 1. Install the required packages:
- ```
- $ port install protobuf-cpp libarchive
- ```
+```
+$ port install protobuf-cpp libarchive
+```
- or
+or
- ```
- $ brew install protobuf libarchive
- ```
+```
+$ brew install protobuf libarchive
+```
-2. Build Bazel:
+#### 2. Build Bazel:
- ```
- $ cd bazel
- $ ./compile.sh
- ```
+```
+$ cd bazel
+$ ./compile.sh
+```
-3. Run Bazel:
+#### 3. Run Bazel:
- ```
- $ ./output/bazel help
- ```
+```
+$ ./output/bazel help
+```
## Running Bazel
The Bazel executable is located at `output/bazel` in the Bazel home directory.
It's a good idea to add this path to your default paths, as follows:
-```
+```bash
$ export PATH="$PATH:$HOME/bazel/output"
```