update and extend SBEHelp prosa

SmalltalkSources/SBE-Book.package/SBEHelp.class/class/introduction.st

@@ -12,10 +12,10 @@ Squeak by Example is a book, intended for both students and developers, that wil
 
 About this version of the book
 
-Squeak by Example is a classical book intended for PDF/print format in the first place. Nevertheless, we made some efforts to make it available right in Squeak. For this, we wrote our own LaTeX parser that uses Sandblocks'' Tree-sitter integration and a LaTeX grammar for tree-sitter to convert over 10,000 SLOC of text into Squeak objects (don''t try this at home!!). You can read the result in this help structure or search it using the search bar at the top. Note that this parser is meant to be an approximation only and we didn''t get every space right to save our own sanity. Nevertheless, if you''ve got any questions or feedback, we''re there at our GitHub repo: https://github.com/hpi-swa-lab/SqueakByExample-english
+Squeak by Example is a traditional book intended for PDF/print format in the first place. Nevertheless, we made some efforts to make it available right in Squeak. For this, we wrote our own LaTeX parser that uses Sandblocks'' Tree-sitter integration and a LaTeX grammar for tree-sitter to convert over 10,000 SLOC of text into Squeak objects (don''t try this at home!!). You can read the result in this help structure or search it using the search bar at the top. Note that our parser is meant to be an approximation only and we didn''t get every space right to save our own sanity. However, if you''ve got any questions or feedback, we''re there at our GitHub repo: https://github.com/hpi-swa-lab/SqueakByExample-english
 
 Enjoy and carpe Squeak!!!
-]style[(17 2 17 365 30 53 3 1 5 151 11 1 11 1 11 7 13 399 56 23)b,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english;,,b,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english/releases;,,Rhttps://www.lulu.com/shop/patrick-rein-and-christoph-thiede/squeak-by-example-60/paperback/product-8vr2j2.html;,,Rhttps://github.com/hpi-swa/sandblocks;,,Rhttps://tree-sitter.github.io/tree-sitter/;,,Rhttps://github.com/hpi-swa-lab/sb-tree-sitter;,,Rhttps://github.com/latex-lsp/tree-sitter-latex;,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english;,!' readStream nextChunkText)
+]style[(17 2 17 365 30 55 3 1 5 151 11 1 11 1 11 7 13 393 56 23)b,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english;,,b,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english/releases;,,Rhttps://www.lulu.com/shop/patrick-rein-and-christoph-thiede/squeak-by-example-60/paperback/product-8vr2j2.html;,,Rhttps://github.com/hpi-swa/sandblocks;,,Rhttps://tree-sitter.github.io/tree-sitter/;,,Rhttps://github.com/hpi-swa-lab/sb-tree-sitter;,,Rhttps://github.com/latex-lsp/tree-sitter-latex;,,Rhttps://github.com/hpi-swa-lab/SqueakByExample-english;,!' readStream nextChunkText)
 			key: #introduction;
 			shouldStyle: false;
 			yourself

SmalltalkSources/SBE-Book.package/SBEHelp.class/class/pages.st

@@ -1,4 +1,4 @@
 accessing
 pages
 
-	^ #("introduction" "<- enable for edits" theBook)
+	^ #("introduction" "<- enable for edits" preface theBook)

SmalltalkSources/SBE-Book.package/SBEHelp.class/class/preface.st

@@ -0,0 +1,21 @@
+pages
+preface
+	"This method was automatically generated. Edit it using:"
+	"SBEHelp edit: #preface"
+	<generated>
+	^(HelpTopic
+		title: 'How to use this book'
+		contents: 
+'How to use this book
+
+You can read this book from beginning to end, from end to beginning, or browse through random sections as your interests take you. Either way, here are some tips on how to get the most out of reading this book right in Squeak:
+
+Interactive contents. Since Squeak is a super-duper-interactive system, you can also interact directly with the contents of this book. For example, you can select any mentioned message and press Cmd+m to browse its implementors, just like anywhere else in the image. Analogously, Cmd+b is available to browse a class definition, Cmd+p to print an expression, Cmd+D to debug it, and all your other favorite shortcuts.
+
+Smart search. Did you notice the search bar at the top of this window? You can search the entire book with it!!!!1 More importantly, if you also have installed the SemanticText package, this will even perform a smart search powered by OpenAI. So, instead of "exception handling", you could just search for "catch errors". Note that this is an experimental feature and watch out for artificial stupidity and hallucinations.
+
+Fallback to PDF. While we managed to parse most of the book in a satisfactory quality, we just could not get some things right (yet). (Imagine parsing a context-sensitive language with a context-free grammar?) So, if you encounter an unreadable artifact, send your thanks to Donald Knuth and yellow-click on the relevant section in the tree to open it in a PDF in the great darkness outside of Squeak.!
+]style[(21 229 22 173 5 15 12 53 5 44 5 4 5 16 5 4 8 42 13 409 16 385)b,,b,,i,,i,,i,,i,,i,,i,,i,,b,,b,!' readStream nextChunkText)
+			key: #preface;
+			shouldStyle: false;
+			yourself

SmalltalkSources/SBE-Book.package/SBEHelp.class/methodProperties.json

@@ -5,8 +5,9 @@
 		"bookBlurb" : "ct 11/15/2023 17:39",
 		"bookName" : "ct 11/15/2023 17:30",
 		"icon" : "ct 11/15/2023 21:37",
-		"introduction" : "ct 11/15/2023 18:03",
-		"pages" : "ct 11/21/2023 13:58",
+		"introduction" : "ct 11/25/2023 21:11",
+		"pages" : "ct 11/25/2023 21:11",
+		"preface" : "ct 11/25/2023 21:28",
 		"squeakBalloonIcon" : "ct 11/15/2023 17:33",
 		"theBook" : "ct 11/15/2023 17:37" },
 	"instance" : {