diff options
author | Dan Allen <dan@opendevise.com> | 2018-12-27 13:16:44 -0700 |
---|---|---|
committer | Dan Allen <dan@opendevise.com> | 2018-12-28 08:19:21 +0000 |
commit | 844e89d1c02ec139c087f47fe12e6bfc4a6eafd0 (patch) | |
tree | 81ad37ad7f1b3d87ef319ba7eb17f7845454c225 /docs/modules/ROOT/pages/build-preview-ui.adoc | |
parent | 96bfce53be64712242473055eeff58760dca5597 (diff) | |
download | alpine-antora-theme-844e89d1c02ec139c087f47fe12e6bfc4a6eafd0.tar.bz2 alpine-antora-theme-844e89d1c02ec139c087f47fe12e6bfc4a6eafd0.tar.xz |
update docs to reflect changes in Gulp build and Node requirements
Diffstat (limited to 'docs/modules/ROOT/pages/build-preview-ui.adoc')
-rw-r--r-- | docs/modules/ROOT/pages/build-preview-ui.adoc | 27 |
1 files changed, 12 insertions, 15 deletions
diff --git a/docs/modules/ROOT/pages/build-preview-ui.adoc b/docs/modules/ROOT/pages/build-preview-ui.adoc index e386f05..3daab1c 100644 --- a/docs/modules/ROOT/pages/build-preview-ui.adoc +++ b/docs/modules/ROOT/pages/build-preview-ui.adoc @@ -26,45 +26,42 @@ The next two sections explain how to use these modes. To build the UI once for preview, then stop, execute the `build-preview` task using the following command: - $ gulp build:preview + $ gulp preview:build This task pre-compiles the UI files into the [.path]_public_ directory. To view the preview pages, navigate to the HTML pages in the [.path]_public_ directory using your browser (e.g., [.path]_public/index.html_). === Build Continuously -To avoid the need to run the `build-preview` task over and over, you can use the `preview` command instead to have it run continuously. +To avoid the need to run the `preview:build` task over and over, you can use the `preview` command instead to have it run continuously. This task also launches a local HTTP server so updates get synchronized with the browser (i.e., "`live reload`"). To launch the preview server, execute the following command: $ gulp preview -You'll see two URLs listed in the output of this command: +You'll see a URL listed in the output of this command: .... -[BS] Access URLs: - ---------------------------------- - Local: http://localhost:5252 - External: http://192.168.1.7:5252 - ---------------------------------- -[BS] Serving files from: build -[BS] Watching files... +[12:59:28] Starting 'preview:serve'... +[12:59:28] Starting server... +[12:59:28] Server started http://localhost:5252 +[12:59:28] Running server .... -Navigate to the first one to see the preview site. +Navigate to the URL to view the preview site. While this command is running, any changes you make to the source files will be instantly reflected in the browser. -This works by monitoring the project for changes, running the `build` task if a change is detected, and sending the updates to the browser. +This works by monitoring the project for changes, running the `preview:build` task if a change is detected, and sending the updates to the browser. Press kbd:[Ctrl+C] to stop the preview server and end the continuous build. == Package for Previewing -If you need to package the UI in order to preview the UI on the real site in local development, run the following command: +If you need to bundle the UI in order to preview the UI on the real site in local development, run the following command: - $ gulp pack + $ gulp bundle -The `pack` command also invokes the `lint` command to check that the CSS and JavaScript follow the coding standards. +The `bundle` command also invokes the `lint` command to check that the CSS and JavaScript follow the coding standards. The UI bundle will be available at [.path]_build/ui-bundle.zip_. You can then point Antora at this bundle using the `--ui-bundle-url` command-line option. |