[Bf-docboard] Bf-docboard Digest, Vol 79, Issue 3

Kesten Broughton solarmobiletrailers at gmail.com
Sun Sep 25 23:40:41 CEST 2011


Hi Jared,

I like the new wiki colors too.  One problem I often encountered as a laptop
user is that shortcuts frequently require the number pad.  Eg.

"The *active* camera is the camera that is currently used for rendering and
camera view (0 NumPad)."

It would be a nice feature if on-mouse-over of the keypad gifs there was a
"help" option that would take you either to a page explaining keyboard
emulation, or describing how to use the new spacebar feature in the 3d
viewport to find the gui location of the shortcut.  For this example, I can
move to the 3dViewport, hit spacebar, and type active which pulls up a list
including the item i need "set active object as camera".

Or perhaps this spacebar feature should be put in a top 10 things to know
about blender and the entry to the wiki.

kesten

On Sun, Sep 25, 2011 at 5:00 AM, <bf-docboard-request at blender.org> wrote:

> Send Bf-docboard mailing list submissions to
>        bf-docboard at blender.org
>
> To subscribe or unsubscribe via the World Wide Web, visit
>        http://lists.blender.org/mailman/listinfo/bf-docboard
> or, via email, send a message with subject or body 'help' to
>        bf-docboard-request at blender.org
>
> You can reach the person managing the list at
>        bf-docboard-owner at blender.org
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Bf-docboard digest..."
>
>
> Today's Topics:
>
>   1. Re: The pdf version of User's manual is 15 months old- How
>      about a new one? (John Blain)
>   2. Re: Wiki upgrade 2011 (Jared Reisweber)
>   3. Re: The pdf version of User's manual is 15 months old- How
>      about a new one? (Raindrops From Sky)
>   4. Re: Wiki upgrade 2011 (Raindrops From Sky)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Sun, 25 Sep 2011 06:40:17 +1000
> From: John Blain <silverjb12 at gmail.com>
> Subject: Re: [Bf-docboard] The pdf version of User's manual is 15
>        months old- How about a new one?
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
>        <CAHCKqi=ytm9M8cNRp0LxARduc1A76EjORJg-i4N9LiGbTqcUtw at mail.gmail.com
> >
> Content-Type: text/plain; charset="iso-8859-1"
>
> Hi Narayan
>
> In this discussion what sort of a PDF manual are you guys discussing? My
> Blender 2.59 PDF manual is there for grabs if you want a book for
> beginners.
>
> http://silverjb.limewebs.com/index.html
>
> Regards
>
> John Blain
>
> On 24 September 2011 19:09, Raindrops From Sky
> <raindrops.fromsky at gmail.com>wrote:
>
> > Actually we should NOT expect a 15-months old manual to be in demand any
> > more; especially because the new 2.5x Blender is totally different.
> >
> > Let us not question whether this project is worth the effort.
> > I would be happy to put all the effort in making the new pdf manual.
> >
> > That leaves only the task of installing the extension to export as odt.
> So
> > let us simply go ahead and do it! :)
> >
> > BTW the pdf would NOT be a direct transcription of wiki, but a totally
> > different creation.
> > Compare the LMMS wiki with the pdf manual I created; and see what I mean.
> >
> > If the "export as odt" extension is not available, I could rip the
> website
> > with Httrack and make the manual.
> > I propose to release the pdf manual with CC license.
> > Please let me know if there are any issues with this idea.
> >
> > Regards,
> > Narayan
> >
> > _______________________________________________
> > Bf-docboard mailing list
> > Bf-docboard at blender.org
> > http://lists.blender.org/mailman/listinfo/bf-docboard
> >
> >
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> http://lists.blender.org/pipermail/bf-docboard/attachments/20110925/1ff4a5fb/attachment-0001.htm
>
> ------------------------------
>
> Message: 2
> Date: Sat, 24 Sep 2011 22:16:57 -0400
> From: Jared Reisweber <jaredr122 at gmail.com>
> Subject: Re: [Bf-docboard] Wiki upgrade 2011
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
>        <CAJgraRQdazZx1U+ADhwyCKM7Oyt8fPcp1ka2smzaDqLmQCqUoA at mail.gmail.com
> >
> Content-Type: text/plain; charset="iso-8859-1"
>
> Nice work Mindrones! Its definitely a lot easier to read now. I agree about
> the ability to collapse the nav tree, and the side bar disappearing.
>
> I saw that you reverted the 2.5 index to match the 2.4 index. I kept track
> of the changes i made to the 2.5 index and manual pages:
>
>
> https://docs.google.com/spreadsheet/ccc?key=0AgUiaPsPYcKpdElpc2V3S1JIb21kUTNMT0YzTTJ2X3c&hl=en_US#gid=1
>
> The first page lists the status of the wiki, as it appears in the sandbox
> version (
> http://wiki.blender.org/index.php/Meta:Sandbox/Doc:2.5/Manual_Proposal).
> It
> includes pages that do not exist, exist but need major improvement, and
> pages that seem complete. I've been updating this as new pages have been
> added, but wiki editors should feel free to update this as well.
>
> The second page compares the old index with the new index ( new pages,
> removed links, changed page names, and moved content), which should help
> with managing all the  2.5 content(transferring pages, renaming pages,
> preventing duplicate wiki content, etc.). It is missing a few entries that
> were added recently to the index, however.
>
> -Jared
>
> On Tue, Sep 20, 2011 at 3:19 AM, Raindrops From Sky <
> raindrops.fromsky at gmail.com> wrote:
>
> > Hi!
> >
> > The new light background is far easier to read. The gray background
> ensures
> > that long hours of reading does not tire the eyes. Fantastic!
> >
> > I have two LCD monitors; one 17" monitor with 1.25:1 aspect ratio and the
> > other 22" HD monitor with 16:9 ratio. Because of high-resolutions, I have
> to
> > use different zoom factors for both (for all Windows applications;
> including
> > FireFox).
> >
> > When I zoom in, the right-side panel vanishes; and the tree panel
> occupies
> > a disproportionately large screen space. Can this be looked into?
> >
> > I have another suggestion: The tree is not needed all the time. Can we
> fold
> > it away with a click (or resize it by dragging), as in the side bar of
> > FireFox?
> >
> > Alternatively, it could have a button to fold/unfold as in Google Map or
> > Google wiki (see sample here, where a << button hides the side-panel:
> > http://code.google.com/p/zscreen/wiki/ZScreenWiki?tm=6
> >
> > Thanks and regards,
> > Narayan
> >
> > _______________________________________________
> > Bf-docboard mailing list
> > Bf-docboard at blender.org
> > http://lists.blender.org/mailman/listinfo/bf-docboard
> >
> >
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> http://lists.blender.org/pipermail/bf-docboard/attachments/20110924/c4824d1a/attachment-0001.htm
>
> ------------------------------
>
> Message: 3
> Date: Sun, 25 Sep 2011 09:08:03 +0530
> From: Raindrops From Sky <raindrops.fromsky at gmail.com>
> Subject: Re: [Bf-docboard] The pdf version of User's manual is 15
>        months old- How about a new one?
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
>        <CAFBj6EdgP-iZW-Rua0h8EoTCzq6sXAN4m6fR47ErLucMPNuoqg at mail.gmail.com
> >
> Content-Type: text/plain; charset=ISO-8859-1
>
> For sure, John! I have followed your book right from the beginning.
>
> Then there is another excellent book called 'Blender Basics', by James
> Chronister.
>
> http://www.cdschools.org/54223045235521/lib/54223045235521/BlenderBasics_4thEdition2011.pdf
>
> Both these books are meant for beginners; so they cover only the
> basics of each topic.
> Too much detail would overwhelm and discourage a newbie; so this is
> the right approach.
> Once the self-confidence of the user grows, he is expected to explore
> the Blender GUI further on his own.
>
> On the other hand, a User Manual must explain the GUI fully,
> screen-by-screen.
> It is supposed to provide reference information to users with all
> expertise levels.
>
> I want to create a comprehensive user's manual that goes beyond a
> visual tour of Blender.
>
> Here are two examples of my approach:
>
> http://sourceforge.net/projects/lmms/files/UserManual/UserManual_0.4.12.1_2011-08-30.pdf/download
> http://www.den4b.com/wiki/ReNamer
>
> The common theme in my user manuals is that they explain how each
> screen works, explain the working principles; and provide further
> references for the more enlightened reader.
>
> They change significantly based on the needs of the target application:
>
> The ReNamer is a small application with a workflow-based GUI.
> Therefore its manual has mostly screen-by-screen explanation (with
> examples). However, the manual also treats two complex topics: RegEx
> and Pascal script. There are several flavors of RegEx, so it was
> necessary explain the flavor used in ReNamer. On the other hand,
> Pascal Script is not so widely used, so it is difficult to find good
> tutorials on it. So I added a quick guide on the subject.
>
> Check them out!
> http://www.den4b.com/wiki/ReNamer:Pascal_Script:Quick_guide
> http://www.den4b.com/wiki/ReNamer:Regular_Expressions
>
> On the other hand, LMMS is a complex application with totally
> non-conventional controls and a large number of interrelated windows.
> Further, the users are not expected to be familiar with the theory of
> music. So this manual follows a totally different approach: The
> musical/acoustic terms are explained first, with further reference to
> Wikipedia. Then a functional diagram of LMMS is given. That is
> followed by the screen-by-screen explanation. At all times, the
> interrelationship between different windows is highlighted.
>
> Blender is at a much higher level compared to LMMS, with many
> underlying principles to be explained. So its user manual has to be
> even more comprehensive.
>
> To conclude, the User's Manual I am proposing is quite different from
> the existing books.
> It is a reference book that can also be read from cover to cover, by
> newbies and pros alike.
>
> Best regards,
> Narayan
>
> On 9/25/11, John Blain <silverjb12 at gmail.com> wrote:
> > Hi Narayan
> >
> > In this discussion what sort of a PDF manual are you guys discussing? My
> > Blender 2.59 PDF manual is there for grabs if you want a book for
> beginners.
> >
> > http://silverjb.limewebs.com/index.html
> >
> > Regards
> >
> > John Blain
> >
> > On 24 September 2011 19:09, Raindrops From Sky
> > <raindrops.fromsky at gmail.com>wrote:
> >
> >> Actually we should NOT expect a 15-months old manual to be in demand any
> >> more; especially because the new 2.5x Blender is totally different.
> >>
> >> Let us not question whether this project is worth the effort.
> >> I would be happy to put all the effort in making the new pdf manual.
> >>
> >> That leaves only the task of installing the extension to export as odt.
> So
> >> let us simply go ahead and do it! :)
> >>
> >> BTW the pdf would NOT be a direct transcription of wiki, but a totally
> >> different creation.
> >> Compare the LMMS wiki with the pdf manual I created; and see what I
> mean.
> >>
> >> If the "export as odt" extension is not available, I could rip the
> website
> >> with Httrack and make the manual.
> >> I propose to release the pdf manual with CC license.
> >> Please let me know if there are any issues with this idea.
> >>
> >> Regards,
> >> Narayan
> >>
> >> _______________________________________________
> >> Bf-docboard mailing list
> >> Bf-docboard at blender.org
> >> http://lists.blender.org/mailman/listinfo/bf-docboard
> >>
> >>
> >
>
>
> ------------------------------
>
> Message: 4
> Date: Sun, 25 Sep 2011 09:49:22 +0530
> From: Raindrops From Sky <raindrops.fromsky at gmail.com>
> Subject: Re: [Bf-docboard] Wiki upgrade 2011
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
>        <CAFBj6EdTEf3Q3q=vweo1_WLgJVaC0f+TSFbnE6pM3r7uw8-uxg at mail.gmail.com
> >
> Content-Type: text/plain; charset=ISO-8859-1
>
> Fantastic organized work, Jared!
>
> Some suggestions:
> What do the different background colors mean in Sheet1?
> Why are the two columns blank? ("name change?" and "Hotkeys?")
> Are the wiki pages supposed to have hotkeys?
>
> In your sandbox TOC, the Nav tree looks severely pruned (positively
> frost-bitten :)).
> If the tree is fully functional, people would be able to see the merit
> in your proposed changes more easily. Just my two cents...
>
> Luca, is there a plan to formally review+approve the re-organized TOC
> proposed by Jared?
>
>
> Regards,
> Narayan
>
> On 9/25/11, Jared Reisweber <jaredr122 at gmail.com> wrote:
> > Nice work Mindrones! Its definitely a lot easier to read now. I agree
> about
> > the ability to collapse the nav tree, and the side bar disappearing.
> >
> > I saw that you reverted the 2.5 index to match the 2.4 index. I kept
> track
> > of the changes i made to the 2.5 index and manual pages:
> >
> >
> https://docs.google.com/spreadsheet/ccc?key=0AgUiaPsPYcKpdElpc2V3S1JIb21kUTNMT0YzTTJ2X3c&hl=en_US#gid=1
> >
> > The first page lists the status of the wiki, as it appears in the sandbox
> > version (
> > http://wiki.blender.org/index.php/Meta:Sandbox/Doc:2.5/Manual_Proposal).
> It
> > includes pages that do not exist, exist but need major improvement, and
> > pages that seem complete. I've been updating this as new pages have been
> > added, but wiki editors should feel free to update this as well.
> >
> > The second page compares the old index with the new index ( new pages,
> > removed links, changed page names, and moved content), which should help
> > with managing all the  2.5 content(transferring pages, renaming pages,
> > preventing duplicate wiki content, etc.). It is missing a few entries
> that
> > were added recently to the index, however.
> >
> > -Jared
> >
> > On Tue, Sep 20, 2011 at 3:19 AM, Raindrops From Sky <
> > raindrops.fromsky at gmail.com> wrote:
> >
> >> Hi!
> >>
> >> The new light background is far easier to read. The gray background
> >> ensures
> >> that long hours of reading does not tire the eyes. Fantastic!
> >>
> >> I have two LCD monitors; one 17" monitor with 1.25:1 aspect ratio and
> the
> >> other 22" HD monitor with 16:9 ratio. Because of high-resolutions, I
> have
> >> to
> >> use different zoom factors for both (for all Windows applications;
> >> including
> >> FireFox).
> >>
> >> When I zoom in, the right-side panel vanishes; and the tree panel
> occupies
> >> a disproportionately large screen space. Can this be looked into?
> >>
> >> I have another suggestion: The tree is not needed all the time. Can we
> >> fold
> >> it away with a click (or resize it by dragging), as in the side bar of
> >> FireFox?
> >>
> >> Alternatively, it could have a button to fold/unfold as in Google Map or
> >> Google wiki (see sample here, where a << button hides the side-panel:
> >> http://code.google.com/p/zscreen/wiki/ZScreenWiki?tm=6
> >>
> >> Thanks and regards,
> >> Narayan
> >>
> >> _______________________________________________
> >> Bf-docboard mailing list
> >> Bf-docboard at blender.org
> >> http://lists.blender.org/mailman/listinfo/bf-docboard
> >>
> >>
> >
>
>
> ------------------------------
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
> End of Bf-docboard Digest, Vol 79, Issue 3
> ******************************************
>



-- 

Kesten Broughton
President and Technology Director, Solar Mobile Trailers
kesten at solarmobiletrailers.com
www.sunfarmkitchens.ca <http://www.sunfarmkitchens.ca>
US/Can 512 701 4209
Mexico 011 52 196 1142 0302
skype atlanticzebra
3294 Route 490 Dundas,
NB Canada E1G 3K2
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20110925/bb63b4f3/attachment-0001.htm 


More information about the Bf-docboard mailing list