Qlik Core Website
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.
For the generated site, see core.qlik.com.
To develop and contribute to the Qlik Core documentation, the following must be available on the local machine:
- Docker - Docker for Windows or Docker for Mac
- Bash - On Windows, Git Bash included in Git for Windows is recommended
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:
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:
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
The linters that are enabled is configured in .lint-condo.yaml.