aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/jekyll-tree.sh
Commit message (Collapse)AuthorAge
* Rework jekyll-tree build to add redirects from site root.Gravatar dzc2017-06-26
| | | | | | | | | | | | | | As described in the commit message for 5596d3b, the new docs.bazel.build site will have one directory per released version and a master directory for the latest documentation at HEAD. This change reworks the jekyll-tree script to construct a final Jekyll tree containing the documentation at HEAD with documentation under /versions/master and redirect pages at the site root for each documentation page. TESTED=scripts/serve-docs.sh RELNOTES: None PiperOrigin-RevId: 159920553
* Fix paths in Bazel docs, removing references to versions/master.Gravatar dzc2017-06-08
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Follow-up to https://github.com/bazelbuild/bazel/commit/22b85a2a3c79c6f3aef1e0a61e485bb135be4551. This change updates paths and URLs to Bazel docs, removing the versions/master directory and changing bazel.build/docs to docs.bazel.build. For clarification on the convention of the docs site, links referencing docs.bazel.build/foo.html will be redirected to docs.bazel.build/versions/master/foo.html. The versions/master directory will contain the documentation pages pushed from HEAD. Once versioned documentation is ready, then docs.bazel.build/foo.html will instead be redirected to docs.bazel.build/x.y.z/foo.html, where x.y.z is the directory for the latest stable Bazel version. Follow-ups to this change: * Add script that will be used by the daily push job that pushes the latest documentation from HEAD to docs.bazel.build. This script will do the following: * Build the Jekyll tree, run jekyll build, and modify the resulting site tree, moving the docs/ directory into versions/master. * Add redirects for each of the site pages from the root of the site to the corresponding page in versions/master. * This should give us the minimum viable product for the new docs site. * Add script for cutting a release of the docs and pushing to a new versioned directory on the docs.bazel.build bucket. RELNOTES: None PiperOrigin-RevId: 158347197
* Fix links on doc pages that were pointing to .md files.Gravatar David Chen2016-09-01
| | | | | -- MOS_MIGRATED_REVID=131832236
* Fix typo in shell variable namesGravatar Klaus Aehlig2016-08-29
| | | | | | | | | | | | site/jekyll-tree.sh derives their own variables TMP and OUT_DIR from TMPDIR (using /tmp as a default, but not touching the TMPDIR variable). So those variables ought to be used also in the rest of the script. -- Change-Id: Ic62dffd36347982a34bc7c5cbabc7c9b3ada0cb7 Reviewed-on: https://bazel-review.googlesource.com/#/c/5671 MOS_MIGRATED_REVID=131583456
* Replace doc pages with redirects to versioned doc pages.Gravatar David Chen2016-08-29
| | | | | | | | | | | | | | * Add a new `redirect` Jekyll layout. * Replace all pages under docs/ with redirects to corresponding page under versions/master/. * Prepend links on Documentation sidebar, including generated navs for the Skylark Library and Build Encyclopedia, with prefix for versioned directory. * Add code to both the internal jekyll-config.sh and external jekyll-tree.sh to add redirect pages for the Skylark Library and Build Encyclopedia. * Bring the branched User Manual doc up to date with latest changes. -- MOS_MIGRATED_REVID=131568800
* Rollback of commit 3e8bcae69a0718cf6972be086706b1841e0ed6b7.Gravatar Damien Martin-Guillerez2016-07-29
| | | | | | | | | | | | | | | | | | | | | | | | | | *** Reason for rollback *** Breaks design docs links *** Original change description *** Move Bazel docs into versioned directory. * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze rel... *** -- MOS_MIGRATED_REVID=128690580
* Move Bazel docs into versioned directory.Gravatar David Chen2016-07-27
| | | | | | | | | | | | | | | | | | | | | | | | | | * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze release script to copy docs from third_party/bazel/site/versions/master Changes to follow this CL: * Separate navigation from layouts so that navigation can be versioned as well. * Add tool for cutting a release of Bazel docs and copies them into a new version directory. Bug: #579 -- MOS_MIGRATED_REVID=128510319
* jekyll-tree.sh: do not generate unneeded tempfileGravatar Klaus Aehlig2016-07-01
| | | | | | | -- Change-Id: I5d420298aa841d04059462c10acb263ecf5cec28 Reviewed-on: https://bazel-review.googlesource.com/#/c/3941 MOS_MIGRATED_REVID=126296592
* Generate the command-line reference from bazel help.Gravatar Ulf Adams2016-06-23
| | | | | | | -- Change-Id: I277f81472520b7f490cb178bb14c9618553cc4b2 Reviewed-on: https://bazel-review.googlesource.com/#/c/3880/ MOS_MIGRATED_REVID=125657323
* Fix mktemp call for old version of OS XGravatar Damien Martin-Guillerez2016-05-25
| | | | | | | | | mktemp -d needs a template name for older version of OS X. See http://ci.bazel.io/view/Bazel%20bootstrap%20and%20maintenance/job/Bazel/JAVA_VERSION=1.7,PLATFORM_NAME=darwin-x86_64/563/console -- MOS_MIGRATED_REVID=123207650
* Add generated docs to Jekyll tree build target. Add script for bringing upGravatar David Chen2016-05-09
local instance of bazel.io site. * Add a new genrule rule that runs the new jekyll-tree.sh to do the following: * Combine the generated docs for the Build Encyclopedia and Skylark Library with the static site docs * Combine the README.md files for the Docker and Packaging rules with the Jekyll tree * Process the generated docs, replaces instances of "blaze" with "bazel", etc. * Add scripts/serve-docs.sh script that can be used to bring up a local instance of the bazel.io website. As of this patch, it is possible to construct the full Bazel.io site tree from the master branch. -- MOS_MIGRATED_REVID=121813688