Difference between revisions of "FAQ"

Jump to navigation Jump to search
1,487 bytes added ,  4 years ago
Remove documentation about splitting ZIM files
(Remove documentation about splitting ZIM files)
 
(31 intermediate revisions by 6 users not shown)
Line 5: Line 5:
{{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 [[{{ll|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-->
My ZIM file is too big, what should I do?</translate>|answer=<translate><!--T:26-->
My ZIM file is too big, what should I do?</translate>|answer=<translate><!--T:26-->
USB flash drives and memory cards are often formatted 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:</translate>
USB flash drives and memory cards are often formatted using the FAT32 filesystem which can't store files bigger than 4GB. Better use exFat, or any modern filesystem, and then you will be able to store big ZIM files.</translate>}}
<translate>
* On Microsoft Windows: [http://www.jaist.ac.jp/~hoangle/filesj/ FSJ-Lite],</translate>
<translate>
* On Apple Mac OSX: [http://loekjehe.home.xs4all.nl/Split&Concat/ Split&Concat]</translate>
<translate>
* On GNU/Linux and with the console: split --bytes=2000M my_big_file.zim
</translate>
 
<translate>To be readable by Kiwix, all chunks must be located in the same folder. Open then the xxx.zimaa file with Kiwix.</translate>
}}


{{FAQ_entry|question=<translate><!--T:1-->
{{FAQ_entry|question=<translate><!--T:1-->
Line 31: Line 21:
{{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 [<tvar|1>https://www.mediawiki.org/wiki/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-->
Line 38: Line 28:


{{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 OS X?</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>}}


Line 48: Line 38:
I have downloaded a ZIP file (pre-indexed ZIM file) but I can't unzip 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 unzip 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:42-->
How do I check the integrity of my ZIM file?</translate>|answer=<translate><!--T:43-->
You can retrieve the checksums for each file we serve online using this pattern: <source>kiwix-filename.zim.mirrorlist</source>Example: <source>https://download.kiwix.org/zim/wikipedia/wikipedia_en_all_novid_2018-06.zim.mirrorlist</source></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 formatted 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 formatted 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 are 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>}}
{{FAQ_entry|question=<translate><!--T:31-->
I have a downloaded a .torrent file, but the download does not progress in my BitTorrent client.</translate>|answer=<translate><!--T:32-->
There are a few reasons why the download with BitTorrent might failed, most of them are related to the usage of [https://en.wikipedia.org/wiki/BitTorrent#Web_seeding web seeds]:</translate>
* <translate><!--T:33-->
Your computer is behind a proxy, you need to configure your BitTorrent correctly to use it</translate>.
* <translate><!--T:34-->
Your computer is part of a local network with custom network rules forbidding the BitTorrent usage, you should complain to your network system administrator.</translate>
* <translate><!--T:35-->
Your BitTorrent client does not support web seeds (correctly), please try with a better one (for example, [http://deluge-torrent.org/ Deluge]).</translate>}}
{{FAQ_entry|question=<translate><!--T:36-->
Where are located, on my computer, the content files I have downloaded?</translate>|answer=<translate>
<!--T:37-->
If you have used the Kiwix library, the content are stored:</translate>
<translate><!--T:38-->
* On OS X:</translate> <source lang="bash">/Users/<LOGIN>/Library/Application Support/Kiwix/Profiles/<PROFILE>/data/</source>
<translate><!--T:39-->
* On GNU/Linux:</translate> <source lang="bash">/home/<LOGIN>/.www.kiwix.org/kiwix/<PROFILE>/data/</source>
<translate><!--T:40-->
* On Windows:</translate> <source lang="bash">C:Documents and Settings<LOGIN>Application Datawww.kiwix.orgKiwixProfiles<PROFILE>data</source>}}


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

Navigation menu