Commit a39022f9 authored by Dmitry Shelepnev's avatar Dmitry Shelepnev
Browse files

Update README.md

parent 23bafb4f
Loading
Loading
Loading
Loading
+51 −6
Original line number Diff line number Diff line
@@ -30,6 +30,7 @@
	SOPDS_AUTH = < False | True >
	SOPDS_SCAN_SHED_MIN  = '0'
	SOPDS_SCAN_SHED_HOUR = '0,12'
	SOPDS_INPX_ENABLE = < False | True >
    
1.4 Производим инициализацию базы данных и заполнение начальными данными (жанры)

@@ -137,10 +138,54 @@ UBUNTU: для работы с БД Mysql в UBUNTU потребовалось
	python3 manage.py sopds_server stop
	python3 manage.py sopds_scanner stop
	
#### 3. Настройка базы данных PostgreSQL (опционально, наилучший вариант использования программы Sumple OPDS).
3.1 PostgreSQL - является наилучшим вариантом использования ПО Simple OPDS. Однако для этого неоюбходимо установить БД
    и настроить ее (подробное описание можно найти в Интернет, напримр здесь: http://alexxkn.ru/node/42)

#### 3. Настройка конвертации fb2 в EPUB или MOBI (опционально, можно не настраивать)  
CentOS7: для работы с БД PostgreSQL в CentOS7 потребовалось установить доп пакет psycopg2:   
   
3.1 Конвертер fb2-to-epub http://code.google.com/p/fb2-to-epub-converter/
    pip3 install psycopg2

Далее необходимо сначала в БД PostgreSQL создать базу данных "sopds" и пользователя с необходимыми правами,
например следующим образом:

	psql -U postgres
	Password for user postgres: *****
	postgres=# create role sopds with password 'sopds' login;
	postgres=# create database sopds with owner sopds;
	postgres=# \q
	
3.2 Далее в конфигурационном файде нужно закомментировать строки подключения к БД sqlite и соответсвенно раскомментировать
строки подключения к БД PostgreSQL:

	DATABASES = {
	    'default': {
	    'ENGINE': 'django.db.backends.postgresql_psycopg2',
	    'NAME': 'sopds',
	    'USER': 'sopds',
	    'PASSWORD': 'sopds',
	    'HOST': '', # Set to empty string for localhost.
	    'PORT': '', # Set to empty string for default.
	    }
	}


    # DATABASES = {
    #    'default': {
    #        'ENGINE': 'django.db.backends.sqlite3',
    #        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    #    }         
    #}  

3.4 Далее необходимо для инициализации и заполнения вновь созданной БД заново выполнить пункты 1.4 - 1.9 данной инструкции
Однако, если Вы уже ранее запустили HTTP/OPDS сервер и SCANNER сервер, то потребуется сначала остановить их:

	python3 manage.py sopds_server stop
	python3 manage.py sopds_scanner stop
	
#### 4. Настройка конвертации fb2 в EPUB или MOBI (опционально, можно не настраивать)  

4.1 Конвертер fb2-to-epub http://code.google.com/p/fb2-to-epub-converter/
- во первых необходимо скачать последнюю версию конвертера fb2toepub по ссылке выше (текущая уже находится в проекте)
  к сожалению конвертер не совершенный и не все книги может конвертировать, но большинство все-таки конвертируется 
- далее, необходимо скопировать архив в папку **./convert/fb2toepub** и разархивировать 
@@ -151,14 +196,14 @@ UBUNTU: для работы с БД Mysql в UBUNTU потребовалось

- В результате OPDS-клиенту будут предоставлятся ссылки на FB2-книгу в формате epub  

3.2 Конвертер fb2epub http://code.google.com/p/epub-tools/ (конвертер написан на Java, так что в вашей системе должнен быть установлен как минимум JDK 1.5)  
4.2 Конвертер fb2epub http://code.google.com/p/epub-tools/ (конвертер написан на Java, так что в вашей системе должнен быть установлен как минимум JDK 1.5)  
- также сначала скачать последнюю версию по ссылке выше (текущая уже находится в проекте)  
- скопировать jar-файл например в каталог **./convert/fb2epub** (Здесь уже лежит shell-скрипт для запуска jar-файла)  
- Соответственно прописать пути в файле конфигурации **./sopds/settings.py** к shell-скрипту fb2epub (данный конвертер работает также и в Windows) 

>     SOPDS_FB2TOEPUB = os.path.join(BASE_DIR, 'convert\\fb2epub\\fb2epub.cmd' if sys.platform =='win32' else 'convert/fb2epub/fb2epub' )

3.3 Конвертер fb2conv (конвертация в epub и mobi) http://www.the-ebook.org/forum/viewtopic.php?t=28447  
4.3 Конвертер fb2conv (конвертация в epub и mobi) http://www.the-ebook.org/forum/viewtopic.php?t=28447  
- Необходимо установить python 2.7 и пакеты lxml, cssutils:   
  
         yum install python  
@@ -175,7 +220,7 @@ UBUNTU: для работы с БД Mysql в UBUNTU потребовалось
>     SOPDS_FB2TOEPUB = os.path.join(BASE_DIR,'convert/fb2conv/fb2epub')
>     SOPDS_FB2TOMOBI = os.path.join(BASE_DIR,'convert/fb2conv/fb2mobi')

#### 4. Консольные команды Simple OPDS  
#### 5. Консольные команды Simple OPDS  

Показать информацию о коллекции книг:  

@@ -198,7 +243,7 @@ UBUNTU: для работы с БД Mysql в UBUNTU потребовалось
    python3 manage.py sopds_server start [--host <IP address>] [--port <port N>] [--daemon]    


#### 5. Опции каталогизатора Simple OPDS (www.sopds.ru)
#### 6. Опции каталогизатора Simple OPDS (www.sopds.ru)
Каталогизатор Simple OPDS имеет дополнительные настройки которые можно указывать в конце файла sopds/settings.py  

**SOPDS_ROOT_LIB** - содержит путь к каталогу, в котором расположена ваша коллекция книг.