# kiwix-tools/cfg - "Build" settings for package

#---------------------------------------------------------------------

[technotes]

1. The source tarball used by this package was created  based on "git"
upstream sources. The sources were obtained as follows:

    ocgitfetch --run \
--checkout=3.8.2 \
https://github.com/kiwix/kiwix-tools.git

#---------------------------------------------------------------------

2. This package installs, among other components, a daemon that can be
started and stopped as follows:

      service kiwix start       # start
      service kiwix stop        # stop

The daemon is started automatically at boot time.

#---------------------------------------------------------------------

3. While the daemon is running,  an etext web interface [specifically,
the Kiwix web interface] is available on the local system at:

      http://localhost:3500/

#---------------------------------------------------------------------

4. The daemon serves ZIM files that are stored in the following direc-
tory:
      /static/zim/

To add more ZIM files,  simply copy them into the  indicated directory
and then [as root] execute:

      service kiwix restart

#---------------------------------------------------------------------

5. For best results:

Use the UChromium web browser. Install the browser extension "stylus".
Add the following style in "stylus":

.mw-body-content {
    font-size:6mm
}

Apply the style to URLs starting with:

http://localhost:3500/

#---------------------------------------------------------------------

6. "kiwix-tools" replaces Qt6-based ZIM-file browsers such as "golden-
dict-ng" and "kiwix-desktop".

Note:  As of mid-2026,  Qt6-based approaches had become unreliable and
"kiwix-tools" output was arguably closer  to the original web-page ex-
perience regardless.

#---------------------------------------------------------------------

[buildtimes]

#---------------------------------------------------------------------

[settings]
compiler = clang
license  = See "license*.txt" in installed tree
licfile  = COPYING

#---------------------------------------------------------------------

[depends]
brotli
curl
gnutls3
libdocopt
libffi
libgmp
libicu
libidn2
libkiwix
libmicrohttpd
libpsl
librtmp
libsasl
libssh2
libunistring
libzim
meson
nettle3
ninja
openssl
openssl3
p11kit
util-linux
xapian
xzutils
zlib
zstd

#---------------------------------------------------------------------

[configure]
killany -w kiwix-serve

PATH=$PRODTREE/python3/bin:$PATH
PP=$PKGDIR_PROD

rm -fr lacobj && mkdir lacobj && cd lacobj
#
meson setup \
    -D prefix=$PP                \
    -D bindir=$PP/bin            \
    -D buildtype=release         \
    -D includedir=$PP/include    \
    -D libdir=$PP/lib            \
    -D mandir=$PP/man

#---------------------------------------------------------------------

[build]
cd lacobj && ninja_simple_build

#---------------------------------------------------------------------

[postbuild]
BINDIR=$PKGDIR_PROD/bin
mkdir -p $BINDIR

cd $BINDIR
cp -p $PKGDIR_SPECIAL/kiwix-view .
chmod 755             kiwix-view

mkdir -p /etc/init.d/
INITFILE=/etc/init.d/kiwix
cp -p $PKGDIR_SPECIAL/init.d-kiwix $INITFILE
chmod 755 $INITFILE

#---------------------------------------------------------------------

[setup.boot]
service kiwix start

#---------------------------------------------------------------------

# Original URLs. These URLs were valid at one point, but may have died
# since then. If you download newer versions of tarballs [etc.], don't
# delete  the  original versions,  as you may not  be able  to replace
# them.

[urls]
url_debian  = tbd
url_home    = tbd
url_lfs     = tbd
url_tarball = git               # See "technotes" in "cfg" file

#---------------------------------------------------------------------

[history]
260505 Added package
260505 Started with f76e38bdc ("git" hash)