office/okular
office/okular
1
0
Fork 0
mirror of https://invent.kde.org/graphics/okular synced 2024-11-04 21:09:05 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
9625 commits 138 branches 360 tags 104 MiB
C++ 86.9%
C 10.2%
CMake 1.2%
QML 1.1%
JavaScript 0.4%
Other 0.1%
Find a file
Ari Iramanesh aa66a9b964 Increase PageUp/Down overlap 
The original 50% value seems arbitrary and needless. I would like to use
75%, personally. This commit sets the maximum to 99%.
2022-02-25 11:24:42 -08:00
autotests Simplify keystroke event handling 2022-02-24 16:10:22 +01:00
cmake/modules Convert CMake module license statements to SPDX 2021-06-10 08:11:56 +00:00
conf Allow user to select tts voice in addition to engine. 2022-02-14 08:20:14 -07:00
core Fix keystroke events 2022-02-24 23:39:28 +00:00
doc Add TTS voice selection option to the docs 2022-02-20 21:23:52 +02:00
generators mobile: Add Signature Viewing UI 2022-02-18 08:32:13 +00:00
gui mobile: Add Signature Viewing UI 2022-02-18 08:32:13 +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 Convert license headers to SPDX 2021-06-10 08:11:56 +00:00
LICENSES Download GFDL-1.2-or-later license 2021-06-10 08:11:56 +00:00
mobile Put the Android extra linking cmake code behind a variable 2022-02-24 14:12:34 +01:00
part Increase PageUp/Down overlap 2022-02-25 11:24:42 -08:00
shell Adds option editor-cmd to the commandline 2022-02-18 13:33:28 +00:00
.clang-tidy CI: Debian has removed clazy from testing, use the one in unstable for now 2022-01-03 17:03:46 +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 Add auto generated files to .gitignore 2021-12-17 01:40:21 +03:00
.gitlab-ci.yml Improve mobile drawer 2022-01-19 22:33:21 +00:00
.kde-ci.yml Tweak default UI 2021-12-17 22:03:35 +00:00
.krazy
_clang-format Manual fixes to license headers 2021-06-10 08:11:56 +00:00
aboutdata.h Add back credits for the former ODT backend 2021-09-07 14:50:26 +02:00
CMakeLists.txt mobile: Add Signature Viewing UI 2022-02-18 08:32:13 +00:00
config-okular.h.cmake Increase kjs requirement for using the timeout check 2020-06-24 12:06:32 +02:00
kdocumentviewer.h Convert license headers to SPDX 2021-06-10 08:11:56 +00:00
Mainpage.dox Clean up ServiceType property usage for JSON based plugins 2021-05-21 06:53:52 +02:00
Messages.sh Mark items with name in toolsQuick as default 2021-06-01 21:34:40 +00:00
metainfo.yaml replace "MacOSX" with "macOS" 2021-08-24 21:00:17 +00:00
okular.categories Use new syntax 2018-11-20 13:21:08 +01:00
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 2021-09-10 02:19:38 +00: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

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 don’t 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.