Bug 291176

Summary:	Documentation wish: add that document archive must have ".okular" extension
Product:	[Applications] okular	Reporter:	neteler <neteler>
Component:	general	Assignee:	Okular developers <okular-devel>
Status:	RESOLVED FIXED
Severity:	wishlist	CC:	lueck, null
Priority:	NOR
Version:	0.13.2
Target Milestone:	---
Platform:	Fedora RPMs
OS:	Linux
Latest Commit:	https://commits.kde.org/okular/9f0aa37906c9230ad1a48961f88ab2d654eec0e6	Version Fixed In:
Sentry Crash Report:

Description neteler@gmail.com 2012-01-10 15:02:41 UTC

Version:           0.13.2 (using KDE 4.7.4) 
OS:                Linux

THE OKULAR HANDBOOK

3.3 Annotations

Please document that an export document archive must have ".okular" extension.
By default the user may use .pdf and hence fail to reopen the file again
(since it is really a zip file).

Reproducible: Always

Steps to Reproduce:
Annotate PDF -> File -> Export As -> Document Archive

To be updated in the "Okular Handbook", section 3.3


Expected Results:  
Document contains an additional note.

Comment 1 Burkhard Lück 2012-01-10 17:34:58 UTC

Compiled from sources
$ okular --version
xxQt: 4.8.0
KDE Development Platform: 4.7.97 (4.8 RC2 (4.7.97)
xxOkularxx: 0.13.80
I am not able to use other extensions than ".okular" and then the okular can't be open an more

Kubuntu 11.04
$ okular --version
Qt: 4.7.2
KDE: 4.7.2 (4.7.2)
Okular: 0.13.2
I am not able to use another extension than ".okular"

Comment 2 Burkhard Lück 2012-01-10 17:36:53 UTC

(In reply to comment #1)
> Compiled from sources
> $ okular --version
> xxQt: 4.8.0
> KDE Development Platform: 4.7.97 (4.8 RC2 (4.7.97)
> xxOkularxx: 0.13.80
> I am not able to use other extensions than ".okular" and then the okular can't
> be open an more
> 
Sorry typo: I am able to use other extensions than ".okular"

Comment 3 Albert Astals Cid 2012-01-10 19:59:27 UTC

Burkhard can you repeat your sentences whole again, i got a bit confused :D

Comment 4 null 2017-11-26 22:46:03 UTC

Testing with 17.12 Beta, ".okular" is preselected and also mentioned at the bottom. If you change to ".pdf", it will actually be saved as a PDF and work fine. If you have no extension at all, ".okular" gets appended automatically.

Only if you change to something strange like ".okular-foo", Okular's automatic reopening will fail, and the saved version cannot be opened manually unless renamed. IMO the behaviour of the file dialog is good enough.

Adding this to the documentation could still be worth it, I'll try to prepare a patch once I find the time.

Comment 5 null 2018-01-01 07:41:27 UTC

Git commit 9f0aa37906c9230ad1a48961f88ab2d654eec0e6 by Henrik Fehlauer.
Committed on 01/01/2018 at 07:41.
Pushed by rkflx into branch 'master'.

Document ".okular" filename extension

Summary:
In general Okular makes it very hard to get the filename extension for
document archives wrong when saving. Still it would be nice to document
this.

Test Plan: `meinproc5` still happy.

Reviewers: lueck, yurchor

Reviewed By: yurchor

Subscribers: #okular

Tags: #okular

Differential Revision: https://phabricator.kde.org/D9577

M  +1    -1    doc/index.docbook

https://commits.kde.org/okular/9f0aa37906c9230ad1a48961f88ab2d654eec0e6