feat: Use default PDF reader defined in XDG Mime Application (fallbac…

…k to zathura) (#65)

Zaman now uses the default PDF reader defined in [XDG Mime Application](https://wiki.archlinux.org/title/XDG_MIME_Applications) and only use Zathura as a fallback option if no default PDF reader is set.

Introduces the new `xdg-utils` dependency.

README.md

@@ -11,8 +11,9 @@
 
 ## Description
 
-A simple CLI tool to display (or save) man pages as PDFs files via [Zathura](https://pwmt.org/projects/zathura/) for an easier reading.  
-It also allows to navigate through all the man pages available on your system via a dynamic menu ([Rofi](https://davatorium.github.io/rofi/) or [Dmenu](https://tools.suckless.org/dmenu/)).
+A simple CLI tool to display (or save) man pages as PDFs files for an easier reading.  
+Zaman first looks for the default PDF reader defined in [XDG MIME Applications](https://wiki.archlinux.org/title/XDG_MIME_Applications) and fallback to [Zathura](https://pwmt.org/projects/zathura/) if no default PDF reader is set.  
+It also allows to navigate through all the man pages available on the system through a dynamic menu via [Rofi](https://davatorium.github.io/rofi/) or [Dmenu](https://tools.suckless.org/dmenu/).
 
 ## Installation
 
@@ -31,35 +32,35 @@ Install dependencies:
 #### Debian / Ubuntu
 
 ```bash
-sudo apt install man-db groff zathura zathura-pdf-poppler rofi
+sudo apt install man-db groff xdg-utils zathura zathura-pdf-poppler rofi
 sudo apt install make bats scdoc
 ```
 
 #### Fedora
 
 ```bash
-sudo dnf install man-db groff groff-perl "perl(Compress::Zlib)" zathura zathura-pdf-poppler rofi
+sudo dnf install man-db groff groff-perl "perl(Compress::Zlib)" xdg-utils zathura zathura-pdf-poppler rofi
 sudo dnf install make bats scdoc
 ```
 
 #### Arch Linux
 
 ```bash
-sudo pacman -S man-db groff zathura zathura-pdf-poppler rofi
+sudo pacman -S man-db groff xdg-utils zathura zathura-pdf-poppler rofi
 sudo pacman -S --asdeps make bats scdoc
 ```
 
 #### Alpine Linux
 
 ```bash
-sudo apk add man-db groff zathura zathura-pdf-poppler rofi
+sudo apk add man-db groff xdg-utils zathura zathura-pdf-poppler rofi
 sudo apk add make bats scdoc
 ```
 
 #### Gentoo
 
 ```bash
-sudo emerge man-db groff zathura zathura-pdf-poppler rofi
+sudo emerge man-db groff xdg-utils zathura zathura-pdf-poppler rofi
 sudo emerge make bats scdoc
 ```
 
@@ -95,7 +96,7 @@ Alternatively, you can directly specify the man page to open in the command (exa
 
 ![zaman_cmd](https://user-images.githubusercontent.com/53110319/226755190-9d005cbe-b893-4b96-b6c1-db97a70f3a4b.png)
 
-The man page is opened as a PDF file in [Zathura](https://pwmt.org/projects/zathura/).
+The man page is opened as a PDF file in the default PDF reader defined in [XDG Mime Applications](https://wiki.archlinux.org/title/XDG_MIME_Applications) or in [Zathura](https://pwmt.org/projects/zathura/) if no default PDF reader is set.
 
 ![zaman_pdf](https://github.com/Antiz96/zaman/assets/53110319/fca2f8a7-c428-47f9-a1cd-e3dd295ce3ca)
 

doc/man/zaman.1.scd

@@ -1,13 +1,14 @@
-zaman(1) ["zaman 1.2.3" ["zaman Manual"]]
+zaman(1) ["Zaman 1.2.3" ["Zaman Manual"]]
 
 # NAME
 
-*zaman* - CLI tool to display (or save) man pages as PDFs.
+*Zaman* - CLI tool to display (or save) man pages as PDFs.
 
 # DESCRIPTION
 
-A simple CLI tool to display (or save) man pages as PDFs files in Zathura for easier reading.
-It also allows to navigate through all the man pages available on your system via a dynamic menu (Rofi or Dmenu).
+A simple CLI tool to display (or save) man pages as PDFs files for an easier reading.
+Zaman first looks for the default PDF reader defined in XDG MIME Applications and fallback to Zathura if no default PDF reader is set.
+It also allows to navigate through all the man pages available on the system through a dynamic menu via Rofi or Dmenu.
 
 # SYNOPSIS
 
@@ -59,14 +60,18 @@ zaman ls
 *4*
 	User didn't specified a man page or a file to export it in to with the `-o / --output` option.
 
+*5*
+	No default PDF reader defined in XDG Mime Application and `zathura` isn't installed as well.
+
 # SEE ALSO
 
-*zathura*(1),
+*man*(1),
+*groff*(1),
+*xdg-mime*(1),
+*xdg-open*(1),
 *rofi*(1),
 *dmenu*(1),
-*groff*(1),
-*echo*(1),
-*grep*(1)
+*zathura*(1)
 
 # BUGS
 

src/zaman.sh

@@ -1,16 +1,20 @@
 #!/bin/bash
 
-# zaman: A simple cli tool that prints (or saves) man pages in a PDF file for an easier reading.
+# zaman: A simple CLI tool to display (or save) man pages as PDFs files for an easier reading.
 # https://github.com/Antiz96/zaman
 # Licensed under the GPL-3.0 license (or any later version of that license).
 
-# Variables definition
+# General variables
 name="zaman"
 version="1.2.3"
 option="${1}"
 man_selected="${2}"
 file="${3}"
 
+# Create tmp dir if it doesn't exists
+tmpdir="${TMPDIR:-/tmp}/${name}-${UID}"
+mkdir -p "${tmpdir}"
+
 # Display debug traces if the -D / --debug argument is passed
 for arg in "${@}"; do
 	case "${arg}" in
@@ -67,10 +71,22 @@ check_man_page() {
 	fi
 }	
 
-# Definition of the print_to_pdf function: Print "${man_selected}" into a PDF file via `zathura`
+# Definition of the print_to_pdf function: Display "${man_selected}" in a PDF file
 print_to_pdf() {
 	check_man_page
-	man -Tpdf "${man_selected}" | zathura - &
+
+	# Check if a default PDF reader is set, otherwise fallback to zathura
+	if [ -n "$(xdg-mime query default application/pdf)" ]; then
+		pdf_reader="xdg-open"
+	elif command -v zathura > /dev/null; then
+		pdf_reader="zathura"
+	else
+		echo -e >&2 "There is no default PDF reader defined and Zathura isn't installed\nPlease, define a default PDF reader in XDG Mime Applications or install Zathura"
+		exit 5
+	fi
+
+	man -Tpdf "${man_selected}" > "${tmpdir}/${man_selected}.pdf"
+        "${pdf_reader}" "${tmpdir}/${man_selected}.pdf" &
 }
 
 # Definition of the menu function: Print the list of available man pages through a `rofi` or `dmenu` menu