Re: [Inkscape-docs] News item.... graphics issues in manual

2017-06-07 Thread Maren Hachmann
Hi Marietta,

I now have master permissions on the linked project, and have added you
as a developer there. Also assigned you to your first task :)

You don't need SSH to just work on the issues section. We will not use
the repository for anything but the README file currently.

Translations are far in the future, let's start with the task at hand.
Try to keep the overhead small (short issue texts, concise descriptions).

If you like, you can create an issue for 'We need to figure out how
translations of the manual can be created and tracked'
(proposed solution: just make a copy of the book on flossmanuals, then
translate, organize translators via issue on gitlab, use issue tags to
specify language.).

Kind Regards,
 Maren

Am 07.06.2017 um 06:41 schrieb Marietta Walker:
> For Martin:
> 
> Are we working on the project at Gitlab titled:
> Inkscape\Inkscape-docs\manuals or are you creating another project?   If
> we keep it under one large generic heading such as the above mentioned,
> then we can track sub projects under one umbrella, English Translation
> for Inkscape Beginners/Dutch Translation for "Whatever/etc. Am I making
> any sense?
> 
> Also do I need to add SSH to my account?
> 
> Since I am completely unfamiliar with Gitlab, I am wanting to get in
> there and learn and get started.
> 
> Thanks
> 
> 
> 
> 
> On 6/6/2017 10:15 PM, brynn wrote:
>>> - We will delete some, and keep those that are good. If you don't want
>> to work on this, then we can add this to the task list, for someone else
>> to grab.
>>
>> No, I don't mind doing it.  I just need to be clear what the goal is
>> and what the parameters are.  Although I won't be happy if I rename
>> files and find out later that they're going to be replaced.
>>
>> Here you seem to be asking me to make the screenshots.  But in a
>> different message, I thought you said that CR had volunteered. Maybe I
>> misunderstood somewhere?  But I don't have a very pretty theme color.
>>
>> How about if I make a list of all the ones that need to be replaced,
>> and give the list to C R.  Then he could make them with the default
>> Windows theme, and either upload them himself, or send to me and I'll
>> upload?
>>
>> Not sure about developers spending time reviewing the manual at
>> hackfest, when time is at such a premium, with travel expenses and
>> all.  It seems like after hackfest would be better.  Plus do we really
>> need reviews from advanced users? New users would seem better for
>> sources of reviews?
>>
>> But I can finish my part before hackfest.  If C R has time to make
>> them, I'm sure we can finish the whole thing by that time.  Or even if
>> you want me to try making another user account, to find out if it
>> could use a different theme. Then I could make the screenshots.
>>
>> All best,
>> brynn
>>
>>
>> -Original Message- From: Maren Hachmann
>> Sent: Tuesday, June 06, 2017 7:50 PM
>> To: brynn ; Inkscape-Docs
>> Subject: Re: [Inkscape-docs]News item graphics issues in manual
>>
>> Am 07.06.2017 um 03:08 schrieb brynn:
>>> If you're saying that Inkscape is supposed to detect what kind of screen
>>> is being used, and automatically set itself accordingly, that's
>>> something I've never heard of, or experienced.
>>
>> - According to the program code, if width/height > 1.65, Inkscape will
>> switch to 'Wide' mode. You could try it out by removing / renaming your
>> preferences file. I suspect you have moved it from your old computer.
>> Let's stick to that for screenshots, it makes sense. If it doesn't work,
>> it's a bug.
>>
>>>> It would be helpful if you could continue with renaming the images that
>>> do not need to be changed - i.e. the tool icons, or drawings without any
>>> text or menus shown.
>>>
>>> I haven't started yet.  I don't want to duplicate or waste work energy.
>>> It seems like it would be less work all around, to just give appropriate
>>> names to the new screens and graphics, than to rename them all now, and
>>> upload whole new images to relace them later.  Or am I missing something
>>> about the plans and processes?
>>
>> - We will delete some, and keep those that are good. If you don't want
>> to work on this, then we can add this to the task list, for someone else
>> to grab.
>>>> Can you go through the images, and rename all the files that will
>>>> not be
>>> deleted, so they will be understandable when others look at them at
>>> Hackfest time?
>>>
>>> Wouldn't I need to wor

Re: [Inkscape-docs] News item.... graphics issues in manual

2017-06-06 Thread Marietta Walker

For Martin:

Are we working on the project at Gitlab titled: 
Inkscape\Inkscape-docs\manuals or are you creating another project?   If 
we keep it under one large generic heading such as the above mentioned, 
then we can track sub projects under one umbrella, English Translation 
for Inkscape Beginners/Dutch Translation for "Whatever/etc. Am I making 
any sense?


Also do I need to add SSH to my account?

Since I am completely unfamiliar with Gitlab, I am wanting to get in 
there and learn and get started.


Thanks




On 6/6/2017 10:15 PM, brynn wrote:

- We will delete some, and keep those that are good. If you don't want

to work on this, then we can add this to the task list, for someone else
to grab.

No, I don't mind doing it.  I just need to be clear what the goal is 
and what the parameters are.  Although I won't be happy if I rename 
files and find out later that they're going to be replaced.


Here you seem to be asking me to make the screenshots.  But in a 
different message, I thought you said that CR had volunteered. Maybe I 
misunderstood somewhere?  But I don't have a very pretty theme color.


How about if I make a list of all the ones that need to be replaced, 
and give the list to C R.  Then he could make them with the default 
Windows theme, and either upload them himself, or send to me and I'll 
upload?


Not sure about developers spending time reviewing the manual at 
hackfest, when time is at such a premium, with travel expenses and 
all.  It seems like after hackfest would be better.  Plus do we really 
need reviews from advanced users? New users would seem better for 
sources of reviews?


But I can finish my part before hackfest.  If C R has time to make 
them, I'm sure we can finish the whole thing by that time.  Or even if 
you want me to try making another user account, to find out if it 
could use a different theme. Then I could make the screenshots.


All best,
brynn


-Original Message- From: Maren Hachmann
Sent: Tuesday, June 06, 2017 7:50 PM
To: brynn ; Inkscape-Docs
Subject: Re: [Inkscape-docs]News item graphics issues in manual

Am 07.06.2017 um 03:08 schrieb brynn:

If you're saying that Inkscape is supposed to detect what kind of screen
is being used, and automatically set itself accordingly, that's
something I've never heard of, or experienced.


- According to the program code, if width/height > 1.65, Inkscape will
switch to 'Wide' mode. You could try it out by removing / renaming your
preferences file. I suspect you have moved it from your old computer.
Let's stick to that for screenshots, it makes sense. If it doesn't work,
it's a bug.


It would be helpful if you could continue with renaming the images that

do not need to be changed - i.e. the tool icons, or drawings without any
text or menus shown.

I haven't started yet.  I don't want to duplicate or waste work energy.
It seems like it would be less work all around, to just give appropriate
names to the new screens and graphics, than to rename them all now, and
upload whole new images to relace them later.  Or am I missing something
about the plans and processes?


- We will delete some, and keep those that are good. If you don't want
to work on this, then we can add this to the task list, for someone else
to grab.
Can you go through the images, and rename all the files that will 
not be

deleted, so they will be understandable when others look at them at
Hackfest time?

Wouldn't I need to work with C R (or whoever), to determine which are
kept and which are replaced?  It seems like some level of coordination
and communication should happen for this, rather than 2 different people
going at it separately in different ways, possibly making incompatible
decisions?


- CR is there for talking, but I trust that you can figure out if an
image is just a tool icon, or contains a drawing without text, and does
not need to be re-created. You might even use gimp to cut off some
French text. This would speed up manual creation quite a bit.
Improvements can be done later.


By the way, why does it need to be ready for hackfest?  I was thinking
the end of the year for a target publishing date, not 3 weeks!


- Ready as in 'translated' and ready to work on and test out for people
speaking English.

Kind Regards,
Maren

-- 


Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs




--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.n

Re: [Inkscape-docs] News item.... graphics issues in manual

2017-06-06 Thread Maren Hachmann
Hi Brynn,

Am 06.06.2017 um 13:50 schrieb brynn:
>> I'm a bit disappointed about everyone being so engaged and vocal about
> helping/liking the action, and now me working on it alone for > 2 weeks
> already.
> But that's normal, I guess - it was the reason why I haven't started
> this earlier, and I felt ready to take it on now, no matter what.
> 
> Don't worry, Maren.  I'm still on top of helping with the manual.  It's
> just life offline keeps pulling me away from computer lately.

- Mine is busy, too.

> I will start proofing as soon as I can get this moderation stuff settled.

- Yes, if you could help with fixing language errors, that would be
helpful.

> For working on the graphics, as you have outlined, I have some blockers
> on that. Somewhere I've mentioned them, but I don't think they were
> answered.  (I think I put comments in the Notes tab, below the line of
> *.  But I see now that that line of * is gone, and so are the comments I
> made.)

- Yes, that tab has been wiped.

> Starting on Interface chapter:
> 
> 1 -- graphics are not proportional, they're stretched long and squeezed
> side to side

> 2 -- the interface that's being used, uses a non-default display mode
> (with command bar on the right)

- Yes, this is described in the book. It's the standard display mode new
users get when they are using a wide screen (please someone correct me
if I'm wrong, my screen is 4:3). Widescreens are standard now, so most
users should get that display.

> 3 -- the interface is using some custom icon set

- It uses the standard icons. All the icons that look different to you
are provided by the operating system and look different from your
Windows setup, yes (they look the same for me, btw.).

> Before we start working on the graphics issues, these things need to be
> addressed, in my opinion (otherwise we might have to eventually
> duplicate some work).

- You can leave the picture layouting to someone experienced with web
page styling. This also requires coordination with the style person or
persons, and some understanding of how the different output formats
influence the layout.

It would be helpful if you could continue with renaming the images that
do not need to be changed - i.e. the tool icons, or drawings without any
text or menus shown.

And then, as a native speaker, language fixes would help us, and perhaps
compiling that list of frequent issues for the chapter that we would
like to add.

Also, I seem to remember there was a glossary chapter that needed to be
added.

> I think we need to be using the most default interface screenshots as
> possible. And of course, the graphics should be displayed in proper
> proportions.
> 
> The most important thing to decide, is where the new graphics will come
> from. Should be someone with not such an ugly theme (color) as mine. 
> Should be someone who is committed to providing the graphics and won't
> disappear.  Should be using a default display mode and icon set.

- CR volunteered for this in another email :D

> I wonder if it's possible in Windows, if I make a new user account, that
> account could use a different theme?  I'll investigate.  If I can, I'll
> provide the graphics.

- Let's take one step after the other, Brynn. It's better to finish one
thing, then take on the next.

This is also easier for me, because I don't need to be all over the
place when I know that a task is being tackled and finished.

Can you go through the images, and rename all the files that will not be
deleted, so they will be understandable when others look at them at
Hackfest time?

Can you get back to us when you are done with that, so we can then find
a new task?

(Probably one of: proofreading for language errors, compiling list of
frequent basic issues and helpful tricks).

Kind Regards,
 Maren

> I'm changing the title of this message to start a separate thread on the
> graphics issues.  (I see a long string of replies to making a News item,
> and I suspect there may be a few different issues.  I'm off to read more
> now  :-) (Also switching to only Docs list)
> 
> All best,
> brynn
> 
> -Original Message- From: Maren Hachmann
> Sent: Sunday, June 04, 2017 6:46 AM
> To: inkscape-de...@lists.sourceforge.net ; Inkscape-Docs
> Subject: Re: [Inkscape-docs] [Inkscape-devel] News item about the new
> manual work?
> 
> CR, I have been translating (and fixing contents as I go) 1-2 chapters
> each day for the last 2.5 weeks and am more than halfway through (35
> chapters done, 24 left to do). There wasn't anyone else to be seen
> around, after the first week, when one person translated a chapter
> (unfortunately they picked the only one that needs to be rewritten from
> scratch, because Inkscape changed), and two people proofread a couple of
> chapters (thank you!!!). Well, and a couple of days ago, someone seems
> to have accidentally wiped all the notes on the book, that were supposed
> to help get people started (or maybe it was a platform bug).
> 
> I'd be glad 

Re: [Inkscape-docs] News item.... graphics issues in manual

2017-06-06 Thread brynn

I'm a bit disappointed about everyone being so engaged and vocal about

helping/liking the action, and now me working on it alone for > 2 weeks
already.
But that's normal, I guess - it was the reason why I haven't started
this earlier, and I felt ready to take it on now, no matter what.

Don't worry, Maren.  I'm still on top of helping with the manual.  It's just 
life offline keeps pulling me away from computer lately.


I will start proofing as soon as I can get this moderation stuff settled.

For working on the graphics, as you have outlined, I have some blockers on that. 
Somewhere I've mentioned them, but I don't think they were answered.  (I think I 
put comments in the Notes tab, below the line of *.  But I see now that that 
line of * is gone, and so are the comments I made.)


Starting on Interface chapter:

1 -- graphics are not proportional, they're stretched long and squeezed side to 
side
2 -- the interface that's being used, uses a non-default display mode (with 
command bar on the right)

3 -- the interface is using some custom icon set

Before we start working on the graphics issues, these things need to be 
addressed, in my opinion (otherwise we might have to eventually duplicate some 
work).


I think we need to be using the most default interface screenshots as possible. 
And of course, the graphics should be displayed in proper proportions.


The most important thing to decide, is where the new graphics will come from. 
Should be someone with not such an ugly theme (color) as mine.  Should be 
someone who is committed to providing the graphics and won't disappear.  Should 
be using a default display mode and icon set.


I wonder if it's possible in Windows, if I make a new user account, that account 
could use a different theme?  I'll investigate.  If I can, I'll provide the 
graphics.


I'm changing the title of this message to start a separate thread on the 
graphics issues.  (I see a long string of replies to making a News item, and I 
suspect there may be a few different issues.  I'm off to read more now  :-) 
(Also switching to only Docs list)


All best,
brynn

-Original Message- 
From: Maren Hachmann

Sent: Sunday, June 04, 2017 6:46 AM
To: inkscape-de...@lists.sourceforge.net ; Inkscape-Docs
Subject: Re: [Inkscape-docs] [Inkscape-devel] News item about the new manual 
work?


CR, I have been translating (and fixing contents as I go) 1-2 chapters
each day for the last 2.5 weeks and am more than halfway through (35
chapters done, 24 left to do). There wasn't anyone else to be seen
around, after the first week, when one person translated a chapter
(unfortunately they picked the only one that needs to be rewritten from
scratch, because Inkscape changed), and two people proofread a couple of
chapters (thank you!!!). Well, and a couple of days ago, someone seems
to have accidentally wiped all the notes on the book, that were supposed
to help get people started (or maybe it was a platform bug).

I'd be glad to see some proofreading and styling/screenshooting people
get on board, so we can continue seamlessly after I'm through with
translating.

I'm a bit disappointed about everyone being so engaged and vocal about
helping/liking the action, and now me working on it alone for > 2 weeks
already.
But that's normal, I guess - it was the reason why I haven't started
this earlier, and I felt ready to take it on now, no matter what.

Anyway, I'm going to continue to plow through, then translations will be
ready before the hackfest. In parallel, I'm going to be plowing through
my new garden, and to help fix up someone else's house, so I expect to
not have time for much else.

I'd be glad if someone could try and reengage people to help with the
manual (preferably people who are able to work independently and know
Inkscape inside out, or who concentrate on something they really do
well, like fixing up language or styling).

There are more than enough open tasks:
from CSS to cover design, to screenshooting, to consistency checking and
layouting, to improving on my more or less weird English, to adding
missing content (or perhaps, translating, of course).

And yet, when we do this, I think it's important to take care to honor
the underlying 'Keep it simple and as short as possible' concept of the
book, which would make it possible for young teenagers to use it to get
started, without much theoretical ballast.
Elisa seems to have invested a *lot* of thought into how she built up
the chapters and when to start teaching which concept. I suspect her
concept stems from experience in teaching live Inkscape courses.

Maren

Am 04.06.2017 um 13:32 schrieb C R:

I'd say let's wait and do a progress report, so we can say that we're
making progress on it, rather than just that we've decided to do it. I
plan on helping this area of the project much more after I handle the
hackfest swag. It would be better to have a more or less complete
manual before we announce it to the public, unless it's a call