Giter VIP home page Giter VIP logo

sozi's Introduction

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 and the Grunt CLI. The build script for Sozi is known to work with Node.js 11 from Nodesource. 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 wine
sudo npm install grunt-cli -g

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

sudo apt install devscripts debhelper

From the root of the source tree:

npm install

Install the Droid Sans font:

  • 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 archives 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-archive (default) Build the desktop application and create zip archives for various platforms.
grunt deb Build Debian packages.
grunt electron-build Build the desktop application without creating archives.
grunt web-build Build the web application without uploading it.
grunt pot Extract a template file (locales/messages.pot) for translation.
grunt jsdoc Generate the API documentation.

Install

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

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

Alien can convert it to an RPM package by sudo alien --to-rpm.

For other platforms, Sozi is released as a zip/tar.xz 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

Helping debugging Sozi

While Sozi is running, press F12 to open the developer tools. Check the Console tab for error messages.

Some environment variables will enable debugging features in Sozi:

  • ELECTRON_ENABLE_LOGGING=1 sozi my-presentation.svg will display JavaScript console messages in the current terminal window.
  • SOZI_DEVTOOLS=1 sozi my-presentation.svg will open the developer tools immediately. This can be useful if F12 has no effect or when you want to debug events that happen at startup.

sozi's People

Contributors

alfonso-peixoto avatar aumouvantsillage avatar auzkok avatar colideum avatar comradekingu avatar darobin avatar dvvd avatar guillaume-savaton-eseo avatar guripreto avatar henrythebuilder avatar hermann12 avatar kai-wegner avatar lebendre avatar louies0623 avatar momeni avatar nathanbnm avatar nigelcunningham avatar oefeningen avatar polch avatar quent57 avatar rasidova2 avatar robertrosman avatar robinpecha avatar s-leroux avatar santossi avatar senshu avatar timvansteenbergen avatar tobiasbrunner avatar weblate avatar xendez avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.