Copyright(C) 2012-2021 Johan Thelin and Jürgen Bocklage-Ryannel
The new home for the Qt6 book (based on QmlBook)
You can always find the latest released version of the book built at https://www.qt.io/product/qt6/qml-book, and the latest snapshot at https://distracted-dijkstra-f5d508.netlify.app/.
- Building the Book Locally
- Building for Release
- For Reviewers
- For Authors
The contents is built into a static site using VuePress. The packages are managed ysing Yarn.
To build the contents locally, run:
$ yarnpkg
$ yarnpkg run docs:dev
Then visit localhost:8080 to view the book.
To build the examples, run:
$ yarnpkg run examples:build
This will create the _examples/ directory with the build. It assumes Qt6 can be found by CMake. My typical command line on a Debian Linux machine looks like this:
$ CMAKE_PREFIX_PATH=/path/to/Qt/6.2.0/gcc_64/lib/cmake/ yarnpkg run examples:build
Subsequent calls do not need CMAKE_PREFIX_PATH to be specified.
To build for release, first build the docs, then package the examples into a tar-ball:
$ yarnpkg run docs:build
$ yarnpkg run examples:package
This creates examples.tar.gz in your package root, as well as where VuePress places the output, i.e. docs/.vuepress/dist/.
Notice that the examples:package command assumes that the VuePress dist/ directory exists.
Pick chapters to review from the Project Board. Also look for issues tagged as Questions in the project.
Reviews are welcome both as issues, or as pull requests. Pick the approach that is the easiest for you!
Chapters are outlined in docs/.vuepress/config.js. Please tag chapters as Qt5, Qt6 Draft, and Qt 6 respectively.