The Trunk: Morphic-tpr.1455.mcz

tim Rowledge uploaded a new version of Morphic to project The Trunk:
http://source.squeak.org/trunk/Morphic-tpr.1455.mcz

==================== Summary ====================

Name: Morphic-tpr.1455
Author: tpr
Time: 24 June 2018, 6:53:35.51633 pm
UUID: 51e4f2c1-d868-474d-823f-78a55a39f40e
Ancestors: Morphic-cmm.1454

Start process of moving responsibilty for deciding on Help content code styling or not from TheWorldMainDock to the actual content.
The overall effect of these groups of changes is to make no visual difference. Yet.

This set actually connects the revised help browser stuff to the world menu entries that open the assorted help browsers

=============== Diff against Morphic-cmm.1454 ===============

Item was changed:
  ----- Method: TheWorldMainDockingBar>>commandKeyHelp (in category 'submenu - help') -----
  commandKeyHelp
  "Open a window giving command key help."
 
  self
  openHelp: #SqueakTutorialsCommandKey
+ topic: nil!
- topic: nil
- styled: false!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>extendingTheSystem (in category 'submenu - help') -----
  extendingTheSystem
 
  self
  openHelp: #SqueakProjectHelp
+ topic: #extendingTheSystem!
- topic: #extendingTheSystem
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>fontSizeSummary (in category 'submenu - help') -----
  fontSizeSummary
 
  self
  openHelp: #SqueakToolsHelp
+ topic: #fontSizeSummary!
- topic: #fontSizeSummary
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>licenseInformation (in category 'submenu - help') -----
  licenseInformation
 
  self
  openHelp: #SqueakLicenseHelp
+ topic: #officialLicense!
- topic: #officialLicense
- styled: false.!

Item was added:
+ ----- Method: TheWorldMainDockingBar>>openHelp:topic: (in category 'submenu - help') -----
+ openHelp: bookSymbol topic: topicSymbol
+ "If a suitable seeming class named bookSymbol exists in the image we open it on the given topic, or on the first page should topic be nil"
+ (Smalltalk classNamed: 'HelpBrowser')
+ ifNil: [self inform: 'Sorry, there is no help system installed.' translated]
+ ifNotNil: [:helpClass |
+ (Smalltalk classNamed: bookSymbol)
+ ifNil: [self inform: 'Sorry, the help book you requested does not exist.']
+ ifNotNil: [:book |
+ topicSymbol
+ ifNil: [(helpClass openOn: book) model showFirstTopic]
+ ifNotNil: [helpClass openOn: (book perform: topicSymbol)]]]!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>releaseNotes (in category 'submenu - help') -----
  releaseNotes
 
  self
  openHelp: #SqueakReleaseNotes
+ topic: nil!
- topic: nil
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>squeakOnlineResources (in category 'submenu - help') -----
  squeakOnlineResources
 
  self
  openHelp: #SqueakProjectHelp
+ topic: #squeakResourcesOnline!
- topic: #squeakResourcesOnline
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>squeakUserInterface (in category 'submenu - help') -----
  squeakUserInterface
 
  self
  openHelp: #SqueakProjectHelp
+ topic: #squeakUserInterface!
- topic: #squeakUserInterface
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>swiki (in category 'submenu - help') -----
  swiki
 
  self
  openHelp: #SWikiHelp
+ topic: nil!
- topic: nil
- styled: false.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>terseGuideToSqueak (in category 'submenu - help') -----
  terseGuideToSqueak
 
  self
  openHelp: #TerseGuideHelp
+ topic: nil!
- topic: nil
- styled: true.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>usefulExpressions (in category 'submenu - help') -----
  usefulExpressions
 
  self
  openHelp: #SqueakTutorials
+ topic: #usefulExpressions!
- topic: #usefulExpressions
- styled: true.!

Item was changed:
  ----- Method: TheWorldMainDockingBar>>workingWithSqueak (in category 'submenu - help') -----
  workingWithSqueak
 
  self
  openHelp: #SqueakProjectHelp
+ topic: #workingWithSqueak!
- topic: #workingWithSqueak
- styled: false.!

This set of changes is the first phase of letting the help content decide how it is presented rather than making the user tell it whether to use code styling or not. The overall (current) effect is not visible, by design.

Later I'd like to see the individual pages of a help broswe be able to choose stylig or plain format - currently (and with these changes) the TerseGuide for example looks different depending on whther you open it individually or within the main help book. That's not really very good.

Better yet, a way to set a 'code style' on Texts would be nice. We can kinda-sorta do it - it is possible to get Shout to style a chunk of text and just paste it into a page, but that doesn't re-style any time you edit the text. I'm pretty sure we can do it, but I don't know how just yet. Ideas and code welcomed.

tim
--
tim Rowledge; [hidden email]; http://www.rowledge.org/tim
Useful Latin Phrases:- Mihi ignosce. Cum homine de cane debeo congredi = Excuse me. I've got to see a man about a dog.