ubuntu-manual team mailing list archive

[Kevin Godby <godbyk@xxxxxxxxx>]

'allo.

2010/4/29 Martin Lukeš <martin.meridius@xxxxxxxxx>:
> Right, index. Totally forgot about that. ;)

No worries. :)

> I might have just few more questions.
> Since application tag doesn't change the font, it's fine if I do something
> like:
>>
>> Pomocí \application{Writer}u.
>
> Whole "Writeru" word will be with the same font and all?
>
> And since Czech language has one beautiful "burden" called declension, when
> I do:
>>
>> Pomocí \application{Centra softwaru pro Ubuntu}.
>
> And then mark its basic form:
>>
>> Použijte \application{Centrum softwaru pro Ubuntu}.
>
> Then in index I get two items marking the same application just because of
> two characters. Is there a workaround so both could be under one item? Their
> basic form would be the best. ;)

Yeah, I knew this would eventually come up!

Okay, I've modified the \application command slightly.  I'll first
illustrate its use with your examples above:

  Pomocí \application[Writer]{Writeru}.
  Pomocí \application[Centrum softwaru pro Ubuntu]{Centra softwaru pro Ubuntu}.
  Použijte \application{Centrum softwaru pro Ubuntu}.

Given that input, the PDF will contain the following:

  Pomocí Writeru.
  Pomocí Centra softwaru pro Ubuntu.
  Použijte Centrum softwaru pro Ubuntu.

And the index will contain the following two entries:

  Centrum softwaru pro Ubuntu
  Writer

Now for the details.  The first argument (inside square brackets [])
is an *optional* argument.  If you provide this optional argument,
that is what will appear in the index.  If you don't supply the
optional argument, the mandatory argument (that which appears in
braces {}) is what will appear in the index.  The document text will
always display what was provided in the mandatory (braces {})
argument.

  \application[index entry]{in-text words}

This means you can use whatever declension is called for in text (as
the mandatory argument), and keep the index entries consolidated by
using a canonical name in the optional argument.

The \commandlineapp macro will work the same way.

Does this solve the problem? And are there other commands that need
this treatment?

Thanks!

--Kevin