Difference between revisions of "FAQ"

From Kiwix
Jump to navigation Jump to search
(ZIM file is too big and new content -> at the top, +infos)
(style (more compact view))
Line 2: Line 2:
<translate><!--T:15-->
<translate><!--T:15-->
This is the Kiwix '''Frequently Asked Questions''' (or '''FAQ''') page. If you don't find an answer to your question, please consider to read the [[Special:MyLanguage/Help|Help page]] or visit our [http://forum.kiwix.org Forum].</translate>
This is the Kiwix '''Frequently Asked Questions''' (or '''FAQ''') page. If you don't find an answer to your question, please consider to read the [[Special:MyLanguage/Help|Help page]] or visit our [http://forum.kiwix.org Forum].</translate>


{{FAQ_entry|question=<translate><!--T:3-->
{{FAQ_entry|question=<translate><!--T:3-->
Where can I find new content?</translate>|answer=<translate><!--T:4-->
Where can I find new content?</translate>|answer=<translate><!--T:4-->
Kiwix uses the [http://openzim.org ZIM format]. We release [[Wikipedia in all languages|our own ZIM files]] which are available for download in the Kiwix library (in the software). You can also use the [https://en.wikipedia.org/wiki/Special:Book Book creator] on Wikipedia to generate your own ZIM files.</translate>}}
Kiwix uses the [http://openzim.org ZIM format]. We release [[Wikipedia in all languages|our own ZIM files]] which are available for download in the Kiwix library (in the software). You can also use the [https://en.wikipedia.org/wiki/Special:Book Book creator] on Wikipedia to generate your own ZIM files.</translate>}}


{{FAQ_entry|question=<translate><!--T:25-->
{{FAQ_entry|question=<translate><!--T:25-->
Line 16: Line 14:
* On GNU/Linux and with the console: split --bytes=2000M my_big_file.zim
* On GNU/Linux and with the console: split --bytes=2000M my_big_file.zim
</translate>}}
</translate>}}


{{FAQ_entry|question=<translate><!--T:1-->
{{FAQ_entry|question=<translate><!--T:1-->
Why is Kiwix not available for PPC Macs?</translate>|answer=<translate><!--T:2-->
Why is Kiwix not available for PPC Macs?</translate>|answer=<translate><!--T:2-->
We do not have a PPC architectured Mac and this architecture is outdated.</translate>}}
We do not have a PPC architectured Mac and this architecture is outdated.</translate>}}


{{FAQ_entry|question=<translate><!--T:5-->
{{FAQ_entry|question=<translate><!--T:5-->
Is it possible to update a ZIM file?</translate>|answer=<translate><!--T:6-->
Is it possible to update a ZIM file?</translate>|answer=<translate><!--T:6-->
It is not possible to update a ZIM file itself, but you may download a new ZIM file with updated versions of the contents.</translate>}}
It is not possible to update a ZIM file itself, but you may download a new ZIM file with updated versions of the contents.</translate>}}


{{FAQ_entry|question=<translate><!--T:7-->
{{FAQ_entry|question=<translate><!--T:7-->
How can I build a ZIM file by myself?</translate>|answer=<translate><!--T:8-->
How can I build a ZIM file by myself?</translate>|answer=<translate><!--T:8-->
To export articles from Wikipedia and other Wikimedia projects, please go to their [http://en.wikipedia.org/w/index.php?title=Special:Book Special:Book]. For any other use case, this is unfortunately still too complicated (in short: parsoid needs to be [[mw:Parsoid/Setup|installed]], then [https://sourceforge.net/p/kiwix/other/ci/master/tree/mwoffliner/mwoffliner.js mwoffliner] + zimwriterfs). Please read [http://openzim.org/Build_your_ZIM_file this page] if you want to have some information.</translate>}}
To export articles from Wikipedia and other Wikimedia projects, please go to their [http://en.wikipedia.org/w/index.php?title=Special:Book Special:Book]. For any other use case, this is unfortunately still too complicated (in short: parsoid needs to be [[mw:Parsoid/Setup|installed]], then [https://sourceforge.net/p/kiwix/other/ci/master/tree/mwoffliner/mwoffliner.js mwoffliner] + zimwriterfs). Please read [http://openzim.org/Build_your_ZIM_file this page] if you want to have some information.</translate>}}


{{FAQ_entry|question=<translate><!--T:9-->
{{FAQ_entry|question=<translate><!--T:9-->
How may I optimize the search engine index?</translate>|answer=<translate><!--T:10-->
How may I optimize the search engine index?</translate>|answer=<translate><!--T:10-->
Launch the script "./kiwix-compact" (only available on GNU/Linux) and this should reduce disk use by almost 50%</translate>}}
Launch the script "./kiwix-compact" (only available on GNU/Linux) and this should reduce disk use by almost 50%</translate>}}


{{FAQ_entry|question=<translate><!--T:11-->
{{FAQ_entry|question=<translate><!--T:11-->
How to install a pre-indexed ZIM file on Mac OSX?</translate>|answer=<translate><!--T:12-->
How to install a pre-indexed ZIM file on Mac OSX?</translate>|answer=<translate><!--T:12-->
Move or copy the "data" directory in "/Applications/Kiwix.app/Contents/". You will probably need to go to the Kiwix "library" to load the ZIM content.</translate>}}
Move or copy the "data" directory in "/Applications/Kiwix.app/Contents/". You will probably need to go to the Kiwix "library" to load the ZIM content.</translate>}}


{{FAQ_entry|question=<translate><!--T:13-->
{{FAQ_entry|question=<translate><!--T:13-->
Is there a user forum where kiwix users can exchange experiences and help each other?</translate>|answer=<translate><!--T:14-->
Is there a user forum where kiwix users can exchange experiences and help each other?</translate>|answer=<translate><!--T:14-->
Yes, it is located at [http://forum.kiwix.org https://forum.kiwix.org]</translate>}}
Yes, it is located at [http://forum.kiwix.org https://forum.kiwix.org]</translate>}}


{{FAQ_entry|question=<translate><!--T:16-->
{{FAQ_entry|question=<translate><!--T:16-->
I have downloaded a ZIP file (pre-indexed ZIM file) but I can't unpack it, the file seems to be corrupted. What should I do?</translate>|answer=<translate><!--T:17-->
I have downloaded a ZIP file (pre-indexed ZIM file) but I can't unpack it, the file seems to be corrupted. What should I do?</translate>|answer=<translate><!--T:17-->
Use an unpacking software which supports the ZIP64 format (ZIP format for big files), like for example [http://www.7-zip.org/ 7-zip]. If this still fails, then your file was corrupted during the transfer, please restart the download using Bittorrent, then it will work.</translate>}}
Use an unpacking software which supports the ZIP64 format (ZIP format for big files), like for example [http://www.7-zip.org/ 7-zip]. If this still fails, then your file was corrupted during the transfer, please restart the download using Bittorrent, then it will work.</translate>}}


{{FAQ_entry|question=<translate><!--T:21-->
{{FAQ_entry|question=<translate><!--T:21-->
I can't copy Kiwix on my USB flash drive because the index files (*.idx directory) are too big.</translate>|answer=<translate><!--T:22-->
I can't copy Kiwix on my USB flash drive because the index files (*.idx directory) are too big.</translate>|answer=<translate><!--T:22-->
USB flash drives are often formated using the FAT32 filesystem which can't store files bigger than 4GB. We recommend to use [http://en.wikipedia.org/wiki/ExFAT exFAT] or [http://en.wikipedia.org/wiki/NTFS NTFS] which can deal with big files and is broadly supported.</translate>}}
USB flash drives are often formated using the FAT32 filesystem which can't store files bigger than 4GB. We recommend to use [http://en.wikipedia.org/wiki/ExFAT exFAT] or [http://en.wikipedia.org/wiki/NTFS NTFS] which can deal with big files and is broadly supported.</translate>}}


{{FAQ_entry|question=<translate><!--T:23-->
{{FAQ_entry|question=<translate><!--T:23-->
How can I launch Kiwix with a specific article?</translate>|answer=<translate><!--T:24-->
How can I launch Kiwix with a specific article?</translate>|answer=<translate><!--T:24-->
You need to launch Kiwix from the command line using the -articleByUrl option. For example:</translate><source lang="bash">kiwix.exe -articleByUrl "zim://A/foo.html" bar.zim</source>}}
You need to launch Kiwix from the command line using the -articleByUrl option. For example:</translate><source lang="bash">kiwix.exe -articleByUrl "zim://A/foo.html" bar.zim</source>}}


== <translate><!--T:18-->
== <translate><!--T:18-->

Revision as of 10:54, 31 October 2014

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎azərbaycanca • ‎català • ‎español • ‎français • ‎galego • ‎italiano • ‎lietuvių • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎العربية • ‎فارسی • ‎বাংলা • ‎中文 • ‎中文(简体)‎ • ‎日本語

This is the Kiwix Frequently Asked Questions (or FAQ) page. If you don't find an answer to your question, please consider to read the Help page or visit our Forum.

Where can I find new content?
Kiwix uses the ZIM format. We release our own ZIM files which are available for download in the Kiwix library (in the software). You can also use the Book creator on Wikipedia to generate your own ZIM files.
My ZIM file is too big, what should I do?
USB flash drives and memory cards are often formated using the FAT32 filesystem which can't store files bigger than 4GB. Kiwix is able to deal with 2GB splitted ZIM files. The splitted ZIM files must be named xxx.zimaa, xxx.zimab, xxx.zimac, etc. To split a ZIM file you may use:
  • On Microsoft Windows: FSJ-Lite,
  • On Apple Mac OSX: Split&Concat
  • On GNU/Linux and with the console: split --bytes=2000M my_big_file.zim
Why is Kiwix not available for PPC Macs?
We do not have a PPC architectured Mac and this architecture is outdated.
Is it possible to update a ZIM file?
It is not possible to update a ZIM file itself, but you may download a new ZIM file with updated versions of the contents.
How can I build a ZIM file by myself?
To export articles from Wikipedia and other Wikimedia projects, please go to their Special:Book. For any other use case, this is unfortunately still too complicated (in short: parsoid needs to be installed, then mwoffliner + zimwriterfs). Please read this page if you want to have some information.
How may I optimize the search engine index?
Launch the script "./kiwix-compact" (only available on GNU/Linux) and this should reduce disk use by almost 50%
How to install a pre-indexed ZIM file on Mac OSX?
Move or copy the "data" directory in "/Applications/Kiwix.app/Contents/". You will probably need to go to the Kiwix "library" to load the ZIM content.
Is there a user forum where kiwix users can exchange experiences and help each other?
Yes, it is located at https://forum.kiwix.org
I have downloaded a ZIP file (pre-indexed ZIM file) but I can't unpack it, the file seems to be corrupted. What should I do?
Use an unpacking software which supports the ZIP64 format (ZIP format for big files), like for example 7-zip. If this still fails, then your file was corrupted during the transfer, please restart the download using Bittorrent, then it will work.
I can't copy Kiwix on my USB flash drive because the index files (*.idx directory) are too big.
USB flash drives are often formated using the FAT32 filesystem which can't store files bigger than 4GB. We recommend to use exFAT or NTFS which can deal with big files and is broadly supported.
How can I launch Kiwix with a specific article?
You need to launch Kiwix from the command line using the -articleByUrl option. For example:
kiwix.exe -articleByUrl "zim://A/foo.html" bar.zim

See also