Go to file
rtlhq c4ff1920ea New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
LICENSES Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
autotests New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00
cmake/modules Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
conf New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00
core New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
debian New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
doc New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00
generators New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
gui Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
hooks Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
icons Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
interfaces Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
mobile New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
part New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00
po New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
shell New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
.clang-tidy Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
.git-blame-ignore-revs Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
.gitignore Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
.gitlab-ci.yml New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00
.kde-ci.yml Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
.krazy Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
CMakeLists.txt New upstream bugfix release (22.12.3) 2023-03-02 16:13:16 +08:00
Mainpage.dox Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
Messages.sh Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
Okular5Config.cmake.in Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
OkularConfigureChecks.cmake Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
README.clang-format Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
README.internals.png Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
README.md Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
TODO Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
_clang-format Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
aboutdata.h Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
config-okular.h.cmake Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
kdocumentviewer.h Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
metainfo.yaml Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
okular.categories Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
okular.upd Import Upstream version 22.08.1 2022-11-04 00:44:45 +08:00
okular_part.desktop New upstream bugfix release (22.12.0) 2022-12-13 19:32:39 +08:00

README.md

Okular Universal Document Viewer

Okular can view and annotate documents of various formats, including PDF, Postscript, Comic Book, and various image formats. It supports native PDF annotations.

Downloads

For download and installation instructions, see https://okular.kde.org/download.php

User manual

https://docs.kde.org/?application=okular&branch=stable5

Bugs

https://bugs.kde.org/buglist.cgi?product=okular

Please report bugs on Bugzilla (https://bugs.kde.org/enter_bug.cgi?product=okular), and not on our GitLab instance (https://invent.kde.org).

Mailing list

https://mail.kde.org/mailman/listinfo/okular-devel

Source code

https://invent.kde.org/graphics/okular.git

The Okular repository contains the source code for:

  • the okular desktop application (the “shell”),
  • the okularpart KParts plugin,
  • the okularkirigami mobile application,
  • several okularGenerator_xyz plugins, which provide backends for different document types.

Apidox

https://api.kde.org/okular/html/index.html

Contributing

Okular uses the merge request workflow. Merge requests are required to run pre-commit CI jobs; please dont push to the master branch directly. See https://community.kde.org/Infrastructure/GitLab for an introduction.

Build instructions

Okular can be built like many other applications developed by KDE. See https://community.kde.org/Get_Involved/development for an introduction.

If your build environment is set up correctly, you can also build Okular using CMake:

git clone https://invent.kde.org/graphics/okular.git
cd okular
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/your/install/dir ..
make
make install

Okular also builds tests in the build tree. To run them, you have to run make install first.

If you install Okular in a different path than your system install directory it is possible that you need to run

source prefix.sh

so that the correct Okular instance and libraries are picked up. Afterwards one can run okular inside the shell instance. The source command is also required to run the tests manually.

As stated above, Okular has various build targets. Two of them are executables. You can choose which executable to build by passing a flag to CMake:

cmake -DCMAKE_INSTALL_PREFIX=/path/to/your/install/dir -DOKULAR_UI=desktop ..

Available options are desktop, mobile, and both.

clang-format

The Okular project uses clang-format to enforce source code formatting. See README.clang_format for more information.