Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [87b113] master /
History



File Date Author Commit
android 2014-06-13 Ross Combs Ross Combs [199ab9] Add two override fonts to cover the Gujarati an...
debian 2012-12-01 kelson42 kelson42 [f7b7dc] + update of the control files
desktop 2012-07-06 reg_ reg_ [98e47a] WARN dangerous: removed old autotools scripts.
dvd 2014-05-23 Kelson42 Kelson42 [e332bd] + new version able to deal on Windows with path...
etc 2012-07-06 reg_ reg_ [98e47a] WARN dangerous: removed old autotools scripts.
fedora 2010-04-17 kelson42 kelson42 [655512] unac is not used anymore
installer 2014-05-19 Kelson42 Kelson42 [614130] Replace 0.9rc3 by 0.9
kiwix 5 days ago kelson42 kelson42 [826e05] + read only *.xml files
src 2 days ago kelson42 kelson42 [8bafdd] + Return correct HTTP header for resources (ins...
static 4 days ago kelson42 kelson42 [c7f181] + fix Doctype HTML line (was breaking Opera out...
.gitignore 2014-05-19 kelson42 kelson42 [6dc93e] + Clean a little bit
AUTHORS 2013-12-08 Rashiq Ahmad Rashiq Ahmad [0e60a4] Filewriter integration + finally added my name ...
CHANGELOG 4 hours ago Seb35 Seb35 [87b113] Deal with multi-arch compilation architectures:...
COPYING 2009-11-28 kelson42 kelson42 [74e2d8] + small move of info files
Makefile.am 2014-05-30 kelson42 kelson42 [6cb010] Remove following line from install-exe-hook (wa...
OVERVIEW 2014-05-16 rgaudin rgaudin [d7951c] Added an OVERVIEW file to help debug OSX/deps
README 2014-05-19 Kelson42 Kelson42 [c72ebc] + replace "svn" by "git"
autogen.sh 2014-06-13 Ross Combs Ross Combs [199ab9] Add two override fonts to cover the Gujarati an...
build-kiwix-release.sh 2012-03-02 reg_ reg_ [99825e] updated sugar UI to match OLPC XO
build-kiwix-sugar.sh 2014-05-30 kelson42 kelson42 [e7d9fc] No ".svn" directory anymore
configure.ac 2 days ago Seb35 Seb35 [83a692] Deal with multi-arch compilation architectures,...
sign-osx-build.sh 2014-05-20 renaud gaudin renaud gaudin [34ed0f] Removed all remaining warnings from AppStore

Read Me

****************************************
* Kiwix                                *
****************************************

== Presentation ==
Kiwix is an offline reader for Web content. It's especially thought to
make Wikipedia available offline.  This is done by reading the content
of the project stored in a file format ZIM, a high compressed open
format with additional meta-data.

== Compilation ==
Read 'COMPILE' file

== Legal and disclaimer ==
Read 'COPYING' file

== Contact ==
Email: kiwix-developer@lists.sourceforge.net or contact@kiwix.org
Jabber: kelson@kiwix.org
IRC: #kiwix on irc.freenode.net join or use web interface http://chat.kiwix.org/

*********************************************************************
************* COMPILATION INSTRUCTIONS FOR KIWIX ********************
*********************************************************************

Take care, the paragraphs are about the *target platforms*. If you
want to build Kiwix for Android on a GNU/Linux system, you should
follow the instructions of the "Android" paragraph.

== GNU/Linux ==

=== Static ===

Kiwix uses shared libraries only. A static build of Kiwix is a build
which packages the dependencies.  Command line tools (indexer, server,
etc) are compiled statically.

# Run automake
./autogen.sh

# Run autoconf
./configure --enable-compileall --enable-staticbins --disable-android

# Download all dependencies
cd src/dependencies; make ; cd ../..

# Reconfigure with dependencies (Gecko version)
./configure --enable-compileall --enable-staticbins --disable-android

# Compile
make

# Creates tarbal suitable for distribution (no deps)
make diststatic

# If you want to be able to run directly from your dev repository copy
# the "xulrunner" directory in the distributation tarball to the
# "kiwix" sub-directory of your developement tree.

# Don't try to install with "make install", if you want to have kiwix
# install on your system just copy the directory in a /usr/local/bin
# directory.

== Dynamic ==

GNU/Linux build uses shared libraries by default. You will need the
following dependencies (also -dev packages) to compile Kiwix for Linux
(this list can vary a little bit depending of the GNU/Linux
distribution):
* g++
* gcc
* autoconf
* automake
* libtool
* pkg-config
* liblzma
* libicu
* libmicrohttpd
* zlib
* libcrypto++
* cmake
* wget
* aria2
* libuuid
* libssl
* libzim
* libpugixml
* libctpp2
* xulrunner

Debian is the only distribution providing natively all these
packages. Ubuntu provides most of them, excluding xulrunner and
zimlib. You will have to download and install them separatly or run
configure --with-static-dep=SELF. Then run the following commands:

# Run automake
./autogen.sh

# Configure the compilation
# check --help for options. Most dependencies accept --with-dep=XX and
# with-static-dep=XX.a. Static version of libraries are used for building
# static binaries (server, indexer, etc) Use --with-dep=SELF or
# --with-static-dep=SELF to trigger fetch and build for the dependency.
./configure

# Compile
make

# Optionaly install on the filesystem
sudo make install

== Mac OSX Universal ==

[warning] To build the Mac OS version you will have to install
proprietary software which are free of charge.
You will also need to build on an Apple Mac computer.

* Install OSX 10.6.5+ (proprietary)
* Install XCode 3.2.5+ (proprietary) -
  http://developer.apple.com/technologies/xcode.html (requires registration)
  http://download.kiwix.org/dev/xcode_3.2.5_and_ios_sdk_4.2_final.dmg
* Install Java
* Install MacPorts - http://www.macports.org/install.php

* Configure Macports

* Install the following tools and libraries
sudo port install autogen +universal pkgconfig +universal wget +universal gmake +universal coreutils +universal libidl +universal autoconf213 +universal icu +universal

./autogen.sh alt && ./configure --enable-compileall
cd src/dependencies && make
make clean
./autogen.sh alt && ./configure --enable-compileall --enable-compileall --disable-dependency-tracking --with-target-arch=i386
make
make distmac
make clean
./autogen.sh alt && ./configure --enable-compileall --enable-compileall --disable-dependency-tracking --with-target-arch=x86_64
make
make distmac
make universal

* Debugging tips:

- components file type can be either Mach-O dynamically linked shared library
  or Mach-O bundle but above instructions will create dynamic libraries.
- Shared Object (.so files on Linux) have .dylib extension on OSX.
- use dtruss to inspect program execution like strace.
- dyldinfo -lazy_bind | dyldinfo -bind components/zimAccessor.dylib |grep zim
- nm -gm components/zimAccessor.dylib | nm -u | nm -g
- otool -L libzim.dylib
- install_name_tool -change @executable_path/../libicuuc.dylib libicuuc.dylib kiwix-serve
- lldb


== Android ==

Android is just an additional target but you can still build for Android only
from a Linux or Mac (it cross-compiles).

* ./autogen.sh

* ./configure --disable-staticbins --disable-manager --disable-server --disable-launcher --disable-indexer --disable-installer --disable-searcher --disable-reader --disable-components --enable-android --enable-compileall

* cd src/dependencies && make android-deps && cd -

* cd android && ./build-android-with-native.py

== Windows ==

* Install Windows XP SP2+
* Install Visual Studio Express 2010
* Install 7-zip
* Install MozillaBuild 1.6
* Install ActivePerl
* Install Ruby
* Install NSIS 2.46
* Install nsis_locate
* Install nsis_uac
* Replace installed UAC.dll by new one.

* Install all software in default locations.

* Change your Windows PATH environment variable:
  - 7zip
  - NSIS
  - ruby
  - Perl
  - mozilla-build\msys\bin\

* Get shell from c:\mozilla-build\start-msvc10.bat

* mkdir -p /c/slave/windows-32b
  git clone git://git.code.sf.net/p/kiwix/kiwix kiwix
  cd kiwix
  ./autogen.sh alt
  ./configure --disable-indexer --enable-jar
  make win
  make windist
  make wininstaller