Difference between revisions of "Kiwix-serve"

Jump to navigation Jump to search
Marked this version for translation
(Marked this version for translation)
Line 1: Line 1:
{{translations}}
{{translations}}
[[File:Kiwix_0.9_rc2_article_served_en_screenshot.png|right|thumb|<translate>Kiwix-serve, embedded in Kiwix, on a Microsoft Windows computer</translate>]]
[[File:Kiwix_0.9_rc2_article_served_en_screenshot.png|right|thumb|<translate><!--T:1-->
[[File:Two_kiwix-plugs.jpg|right|thumb|<translate>With [[Kiwix-plug]], kiwix-serve runs on pretty small hardwares</translate>]]
Kiwix-serve, embedded in Kiwix, on a Microsoft Windows computer</translate>]]
[[File:Two_kiwix-plugs.jpg|right|thumb|<translate><!--T:2-->
With [[Kiwix-plug]], kiwix-serve runs on pretty small hardwares</translate>]]


<translate>'''Kiwix-serve is a ZIM compatible Web server.''' With it's help you can deliver ZIM file content over your network.</translate>
<translate><!--T:3-->
'''Kiwix-serve is a ZIM compatible Web server.''' With it's help you can deliver ZIM file content over your network.</translate>


<translate>Based on the well known protocol HTTP, kiwix-serve allows you to share the [[Special:MyLanguage/Wikipedia_in_all_languages|ZIM files available]] on your computer easily with the other computers connected to your network. You simply need to start kiwix-serve on your computer and others will be able to access it with their own Web browser.</translate>
<translate><!--T:4-->
Based on the well known protocol HTTP, kiwix-serve allows you to share the [[Special:MyLanguage/Wikipedia_in_all_languages|ZIM files available]] on your computer easily with the other computers connected to your network. You simply need to start kiwix-serve on your computer and others will be able to access it with their own Web browser.</translate>


<translate>Kiwix-serve is a good solution if you have a LAN network and don't want to install Kiwix on all computers. It's a good alternative if you don't have a shared network disk from which everybody can start Kiwix.</translate>
<translate><!--T:5-->
Kiwix-serve is a good solution if you have a LAN network and don't want to install Kiwix on all computers. It's a good alternative if you don't have a shared network disk from which everybody can start Kiwix.</translate>


== <translate>Features</translate> ==
== <translate><!--T:6-->
<translate>Kiwix-serve has not so many features like Kiwix, but provides the most important ones:
Features</translate> ==
<translate><!--T:7-->
Kiwix-serve has not so many features like Kiwix, but provides the most important ones:
* Full text search engine
* Full text search engine
* Search suggestions
* Search suggestions
Line 20: Line 27:
* Able to deal with one ZIM file or XML library files</translate>
* Able to deal with one ZIM file or XML library files</translate>


== <translate>Get it</translate> ==
== <translate><!--T:8-->
<translate>On Microsoft Windows, Apple Mac OSX and GNU/Linux, kiwix-serve is packaged and distributed with Kiwix. You simply need to [[Special:MyLanguage/Software|download the Kiwix installer corresponding to your Operating System]].</translate>
Get it</translate> ==
<translate><!--T:9-->
On Microsoft Windows, Apple Mac OSX and GNU/Linux, kiwix-serve is packaged and distributed with Kiwix. You simply need to [[Special:MyLanguage/Software|download the Kiwix installer corresponding to your Operating System]].</translate>


<translate>We also provide [//sourceforge.net/projects/kiwix/files/ pre-compiled binaries for ARM GNU/Linux].</translate>
<translate><!--T:10-->
We also provide [//sourceforge.net/projects/kiwix/files/ pre-compiled binaries for ARM GNU/Linux].</translate>


<translate>For other systems, you will have to [[compilation|download and compile kiwix-serve source code on your own]].</translate>
<translate><!--T:11-->
For other systems, you will have to [[compilation|download and compile kiwix-serve source code on your own]].</translate>


== <translate>Use it</translate> ==
== <translate><!--T:12-->
<translate>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.</translate>
Use it</translate> ==
<translate><!--T:13-->
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.</translate>


<translate>Prerequisites:
<translate><!--T:14-->
Prerequisites:
* kiwix-serve binary, available in the Kiwix application directory
* 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 user profile).</translate>
* A ZIM file or a library file (you can use the library.xml file available in your Kiwix user profile).</translate>


<translate>Unix command line (just use kiwix-serve.exe on Microsoft Windows) example to start kiwix-serve with a XML library file:
<translate><!--T:15-->
Unix command line (just use kiwix-serve.exe on Microsoft Windows) example to start kiwix-serve with a XML library file:
<source lang="bash">
<source lang="bash">
kiwix-serve --library ~/.www.kiwix.org/kiwix/efrnsupg.default/library.xml
kiwix-serve --library ~/.www.kiwix.org/kiwix/efrnsupg.default/library.xml
</source></translate>
</source></translate>


<translate>Unix command line example to start kiwix-serve with a ZIM file:
<translate><!--T:16-->
Unix command line example to start kiwix-serve with a ZIM file:
<source lang="bash">
<source lang="bash">
kiwix-serve --port=8080 wikipedia.zim
kiwix-serve --port=8080 wikipedia.zim
</source></translate>
</source></translate>


<translate>One time kiwix-serve is started, everybody, who has access to this computer per 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:
<translate><!--T:17-->
One time kiwix-serve is started, everybody, who has access to this computer per 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:
<source lang="bash">
<source lang="bash">
http://xxx.xxx.xxx.xxx:80/
http://xxx.xxx.xxx.xxx:80/
</source></translate>
</source></translate>


== <translate>Options</translate> ==
== <translate><!--T:18-->
<translate>Kiwix-serve provides a few options:
Options</translate> ==
<translate><!--T:19-->
Kiwix-serve provides a few options:
* --port=PORT to specify the port you want to open for listening (per default 80)
* --port=PORT to specify the port you want to open for listening (per default 80)
* --index=foobar.ix to specify an fulltext index directory
* --index=foobar.ix to specify an fulltext index directory
Line 57: Line 76:
* --verbose to get a few logs</translate>
* --verbose to get a few logs</translate>


<translate>You can also run kiwix-serve without index, but in this case you won't have access to the fulltext search engine.</translate>
<translate><!--T:20-->
You can also run kiwix-serve without index, but in this case you won't have access to the fulltext search engine.</translate>


== <translate>See also</translate> ==
== <translate><!--T:21-->
<translate>* [http://library.kiwix.org kiwix-serve demonstration instance]
See also</translate> ==
<translate><!--T:22-->
* [http://library.kiwix.org kiwix-serve demonstration instance]
* [[kiwix-index]]
* [[kiwix-index]]
* [[kiwix-manage]]
* [[kiwix-manage]]
* [[kiwix-plug]]</translate>
* [[kiwix-plug]]</translate>

Navigation menu