Kiwix-manage

From Kiwix
Revision as of 11:18, 10 September 2011 by Kelson (talk | contribs) (→‎Usage)
Jump to navigation Jump to search

kiwix-manage is a console tool which allows to build library files for Kiwix. A library file is an XML flat file listing ZIM files with all the necessary informations like (favicon, date, creator, description, indexpath, filepath, title, source/metalink, ...).

kiwix-manage generated files are thought for two usages:

  • Local library file for kiwix-serve (need to be implemented in kiwix-serve)
  • Remote/portable library file for the Kiwix software, providing a list of downloadable content (example).

By the way, an intern library file is also managed an build directly by Kiwix, following the user behaviour (adding, removing new content)... and the format is exactly the same.

Technical details

kiwix-manage is based on a kiwix::Manager class coded in C++ and using a simple/fast/protable XML/DOM XML library (pugixml). To extract content from the ZIM file, it will use the zimlib code.

Usage

kiwix-manage LIBRARY_FILE add ZIM_FILE [METALINK URL/FILE] ...
kiwix-manage LIBRARY_FILE show [CONTENTID1] [CONTENTID2] ... (show everything if no param.)
kiwix-manage LIBRARY_FILE remove CONTENTID1 [CONTENTID2] ...

See also