Permalink
Fetching contributors…
Cannot retrieve contributors at this time
154 lines (113 sloc) 4.41 KB

Github Downloads (latest) Github Downloads (total)

Sozi is a presentation tool for SVG documents.

It is free software distributed under the terms of the Mozilla Public License 2.0.

More details can be found on the official web site: http://sozi.baierouge.fr

Building and installing Sozi from sources

Get the source files

Clone the repository:

git clone git://github.com/senshu/Sozi.git

Install the build tools and dependencies

Install Node.js, Bower and the Grunt CLI. If you plan to build a Windows executable from Linux or OS X, also install wine. In Debian/Ubuntu and their derivatives, you can type the following commands.

sudo apt install nodejs nodejs-legacy npm wine
sudo npm install bower grunt-cli -g

If you plan to build Debian packages, also install the following packages:

sudo apt install devscripts debhelper

From the root of the source tree:

npm install
bower install

Also install the following:

  • Droid Sans as vendor/DroidSans/DroidSans.eot|ttf and vendor/DroidSans/DroidSans-Bold.eot|ttf

Build

To build the desktop application for all platforms, run the following command from the root of the source tree:

grunt

After a successful build, you will get a dist folder that will contain the generated application bundles for each platform.

You can customize the build by creating a custom configuration file. See config.default.json and config.linux-x64.json for examples. For instance, if you want to build 64-bit executables for OS X and Linux, the configuration file (config.linux-darwin-x64.json) will look like this:

{
    "platforms": [
        "darwin-x64",
        "linux-x64"
    ]
}

Then run Grunt with the --config option:

grunt --config=config.linux-darwin-x64.json

Other Grunt tasks are available for developers:

Command Effect
grunt electron-bundle (default) Build the desktop application and create zip bundles for various platforms.
grunt deb Build Debian packages.
grunt electron-build Build the desktop application without creating bundles.
grunt web-build Build the web application without uploading it.
grunt web-demo Build the web application and upload it to a server.
grunt pot Extract a template file (locales/messages.pot) for translation.

Install

Since Sozi 18.01, a Debian package is available for users of Debian or Ubuntu-based distributions.

sudo dpkg -i sozi_[...].deb

For other platforms, Sozi is released as a zip/tgz archive that you can extract wherever you like.

  • OS X users can drag the Sozi.app subfolder into their Applications folder.
  • Windows and Linux users can run the Sozi executable directly from the extracted folder.

If installation on your specific platform is supported by Sozi, there will be an install folder in the extracted archive containing installation scripts. To install Sozi system-wide:

cd Sozi-[...]/install
sudo ./install.sh

To install Sozi in your home folder:

cd Sozi-[...]/install
./install-local.sh

In many situations, Sozi will not need additional software to be installed. If Sozi complains about missing libraries, here is the list of all the known runtime dependencies of the Sozi executable:

libasound2
libatk1.0-0
libc6
libcairo2
libcups2
libdbus-1-3
libexpat1
libfontconfig1
libfreetype6
libgcc1
libgconf-2-4
libgdk-pixbuf2.0-0
libglib2.0-0
libgtk2.0-0
libnspr4
libnss3
libpango-1.0-0
libpangocairo-1.0-0
libstdc++6
libx11-6
libx11-xcb1
libxcb1
libxcomposite1
libxcursor1
libxdamage1
libxext6
libxfixes3
libxi6
libxrandr2
libxrender1
libxss1
libxtst6