Return-Path: X-Original-To: apmail-spark-commits-archive@minotaur.apache.org Delivered-To: apmail-spark-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id A312218DCF for ; Tue, 4 Aug 2015 00:01:03 +0000 (UTC) Received: (qmail 43446 invoked by uid 500); 4 Aug 2015 00:01:03 -0000 Delivered-To: apmail-spark-commits-archive@spark.apache.org Received: (qmail 43412 invoked by uid 500); 4 Aug 2015 00:01:03 -0000 Mailing-List: contact commits-help@spark.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list commits@spark.apache.org Received: (qmail 43398 invoked by uid 99); 4 Aug 2015 00:01:03 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 04 Aug 2015 00:01:03 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 6C806E03C2; Tue, 4 Aug 2015 00:01:03 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: rxin@apache.org To: commits@spark.apache.org Message-Id: <0f54fbd1200341adad5070735dfeaf02@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: spark git commit: Add a prerequisites section for building docs Date: Tue, 4 Aug 2015 00:01:03 +0000 (UTC) Repository: spark Updated Branches: refs/heads/master 13675c742 -> 7abaaad5b Add a prerequisites section for building docs This puts all the install commands that need to be run in one section instead of being spread over many paragraphs cc rxin Author: Shivaram Venkataraman Closes #7912 from shivaram/docs-setup-readme and squashes the following commits: cf7a204 [Shivaram Venkataraman] Add a prerequisites section for building docs Project: http://git-wip-us.apache.org/repos/asf/spark/repo Commit: http://git-wip-us.apache.org/repos/asf/spark/commit/7abaaad5 Tree: http://git-wip-us.apache.org/repos/asf/spark/tree/7abaaad5 Diff: http://git-wip-us.apache.org/repos/asf/spark/diff/7abaaad5 Branch: refs/heads/master Commit: 7abaaad5b169520fbf7299808b2bafde089a16a2 Parents: 13675c7 Author: Shivaram Venkataraman Authored: Mon Aug 3 17:00:59 2015 -0700 Committer: Reynold Xin Committed: Mon Aug 3 17:00:59 2015 -0700 ---------------------------------------------------------------------- docs/README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/spark/blob/7abaaad5/docs/README.md ---------------------------------------------------------------------- diff --git a/docs/README.md b/docs/README.md index d7652e9..5020989 100644 --- a/docs/README.md +++ b/docs/README.md @@ -8,6 +8,16 @@ Read on to learn more about viewing documentation in plain text (i.e., markdown) documentation yourself. Why build it yourself? So that you have the docs that corresponds to whichever version of Spark you currently have checked out of revision control. +## Prerequisites +The Spark documenation build uses a number of tools to build HTML docs and API docs in Scala, Python +and R. To get started you can run the following commands + + $ sudo gem install jekyll + $ sudo gem install jekyll-redirect-from + $ sudo pip install Pygments + $ Rscript -e 'install.packages(c("knitr", "devtools"), repos="http://cran.stat.ucla.edu/")' + + ## Generating the Documentation HTML We include the Spark documentation as part of the source (as opposed to using a hosted wiki, such as --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@spark.apache.org For additional commands, e-mail: commits-help@spark.apache.org