Add titles to Bazel documentation pages. Fixes #790 -- MOS_MIGRATED_REVID=112563137
diff --git a/site/blog/index.md b/site/blog/index.md index 4e8755c..5f2d376 100644 --- a/site/blog/index.md +++ b/site/blog/index.md
@@ -1,5 +1,6 @@ --- layout: blog +title: Blog --- {% for post in site.categories.blog %}
diff --git a/site/contributing.md b/site/contributing.md index b32a4a3..ea55f40 100644 --- a/site/contributing.md +++ b/site/contributing.md
@@ -1,5 +1,6 @@ --- layout: community +title: Contributing to Bazel --- # Contributing to Bazel
diff --git a/site/docs/bazel-user-manual.html b/site/docs/bazel-user-manual.html index d3db726..a140540 100644 --- a/site/docs/bazel-user-manual.html +++ b/site/docs/bazel-user-manual.html
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: User Manual +--- <h1>A User's Guide to Bazel</h1> <h2 id='overview'>Bazel overview</h2>
diff --git a/site/docs/build-ref.html b/site/docs/build-ref.html index eed9bf7..87004ca 100644 --- a/site/docs/build-ref.html +++ b/site/docs/build-ref.html
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Concepts +--- <h1>Bazel: Concepts and Terminology</h1> <p> This document provides an overview of concepts and terminology used
diff --git a/site/docs/cpp.md b/site/docs/cpp.md index 7a194e0..8ae8595 100644 --- a/site/docs/cpp.md +++ b/site/docs/cpp.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: C++ Basics --- C++ Basics
diff --git a/site/docs/external.md b/site/docs/external.md index 29646ed..14480d9 100644 --- a/site/docs/external.md +++ b/site/docs/external.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: External Dependencies --- # Working with external dependencies
diff --git a/site/docs/getting-started.md b/site/docs/getting-started.md index 510445b..613793c 100644 --- a/site/docs/getting-started.md +++ b/site/docs/getting-started.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: Getting Started --- # Getting Started with Bazel
diff --git a/site/docs/install.md b/site/docs/install.md index ee77bb9..0d2ee3c 100644 --- a/site/docs/install.md +++ b/site/docs/install.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: Installing Bazel --- # Installing Bazel
diff --git a/site/docs/mobile-install.md b/site/docs/mobile-install.md index 2314ee1..f273871 100644 --- a/site/docs/mobile-install.md +++ b/site/docs/mobile-install.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: mobile-install --- # bazel mobile-install
diff --git a/site/docs/output_directories.md b/site/docs/output_directories.md index 4ba6073..f3b40f0 100644 --- a/site/docs/output_directories.md +++ b/site/docs/output_directories.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Output Directory Layout +--- + # Output Directory Layout ## Requirements
diff --git a/site/docs/query.html b/site/docs/query.html index b2438b6..8d76b22 100644 --- a/site/docs/query.html +++ b/site/docs/query.html
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Query Language +--- <h1>The Bazel Query Reference</h1> <p>
diff --git a/site/docs/skyframe.md b/site/docs/skyframe.md index 0c5e2be..de2a0b7 100644 --- a/site/docs/skyframe.md +++ b/site/docs/skyframe.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: Skyframe --- # Skyframe
diff --git a/site/docs/skylark/concepts.md b/site/docs/skylark/concepts.md index e8a6ab2..76e1fe9 100644 --- a/site/docs/skylark/concepts.md +++ b/site/docs/skylark/concepts.md
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Skylark - Concepts +--- # Concepts ## Loading a Skylark extension
diff --git a/site/docs/skylark/cookbook.md b/site/docs/skylark/cookbook.md index c4f718f..c479a10 100644 --- a/site/docs/skylark/cookbook.md +++ b/site/docs/skylark/cookbook.md
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Skylark Cookbook +--- Skylark cookbook ================ @@ -90,7 +94,7 @@ for flavor in flavors: for test in test_files: ts.append(system_test(name, flavor, test)) - native.test_suite(name = name, tests = ts) + native.test_suite(name = name, tests = ts) ``` In the following BUILD file, note how `(fast, basic_test.py)` is emitted for
diff --git a/site/docs/skylark/index.md b/site/docs/skylark/index.md index 71a282ac..49164ff 100644 --- a/site/docs/skylark/index.md +++ b/site/docs/skylark/index.md
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Custom Rules +--- # Custom rules Skylark is the code name of the extension mechanism for Bazel. It lets you write
diff --git a/site/docs/skylark/macros.md b/site/docs/skylark/macros.md index f4f6129..1ecf59e 100644 --- a/site/docs/skylark/macros.md +++ b/site/docs/skylark/macros.md
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Macros +--- # Macros ## Macro creation
diff --git a/site/docs/skylark/rules.md b/site/docs/skylark/rules.md index 8004789..12d6f96 100644 --- a/site/docs/skylark/rules.md +++ b/site/docs/skylark/rules.md
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Skylark Rules +--- Rules =====
diff --git a/site/docs/test-encyclopedia.html b/site/docs/test-encyclopedia.html index 7aec9e9..7429066 100644 --- a/site/docs/test-encyclopedia.html +++ b/site/docs/test-encyclopedia.html
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Test Encyclopedia +--- <h1>Bazel Test Encyclopedia</h1> <p class="lead">An Exhaustive Specification of the Test Execution Environment</p>
diff --git a/site/docs/tutorial/android-app.md b/site/docs/tutorial/android-app.md index d58cf39..65bc7da 100644 --- a/site/docs/tutorial/android-app.md +++ b/site/docs/tutorial/android-app.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Build an Android App +--- + # Tutorial - Build an Android App The sample Android app in this tutorial is a very simple application that makes
diff --git a/site/docs/tutorial/backend-server.md b/site/docs/tutorial/backend-server.md index fc85cd6..073ffbc 100644 --- a/site/docs/tutorial/backend-server.md +++ b/site/docs/tutorial/backend-server.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Build the Backend Server +--- + # Tutorial - Build the Backend Server The backend server is a simple web application that runs on Google App Engine
diff --git a/site/docs/tutorial/environment.md b/site/docs/tutorial/environment.md index 5cd9972..219060d 100644 --- a/site/docs/tutorial/environment.md +++ b/site/docs/tutorial/environment.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Set Up Your Environment +--- + # Tutorial - Set Up Your Environment The first step in this tutorial is to set up your environment.
diff --git a/site/docs/tutorial/index.md b/site/docs/tutorial/index.md index 6d15484..c7e5d24 100644 --- a/site/docs/tutorial/index.md +++ b/site/docs/tutorial/index.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Introduction +--- + # Tutorial - Introduction You can use Bazel to build a variety of software outputs, including
diff --git a/site/docs/tutorial/ios-app.md b/site/docs/tutorial/ios-app.md index 9faf711..b4acb20 100644 --- a/site/docs/tutorial/ios-app.md +++ b/site/docs/tutorial/ios-app.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Build an iOS App +--- + # Tutorial - Build an iOS App Like the [Android app](android-app.md) you built in the previous step, the iOS
diff --git a/site/docs/tutorial/review.md b/site/docs/tutorial/review.md index ed5f5ff..62d4501 100644 --- a/site/docs/tutorial/review.md +++ b/site/docs/tutorial/review.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Review +--- + # Tutorial - Review In this tutorial, you used Bazel to build an [Android app](android-app.md),
diff --git a/site/docs/tutorial/workspace.md b/site/docs/tutorial/workspace.md index be88832..ff3f6da 100644 --- a/site/docs/tutorial/workspace.md +++ b/site/docs/tutorial/workspace.md
@@ -1,3 +1,8 @@ +--- +layout: documentation +title: Tutorial - Set Up a Workspace +--- + # Tutorial - Set Up a Workspace A [workspace](/docs/build-ref.html#workspaces) is a directory that contains the
diff --git a/site/docs/windows.md b/site/docs/windows.md index 3761b5c..038c7e1 100644 --- a/site/docs/windows.md +++ b/site/docs/windows.md
@@ -1,5 +1,6 @@ --- layout: documentation +title: Windows --- Building Bazel on Windows
diff --git a/site/governance.md b/site/governance.md index c94b110..d9b4ed9 100644 --- a/site/governance.md +++ b/site/governance.md
@@ -1,5 +1,6 @@ --- layout: community +title: Governance --- # Governance
diff --git a/site/index.html b/site/index.html index 30173df..3e2c9db 100644 --- a/site/index.html +++ b/site/index.html
@@ -1,5 +1,6 @@ --- layout: home +title: Home --- <div class="hero">
diff --git a/site/roadmap.md b/site/roadmap.md index 75865a7..0fa75e6 100644 --- a/site/roadmap.md +++ b/site/roadmap.md
@@ -1,5 +1,6 @@ --- layout: community +title: Roadmap --- # Bazel Feature Roadmap
diff --git a/site/support.md b/site/support.md index fe07f09..1cad480 100644 --- a/site/support.md +++ b/site/support.md
@@ -1,5 +1,6 @@ --- layout: community +title: Support Policy --- # Support Policy
diff --git a/site/users.md b/site/users.md index e9ef68e..1e68300 100644 --- a/site/users.md +++ b/site/users.md
@@ -1,5 +1,6 @@ --- layout: community +title: Bazel Users --- # Corporate users of Bazel
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/common-definitions.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/common-definitions.vm index aa3f96c..63598e9 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/common-definitions.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/common-definitions.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Common Definitions +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <h1>Common definitions</h1>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm index 7b441c1..49105b2 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Functions +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <h1>Functions</h1>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/make-variables.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/make-variables.vm index 02c8055..684f998 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/make-variables.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/make-variables.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Make Variables +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <!-- ============================================
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/overview.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/overview.vm index 38aeeb7..33b24fb 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/overview.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/overview.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Build Encyclopedia +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <h1>Bazel BUILD Encyclopedia of Functions</h1>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/predefined-python-variables.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/predefined-python-variables.vm index be0b196..c50fb8a 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/predefined-python-variables.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/predefined-python-variables.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: Predefined Python Variables +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <h2 id="predefined-python-variables">Predefined Python Variables</h2>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm index fc54f25..9e9345c 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/rules.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: ${ruleFamily.name} Rules +--- #parse("com/google/devtools/build/docgen/templates/be/header.vm") <h1>${ruleFamily.name} Rules</h1>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/skylark-library.vm b/src/main/java/com/google/devtools/build/docgen/templates/skylark-library.vm index 5646e10..83f6540 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/skylark-library.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/skylark-library.vm
@@ -1,3 +1,7 @@ +--- +layout: documentation +title: ${module.title} +--- <h1 id="modules.${module.name}">${module.title}</h1> ${module.documentation}