added packages to the prereq list since we are not building them with the global...
[lxqt-slackware.git] / README.md
1 # LXQT on Slackware
2
3 A collection of scripts to let you build [LXQT](https://github.com/lxqt/lxqt/) 0.16.0 on Slackware
4
5 ## Getting Started
6
7 If you want to build lxqt on Slackware these scripts will help you. I tried to make every step trivial but I can't be sure these instructions will work on every system. If you want to build different versions of LXQT those script will probably not work unless you modify them.
8
9 ### Prerequisites
10
11 In order to build LXQT on Slackware you'll need a few packages from [SlackBuilds.org](https://slackbuilds.org/), here's the list:
12
13 * openbox - [SBo](https://slackbuilds.org/repository/14.2/desktop/openbox/)
14 * imlib2 (optional for openbox) - [SBo](https://slackbuilds.org/repository/14.2/libraries/imlib2/)
15 * muParser - [SBo](https://slackbuilds.org/repository/14.2/libraries/muParser/)
16 * libstatgrab - [SBo](https://slackbuilds.org/repository/14.2/libraries/libstatgrab/)
17 * libconfig - [SBo](https://slackbuilds.org/repository/14.2/libraries/libconfig/)
18
19 Since early December 2020 kde5 is now merged inside the main tree on -current, so you no longer need to install the ktown repository from AlienBob. I've updated the Prerequisites list to reflect the latest installed versions as of 17/12/2020
20
21 ### Preparation
22
23 Before we get to start building we need to do a few things:
24
25 * Check prerequisite packages to ensure that we have all dependancies:
26 * after running this script we'll have a log of all the installed dependancies as well as hints on where to find those packages we are missing.
27 * a little notice regarding gtk+2 and gtk+3, even if those 2 packages are installed, my script doesn't see them, I think it has something to do with the way regex works and the fact that there's a + in the name, but I didn't investigate much. Bottom line, if you have them installed you're good to go!
28
29 ```
30 sh CHECK_PREREQ.sh
31 ```
32
33 * Download the source tree, this operation will also give us the version numbers for every package
34 * this script will generate a versioning file containing all the version numbers for the packages.
35
36 ```
37 sh DOWNLOAD.sh
38 ```
39
40 ### Building and Installing
41
42 Now we have everything we need, with a little luck we don't need to do much except:
43 ```
44 sh build_all.sh
45 ```
46 and after a while we should see our packages inside the packages directory.
47
48 ## Tested on
49
50 I tested this bunch of scripts on a fresh install of slackware64-current updated on 24/04/2020, the system is running inside a chroot that I reinstall fresh everytime I have to build something.
51 If your system is not so clean YMMV as you can imagine.
52
53 ## Contributing
54
55 Feel free to contribute however you feel like.
56
57 ## Authors
58
59 * **Danilo 'danix' Macrì** - *owner* - [danix.xyz](https://danix.xyz)
60
61 ## License
62
63 This project is licensed under the GPLv3 - see the [LICENSE.md](LICENSE.md) file for details
64
65 ## Acknowledgments
66
67 * Huge thans to [AlienBob](https://alien.slackbook.org/blog/) whose original lxqt slackbuilds I've used and modified to write this set
68 * Of course all the people behind [LXQT](https://github.com/lxqt/lxqt/), what they do is amazing and I can't thank them enough.