Preview Your Site
On this page, you’ll learn:
How to preview a site locally.
How to run an optional local server to preview a site locally.
Since Antora generates static sites, you do not have to publish the site to a web server to view it. A site generated by Antora works just as well using the browser’s local file: protocol. This characteristic of an Antora site is an essential tool for previewing your work.
To view the site locally, navigate to any HTML page inside the destination folder in your browser. If you’re following along with the Demo, look for the file build/site/index.html in your project. You will be viewing the HTML pages through the file: protocol of the browser, which you can see in the location bar.
Although the site is viewable without a web server, you may still need to view your site through a web server to test certain features, such as indexified URLs, caching, or scripts that don’t work over the file: protocol. You can use the http-server package for this purpose. http-server is a simple, static web server for Node.js.
Install the http-server package globally using npm:
demo-site $ npm i -g http-server
demo-site $ yarn global add http-server
That puts a command by the same name on your PATH.
Now launch the web server by pointing it at the location of the generated site.
In the terminal, type the command name,
http-server, followed by the location of the generated site (i.e., the output dir).
We also recommend adding the
-c-1 flag to disable caching.
demo-site $ http-server build/site -c-1
Upon launching the command, the local address of the web server will be displayed in your terminal. You should see the following output in your terminal:
Starting up http-server, serving build/site Available on: http://127.0.0.1:8080 http://192.168.1.8:8080 Hit CTRL-C to stop the server
Paste the first provided URL into the location bar of your browser to view your site through a local web server.
Press Ctrl+C to stop the server.
If you get a port conflict when starting the server (i.e.,
demo-site $ http-server build/site -c-1 -p 5000