turns a collection of documents into a browsable ZIM file
Project description
Nautilus
nautilus turns a collection of documents into a browsable ZIM file.
It downloads the video (webm or mp4 format – optionnaly recompress them in lower-quality, smaller size), the thumbnails, the subtitles and the authors' profile pictures ; then, it create a static HTML files folder of it before creating a ZIM off of it.
Preparing the archive
To be used with nautilus, your archive should be a ZIP file.
- it doesn't need to be structured, but it can.
- it doesn't need to be compressed. It's usually recommended not to.
- it should contain a
collection.jsonfile, but not required (see bellow). - it should only contain to-be-included files. No filtering is done.
- Audio and video files should be in ogg format with
.ogg/.ogvextension to be supported on all platform (mp3/mp4would work only on platform with native support).
cd content/path
zip -r -0 -T ../content_name.zip *
JSON collection file
Either inside the archive ZIP as /collection.json or elsewhere,
specified via --collection mycollection.json, you must supply a JSON file describing your content.
The user-interface only gives access to files referenced properly in the collection.
At the moment, the JSON files needs to provide the following fields for each item in an Array:
[
{
"title": "...",
"description": "...",
"authors": "...",
"files": ["relative/path/to/file"]
}
]
About page
Either inside the archive ZIP as /about.html or elsewhere, specified via --about myabout.html,
you may supply an about page in HTML format. It will be displayed in a modal popup and will include
at its bottom your secondary-logo if provided.
- Use only content tags (no
<html />nor<head />nor<script />etc) - Use inline styling if required but no styling is recommended.
- Include one logo inline if required.
Requirements
zimwriterfsfor ZIM file packaging. Use--no-zimto skip this step.wgetandunzipto install JS dependencies. Seeget_js_deps.shif you want to do it manually.wgetis used to download archive files as well.handlebarsis used to compile JS templates
Installation
nautilus is a python program. if you are not using the docker image, you are advised to use it in a virtualenv. See requirements.txt for the list of python dependencies.
docker
docker run -v my_dir:/output openzim/nautilus nautiluszim --help
pip
pip install nautiluszim
nautiluszim --help
Usage
nautiluszim --archive my-content.zip
Notes
- On macOS, the locale setting is buggy. You need to launch it with
LANGUAGEenvironment variable (as ISO-639-1) for the translations to work.
LANGUAGE=fr nautiluszim --language fra
Development
See CONTRIBUTING.md
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file nautiluszim-1.0.4.tar.gz.
File metadata
- Download URL: nautiluszim-1.0.4.tar.gz
- Upload date:
- Size: 4.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 87fb87cbcc2481f30e992800f9ecac272a7226fc43e9cab68658b51a78912ff9 |
|
| MD5 | da7d29bf37d882f88a8dd945222c0e3f |
|
| BLAKE2b-256 | 3e41d083782024113842cc978ecb372435ba3fe764b26c4222261da373120162 |
File details
Details for the file nautiluszim-1.0.4-py3-none-any.whl.
File metadata
- Download URL: nautiluszim-1.0.4-py3-none-any.whl
- Upload date:
- Size: 4.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9263f97560301cf967e2978293a00c649edf6f60b1909596617502ca3570bcb6 |
|
| MD5 | 6d92945a672d7f8ce60bd331ee9a7019 |
|
| BLAKE2b-256 | 30e1ef424914cc7413818c8eedea43dd0468bb3fe711b2ebc31f49f3e639991b |
