hpi-swa-lab / SqueakByExample-english

An introductory book about the Squeak/Smalltalk programming system, guiding students and developers through the environment, language, tools, and the Morphic framework by means of a series of examples and exercises.
https://www.lulu.com/shop/patrick-rein-and-christoph-thiede/squeak-by-example-60/paperback/product-8vr2j2.html
Other
26 stars 7 forks source link

WIP: First Draft for FindIt.png generation code #4

Closed jon-kroko closed 4 years ago

jon-kroko commented 4 years ago

TODO: Figures for 1st two chapters

QuickTour figures

FirstApp figures

tom95 commented 4 years ago

@jon-kroko @EatingBacon we now have a utility called helper runModal: [] then: [] that you can use whenever you need to screenshot a modal dialog (that is every dialog that opens in Squeak when you have to confirm something like "Save before closing" when you try to close the image, or when you press Cmd+F in the browser and it displays the filterable list).

I included an example on how to use it for FindIt.png, in general you should put the code that opens the modal dialog in the first block (e.g. the shortcut that will trigger it) and anything you want to run after opening the dialog in the second block, e.g. repositioning the dialog, typing something into its search field...

tom95 commented 4 years ago

Is the TODO list based on all the files from the folder? I believe some of them aren't actually used in the book. This expression should return all matches as well: grep includegraphics *

tom95 commented 4 years ago
### MoreWorkspace.tex
- [ ] cloverleafKey
- [ ] WorkspaceWithText

### QuickTour.tex
- [ ] cloverleafKey
- [ ] annotatedDownload
- [ ] download
- [ ] startup
- [ ] worldMenu
- [ ] yellowButtonMenuOnWorkspace
- [ ] morphicHaloOnWorkspace
- [ ] colouredMouse
- [ ] morphicRotate
- [ ] PreferenceBrowser
- [ ] OpenMenu
- [ ] Blob
- [ ] saveAs
- [ ] Tools
- [ ] HelloWorld
- [ ] Doit
- [ ] PrintIt
- [ ] InspectIt
- [ ] SqueakMap
- [ ] ClassBrowser2
- [ ] Kernel
- [ ] FindIt
- [ ] TimeClasses
- [ ] FindIt
- [ ] TimeClasses
- [ ] methodFinder
- [ ] MethodFinder
- [ ] StringTest
- [ ] testShoutConfirm
- [ ] testRunnerOnStringTest
- [ ] Predebugger
- [ ] String

### FirstApp.tex
- [ ] GameBoard
- [ ] AddCategory
- [ ] ClassTemplate
- [ ] AcceptClassDef
- [ ] SBECell
- [ ] SBECellInspector
- [ ] SBECellResize
- [ ] UnknownSelector
- [ ] DeclareInstanceVar
- [ ] Categorize
- [ ] DragMethod
- [ ] Error
- [ ] Debugger
- [ ] FileIn
- [ ] MonticelloBrowser
- [ ] BrowseRepository

...didn't want to just overwrite it. This is the list I could gather from the .tex files directly. Maybe you could do a quick check if it seems to make sense and then copy it over if you like.

timgarrels commented 4 years ago

@tom95 there are some figure references in the chapters. Do we just leave them referencing the old figures and focus on the actual displayed ones? Or do we want the references figures to be new as well?

I just added BooleanHierarchyBrowser.png as generating code, just below the figure reference (which is commented out). I could just move the code the reference definition (e.g. the first include of the figure). Or leave the code there, and it can be moved by the person commenting the reference in again....

tom95 commented 4 years ago

I didn't see any usages of BooleanHierarchyBrowser in the actual book, so I would say we can leave it out for now. Same for any other figure that's not actually used. Or did I misunderstand?

codeZeilen commented 4 years ago

Yes to what tom said. We only update figures that are actually used. No speculative work :)

LinqLover commented 4 years ago

Is ClassBrowser2.png still to do?

LinqLover commented 4 years ago

Regarding Tools.png:

(shows an empty squeak image. wouldn't it make more sense to show some morph's halo in that part of the chapter?)

I just updated the screenshot, but the question about usefulness is remaining open.

LinqLover commented 4 years ago

Just updated the todo list. Is really each bold item assigned to a certain person? If you got stuck, please remove the tick or inform us!

Other open todos:

tom95 commented 4 years ago

Ah sorry, should have explained the list in detail. Strikethrough means unused, bold means problematic/has blocker and regular means untouched. At some point we started drafts for all items, which is why almost all items got to be bold.

LinqLover commented 4 years ago

So how do I know whether someone is working a certain item? @jon-kroko has compared the tick with a semaphore and I do not want to interrupt anyone :)