office/okular
office/okular
1
0
Fork 0
mirror of https://invent.kde.org/graphics/okular synced 2024-11-05 18:34:53 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
9663 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
Albert Astals Cid 6767b8739e Port a few QLinkedList to QList 
QLinkedList is deprecated in later Qt5 and gone in Qt6

The 1:1 port is std::list but in this cases all we ever do
is create the lists, push back to them, and pass then around
to be read, for that a QList is more than enough
2022-03-19 11:22:55 +00:00
autotests Port a few QLinkedList to QList 2022-03-19 11:22:55 +00:00
cmake/modules
conf
core Port a few QLinkedList to QList 2022-03-19 11:22:55 +00:00
doc
generators Port a few QLinkedList to QList 2022-03-19 11:22:55 +00:00
gui Port a few QLinkedList to QList 2022-03-19 11:22:55 +00:00
hooks
icons
interfaces
LICENSES
mobile emit -> Q_EMIT 2022-03-19 10:58:47 +00:00
part Port a few QLinkedList to QList 2022-03-19 11:22:55 +00:00
shell emit -> Q_EMIT 2022-03-19 10:58:47 +00:00
.clang-tidy Enable readability-braces-around-statements 2022-03-09 23:29:56 +01:00
.git-blame-ignore-revs Add the readability-braces-around-statements hash to .git-blame-ignore-revs 2022-03-10 00:09:09 +01:00
.gitignore
.gitlab-ci.yml Move to clang-format 13 2022-03-10 00:23:22 +01:00
.kde-ci.yml
.krazy
_clang-format
aboutdata.h
CMakeLists.txt Add DQT_NO_KEYWORDS 2022-03-19 10:58:47 +00:00
config-okular.h.cmake
kdocumentviewer.h
Mainpage.dox
Messages.sh
metainfo.yaml
okular.categories
okular.upd
Okular5Config.cmake.in
okular_part.desktop
OkularConfigureChecks.cmake
README.clang-format Move to clang-format 13 2022-03-10 00:23:22 +01:00
README.internals.png
README.md Set QT_PLUGIN_PATH 2022-03-07 23:09:02 +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

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.