# qmlbook/qmlbook

The source code for the upcoming qml book

Repository: https://github.com/qmlbook/qmlbook
Canonical: https://ross.abutalabs.com/products/qmlbook
Homepage: http://qmlbook.github.io/
Language: Batchfile
License: BSD-3-Clause
License Family: permissive
Last push: 2023-06-02T17:07:28+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4792, "days_push": 1188, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2583, forks 587 (observed 2026-08-28T04:07:02.486487+00:00)

## What it is
The source for 'Qt5 Cadaques', a free open-source book teaching Qt5 and QML/Qt Quick development, built with Sphinx and published at qmlbook.org. The repository contains the book text (CC BY-NC-SA 4.0) plus BSD-licensed code examples and tooling for generating HTML, single-page, and PDF builds.

## Use cases
- learn QML and Qt Quick from scratch
- free Qt5 book pdf download
- tutorial on model-view-delegate in Qt Quick
- learn to extend QML with C++
- examples of particle simulations and shader effects in QML
- introduction to Qt Creator and Qt5 SDK

## When to choose
- you are learning Qt5/QML and want a structured, free, well-illustrated book
- you want runnable code examples licensed permissively (BSD)
- you want to contribute to or fork an open Qt learning resource

## When to avoid
- you need Qt 6 coverage - the book targets Qt5 and its last build was 2020
- you need a commercial-licensed book text (content is CC BY-NC-SA)
- you need up-to-date tooling or active maintenance

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: documentation
- domain: tutorials, developer-tools, cross-platform
- platform: cross-platform, python
- tags: qt5, qml, qt-quick, book, sphinx, open-textbook

## Member repositories
- qmlbook/qmlbook (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:02.486487+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:22:31.021729+00:00, confidence not recorded.
  - readme: https://github.com/qmlbook/qmlbook (fetched 2026-08-28T04:07:02.486487+00:00, sha f55ed301363d)
  - homepage: http://qmlbook.github.io/ (fetched 2026-08-29T10:05:00.826641+00:00, sha 945677454bfd)
- Data as of 2026-08-30T08:39:29.467469+00:00.
