add readme

This commit is contained in:
Jan-Marten Brüggemann 2024-09-14 01:28:48 +02:00
parent 5749fb4db1
commit ab3949db50

36
README.md Normal file
View file

@ -0,0 +1,36 @@
# Sync Kiwix
This is a small script to synchronize kiwix zim files from the official repository
## Requirements
You will need conda. See https://conda.io/projects/conda/en/latest/user-guide/install/index.html for installation instructions.
## Install
Clone this repo:
```bash
git clone https://git.fusselkater.org/fusselkater/sync_kiwix.git
```
Change into the sync_kiwix directory and install the conda environment:
```bash
conda env create -f environment.yml
```
## Usage
Activate the conda environment:
```bash
conda activate sync_kiwix
```
Run the script:
```bash
python ./sync_kiwix.py --help
```
The output of `--help` will show you the available commands.
### Example
To download the archlinux wiki:
```bash
python sync_kiwix.py archlinux_en_all_maxi .
```