Port IconComboBox to DropDown
[inkscape.git] / INSTALL.md
blobdc2a2fb5d27a76b8e04e139742d3a521d82cfac3
1 Installation
2 ============
4 Required Dependencies
5 ---------------------
7 The Inkscape core depends on several other libraries that you will need
8 install, if they are not already present on your system. The most
9 typical libraries you may need to install are: 
10 [Boehm-GC](http://www.hboehm.info/gc/), 
11 [libsigc++](https://github.com/libsigcplusplus/libsigcplusplus), 
12 [gtkmm](https://www.gtkmm.org/).
14 Make sure you got the submodules code when fetching the code 
15 (either by using `--recurse-submodules` on the git clone command, as recommended on the [Getting started](https://inkscape.org/develop/getting-started/#fetching-the-source-code) page, or by running `git submodule init && git submodule update`)
17 Please see [the wiki page on compiling Inkscape](http://wiki.inkscape.org/wiki/index.php/CompilingInkscape) for the
18 most current dependencies, including links to the source tarballs. 
19 For common linux-distributions (Ubuntu, Debian, Fedora) you can use 
20 [a bash-script](https://gitlab.com/inkscape/inkscape-ci-docker/-/raw/master/install_dependencies.sh?inline=false) 
21 for getting required libraries.
23 Basic Installation
24 ------------------
26 For Linux based Free Desktops, Inkscape version 0.92 and newer can be built using CMake:
28 ```sh
29 mkdir build
30 cd build
31 cmake ..
32 make
33 make install
34 ```
36 See `CONTRIBUTING.md` for more developer details and the [wiki](https://wiki.inkscape.org/wiki/index.php?title=Compiling_Inkscape).
38 For non-linux platforms, please see the Inkscape wiki pages here:
40 For building on ChromeOS, please click [here](
41 https://wiki.inkscape.org/wiki/index.php?title=Compiling_Inkscape_on_Chrome_OS)
43 For building on Windows, please click [here](
44 https://wiki.inkscape.org/wiki/index.php?title=Compiling_Inkscape_on_Windows_with_MSYS2)
46 For building on Mac, please click [here](
47 https://wiki.inkscape.org/wiki/index.php?title=CompilingMacOsX)
50 Running Without Installing
51 --------------------------
53 For developers and others who want to run Inkscape without installing it please
54 see the ***Building*** section in the `CONTRIBUTING.md` file.
56 Extensions
57 ----------
59 All Inkscape extensions have been moved into their own repository. They
60 can be installed from there and should be packaged into builds directly.
61 Report all bugs and ideas to that sub project.
63 [Inkscape Extensions](https://gitlab.com/inkscape/extensions/)
65 They are available as a sub-module which can be updated independently:
67 ```sh
68 git submodule update --remote
69 ```
71 This will update the module to the latest version and you will see the
72 extensions directory is now changes in the git status. So be mindful of that.
74 Build Options
75 -------------
77 A number of configuration settings can be overridden through CMake. To
78 see a list of the options available for Inkscape, run:
80 ```sh
81 cmake -L
82 ```
83 or, for more advanced cmake settings:
85 ```sh
86 cmake --help
87 ```
89 For example, to build Inkscape with only SVG 1 support, and no SVG 2, do:
91 ```sh
92 cmake .. -DWITH_SVG2=OFF
93 ```
95 Or, to build Inkscape with debugging symbols, do:
97 ```sh
98 cmake -DCMAKE_BUILD_TYPE=Debug ..
99 ```