Re: [Gimp-docs] a new user perspective

2010-11-15 Thread Roman Joost
Hi Ulf,

On Sun, Nov 14, 2010 at 08:51:03PM +0100, Ulf-D. Ehlert wrote:
> (1) Compact layout. 
> This is mostly a matter of the chosen style(sheet):
> We (you?) could create an alternate stylesheet , e.g. "compact.css" 
> (starting with a copy of gimp-help-screen.css) and change text layout 
> etc. according to your suggestions. (And we can make it the default 
> stylesheet at any time.)
> 
> BTW, the HTML pages read "gimp-help-custom.css" if this stylesheet 
> exists (by default it does not), so that's a good place to apply and 
> test your changes in the real world.
Just keep in mind with those changes, that the GIMP Help browser uses
almost the same stylesheets. Perhaps it is not the desirable goal to
have a compact layout for the user who downloaded the manual or uses the
help browser to browse the manual.

Cheers,
-- 
Roman Joost
www: http://www.romanofski.de
email: romanof...@gimp.org


signature.asc
Description: Digital signature
___
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs


Re: [Gimp-docs] a new user perspective

2010-11-15 Thread Ulf-D. Ehlert
David (Tuesday, 09. November 2010)
> > So shouldn't we ask someone who had never worked with
> > GIMP or had never tried to read the manual? ;-)
> 
> That *is* me, isn't it? ("a new user perspective")

Are you kidding?! ;-)
 
> Actually I was referring to the page content on eg the 'basic
> concepts' page, where the writing and the pictures are closer
> together in my version than in the existing version - allows you
> to see more on one screen

(Oops, I didn't check the links...)
Yes, your Basic Concepts page looks fine. :-)

So we have several proposed improvements, and if I see it correctly 
they are more or less independent of each other:

(1) Compact layout. 
This is mostly a matter of the chosen style(sheet):
We (you?) could create an alternate stylesheet , e.g. "compact.css" 
(starting with a copy of gimp-help-screen.css) and change text layout 
etc. according to your suggestions. (And we can make it the default 
stylesheet at any time.)

BTW, the HTML pages read "gimp-help-custom.css" if this stylesheet 
exists (by default it does not), so that's a good place to apply and 
test your changes in the real world.

(1.1) Floating images.
It seems that too ;-) many people like them, so we should provide a 
way to enable floating images.
Of course it is possible to make *all* images (exception: icons) 
float, but I'd prefer to add a modified DocBook-XSL template which 
passes some attribute to HTML (e.g.
),
where we can select it with CSS.
Then we can control which images should float (I think the most 
figures - especially large figures - should not).

I can add the appropriate changes for inlinemediaobjects - graphics 
without title or caption. If needed we can do the same for 
mediaobjects - graphics without title but with optional caption - and 
figures - graphics with title and optional caption. Ok?

(Alternative approach: create an alternate stylesheet.) 

> It would be, although even with 2 levels it would still miss basic
> concepts, layers, selections. But that would be a vast improvement
> in my view :). And if people could not find what they wanted from
> that, we'd know the structure was wrong...

(2) Compact tocs (without changes).
This is simple, just change the controlling xslt parameters. (If we 
really do this, we should try to generate a deep toc as appendix or 
so.)

(3) Rename some chapters.
Just list your suggested changes, and unless there are any 
objections/problems we will apply them.

(4) Changed Basic Concepts.
Hmm, looks good to me - any comments?

(5) Rearrange (resort, merge, etc.) chapters (concepts and usage).
Looks good too. IMO we should try to implement and test this in a new 
branch and see if we like it.

Bye,
Ulf


-- 
Allein bin ich manchmal einsam; mit anderen oft;
in Gesellschaft fast immer. Was mich mehr als alles
krank macht, sind die unheilbar Gesunden.
-- Karlheinz Deschner


signature.asc
Description: This is a digitally signed message part.
___
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs


Re: [Gimp-docs] a new user perspective

2010-11-15 Thread Roman Joost
Hi David,

On Thu, Nov 11, 2010 at 01:16:57PM +, David wrote:
> > Perhaps it would be a good idea to split up the documentation into two
> > books: the first would be a function reference and the second a more
> > helpful tutorial based manual.
> 
> Sorry - but I don't understand what you mean by 'function reference'. The 
> current 'function reference' section isn't - it contains menus, for example, 
> which are not functions. It may be a language/translation problem...?
Sorry for the use of my technical term.

> What would you include if there was a book called 'function
> reference'? Would it be different to the existing section (which is
> misnamed in my view)?
The current manual is currently two types of books. Part I and II is a
descriptive manual with tutorials. It describes how to do "things" with
GIMP.

The Part which is currently labeled or mislabeled as a "function
reference" is a reference for almost every item you can find in GIMP.
Perhaps "User Interface Reference" or simply "GIMP Reference" is more
descriptive.

Cheers,
-- 
Roman Joost
www: http://www.romanofski.de
email: romanof...@gimp.org


signature.asc
Description: Digital signature
___
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs