Kiwix-serve
A kiwix-serve egy ZIM-kompatibilis webkiszolgáló. A segítségével terjesztheti a ZIM-fájl tartalmát a hálózaton keresztül.
A jól ismert HTTP-protokoll alapján a kiwix-serve lehetővé teszi, hogy egyszerűen megossza a számítógépén elérhető ZIM-fájlokat másokkal, akik a hálózatra csatlakoztak. Egyszerűen csak el kell indítania a kiwix-serve kiszolgálót, és a tartalom elérhetővé válik bárki számára a saját webböngészőjén keresztül.
A kiwix-serve jó megoldás, ha van egy helyi hálózata és nem szeretné a Kiwix programot minden számítógépre telepíteni. Akkor is jó alternatíva, ha nem rendelkezik megosztott hálózati lemezzel, amelyről bárki elindíthatná a Kiwix programot.
Features
Kiwix-serve has not so many features like Kiwix, but provides the most important ones:
- Full text search engine
- Search suggestions
- Really small and efficient
- Compatible with almost all browsers
- Available on all platforms
- Available as command line executable
- Embedded in Kiwix UI
- Able to deal with one ZIM file or XML library files
Get it
On Microsoft Windows, Apple Mac OS X and GNU/Linux, kiwix-serve is packaged and distributed with Kiwix. You simply need to download the Kiwix installer corresponding to your Operating System.
We newly provide kiwix-serve as part of the Kiwix tools and pre-compiled binaries for many systems are available.
For other systems, you will have to download and compile kiwix-serve source code on your own.
Use it
Kiwix-serve is directly available in the Kiwix menu "Tools > server", but for people wanting to use it from the command line, here is how it works.
Prerequisites:
- kiwix-serve binary, available in the Kiwix application directory
- A ZIM file or a library file (you can use the library.xml file available in your Kiwix data directory).
Unix command line (just use kiwix-serve.exe on Microsoft Windows) example to start kiwix-serve with an XML library file:
kiwix-serve --library ~/.www.kiwix.org/kiwix/efrnsupg.default/data/library/library.xml
Unix command line example to start kiwix-serve with a ZIM file:
kiwix-serve --port=8080 wikipedia.zim
Once kiwix-serve is started, anyone with access to this computer over the network, will be able to connect to it. You need to retrieve the IP (xxx.xxx.xxx.xxx) of your computer and remember the port (per default 80) you have used and then people will only have to type in their browser address bar:
http://xxx.xxx.xxx.xxx:80/
Options
Kiwix-serve provides a few options:
- --port=PORT to specify the port you want to open for listening (per default 80)
- --index=foobar.idx to specify a fulltext index directory
- --daemon to execute the software in background
- --attachToProcess=PID to attach kiwix-serve process to other process
- --verbose to get a few logs
You can also run kiwix-serve without index, but in this case you won't have access to the fulltext search engine.