docs: add build instructions to README

This commit is contained in:
outfoxxed 2024-03-07 06:00:46 -08:00
parent 5ac04649aa
commit f32b4175fb
Signed by untrusted user: outfoxxed
GPG key ID: 4C88A185FB89301E
5 changed files with 87 additions and 6 deletions

2
.gitignore vendored
View file

@ -1,7 +1,7 @@
# build files
/result
/build/
compile_commands.json
/compile_commands.json
# clangd
/.cache

View file

@ -8,7 +8,7 @@ lint:
configure target='debug' *FLAGS='':
cmake -GNinja -B {{builddir}} \
-DCMAKE_BUILD_TYPE={{ if target == "debug" { "Debug" } else { "Release" } }} \
-DCMAKE_BUILD_TYPE={{ if target == "debug" { "Debug" } else { "RelWithDebInfo" } }} \
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON {{FLAGS}}
ln -sf {{builddir}}/compile_commands.json compile_commands.json
@ -19,6 +19,8 @@ _configure_if_clean:
build: _configure_if_clean
cmake --build {{builddir}}
release: (configure "release") build
clean:
rm -f compile_commands.json
rm -rf {{builddir}}
@ -29,5 +31,5 @@ run *ARGS='': build
test *ARGS='': build
ctest --test-dir {{builddir}} --output-on-failure {{ARGS}}
install *ARGS='': clean (configure "release") build
install *ARGS='':
cmake --install {{builddir}} {{ARGS}}

View file

@ -7,6 +7,86 @@ Hosts: [outfoxxed's gitea], [github]
[outfoxxed's gitea]: https://git.outfoxxed.me/outfoxxed/quickshell
[github]: https://github.com/outfoxxed/quickshell
Documentation can be built from the [quickshell-docs](https://git.outfoxxed.me/outfoxxed/quickshell-docs) repo,
though is currently pretty lacking.
# Installation
## Nix
This repo has a nix flake you can use to install the package directly:
```nix
{
inputs = {
nixpkgs.url = "nixpkgs/nixos-unstable";
quickshell = {
url = "git+https://git.outfoxxed.me/outfoxxed/quickshell";
inputs.nixpkgs.follows = "nixpkgs";
};
};
}
```
Quickshell's binary is available at `quickshell.packages.<system>.default` to be added to
lists such as `environment.systemPackages` or `home.packages`.
## Manual
If not using nix, you'll have to build from source.
### Dependencies
To build quickshell at all, you will need the following packages (names may vary by distro)
- just
- cmake
- pkg-config
- ninja
- Qt6 [ QtBase, QtDeclarative ]
To build with wayland support you will additionally need:
- wayland
- wayland-scanner (may be part of wayland on some distros)
- wayland-protocols
- Qt6 [ QtWayland ]
### Building
To make a release build of quickshell run:
```sh
$ just release
```
If you have all the dependencies installed and they are in expected
locations this will build correctly.
To install to /usr/local/bin run as root (usually `sudo`) in the same folder:
```
$ just install
```
### Building (Nix)
You can build directly using the provided nix flake or nix package.
```
nix build
nix build -f package.nix # calls default.nix with a basic callPackage expression
```
# Development
For nix there is a devshell available from `shell.nix` and as a devShell
output from the flake.
The Justfile contains various useful aliases:
- `just configure [<debug|release> [extra cmake args]]`
- `just build` (runs configure for debug mode)
- `just run [args]`
- `just clean`
- `just test [args]` (configure with `-DBUILD_TESTING=ON` first)
- `just fmt`
- `just lint`
#### License
<sup>

2
docs

@ -1 +1 @@
Subproject commit 1ca13d9ffded3fbddb0380c0d0df85304065efa9
Subproject commit 32aae34d4bf77f4455628bd13091474d67461527

View file

@ -88,8 +88,7 @@ Q_ENUM_NS(Enum);
/// }
///
/// Text {
/// anchors.horizontalCenter: parent.horizontalCenter
/// anchors.verticalCenter: parent.verticalCenter
/// anchors.centerIn: parent
/// text: "Hello!"
/// }
/// }