From 879140da747c40e3a3ca0ad142f9b95726bde0f1 Mon Sep 17 00:00:00 2001 From: jcgregorio Date: Thu, 29 Jan 2015 09:55:14 -0800 Subject: Add docs for running docserver locally. BUG=skia:3346 Review URL: https://codereview.chromium.org/891483002 --- site/dev/tools/markdown.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'site') diff --git a/site/dev/tools/markdown.md b/site/dev/tools/markdown.md index c7a7324336..c1230d2a59 100644 --- a/site/dev/tools/markdown.md +++ b/site/dev/tools/markdown.md @@ -13,6 +13,28 @@ with the value of the Reitveld issue id: https://skia.org?cl=REITVELD_ISSUE_NUMBER +You can also run a local copy of the documentation server, which will allow +you to preview changes much quicker. You must have [Go](https://golang.org) +installed on your computer, which you will have if you are running on a Google +corporate workstation. Run: + + go get skia.googlesource.com/buildbot.git/doc/go/docserver + +And then **from within** the directory of your local Git checkout of Skia run: + + docserver --preview + +Then visit http://localhost:8000 to preview your changes. There is no need to +restart the server for file changes, but you will need to restart it if there +are changes to the navigation menu, i.e. you add or remove a file and want it +to appear in the navigation on the right hand side of the page. + +If port 8000 is unavailable on your machine you can set the port to use via +the --port flag: + + docserver --preview --port=:8002 + + Some Example MarkDown --------------------- -- cgit v1.2.3