qbs/qbs.io

The Qbs website

Qbs

Qbs is a build automation tool designed to conveniently manage the build process of software projects across multiple platforms. Qbs can be used for any software project, regardless of programming language, toolkit, or libraries used.

Documentation

Qbs product documentation is available at doc.qt.io/qbs

The project's homepage is wiki.qt.io/qbs

Supported platforms

Qbs binaries are available for Windows, macOS, Linux, and FreeBSD.

For more information about how to install Qbs on your platform, see the Installing page in the documentation.

Qbs allows to build applications for different platforms, for the list of supported platforms and the details about each platform, see the Target Platforms page.

Building Qbs

For information about building Qbs from sources, see "Appendix A: Building Qbs".

Reporting Bugs

Please report any bugs in our bug tracker.

Contributing

See Contributing to Qbs

qbs.io's Issues

Documentation for how to contribute

I just recently decided to give Qbs a proper go because... I don't want to end up in CMake land ever again.

I have pledged in the comments of this bugreport that I will contribute to the effort of making Qbs in general and Qbs documentation in particular more approachable for "mere mortals".

So far I have come this far:

$ git clone [email protected]:mrdeveloperdude/qbs.io.git
# ...

$ cd qbs.io/

$ sudo apt install hugo nodejs npm
# ...

$ npm install
# ...

$ npm audit fix
# ...

$ npx browserslist@latest --update-db
# ...

$ npx browserslist@latest --update-db
# Because one time was not enough apparently


$ hugo server

Start building sites … 
Built in 2031 ms
Error: Error building site: POSTCSS: failed to transform "css/main.css" (text/css): Error: ENOENT: no such file or directory, stat '/home/leo/Desktop/Projects/QbsDoc/qbs.io/stdin'
    at Object.statSync (fs.js:1016:3)
    at trackModified (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/tailwindcss/lib/lib/setupContextUtils.js:463:46)
    at Object.getContext (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/tailwindcss/lib/lib/setupContextUtils.js:818:5)
    at /home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/tailwindcss/lib/lib/setupTrackingContext.js:142:53
    at /home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/tailwindcss/lib/processTailwindFeatures.js:41:11
    at plugins (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/tailwindcss/lib/index.js:20:104)
    at LazyResult.runOnRoot (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/postcss/lib/lazy-result.js:339:16)
    at LazyResult.runAsync (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/postcss/lib/lazy-result.js:393:26)
    at LazyResult.async (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/postcss/lib/lazy-result.js:221:30)
    at LazyResult.then (/home/leo/Desktop/Projects/QbsDoc/qbs.io/node_modules/postcss/lib/lazy-result.js:206:17) {
  errno: -2,
  syscall: 'stat',
  code: 'ENOENT',
  path: '/home/leo/Desktop/Projects/QbsDoc/qbs.io/stdin'
}

My idea is that I will contribute some documentation as I learn Qbs from a complete beginner's perspective. Hopefully I will manage to capture the relevant questions and present them in a good way as documentation.

But before I can succeed with this, I need to get the damn thing running locally. I have used NPM many years ago and hugo is completely new to me.

There seems to be no README file in this repo, so maybe my first contribution could be such a README file. So what are the steps missing to get this running locally?

Thanks!