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.
The most straightforward way to use http-server is to invoke it using npx:
demo-site $ npx http-server -v
If you prefer, you can install the package globally using npm instead.
demo-site $ npm i -g http-server
That puts a command by the same name on your PATH so you don’t need to prefix it with
We’ll assume for the purpose of this tutorial that you are calling http-server using
Now launch the web server by pointing it at the location of the generated site.
In the terminal, type the command name,
npx 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 $ npx 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 $ npx http-server build/site -c-1 -p 5000