DmitrijMay 18, 2019, 3:29 p.m.

Читалка fb3-файлов на Qt Creator

Content

Некоторое время назад я опубликовал проект fb2-читалки, в процессе работы над которой я узнал, что данный формат является морально устаревшим. Поэтому я начал осваивать новые форматы и остановился на fb3 — формате-приемнике fb2. В процессе работы я столкнулся с некоторыми проблемами, которые не решены в полном объёме. К тому же, несмотря на то, что книги в fb3 уже появляются, формат окончательно не утверждён. Хотя книги уже появляются. Поэтому я решил опубликовать программу в текущем виде и рассказать о своих достижениях и неудачах. Впоследствии я планирую новую версию с поддержкой формата epub.

fb3

Файл fb3 является zip-контейнером, в котором находятся элементы книги. Поэтому я реализовал следующий алгоритм. Распаковываем все файлы во временную папку и считываем из неё все необходимые элементы.

if(name.endsWith(".fb3"))
{
    QString s = thisName;
    QString nameUn = QStandardPaths::standardLocations(QStandardPaths::TempLocation).at(0)
                    + "/dmreader/" + s;

    if(!openerTextFiles::UnZip(name, nameUn)) // распаковка архива
        qDebug() << "файл " << name << " не открыт";
    else
    {
        // извлекаем содержимое
        openerTextFiles::openFBFile(nameUn + "/fb3/body.xml", &text, &content); 
        // помещаем содержимое в окно textBrowser
        ui->textBrowser->setText(text);
        ui->textBrowser->verticalScrollBar()->setValue(0);
        ui->comboBoxContent->insertItems(0, content);
        ui->comboBoxContent->setCurrentIndex(-1);
        this->setWindowTitle(content.first());
    }
}

Типовой файл содержит:

Папка fb3 содержит основную информацию, в частности два ключевых элемента body.xml — текст книги и description.xml — аннотацию книги, которые соответствуют основным блокам файла fb2. Папка img содержит иллюстрации книги.
Структура body.xml за некоторыми поправками структуре fb2. Поправки направлены на расширение функциональности и упрощение структуры. Добавлены тэги ol, ul, li для создания списков. blockquote – цитата, em – акцентирования текста (курсив), pre – блок предварительно форматированного текста идентичные html. Тэги underline (подчёркнутый) и spacing (разряженный) можно реализовать следующими заменами:

<span style=\"text-decoration:underline;\">
<span style=\"letter-spacing:5px;\">

Также несколько модифицирована система примечаний, не буду останавливаться на этом.
Существенно изменена система иллюстраций. В тексте с помощью тэга размещены ссылки на номера картинок. Для отображения рисунков необходимо предварительно считать ссылки на них из файла "/_rels/body.xml.rels". Для этого я создаю массив img_fb3 типа QHash , где первая строка - ссылка на рисунок по тексту, вторая — путь к рисунку в каталоге img.
Обрабатывается тэг img так

if( sr.name().toString() == "img" ) // расположение рисунков fb3
{
    if(sr.attributes().count() > 0)
    {
        if( sr.attributes().at(0).name().toString() == "src" )
            book->append("<p align=\"center\"><img src=\""
                         + filerels + "/"
                         + img_fb3.take( sr.attributes().at(0).value().toString() )
                         + "\" alt=\"рисунок\"" + "/></p>");   
        else
            qDebug() << "img src ошибка";
    }
    break;
}

img_fb3 наполняется так

if(sr.name().toString() == "fb3-body") // ссылки на картинки fb3
{
    QFile fr(filerels + "/_rels/body.xml.rels" );
    if (!fr.open(QIODevice::ReadOnly | QIODevice::Text))
    {
        qDebug() << "файл body.xml.rels не открыт";
        break;
    }

    QXmlStreamReader srr(&fr);
    while( !srr.atEnd() )
    {
        switch( srr.readNext() )
        {
        case QXmlStreamReader::StartElement:
            if(srr.name().toString() == "Relationship")
            {
                QString f, s;
                for(int i = 0; i < srr.attributes().count(); i++)
                {
                    if( srr.attributes().at(i).name() == "Id" )
                        s = srr.attributes().at(i).value().toString();
                    if( srr.attributes().at(i).name() == "Target" )
                        f = srr.attributes().at(i).value().toString();
                }
                if(f.indexOf("cover") != -1)
                {
                    book->append("<p align=\"center\"><img src=\""
                                 + filerels + "/" + f
                                 + "\" alt=\"рисунок\"" + "/></p>");
                }
                else
                    img_fb3.insert(s, f);
                //qDebug() << f;
            }
            break;
        default: ;
        }
    }
    fr.close();
    break;
}

Кроме того, остались некоторые тэги предназначение которых мне до конца не понятно: , .

Открываем zip-архив

Первоначально для разархивации я планировал использовать программу 7z. Но этот вариант отпал, когда я узнал, что реализовать распаковку файлов можно с помощью библиотеки zlib и интерфейсов из библиотек zipreader_p.h, zipwriter_p.h и zip.cpp, которые можно скачать вместе с другими исходниками Qt. В конце концов, я узнал, что эти библиотеки входят и в распространяемые версии Qt (модуль gui-private). Кстати такой приватный модуль-двойник есть у каждого основного модуля. И как гласит предупреждение в каждом из приватных заголовочных файлов:
(This file is not part of the Qt API. It exists purely as an implementation detail. This header file may change from version to version without notice, or even be removed).
Итак, функция UnZip(QString name, QString path) помещает содержимое архива name в папку path. В качестве временного хранилища я предлагаю использовать папку "dmreader" создаваемую в каталоге для хранения временных файлов QStandardPaths::standardLocations(QStandardPaths::TempLocation).at(0).
Реализация распаковки архива

bool openerTextFiles::UnZip(QString zfile, QString path)
{
    QZipReader cZip(zfile);
    QDir dir(path);
    if(!dir.exists())
        dir.mkpath( path );

    //bool b = cZip.extractAll( path );
    bool b = extractFiles( cZip , path );
    cZip.close();
    return b;
}

Если бы мы имели дело с zip архивом, то достаточно было бы использовать функцию extractAll(QString path) класса QZipReader. Однако fb3 архив имеет одну особенность, на которой я не буду здесь останавливаться. Я дополнил этот алгоритм на коленке в функции extractFiles(QZipReader zip ,QString path).

bool openerTextFiles::extractFiles(const QZipReader &zip, const QString &destinationDir)
{
    QDir baseDir(destinationDir);
    QVector<QZipReader::FileInfo> allFiles = zip.fileInfoList();
    // create directories first
    foreach (QZipReader::FileInfo fi, allFiles) {
        const QString absPath = destinationDir + QDir::separator() + fi.filePath;
        if (fi.isDir) {
            if (!baseDir.mkpath(absPath))
                return false;
            if (!QFile::setPermissions(absPath, fi.permissions))
                return false;
        }
    }
    //  ------------------------
    foreach (QZipReader::FileInfo fi, allFiles) {
        const QString absPath = destinationDir + "/" + fi.filePath;
        QString d; // для fb3
        if(absPath.indexOf("/") != -1)
        {
            d = absPath.left(absPath.lastIndexOf("/"));
            QDir dir(d);
            if(!dir.exists()){
                dir.mkdir(dir.path());
            }
        }
    }
    foreach (QZipReader::FileInfo fi, allFiles) {
        const QString absPath = destinationDir + "/" + fi.filePath;
        if(absPath.endsWith("/"))
        {
            if( !baseDir.exists(fi.filePath) )
            {
                if (!baseDir.mkdir(fi.filePath))
                    return false;
                if (!QFile::setPermissions(absPath, fi.permissions))
                    return false;
            }
        }
        else
        {
            QString d; // для fb3
            if(absPath.indexOf("/") != -1)
            {
                d = absPath.left(absPath.lastIndexOf("/"));
                QDir dir(d);
                if(!dir.exists()){
                    dir.mkdir(dir.path());
                }
            }
            QFile f(absPath);
            if (!f.open(QIODevice::WriteOnly))
                return false;
            f.write(zip.fileData(fi.filePath));
            f.setPermissions(fi.permissions);
            f.close();
        }
    }
    return true;
    //  ------------------------
    // set up symlinks
    foreach (QZipReader::FileInfo fi, allFiles) {
        const QString absPath = destinationDir + QDir::separator() + fi.filePath;
        if (fi.isSymLink) {
            QString destination = QFile::decodeName(zip.fileData(fi.filePath));
            if (destination.isEmpty())
                return false;
            QFileInfo linkFi(absPath);
            if (!QFile::exists(linkFi.absolutePath()))
                QDir::root().mkpath(linkFi.absolutePath());
            if (!QFile::link(destination, absPath))
                return false;
        }
    }
}

Исходный текст программы можно скачать здесь .

Заключение

Написанная программа не претендует на полную функциональность при чтении fb3 файлов. Но для того чтобы открыть текст, посмотреть его и сохранить в html, который можно обрабатывать в большом количестве редакторов она отлично подходит. Приятного чтения.

We recommend hosting TIMEWEB
We recommend hosting TIMEWEB
Stable hosting, on which the social network EVILEG is located. For projects on Django we recommend VDS hosting.

Добрый день!

Вы не думали разместить репозиторий проекта на GitHub?

Приветствую!

Я думаю дойдёт и до этого, но пока изучать его у меня нет желания.

Comments

Only authorized users can post comments.
Please, Log in or Sign up
Timeweb

Let me recommend you the excellent hosting on which EVILEG is located.

For many years, Timeweb has been proving his stability.

For projects on Django I recommend VDS hosting

View Hosting
VD

C++ - Test 001. The first program and data types

  • Result:73points,
  • Rating points1
Ds

C++ - Тест 003. Условия и циклы

  • Result:64points,
  • Rating points-1
o

C++ - Test 001. The first program and data types

  • Result:86points,
  • Rating points6
Last comments
D:

QML - Lesson 016. SQLite database and the working with it in QML Qt

Добрый день, пытаюсь разобраться и подргнать пример под себя. Есть бд с огромным количеством полей. В приложении на виджетах при использовании QTableView все работает и путем простого sql запрос…

Django - Tutorial 039. Adding private messages and chats on the site - Part 2 (Dialogue and chat counter with unread messages)

Добавляйте поле файла в модель сообщения. И в форме сообщения указывайте, что поле с файлом.
s

Django - Tutorial 023. Like Dislike system using GenericForeignKey

все, я со всем разобрался!) Извините!)
s

Django - Tutorial 023. Like Dislike system using GenericForeignKey

Доброго времени суток!) Я случайно набрел на вашу статью, и она помогла мне решить некоторые мои трудности, я прошел за вами по шагам, в попытках адаптировать это под себя, и возник вопрос. У ва…
Now discuss on the forum

Динамическое заполнение StackLayout в qml

Всем привет. Пытаюсь решить такую задачку, есть TabBar и его кнопки. StackLayout{ currentIndex: tabBar.currentIndex A {id: tabA} B {id: tabB} C {id: tabC} D {id: ta…

Наследование QWidget

Добрый день В addWidget нужно ещё указывать номер строки и колонки, куда добаляется виджет. И в вашем случае лучше Диалоговое окно не наследовать сразу от QDialog и W, а наследовать …
M

QML: изменение стиля при наведении и при нажатии на кнопку

enabled = false перестанет быть активной и не будет ни на что реагировать) Хм.. по-моему пробовал такое. Проверю ещё раз после работы. Ура, спасибо большо…
U

Динамическое наполнение StackView QML

Во затупил))) Спасибо за все))) StackView.push("ModuleTip1.qml") ну или в сложной иерархии StackView.push("qrc:/folder/ModuleTip1.qml") и всего делов... Не пойму, почему сра…

QEventLoop тормозит при удалении экземпляра

Думаю, что нет. Лучше вообще без исключений, но не всегда возможно.
About
Services
© EVILEG 2015-2020
Recommend hosting TIMEWEB