Skip to content
Source code for the core.qlik.com website.
Branch: master
Clone or download
carlioth Updates to documentation of swarm deprication (#526)
* Updates to documentation of swarm deprication
Latest commit 3a94b72 Jul 5, 2019

README.md

Qlik Core Website

CircleCI

This repo contains sources to the Qlik Core end-user documentation.

Documentation is primarily represented as markdown files and images. Markdown files are organized in the same way as the generated site is organized.

MkDocs is used to generate and build the site. Currently the mkdocs-material theme is used but this shall be changes to a theme matches Qlik branding.

For the generated site, see core.qlik.com.

Prerequisites

To develop and contribute to the Qlik Core documentation, the following must be available on the local machine:

Serving the Site Locally

To generate and serve the site locally on a developer machine, use the serve.sh Bash script, in the repository root:

./serve.sh

This makes the generated site available here.

Once the site is running locally, modifications to sources can be made and the local web server automatically updates. No re-build step is needed.

Building the Site

To build the site for deployment to some external web server, use the build.sh Bash script, in the repository root:

./build.sh

This builds the site contents in the site/ folder in the repository root. This folder is an entry in .gitignore to avoid undesired pending repo changes.

Linting the Documentation

For linting the documentation in this repository we use lint-condo, which contains a set of linters for linting a markdown file. The linting is part of the Circle CI pipeline, but can also be run locally

./lint.sh

The linters that are enabled is configured in .lint-condo.yaml.

You can’t perform that action at this time.