1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
=================
Ubuntu UI Toolkit
=================
Introduction
------------
This project consists of a set of QML components to ease the creation of
beautiful applications in QML for Ubuntu.
QML alone lacks built-in components for basic widgets like Button, Slider,
Scrollbar, etc, meaning a developer has to build them from scratch. This
toolkit aims to stop this duplication of work, supplying beautiful components
ready-made and with a clear and consistent API.
These components are fully themeable so the look and feel can be easily
customized. Resolution independence technology is built in so UIs are scaled
to best suit the display.
Other features:
- localisation through gettext
This project supports QML2 and above.
Building & Setup
----------------
You need Qt5 installed to proceed. To build this repository, run
$ qmake
$ make
View the components gallery by running
$ ./gallery.sh
To install these components, run
$ make install
You may need to be root for this command to succeed.
To use these components in QML without installing them, you need to set the
QML2_IMPORT_PATH environment variable. This is done by running
$ source export_modules_dir.sh
from the root directory of this repository, but is lost when you close your
shell.
Documentation
-------------
Main Documentation (QDocs):
+++++++++++++++++++++++++++
Once built, you may view the documentation by opening
`documentation/html/overview-ubuntu-sdk.html` in your favorite web browser.
Autopilot Emulators (Sphinx docs):
++++++++++++++++++++++++++++++++++
To build the AutoPilot Emulators API documentation (html),
* install python-sphinx::
$ sudo apt-get install python-sphinx
* from the branch's root, run::
$ sphinx-build -b html docs-autopilot-emulator emulator-html
* Once built, you may view the documentation by opening
`emulator-html/ubuntuuitoolkit.html` in your favorite web browser.
|