You are not logged in.

#1 2011-03-15 10:13:13

mlq
Member
Registered: 2011-03-15
Posts: 171
Website

zathura - a document viewer

zathura - a document viewer

zathura is a highly customizable and functional document viewer. It provides a minimalistic and space saving interface as well as an easy usage that mainly focuses on keyboard interaction.

Dependencies
  • girara-gtk2 (>= 0.1.3)

  • gtk2 (>= 2.18.6)

  • cairo (>= 1.8.8)

Plugins
Installation
Development version

The version we are currently working on supports multiple file formats as well as continuous scrolling, and
also includes all known features from the latest stable version. We would welcome you to check it out and give
us feedback before we release it. It is available in the "develop" branch in our GIT repository.

Localization

Since 0.1.1 zathura supports translation, but at the moment we only provide english and german language files.
We need your help to get our projects translated into other languages. If you are interested, you can find all
necessary information here.

Bugs & Features

We are very happy about constructive feedback, bug reports and feature requests, but we ask you to use
our bug tracker for filling in those.

Links

Last edited by mlq (2012-06-09 22:09:24)

Offline

#2 2011-03-15 10:14:14

mlq
Member
Registered: 2011-03-15
Posts: 171
Website

Re: zathura - a document viewer

Reserved for additional information.

Offline

#3 2011-03-15 12:44:47

X-dark
Member
From: France
Registered: 2009-10-25
Posts: 142
Website

Re: zathura - a document viewer

Why recreating this thread and the jumanji one? They already exist here: https://bbs.archlinux.org/viewtopic.php?id=80458 and here https://bbs.archlinux.org/viewtopic.php?id=100505


Cedric Girard

Offline

#4 2011-03-15 14:02:08

Inxsible
Forum Fellow
From: Chicago
Registered: 2008-06-09
Posts: 9,183

Re: zathura - a document viewer

The old threads have been closed at neldoreth's request and version 2 threads are now here.


Forum Rules

There's no such thing as a stupid question, but there sure are a lot of inquisitive idiots !

Offline

#5 2011-03-16 16:16:29

jwhendy
Member
Registered: 2010-04-01
Posts: 621

Re: zathura - a document viewer

I recently opened THIS and see that zathura does not have link-opening abilities. Is that a planned feature?

Offline

#6 2011-03-16 16:58:26

Runiq
Member
From: Germany
Registered: 2008-10-29
Posts: 1,053

Re: zathura - a document viewer

It does have link-opening abilities, but you have to open them with the keyboard. Just like in vimperator/pentadactyl: Press f, press the number corresponding to the link you want to open, et voilà -- link opened.

Last edited by Runiq (2011-03-16 16:59:07)

Offline

#7 2011-03-21 09:20:52

ngoonee
Forum Fellow
From: Between Thailand and Singapore
Registered: 2009-03-17
Posts: 7,358

Re: zathura - a document viewer

With the new website, I'm not sure where configuration information can be found?

EDIT: Submitted two bugs and a feature request, thanks for the great software smile

Last edited by ngoonee (2011-03-22 02:56:42)


Allan-Volunteer on the (topic being discussed) mailn lists. You never get the people who matters attention on the forums.
jasonwryan-Installing Arch is a measure of your literacy. Maintaining Arch is a measure of your diligence. Contributing to Arch is a measure of your competence.
Griemak-Bleeding edge, not bleeding flat. Edge denotes falls will occur from time to time. Bring your own parachute.

Offline

#8 2011-03-24 14:59:14

mlq
Member
Registered: 2011-03-15
Posts: 171
Website

Re: zathura - a document viewer

Hello,

zathura 0.0.8.3 has been released:

  • Updated text searching

  • Support for poppler >= 0.15

  • Fixed print command with multiple arguments

  • Fixed GOptionEntries

  • Updated Makefile

  • Fixed several memory leaks

  • Fixed segmentation faults

The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.

Best regards

Offline

#9 2011-03-24 15:02:58

ngoonee
Forum Fellow
From: Between Thailand and Singapore
Registered: 2009-03-17
Posts: 7,358

Re: zathura - a document viewer

mlq wrote:

The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.

Just to confirm, the 'feature version' refers to 'girara'?


Allan-Volunteer on the (topic being discussed) mailn lists. You never get the people who matters attention on the forums.
jasonwryan-Installing Arch is a measure of your literacy. Maintaining Arch is a measure of your diligence. Contributing to Arch is a measure of your competence.
Griemak-Bleeding edge, not bleeding flat. Edge denotes falls will occur from time to time. Bring your own parachute.

Offline

#10 2011-03-24 15:04:48

mlq
Member
Registered: 2011-03-15
Posts: 171
Website

Re: zathura - a document viewer

Hello,

ngoonee wrote:
mlq wrote:

The package in the archlinux repository has already been updated. Keep in mind that this release has almost nothing to do with
the feature version of zathura, since it build upon a different code base.

Just to confirm, the 'feature version' refers to 'girara'?

Yes, the "feature version" is the one that is using libgirara and where the development is happening in the girara branch.

Best regards

Offline

#11 2011-03-24 16:58:51

jwhendy
Member
Registered: 2010-04-01
Posts: 621

Re: zathura - a document viewer

@Runiq: thanks for the tip

Offline

#12 2011-03-24 19:07:33

Stalafin
Member
From: Berlin, Germany
Registered: 2007-10-26
Posts: 617

Re: zathura - a document viewer

Some time ago I read there are plans to change zathura to mupdf as a rendering engine. Is that still being worked on?

Offline

#13 2011-03-24 20:00:47

mlq
Member
Registered: 2011-03-15
Posts: 171
Website

Re: zathura - a document viewer

Hello,

Stalafin wrote:

Some time ago I read there are plans to change zathura to mupdf as a rendering engine. Is that still being worked on?

mupdf is used as a possible backend for zathura in the girara branch.

Best regards

Offline

#14 2011-03-30 14:48:12

Sébastien
Member
Registered: 2011-03-30
Posts: 3

Re: zathura - a document viewer

Hello,

I was looking for something just like this, manupilating pdf in a vim way !

But I’m french and my keyboard is not in qwerty but bépo (a french dvorak keyboard), and right now it’s impossible to use this pdf viewer (jkl and h are spread across the keyboard).

So I’ve tried to change the config with a zathurarc file as explained on the website. But if it works sometimes, some other times it doesn’t. For example, this :

map + zoom in
map - zoom out

… just doesn’t work, and it’s from the zathurarc example file on the official website.

I’ve looked everywhere to find the config.h file and I didn’t. And I realised that you’ve got this file when you compile zathura, and I didn’t because I’ve got it from the ubuntu repository with apt-get.

So my question is : should I compile it in order to have this file (config.h) ?

I would love to move from ubuntu to archlinux but I don’t feel ready yet.

Thank you for your advices and your patience.

Sébastien.

Offline

#15 2011-03-30 16:38:10

ANOKNUSA
Member
Registered: 2010-10-22
Posts: 2,141

Re: zathura - a document viewer

Sébastien wrote:

<snip>
I’ve looked everywhere to find the config.h file and I didn’t. And I realised that you’ve got this file when you compile zathura, and I didn’t because I’ve got it from the ubuntu repository with apt-get.

So my question is : should I compile it in order to have this file (config.h) ?

I would love to move from ubuntu to archlinux but I don’t feel ready yet.

Thank you for your advices and your patience.

Sébastien.

The file is found in the source package on git, and can be used to compile a version of Zathura with custom options.  Though it's a bit confusing (Jumanji and Zathura still have little in the way of documentation), you can download the source, look over the config.h file, and transcribe the options in it you want to change to ~/.config/zathura/zathurarc.

Also, I'm not too familiar with Dvorak: might the "+" key still be "=" by default, a la QWERTY?

Last edited by ANOKNUSA (2011-03-30 16:48:28)

Offline

#16 2011-03-30 19:49:58

Sébastien
Member
Registered: 2011-03-30
Posts: 3

Re: zathura - a document viewer

Thank you for your answer,

So I’ve got the "config.def.h" from the source package, and  I searched inspiration from it for my zathurarc, but it’s still doesn’t work. Here are my tries :

map s navigate up
map t navigate down
map S navigate previous
map T navigate next

/* shortcuts */
Shortcut shortcuts[] = {
{0,                  GDK_s,             sc_navigate_index,    INDEX,               { UP } },
{0,                  GDK_s,            sc_navigate,          FULLSCREEN,          { UP } },
{0,                  GDK_s,            sc_scroll,            NORMAL,              { UP } },

};
 

As you can see, the only things I really try to do for now, is to map going down with "t" and going up with "s" (the equivalent of "j" and "k" on my keyboard).
I tried all the things above individually and the only things that work properly is :

map S navigate previous
map T navigate next

… it was the example on the website (but it moves a whole page and I want also to move line by line).

About your question (ANONKNUSA) no the + is not on the default qwerty. On my keyboard, I’ve got it on "Alt gr + c".

So, if at least I manage to map "t" with down and "s" with up, I’ll be very happy.

A good documentation will be very good for this very good programm (in order to help motivated clumsy newbie like me !)

Thanks for your help !

Offline

#17 2011-03-30 20:37:09

ANOKNUSA
Member
Registered: 2010-10-22
Posts: 2,141

Re: zathura - a document viewer

Give something like this a try:

map <SHIFT-T> navigate_next

You could also try "Shift-" or just a capital "S-";  the defaults work for me, so I haven't tried any custom key bindings myself.

Offline

#18 2011-03-31 09:08:39

Sébastien
Member
Registered: 2011-03-30
Posts: 3

Re: zathura - a document viewer

Ok, it works fine now.

I did the compilation, so I could define all my keybindings as I wanted to.

I had to do it twice because first I had conflict with my keybindings. So maybe that was the same reason, when it didn’t work with the zathurarc file.

Thank you very much Anoknusa for your help.

Sébastien.

Offline

#19 2011-04-02 13:15:38

escherdragon
Member
Registered: 2010-06-12
Posts: 8

Re: zathura - a document viewer

Hello,

Here is a patch (against 0.0.8.3) that improves marks by allowing them to record exact page positions in addition to the page number:
(apply with patch -p0 from the zathura compilation directory)

diff -Naur zathura.c zathura.c
--- zathura.c    2011-04-02 12:29:24.000000000 +0200
+++ zathura.c    2011-04-02 14:48:12.000000000 +0200
@@ -188,8 +188,15 @@
 
 typedef struct
 {
+  gdouble x;
+  gdouble y;
+} PagePosition;
+
+typedef struct
+{
   int id;
   int page;
+  PagePosition position;
 } Marker;
 
 typedef struct
@@ -385,6 +392,8 @@
 void set_completion_row_color(GtkBox*, int, int);
 void set_page(int);
 void switch_view(GtkWidget*);
+void save_page_position(PagePosition*);
+void restore_page_position(PagePosition*);
 GtkEventBox* create_completion_row(GtkBox*, char*, char*, gboolean);
 gchar* fix_path(const gchar*);
 gchar* path_from_env(const gchar*);
@@ -802,6 +811,7 @@
     if(Zathura.Marker.markers[i].id == id)
     {
       Zathura.Marker.markers[i].page = page_number;
+      save_page_position(&Zathura.Marker.markers[i].position);
       Zathura.Marker.last            = page_number;
       return;
     }
@@ -815,6 +825,8 @@
   Zathura.Marker.markers[marker_index].id   = id;
   Zathura.Marker.markers[marker_index].page = page_number;
   Zathura.Marker.last                       = page_number;
+
+  save_page_position(&Zathura.Marker.markers[marker_index].position);
 }
 
 void
@@ -1176,6 +1188,7 @@
     if(Zathura.Marker.markers[i].id == id)
     {
       set_page(Zathura.Marker.markers[i].page);
+      restore_page_position(&Zathura.Marker.markers[i].position);
       return;
     }
   }
@@ -1754,6 +1767,36 @@
 }
 
 void
+save_page_position(PagePosition* position)
+{
+  GtkAdjustment* adjustment;
+  adjustment  = gtk_scrolled_window_get_hadjustment(Zathura.UI.view);
+  position->x = gtk_adjustment_get_value(adjustment);
+  adjustment  = gtk_scrolled_window_get_vadjustment(Zathura.UI.view);
+  position->y = gtk_adjustment_get_value(adjustment);
+}
+
+void
+restore_page_position(PagePosition* position)
+{
+  GtkAdjustment* adjustment;
+  if(position->x > 0) {
+    adjustment = gtk_scrolled_window_get_hadjustment(Zathura.UI.view);
+    gtk_adjustment_set_value(adjustment, position->x);
+  }
+  else {
+    Argument argument;
+    argument.n = TOP;
+    sc_scroll(&argument);
+  }
+
+  if(position->y > 0) {
+    adjustment = gtk_scrolled_window_get_vadjustment(Zathura.UI.view);
+    gtk_adjustment_set_value(adjustment, position->y);
+  }
+}
+
+void
 switch_view(GtkWidget* widget)
 {
   GtkWidget* child = gtk_bin_get_child(GTK_BIN(Zathura.UI.viewport));

Cheers,


José Alfredo Romero L.
escherdragon at gmail
"We who cut mere stones must always be envisioning cathedrals."
(Quarry worker's creed)

Offline

#20 2011-04-02 13:30:21

escherdragon
Member
Registered: 2010-06-12
Posts: 8

Re: zathura - a document viewer

BTW, I think I have found a bug in the cb_view_kb_pressed() function: checking for if(Zathura.Global.mode == ADD_MARKER) and if(Zathura.Global.mode == EVAL_MARKER) should be done at the very beginning of the function, otherwise it's impossible to set marks using "a", "s" or any other character that is already mapped to an interactive function. Or am I missing something here?

Cheers,


José Alfredo Romero L.
escherdragon at gmail
"We who cut mere stones must always be envisioning cathedrals."
(Quarry worker's creed)

Offline

#21 2011-04-13 20:05:08

r0b0t
Member
From: /tmp
Registered: 2009-05-24
Posts: 505

Re: zathura - a document viewer

I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?

I really don't understand anything in it.

Thank you

Offline

#22 2011-04-13 20:12:54

Stalafin
Member
From: Berlin, Germany
Registered: 2007-10-26
Posts: 617

Re: zathura - a document viewer

Man page?

Offline

#23 2011-04-13 20:13:45

karol
Archivist
Registered: 2009-05-06
Posts: 25,440

Re: zathura - a document viewer

r0b0t wrote:

I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?

I really don't understand anything in it.

Thank you

Have you read the man page?

DEFAULT SETTINGS
   Shortcuts
       J      Go to next page

       K      Go to previous page

       h      Scroll to the left

       k      Scroll upwards

...

You can configure the keybindings your way https://pwmt.org/projects/zathura/configuration/

Last edited by karol (2011-04-13 20:15:16)

Offline

#24 2011-04-13 21:35:44

r0b0t
Member
From: /tmp
Registered: 2009-05-24
Posts: 505

Re: zathura - a document viewer

karol wrote:
r0b0t wrote:

I'm a "nano" guy and not a vim one, any tut or pdf on how to use this application?

I really don't understand anything in it.

Thank you

Have you read the man page?

DEFAULT SETTINGS
   Shortcuts
       J      Go to next page

       K      Go to previous page

       h      Scroll to the left

       k      Scroll upwards

...

You can configure the keybindings your way https://pwmt.org/projects/zathura/configuration/

Thank you for your reply, Yes I'v reed the man page and also I saw the configuration on pwmt.org and I'v seen also the config.h in the source.
I know how to move around with it like s to fit the page, J/K to go to next and previous, gg and GG to go to first page and last one , but I don't understand the imput methods (if there are ones) and some other stuff.
Here are some questions:

To digit a comand I should hit : and than a command but;

1) I bmark (2 pages) in one pdf, and thant :blist but nothing is shown. I suppose something should be shown right?

2) If I type :info than some info is shown but how to get out of this?

3) How should I type :

  ^f     Scroll page down

   ^b     Scroll page up

   ^d     Scroll half a page down

   ^u     Scroll half a page up

This means really ^ or something else ?
4)  what's

       i      Change to insert mode  (--INSERT--) is shown, but what's the point on typing some characters in the bar below and how to get out of it?

       v      Change to visual mode   ?

Ty.

Last edited by r0b0t (2011-04-13 21:38:22)

Offline

#25 2011-04-13 22:04:33

karol
Archivist
Registered: 2009-05-06
Posts: 25,440

Re: zathura - a document viewer

'^' means Ctrl. E.g. ^f means press and hold Ctrl and press f.

You can quit ':info' , insert mode and visual mode by hitting Esc.

Last edited by karol (2011-04-13 22:07:49)

Offline

Board footer

Powered by FluxBB