Re: [Gimp-docs] Gimp Manual Roadmap proposal

[Roman Joost <romanofski gimp org>]

Dear RyoTa,

On Fri, Feb 07, 2014 at 11:52:13PM +0900, RyoTa SimaMoto wrote:
> Hi,
>
> I am warry about to use Publican.
>
> Publican prohibits to use <link linkend="...">WORD(S)</link> tag
> then allows <xref linkend="..."/> tag only for internal hyperlink.
> (xreflabel is also disallowed.)
> http://jfearn.fedorapeople.org/en-US/Publican/3.2/html/Users_Guide/appe-Users_Guide-Disallowed_elements_and_attributes.html
>
> That means we need revise whole text so that each targeted section
> has a <title>.  In much cases on our document, we use <link> with
> verb/noun for representing an action, a filter, or a tool of GIMP
> instead of using its title in the reference section.  To replace it
> with <xref>, almost links may be reformed in 'see also' style,
> because it cannot be replaced with other adjusted phrase for inline
> context at referring text.
Cheers for pointing this out. It seems that this needs to be looked at
closer in order to figure out the best way to go about it. A migration
seems to be quite costly...

> I presume some translators may unwelcome this restriction especially
> for languages that have conjugation and/or declension, when <xref>
> tag happens in the middle of text structure.
Thanks for this valuable pointer. To keep the discussion for this topic
in one place, would you mind moving this to the associated bug?

    https://bugzilla.gnome.org/show_bug.cgi?id=723512

Cheers!
-- 
Roman Joost
www: http://www.romanofski.de
email: romanofski gimp org