nextcloud-desktop/docs

Building the Docs

The desktop client documentation is not built directly; instead, it is built when the administration, developer, and user manuals are made.

However, if you would like to build a local copy of the desktop client documentation, to preview changes that you are making as you are making them, you can use the following command:

antora \
    --redirect-facility static \
    --stacktrace \
    site.local.yml

Note this command requires Antora’s command-line tools to be installed. To learn more about how to install them, please refer to that documentation in the docs repository.

Previewing the Generated Docs

Assuming that there are no build errors, the next thing to do is to view the result in your browser. In case you have already installed a web server, you need to configure a virtual host (or similar) which points to the directory public, located in the root directory of the repository. This directory contains the generated documentation. Alternatively, use the NPM Serve tool or PHP's built-in webserver.

The following example starts NPM's Serve running in the background, using the public directory as its directory root, and listening on http://localhost:5000 (if available):

serve public &