ubuntu-manual team mailing list archive

[Paddy Landau <paddy@xxxxxxxxx>]

On 02/07/12 11:50, Patrick Dickey wrote:
> > I would think (but by no means do I know) that if you're referring
> to the styles for the manual (the .tex styles and formats), then it
> would be Kevin now. As he's in charge of the manual. Or possibly
> Benjamin Humphrey, although he's not in charge of the project anymore.

Thanks for the information. As I do not know LaTeX (apart from the bit
of editing I've done in gedit for this manual), I cannot say exactly
what I'm referring to! But "the .tex styles and formats" sounds correct.

I need to speak to someone who (a) knows LaTeX; (b) knows how to amend
the tags and styles; and (c) knows specifically how this was done for
Ubuntu's manual.

> > For my own personal curiosity, can you make some type of tutorial on
> how to get started with gummi...

Until we're sure that we can actually make Gummi work, there's no point
on creating a tutorial. However, this will get you going.

 1. Add the Gummi PPA; either *ppa:gummi/gummi* for the stable version
    <https://launchpad.net/%7Egummi/+archive/gummi> or
    *ppa:gummi/unstable* for the latest
    <https://launchpad.net/%7Egummi/+archive/unstable> (which,
    apparently, is usually pretty stable). I recommend the latter,
    because the spell-checker does not work on the stable version
    <http://dev.midnightcoding.org/issues/383>.
 2. Install gummi <apt:gummi>, xetexlive-base <apt:xetexlive-base>,
    xetexlive-xetex <apt:xetexlive-xetex>, rubber <apt:rubber>, latexmk
    <apt:latexmk>, libgtkspell0 <apt:libgtkspell0>, and your required
    language as myspell-[languagecode] (e.g. myspell-en-us
    <apt:myspell-en-us>).
 3. Start Gummi. You will see an example to start with. I find Gummi
    most useful when maximised, even on a wide-screen.
 4. The left-hand side is the editor, and the right-hand side shows the
    finished version. It takes about a two-second pause (it won't update
    while you are typing) to show updates on the right-hand side.
 5. Edit > Preferences > Compilation > Typesetter command > TeXLive with
    XeTeX.
 6. Edit > Preferences > Miscellaneous > Spell check language > [choose
    the required language].


Gummi has the usual editing functions and the ability to open and save
the files. This, to me, makes it ideal — or would, if I knew how to add
the Ubuntu tags and styles.

Gummi also has functions to hold full projects, "make" indexes and so
forth, but I believe that these would not be useful to this project
because of its shared nature (I could be wrong).

Read more about Gummi on its official website
<http://dev.midnightcoding.org/projects/gummi> (nothing to do with Gummi
Bears!).

To edit an extract of the manual, Gummi requires some specific lines at
the start and end. At a minimum, this entails the following two lines at
the top:

    \documentclass[11pt]{article}
    \begin{document}

and the following line at the end:

    \end{document}


You will notice that Gummi will show only an error on the right-hand
side when editing extracts from the Ubuntu manual, because of all the
tags that it does not recognise (e.g. /application, /keystroke).

Paddy