Okular: Difference between revisions

From KDE UserBase Wiki
(add section about DRM)
(Marked this version for translation)
Line 32: Line 32:
If you are interested in contributing to '''Okular''', please [http://okular.kde.org/contact.php contact the team]. Programmers and non-coders are welcome all the same.
If you are interested in contributing to '''Okular''', please [http://okular.kde.org/contact.php contact the team]. Programmers and non-coders are welcome all the same.


== Mobile Version ==
== 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>.
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 form desktop version, but provide better touch support and a mobile interface.  
The mobile version doesn't support all features form desktop version, but provide better touch support and a mobile interface.  


<!--T:25-->
[[File:Okular_mobile_pdf_view.png|250px]]
[[File:Okular_mobile_pdf_view.png|250px]]
[[File:Okular_mobile_toc.png|250px]]
[[File:Okular_mobile_toc.png|250px]]
[[File:Okular_mobile_thumbmails.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]].
You can test the mobile version in your PC by entering {{Input|1=okularkirigami}} in your [[Special:myLanguage/Tutorials/Open a console|terminal]].


Line 58: Line 62:
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.
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 ===
=== DRM === <!--T:27-->


<!--T:28-->
By default, Okular follow 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>
By default, Okular follow 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>. This was then [https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html justified] by a Okular/KPdf developer<ref>[https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html Okular, PDF and file permissions]</ref>.  
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>. This was then [https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html justified] by a Okular/KPdf developer<ref>[https://tsdgeos.blogspot.com/2009/06/okular-pdf-and-drm.html Okular, PDF and file permissions]</ref>.  


=== PDF Signature and certificate ===
=== PDF Signature and certificate === <!--T:30-->


<!--T:31-->
Okular can verify if a PDF certificate is valid. But you can not yet create new signature. See [https://tsdgeos.blogspot.com/2019/01/okular-pdf-signature-certificate.html release note] for more information.
Okular can verify if a PDF certificate is valid. But you can not yet create new signature. See [https://tsdgeos.blogspot.com/2019/01/okular-pdf-signature-certificate.html release note] for more information.


== More Information ==
== More Information == <!--T:32-->


<!--T:33-->
* [https://docs.kde.org/trunk5/en/kdegraphics/okular/index.html Official KDE documentation]
* [https://docs.kde.org/trunk5/en/kdegraphics/okular/index.html Official KDE documentation]
* [https://okular.kde.org/ Okular website]
* [https://okular.kde.org/ Okular website]
Line 76: Line 84:
* [https://phabricator.kde.org/source/okular/ Okular git repository]
* [https://phabricator.kde.org/source/okular/ Okular git repository]


== References ==
== References == <!--T:34-->


<!--T:14-->
<!--T:14-->
[[Category:Graphics]]
[[Category:Graphics]]
</translate>
</translate>

Revision as of 18:18, 3 February 2019

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 form 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.

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 follow 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]. This was then justified by a Okular/KPdf developer[6].

PDF Signature and certificate

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

More Information

References