Frequently Asked Questions

Questions

Compiling Okular

• The 0.5 snapshot release does not compile. What can I do?
• The Poppler backend does not compile. It complains about 'splashRenderToPixmap', for example.
• 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?

Answers

Compiling Okular

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]

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

After that, Okular should find its plugins as expected.

[Up to Questions]

[ Edit ]