Updating 'Squeak by Example'

> On 2019-11-08, at 11:38 AM, Thiede, Christoph <[hidden email]> wrote:
>
> Hi tim,
>
> we (that means, mainly Patrick) are currently working on updating all contents and screenshots of the book to match the latest Squeak version. By the way, we are taking this opportunity to codify each screenshots with a short script in the tex source, so they will not deprecate so fast again (until someone reworks the whole UI) :D

Excellent. And thank you!

>
> What are your tool questions about in detail?

Having never - to the best of my knowledge - used anything that edits LaTEX, I am ignorant of what tool I might use to make any attempt at helping. What editors (Mac, obviously) are capable of editing such a document in any form other than the 'good grief what is this stuff' plain text?


tim
--
tim Rowledge; [hidden email]; http://www.rowledge.org/tim
Useful random insult:- Couldn't find his way through a maze even if the rats helped him.

> On 2019-11-08, at 12:24 PM, Nicolas Cellier <[hidden email]> wrote:
>
> Latex (tex) is plain text contents intermixed with plain text formatting commands...
> So use whatever text editor...

That sounds unpleasantly like raw-editing PDF. eek.


tim
--
tim Rowledge; [hidden email]; http://www.rowledge.org/tim
Oxymorons: Political science

Hi tim,

we (that means, mainly Patrick) are currently working on updating all contents and screenshots of the book to match the latest Squeak version. By the way, we are taking this opportunity to codify each screenshots with a short script in the tex source, so they will not deprecate so fast again (until someone reworks the whole UI) :D

What are your tool questions about in detail? We completely automated the build process, so in general, you can simply fork the repo and change the tex source, and TravisCI will generate a new PDF for you whenever you push (which is deployed as GitHub release and/or an upload to Google Drive). If you would like to build it locally, you will need: a tex editor (recommended - in general, you can do this from vim or notepad as well. Personally, I am using VS Code), make, texlive, and Squeak. For the complete build process, please have a look at .travis.yml and Makefile. The build process basically looks like this:

1. Load the SmalltalkSources into Squeak (they require Trunk)
2. Do it: SBEFigureBuilder buildAllTexFigures
   This will parse all SmalltalkInTex scripts and generate figures of it into the build directory.
3. From shell: run make
   This will:
   • Generate listings from the SmalltalkSources
   • Run texlive to generate bibliography & pdf

I know I finally need to document this process. :) If you have further questions, we're there on GitHub Issues or here.

Best,

Christoph

---

Von: Squeak-dev <[hidden email]> im Auftrag von tim Rowledge <[hidden email]>
Gesendet: Freitag, 8. November 2019 20:12 Uhr
An: The general-purpose Squeak developers list
Betreff: [squeak-dev] Updating 'Squeak by Example'

 

At the squeak board meeting on Weds we discussed updating the 'Squeak by Example' book in order to have working examples and current screenshots etc. It's a good book in general and would be a useful thing to point new squeakers to with some updating.

The sources are at https://github.com/SquareBracketAssociates/SqueakByExample-english (and there are some translations too) and I see some recent changes by Patrick R (thanks!) mentioned in my email. Personally I'd appreciate some advice on what program one might use to edit the stuff. I don't think I can manage LaTEX.

tim
--
tim Rowledge; [hidden email]; http://www.rowledge.org/tim
Useful Latin Phrases:- Visne saltare? Viam Latam Fungosam scio = Do you want to dance? I know the Funky Broadway.