Go to file
Pierre Pronchery 1f3caa913a browser: identify more file types when opening
This allows MIME application handlers to be applied to special files and
folders.
2024-06-02 20:28:30 +02:00
data Import the newer scripts from DeforaOS configure 2024-06-02 20:01:49 +02:00
doc Import the newer scripts from DeforaOS configure 2024-06-02 20:01:49 +02:00
include Rework the desktop to allow modular handlers 2020-09-26 14:46:51 +02:00
po po: re-generate the translation files 2022-05-11 07:04:59 +02:00
src browser: identify more file types when opening 2024-06-02 20:28:30 +02:00
tests Import the newer scripts from DeforaOS configure 2024-06-02 20:01:49 +02:00
tools Import the newer scripts from DeforaOS configure 2024-06-02 20:01:49 +02:00
.gitignore Register the new configuration file 2020-03-03 01:25:07 +01:00
COPYING Switch to the 2-clause BSD license 2018-10-26 13:51:03 -03:00
project.conf project.conf: register the compilation modes 2022-07-11 05:24:47 +02:00
README.md README.md: add some information 2022-07-11 05:21:25 +02:00
TODO Remove an item from the TODO list 2017-12-28 06:06:36 +01:00

DeforaOS Browser

About Browser

Browser is a file manager and image browser.

It can be extended through plug-ins, which are then displayed in the left pane of the file management windows.

Browser is part of the DeforaOS Project, found at https://www.defora.org/.

Compiling Browser

Browser depends on the following components:

  • Gtk+ 2.4 or newer, or Gtk+ 3.0 or newer
  • DeforaOS libDesktop
  • an implementation of make
  • gettext (libintl) for translations
  • DocBook-XSL for the manual pages
  • GTK-Doc for the API documentation

With these installed, the following command should be enough to compile and install Browser on most systems:

$ make install

To install (or package) Browser in a different location, use the PREFIX option as follows:

$ make PREFIX="/another/prefix" install

Browser also supports DESTDIR, to be installed in a staging directory; for instance:

$ make DESTDIR="/staging/directory" PREFIX="/another/prefix" install

The compilation process supports a number of other options, such as OBJDIR for compilation outside of the source tree for instance.

On some systems, the Makefiles shipped may have to be re-generated accordingly. This can be performed with the DeforaOS configure tool.

Documentation

Manual pages for each of the executables installed are available in the doc folder. They are written in the DocBook-XML format, and need libxslt and DocBook-XSL to be installed for conversion to the HTML or man file format.

Likewise, the API reference for Browser (plug-ins) is available in the doc/gtkdoc folder, and is generated using gtk-doc.

Extending Browser

Plug-ins for the Browser program can be written according to the API definitions installed and found in <Desktop/Browser.h> (in the source code in the include/Browser.h file).

A sample plug-in can be found in src/plugins/template.c.

Further plug-ins may also be found in the DeforaOS Integration project.

Distributing Browser

DeforaOS Browser is subject to the terms of the 2-clause BSD license. Please see the COPYING file for more information.