Find a file
David Hurka 5a58d3bb8e Simplify ToggleActionMenu
* Remove the ImplicitDefaultAction intelligence, so ToggleActionMenu is
  not more than a KActionMenu with setDefaultAction().
* Instead, reset the default action when it gets removed from the menu().
  This is done by filtering QActionEvent from menu().
* Add an autotest for ToggleActionMenu.

This replaces prior efforts to fix problems in ToggleActionMenu
in !245 and !254, following the discussion on the virtual meeting
at 2021-02-26.

6b26a2b4b and 1786e6c99 have already ported PageView and
AnnotationActionHandler to the simplified interface.
2021-04-23 01:54:42 +00:00
autotests Simplify ToggleActionMenu 2021-04-23 01:54:42 +00:00
cmake/modules Use more standard cmake functionality to search for discount 2021-01-24 11:16:49 +00:00
conf Fixes changing continuous mode while on tabs issue 2021-04-07 23:39:55 +02:00
core Remove device pixel ratio scaling from PixmapRequest 2021-03-08 00:23:11 +01:00
doc Fix version on doc 2021-04-10 00:18:10 +02:00
generators SVN_SILENT made messages (.desktop file) - always resolve ours 2021-04-21 01:16:32 +00:00
hooks Add .git-blame-ignore-revs and some instructions for clang-format 2020-07-11 09:17:54 +02:00
icons New part/ directory for okularpart sources from /, ui/, conf/ 2020-11-18 19:32:56 +00:00
interfaces Run clang-format 2020-07-11 09:17:33 +02:00
mobile SVN_SILENT made messages (.desktop file) - always resolve ours 2021-04-21 01:16:32 +00:00
part Simplify ToggleActionMenu 2021-04-23 01:54:42 +00:00
shell SVN_SILENT made messages (.desktop file) - always resolve ours 2021-04-21 01:16:32 +00:00
.clang-tidy clang-tidy: Disable bugprone-suspicious-enum-usage 2020-12-10 00:02:14 +01:00
.git-blame-ignore-revs Add .git-blame-ignore-revs and some instructions for clang-format 2020-07-11 09:17:54 +02:00
.gitignore GIT_SILENT: ignore .cmake generated by qtc 2020-05-17 17:41:22 +02:00
.gitlab-ci.yml CI: Switch to new clang-format 2021-01-10 00:51:48 +01:00
.krazy
_clang-format Add _clang_format file 2020-07-11 09:16:24 +02:00
aboutdata.h Run clang-format 2020-07-11 09:17:33 +02:00
CMakeLists.txt GIT_SILENT Upgrade release service version to 21.04.0. 2021-04-14 16:54:23 +02:00
config-okular.h.cmake Increase kjs requirement for using the timeout check 2020-06-24 12:06:32 +02:00
COPYING
COPYING.DOC
COPYING.LIB
kdocumentviewer.h Run clang-format 2020-07-11 09:17:33 +02:00
Mainpage.dox Update Okular developer documentation 2019-02-07 08:13:11 +02:00
Messages.sh New part/ directory for okularpart sources from /, ui/, conf/ 2020-11-18 19:32:56 +00:00
metainfo.yaml New part/ directory for okularpart sources from /, ui/, conf/ 2020-11-18 19:32:56 +00:00
okular.categories
okular.upd Store the state of the builtin annotations in a new config key 2020-08-25 10:16:10 +02:00
Okular5Config.cmake.in Use ecm_setup_qtplugin_macro_names 2020-09-13 11:20:50 +02:00
okular_part.desktop SVN_SILENT made messages (.desktop file) - always resolve ours 2020-10-17 06:04:22 +02:00
OkularConfigureChecks.cmake
README.clang-format We're using clang format 11 on CI now 2021-01-10 10:56:31 +01:00
README.internals.png
README.md Use the canonical URL for docs.kde.org addresses 2021-01-31 00:12:36 +00:00
TODO

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

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

source build/prefix.sh; okular

so that the correct Okular instance and libraries are picked up.

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.