Commit f43a13ca authored by mitshel's avatar mitshel
Browse files

Попытка поравить README.md в стиле markdown

parent 519e840e

README.md

+156 −158
Original line number Diff line number Diff line 
Simple OPDS Catalog

Простой OPDS Каталог

Author: Dmitry V.Shelepnev

Версия 0.19

# Simple OPDS Catalog 

# Простой OPDS Каталог 

# Author: Dmitry V.Shelepnev 

# Версия 0.19 



1. Установка Simple OPDS в Fedora, RedHat, CentOS: 

--------------------------------------------------------------------------------------------------------------



-------------------------------------------------------------------------------------------------------

1.1 Зависимости. 

Требуется Mysql не ниже версии 5 (необходима поддержка хранимых процедур) 

Требуется Python не ниже версии 3.3 (используется атрибут zlib.Decompressor.eof, введенный в версии 3.3)
@@ -19,18 +18,19 @@ yum install mysql-connector-python3 
1.2 Установка. 

Загрузить проект можно с сайта www.sopds.ru. 

Проект имеет следующую структуру: 

opds				- каталог проекта (можно задать свое имя каталога)

	py			- каталог с программами на Python

	db			- каталог инициализационные скрипты для создания БД

	conf			- каталог с файлом конфигурации

	README.md		- файл README



>opds			- каталог проекта (можно задать свое имя каталога) 

>    py			- каталог с программами на Python 

>    db			- каталог инициализационные скрипты для создания БД 

>    conf		- каталог с файлом конфигурации 

>    README.md		- файл README 



1.3 Конфигурационный файл. 

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



1.4 Инициализация базы данных. 

Во первых для работы каталога необходимо создать базу данных "sopds" и пользователя с необходимыми правами, например

следующим образом:

Во первых для работы каталога необходимо создать базу данных "sopds" и пользователя с необходимыми правами,  

например следующим образом: 

     mysql -uroot -proot_pass mysql

     mysql > create database if not exists sopds default charset=utf8;

     mysql > grant select,insert,update,delete,execute on sopds.* to 'sopds'@'localhost' identified by 'sopds';
@@ -52,8 +52,8 @@ opds - каталог проекта (можно задать свое имя 
- Демон сканирования, который будет производить периодическое сканирование Вашей коллекции книг на основании настроек в 

  секции [scand] конфигурационного файла  

- Демон http-opds-сервера, который предоставит доступ к коллекции книг OPDS-клиентам (по умолчанию прослушивается порт 8081)

        на основании настроек в секции [httpd] конфигурационного файла. 

        Доступ к OPDS-каталогу в этом случае можно получить по адресу http://<Ваш Сервер>:8081/ 

  на основании настроек в секции [httpd] конфигурационного файла. Доступ к OPDS-каталогу в этом случае можно получить 

  по адресу http://<Ваш Сервер>:8081/ 



  Команда ./sopdsd.py stop    - приведет к остановке обеих процессов

  Команда ./sopdsd.py status  - покажет информацию о состоянии процессов
@@ -73,7 +73,6 @@ opds - каталог проекта (можно задать свое имя 
     rm -rf covers







2. Настройка конвертации fb2 в EPUB или MOBI (опционально, можно не настраивать)  

--------------------------------------------------------------------------------------------------------------------------
@@ -196,7 +195,6 @@ mod_wsgi. 
Одна из выявленных мной проблем совместимости скрипта sopds.wsgi с веб-сервером Apache состоит в том, что и SOPDS и Apache 

используют библиотеку "libexpat". И если версия libexpat, загруженная сервером Apache сильно отличается от той, которую 

нужна Питону, то происходит crash приложения sopds.wsgi.      

    

Подробное описание этой проблемы и возможных путей решений находится здесь:  

       https://code.google.com/p/modwsgi/wiki/IssuesWithExpatLibrary
@@ -211,4 +209,4 @@ mod_wsgi. 
       ln -s /usr/lib/libexpat.so.1.6.0 /usr/local/apache2/lib/libexpat.so  

       ln -s /usr/lib/libexpat.so.1.6.0 /usr/local/apache2/lib/libexpat.so.0  



    Ну и перезагрузуил Apache
 
Ну и перезагрузил Apache.

conf/sopds.conf

+2 −2
Original line number Diff line number Diff line
@@ -79,9 +79,9 @@ splittitles = 300 
# Опция temp_dir указывает в каком каталоге создавать временные файлы во время преобразования fb2toepub

#fb2toepub=../fb2toepub/unix_dist/fb2toepub

#fb2toepub=../fb2epub/fb2epub

#fb2toepub=../fb2conv/fb2epub

fb2toepub=../fb2conv/fb2epub

#fb2tomobi=../fb2conv/fb2mobi

#temp_dir=/tmp

temp_dir=/tmp



# При установке опции single_commit = yes, данные записываемые сканером в БД коммитятся один раз при окончании сканирования

# Если single_commit = no то коммиты происходят кажды раз при добавлении книги в БД.