Okular: Difference between revisions

From KDE Wiki Sandbox
(New page: ==What is Okular== left| Okular is a universal document viewer based on KPDF for KDE 4. The last stable release is Okular 0.7, shipped in the kdegraphics module of KD...)
 
(Marked this version for translation)
 
(57 intermediate revisions by 13 users not shown)
Line 1: Line 1:
==What is Okular==
<languages />
[[Image:Okular.png|left|]] Okular is a universal document viewer based on KPDF for KDE 4.
<translate>
<!--T:35-->
{{GrafBreadCrumbs|1=Okular}}


The last stable release is Okular 0.7, shipped in the kdegraphics module of KDE 4.1.
==What is Okular?== <!--T:15-->


<!--T:21-->
Okular is a universal document viewer developed by KDE. Okular works on multiple platforms, including but not limited to Linux, Windows, Mac OS X, *BSD, etc.
<!--T:3-->
You can watch for development at the project [http://okular.kde.org/ Home Page].
You can watch for development at the project [http://okular.kde.org/ Home Page].


==Background==
==Background== <!--T:4-->
Its development began as part of Google's Summer of Code program. The description of the project is located at KDE Developer's Corner.
 
<!--T:5-->
Its development began as part of Google's Summer of Code program. The description of the project can be found at [https://web.archive.org/web/20080921165821/https://developer.kde.org/summerofcode/okular.html KDE Developer's Corner].
 
<!--T:6-->
'''Okular''' combines the excellent functionalities of [[Special:myLanguage/KPDF|KPDF]] with the versatility of supporting different kinds of documents, like PDF, Postscript, DjVu, CHM, and others.
 
<!--T:7-->
The [https://okular.kde.org/formats.php document format handlers page] has a chart describing in more detail the supported formats and the features supported in each of them.
 
<!--T:8-->
[[Image:Okular-annotations.png|thumb|300px|center|Annotations in Okular, which can be saved within the PDF file]]
 
<!--T:9-->
As well as supporting many formats, '''Okular''' offers such features as text selection, annotation, extraction of files embedded within a document, and many other surprises.  Screenshots of '''Okular''' in action can be seen [https://okular.kde.org/screenshots.php here].
 
<!--T:10-->
You can talk to developers and other users on IRC, irc.freenode.org, channel [irc://irc.kde.org/#okular #okular].
 
<!--T:11-->
If you are interested in contributing to '''Okular''', please [https://okular.kde.org/contact.php contact the team]. Programmers and non-coders are welcome all the same.
 
== Mobile Version == <!--T:22-->
 
<!--T:23-->
Okular has a mobile version since version 0.16 release in February 2013 <ref>[https://okular.kde.org/news.php Release information]</ref>. The first version was based on the [https://community.kde.org/Plasma/Active active] framework. The mobile viewer was then ported to Kirigami in 2016 by Marco Martin<ref>[https://phabricator.kde.org/R223:eb1f73800e83b11e4a5ae93ac069893aa88f0eaa Commit port mobile version from plasma-framework to kirigami]</ref> and finally to Kirigami2 in 2017<ref>[https://phabricator.kde.org/R223:caf8820cf773316ce41d9a8c1f7357b3ffc3ef86 Commit port mobile version from kirigami to kirigami2]</ref>.
 
<!--T:24-->
The mobile version doesn't support all features from the desktop version, but provide better touch support and a mobile interface.
 
<!--T:25-->
[[File:Okular_mobile_pdf_view.png|250px]]
[[File:Okular_mobile_toc.png|250px]]
[[File:Okular_mobile_thumbmails.png|250px]]
 
<!--T:26-->
You can test the mobile version in your PC by entering {{Input|1=okularkirigami}} in your [[Special:myLanguage/Tutorials/Open a console|terminal]]. A nightly android version is also available at the KDE [https://binary-factory.kde.org/view/Android/job/Okular_android/ binary factory].
 
==Hints and Tips== <!--T:12-->
 
=== Reviewing Documents / Annotations === <!--T:17-->
 
<!--T:18-->
Double-clicking on either one of the '''Review''' tools (<keycap>F6</keycap>) allows you to make multiple annotations without having to reactivate the tool after the first time.
 
<!--T:19-->
How to keep the annotations you made to the PDF file:
 
<!--T:20-->
By default, '''Okular''' saves annotations in the local data directory for each user. Since KDE 4.9, it's optionally possible to store them directly in a PDF file by choosing <menuchoice>File -> Save As...</menuchoice>, so they can be seen in other PDF viewers.
Note that this feature requires Poppler 0.20 or newer for regular PDF documents. If the PDF document you are annotating is encrypted, this feature requires Poppler 0.22 or newer.
 
=== DRM === <!--T:27-->
 
<!--T:28-->
By default, Okular follows the PDF specification and don't allow copying text from DRM protected files. However, there is an option in the settings to disable DRM limitations in <menuchoice>Settings -> General -> Program Features  -> Obey DRM limitations</menuchoice>
 
<!--T:29-->
There was a small controversy in the Debian bug tracker a long time ago, about the default choice to Obey DRM limitations<ref>[https://lists.debian.org/debian-devel/2009/05/msg00879.html DRM and Okular in Debian bug tracker]</ref><ref>[https://lwn.net/Articles/335415/ DRM and Okular in LWM]</ref>. The choice was then [https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html explained] by an Okular/KPdf developer<ref>[https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html Okular, PDF and file permissions]</ref>.


Okular combines the excellent functionalities of KPDF with the versatility of supporting different kind of documents, like PDF, Postscript, DjVu, CHM, and others.
=== PDF Signature and certificate === <!--T:30-->


The [http://okular.kde.org/formats.php|document format handlers page] has a chart describing in more detail the supported formats and the features supported in each of them.
<!--T:31-->
Okular can verify if a PDF certificate is valid. But you can not yet create a new signature. See the [https://tsdgeos.blogspot.com/2019/01/okular-pdf-signature-certificate.html release note] for more information.


[[Image:Okular-annotations.png|thumb|250px|center|Annotating in Okular]]
== More Information == <!--T:32-->


As well as supporting many formats, Okular offers such features as text selection, annotation, extraction of files embedded within a document, and many other surprises. Screenshots of Okular in action can be seen [http://okular.kde.org/screenshots.php here].
<!--T:33-->
* [https://docs.kde.org/trunk5/en/kdegraphics/okular/index.html Official KDE documentation]
* [https://okular.kde.org/ Okular website]
* [https://api.kde.org/okular/html/index.html Okular API documentation]
* [https://invent.kde.org/graphics/okular Okular git repository]


You can talk to developers and other users on IRC, irc.freenode.org, channel #okular
== References == <!--T:34-->


If you are intested in contributing to Okular, please contact the team.  Programmers and non-coders alike are welcome.  Details of how to contact us can be found [http://okular.kde.org/contact.php here].
<!--T:14-->
[[Category:Graphics]]
[[Category:Mobile]]
</translate>

Latest revision as of 18:15, 28 October 2020

Home » Applications » Graphics » Okular

What is Okular?

Okular is a universal document viewer developed by KDE. Okular works on multiple platforms, including but not limited to Linux, Windows, Mac OS X, *BSD, etc.

You can watch for development at the project Home Page.

Background

Its development began as part of Google's Summer of Code program. The description of the project can be found at KDE Developer's Corner.

Okular combines the excellent functionalities of KPDF with the versatility of supporting different kinds of documents, like PDF, Postscript, DjVu, CHM, and others.

The document format handlers page has a chart describing in more detail the supported formats and the features supported in each of them.

Annotations in Okular, which can be saved within the PDF file

As well as supporting many formats, Okular offers such features as text selection, annotation, extraction of files embedded within a document, and many other surprises. Screenshots of Okular in action can be seen here.

You can talk to developers and other users on IRC, irc.freenode.org, channel #okular.

If you are interested in contributing to Okular, please contact the team. Programmers and non-coders are welcome all the same.

Mobile Version

Okular has a mobile version since version 0.16 release in February 2013 [1]. The first version was based on the active framework. The mobile viewer was then ported to Kirigami in 2016 by Marco Martin[2] and finally to Kirigami2 in 2017[3].

The mobile version doesn't support all features from the desktop version, but provide better touch support and a mobile interface.

You can test the mobile version in your PC by entering

okularkirigami

in your terminal. A nightly android version is also available at the KDE binary factory.

Hints and Tips

Reviewing Documents / Annotations

Double-clicking on either one of the Review tools (F6) allows you to make multiple annotations without having to reactivate the tool after the first time.

How to keep the annotations you made to the PDF file:

By default, Okular saves annotations in the local data directory for each user. Since KDE 4.9, it's optionally possible to store them directly in a PDF file by choosing File -> Save As..., so they can be seen in other PDF viewers. Note that this feature requires Poppler 0.20 or newer for regular PDF documents. If the PDF document you are annotating is encrypted, this feature requires Poppler 0.22 or newer.

DRM

By default, Okular follows the PDF specification and don't allow copying text from DRM protected files. However, there is an option in the settings to disable DRM limitations in Settings -> General -> Program Features -> Obey DRM limitations

There was a small controversy in the Debian bug tracker a long time ago, about the default choice to Obey DRM limitations[4][5]. The choice was then explained by an Okular/KPdf developer[6].

PDF Signature and certificate

Okular can verify if a PDF certificate is valid. But you can not yet create a new signature. See the release note for more information.

More Information

References