Frequently Asked Questions

Notice: Undefined variable: KDE4_KPARTS_LIBS in /srv/www/svn/www/sites/okular/faq.php on line 86

Questions

Compiling Okular

• The Poppler backend does not compile. It complains about 'class Poppler::TextBox' and 'edge'.

Running Okular

• Okular tells me there are no plugins installed. What can I do?

General usage

• Why the newly added annotations are not in my PDF document?
• How can I annotate a document and send it to a friend/collegue/etc?
• Using Ubuntu, I cannot read CHM and EPub documents, even if I have okular-extra-backends and libchm1 installed. Why?
• Why the speak options in the Tools menu are grayed out?

Old FAQs

• The 0.5 snapshot release does not compile. What can I do?
• The Poppler backend does not compile. It complains about 'splashRenderToPixmap', for example.

Answers

Compiling Okular

The Poppler backend does not compile. It complains about 'class Poppler::TextBox' and 'edge'.

Do you get an error output similar to

Building CXX object okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/generator_pdf.o
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp: In member function 'Okular::TextPage* PDFGenerator::abstractTextPage(const QList&, double, double, int)';:
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1088: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1091: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1098: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1101: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1113: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1115: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1122: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1125: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1134: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1136: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1144: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1147: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1158: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1160: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1167: error: 'class Poppler::TextBox'; has no member named 'edge';
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1170: error: 'class Poppler::TextBox'; has no member named 'edge';
make[2]: *** [okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/generator_pdf.cpp.o] Error 1
make[1]: *** [okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/all] Error 2
make: *** [all] Error 2

If so, most probably you updated from Poppler 0.6.x or previous to Poppler 0.8.
What you can do is simple:

rm CMakeCache.txt

in the build directory of kdegraphics. Then run cmake again, and all should work as expected.

[Up to Questions]

Running Okular

Okular tells me there are no plugins installed. What can I do?

In a shell set up for your KDE 4 installation, execute the command

kbuildsycoca4 --noincremental

After that, Okular should find its plugins as expected.

[Up to Questions]

General usage

Why the newly added annotations are not in my PDF document?

Short answer: Okular cannot change the annotations in PDF documents.

Longer answer: the library used for reading PDF documents (Poppler) does not allow changing the annotations inside a PDF document. Also, due to the fact that Okular allows you to annotate in any kind of document it supports (even if that format does not support annotations), Okular saves the annotations internally in the local data directory for each user.

[Up to Questions]

How can I annotate a document and send it to a friend/collegue/etc?

Since KDE 4.2, Okular has the "document archiving" feature. This is an Okular-specific format for carrying the document plus various metadata related to it (currently only annotations).
You can save a "document archive" from the open document by choosing "File -> Export As -> Document Archive".
To open an Okular document archive, just open it with Okular as it would be eg a PDF document.

[Up to Questions]

Using Ubuntu, I cannot read CHM and EPub documents, even if I have okular-extra-backends and libchm1 installed. Why?

Ubuntu (thus Kubuntu as well) packages of Okular are compiled without the support for these two formats.

The reason is explained in the following Launchpad report: https://bugs.launchpad.net/kdegraphics/+bug/277007 .

[Up to Questions]

Why the speak options in the Tools menu are grayed out?

Because you don't have the KDE Text To Speech tools, install ktts and they should be enabled

[Up to Questions]

Old FAQs

The 0.5 snapshot release does not compile. What can I do?

Well, it was an unstable release, what did you expect ;-) Now seriously it worked here, some tips to make it compile:

• If you get problems about QApplication::font() beign undefined add ${QT_QTCORE_LIBRARY} ${KDE4_KDEUI_LIBS} ${QT_QTGUI_LIBRARY} after in the line of okular/CMakeLists.txt that starts with
  

  target_link_libraries(okularcore 

• If you get problems about QDBus and QDBusConnection you have either to downgrade your qt-copy to revision 556861 (not advisable) or apply this patch:
  svn diff -r578225:578226 svn://anonsvn.kde.org/home/kde/trunk/playground/graphics/okular/

[Up to Questions]

The Poppler backend does not compile. It complains about 'splashRenderToPixmap', for example.

Do you get an error output similar to

Building CXX object okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/generator_pdf.o
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp: In function 'Okular::Action* createLinkFromPopplerLink(const Poppler::Link*, const Poppler::Document*)':
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:182: warning: enumeration value 'Sound' not handled in switch
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp: In member function 'virtual void PDFGenerator::generatePixmap(Okular::PixmapRequest*)':
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:807: error: 'class Poppler::Page' has no member named 'splashRenderToPixmap'
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp: In member function 'virtual bool PDFGenerator::print(QPrinter&)':
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:933: error: 'class Poppler::Document' has no member named 'print'
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp: In member function 'virtual void PDFPixmapGeneratorThread::run()':
[...]/kdegraphics/okular/generators/poppler/generator_pdf.cpp:1767: error: 'class Poppler::Page' has no member named 'splashRenderToImage'
make[2]: *** [okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/generator_pdf.o] Error 1
make[1]: *** [okular/generators/poppler/CMakeFiles/okularGenerator_poppler.dir/all] Error 2
make: *** [all] Error 2

If so, most probably you first run cmake w/o poppler-qt4 (or its devel package) installed and figured out about its lack, then installed it, run cmake and make again, and got the error above.
What you can do is simple:

rm CMakeCache.txt

in the build directory of kdegraphics. Then run cmake again, and all should work as expected.

[Up to Questions]

[ Edit ]