Commit f32a61b6 authored by mitshel's avatar mitshel
Browse files

Изменения в README.md

parent f58a843b
Loading
Loading
Loading
Loading
+0 −2
Original line number Diff line number Diff line
covers/*
*.fb2
py/*.png
py/__pycache__/*
py/man.zip
py/ziptest.py
py/fb2parse.py
py/b64decode.py
+30 −16
Original line number Diff line number Diff line
@@ -3,41 +3,55 @@ Simple OPDS Catalog
Author: Dmitry V.Shelepnev
Версия 0.06

1. Установка:
Для работы скрипта sopds-scan.py необходимо установить следующие зависимости:
Установка Simple OPDS в Fedora:

1. Зависимости.
Для работы проекта необходимо установить следующие зависимости:
yum install httpd
yum install mysql
yum install python3
yum install mysql-connector-python3

2. Конфигурационный файл:
2. Установка.
Загрузить проект можно с сайта www.sopds.ru. 
Проект имеет следующую структуру:
opds				- каталог проекта (можно задать свое имя каталога)
	py			- каталог с программами на Python
	db			- каталог инициализационные скрипты для создания БД
	conf			- каталог с файлом конфигурации
	README.md		- файл README

Для работы CGI-скрипта необходимо разрешить доступ к каталогу opds, например при помощи следующих директив конфигурационного файла web-сервера Apache httpd.conf:

<Directory "/home/www/opds">
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
</Directory>
Alias   /opds           "/home/www/opds"

3. Конфигурационный файл.
Перед началом работы необходимо внести необходимые настройки в файл конфигурации ./conf/sopds.conf

3. Инициализация базы данных
4. Инициализация базы данных.
Для работы каталога необходимо создать(пересоздать) базу данных sopds при помощи скрипта:
./db/db_create.sh

4. Сканирование каталога с книгами
5. Сканирование каталога с книгами.
Для сканирования каталога с электронными книгами запустить скрипт sopds-scan.py

5. Доступ к OPDS каталогу через WWW
6. Доступ к OPDS каталогу через WWW.
Для сервера Apache необходимо разрешить запуск cgi-скрипта ./py/sopds.cgi
при помощи директивы, помещенной в .htacess:
  Options ExecCGI
или
  Options +ExecCGI

Для ограничения доступа добавьте в .htaccess
  AuthType Basic
  AuthName "SOPDS Library"
  AuthUserFile /home/www/.htpasswd
  require valid-user
Ну и конечно добавить пользователя и пароль в файл /home/www/.htpasswd при помощи утилиты htpasswd


6. Использование OPDS каталога с устройств поддерживающих OPDS
7. Использование OPDS каталога с устройств поддерживающих OPDS.
Ввести OPDS каталог и следующий URL: your_domain_name/opds/py/sopds.cgi

7. Обновление версий
8. Обновление версий
- Поскольку при переходе от версии к версии возможно изменение структуры БД необходимо пересоздать ее следующей командой
  ./db/db_create.sh
- После пересоздания БД и, как следствие уничтожении сыллок из БД на извлеченные обложки стоит удалить со всем содержимым