Gummi » Wiki

Gummi is available through the Gentoo Sunrise project. Sunrise is a community overlay that encourages Gentoo users to contribute their ebuilds. All ebuilds are reviewed by fellow users and gentoo developers. You can add the Sunrise overlay to your system using the layman tool. More information on installing layman/sunrise can be found here. We also provide .ebuild files on the downloads page that you can add to your own (local) overlays. More information on layman and overlays can be found here.

Installation for Ubuntu

Download the Ubuntu .deb package from the website
Open a terminal, browse to the folder where you've placed the file, and typ:

sudo dpkg-i gummi_{version}-0ubuntu1.deb

This will install Gummi and its dependencies. However, in some cases an additional command is necessary to enforce installation of the dependencies:

sudo apt-get install -f

Installation for Fedora

Download the Fedora RPM package from the website
Open a terminal as root, browse to the folder where you've placed the file, and typ:

yum install gummi-{VERSION}-1.noarch.rpm --nogpgcheck

Installation for Arch

coming!

Troubleshooting: spell-checking does not work

Gummi uses the gtkspell program as its backend for spell checking. The packages I provide don't have a direct dependency on it as I want spell checking to be an optional functionality. If you would like to use spell checking but can't, install python-gtkspell or gtkspell-python (depending on your distribution) to enable it. Install additional myspell dictionary packages to enables spell checking for different languages than your default.

Troubleshooting: missing/faulty packages

The texlive dependencies for Gummi are limited to only the basic texlive components. There are numerous latex modules available and to have Gummi install all of them wouldn't make much sense. When a package is included that is not installed on your system, the error output tab in Gummi will provide you with information on what you are missing. Once you have installed the correct latex module, you will be able to use it in your documents.

Two examples, their output and solution:

\usepackage{alexander}  gives error: LaTeX Error: File `alexander.sty' not found. (install the alexander latex module)

\usepackage[T1]{fontenc} gives error: pdfTeX error: pdflatex (file ecrm1000): Font ecrm1000 at 600 not found (install texlive-fontsextra*)

* Your distribution of choice might have a different but similar name for this package).

FAQ: So, who are you?

I'm Alexander van der Mey, an Artificial Intelligence student at the University of Amsterdam. I have been using GNU/Linux since 2005 and settled on Gentoo Linux after a short period of trying out different distributions. My desktop of choice is and has always been Gnome. When I'm not geeking out, you can typically find me having a beer at a local pub or concert hall.

FAQ: What did you use to write Gummi?

I wrote most of Gummi on my Gentoo laptop using gedit (yeah, i know..) and glade.

FAQ: What is Gummi /LaTeX?

LaTeX is a powerful markup language that is widely used in the creation of professional and academic papers. Its syntax can seem daunting at first to a novice user, which is the main reason why I wanted (and needed) an editor that would help out a novice user. Gummi is the result of that desire.

FAQ: How can I help?

Gummi is still in the development stage, and this is my first public project in python. Constructive comments on the code style are appreciated, but most of all I'm looking for people willing to test Gummi and report their findings. Release QA is at the moment pretty much limited to checking whether the svn version will run on my machine. That being said, help in every area is appreciated. If you'd like to contribute by writing code, documentation or think you can contribute in any other way: drop me a line.

FAQ: Can you port Gummi to my platform?

I'm open to the idea of porting Gummi to say MacOS or Windows, but Gummi still needs a lot of work and my priority is with improving Gummi on the linux platform for now.