The Scripter's Scrapbook
'The personal reference library for all programmers'

Current version
Recent Updates
What's New
Updating multiple Scrapbooks
On-line Updates

ssBk v6.0.21

Cross-Platform Support
The Scripter's Scrapbook is supported on all the following computer platforms...

  • Windows: 95, 98, NT, 200x, XP, VISTA , Win7
  • Mac & iMac: OS X (PPC, Intel and Universal)
  • Linux: LiveCode plugin only. Some features may not be available. Please report any issues.
  • Cross-platform file format: Any Scrapbook file will transfer "as is" between any of these platforms

New Users
Please refer to the Installation options available to you in the accompanying 'Where do the files go' document.

LiveCode Community Edition
Use a Standalone version as the plugin option is only supported by the Commercial Edition.

Features, options and flexibility
The release notes and version change logs show how you can organize, store, link and manage your information. Tutorials are available in the Scrapbook.

Current version: 6.0.21
• If the version you download is earlier than this, use 'Check for Updates...' under your Scrapbook's Help menu to update automatically.

Standalone Users:
• If you are updating from version 5.2.16 or earlier, you should download an updated standalone application program from the Free Downloads page before attempting an on-line update.

• Report bugs and feature requests under the HELP menu or use the online Feedback Page.

[Back to Contents]

Version Change Log

This release

  • 6.0.21
    This is an upgrade for LC6 compatibility. You will need a new licence.

    • Classification Platforms: Platform references to Mac OS9 are no longer available. The icon has been changed and now refers to Mobile deployment (iOS, Android etc). Please update any Mac OS9 Entries you may have.
    • Classification Languages: 'Rev' has been replaced by 'LC' in the default language set.

    • Default Font and Size: You can now define your own default Font and Size options in the preferences. Any html output honors your choice.
    • Linux: Added support for Linux. Not all features and options are covered, but please report any issues.
    • Classification Languages: Changes to a language classification can now be immediately reflected in Entries by replacing the old language with the new language.

    • Multiple monitors: All windows should now display as expected on the monitor occupied by the Home or Entries window.
    • HTML: Line breaks are more accurately represented.
    • HTML: Styled text is better represented.
    • HTML: Manually adjusted sizes are better represented.

    • Hanging startup: Early program version detection now offers the option to download an update and gracefully closes the Scrapbook as expected. Only affects users of standalone applications.
    • ssBkChat: When a Scrapbook is used as a plugin on Mac OS X with ssBkChat open, LiveCode now quits gracefully as expected.
    • Highlighting the search text no longer removes the index selection.

Earlier releases:

  • 5.2.19
    This is a general maintenance update.

    • ssBkTokens plugin has been updated.

    • Cancelling Colorizing now behaves as expected.
    • Removing a link now behaves as expected.
    • Ripple effect errors arrising from the above have been corrected.
  • 5.2.18
    This is a general maintenance update.

    • Added access to the color and hilite palettes from the contextual text popup menu.

    • Closing the Scrapbook's home page now works as expected (corrects an inadvertant error introduced in 5.2.17).
  • 5.2.17
    This is a general maintenance update.
    NOTE: Engine version 2.9 or later is now required. If you are using a standalone, you should download an updated standalone application program from the Free Downloads page. This means that MacOS 9 is no longer supported.

    • The API has been incremented to v1.3 with support for multi-line control structures in both IAC text files and the ScriptMaker. In standAlone applications, these scripts are limited to ten statements. If your script cannot be reduced to this limit, it must be implemented by using sequential API scripts or by using a plugin written in LiveCode (see the ssBk API Handbook under the PlugIns menu).

    • The PlugIns menu is now displayed independently for easier access.
    • The right-click Edit and Style contextual menus now include the option to toggle from one to the other directly without having to use the Preferences each time to set your choice.
    • Selecting the Source popup menu with the CTRL key now shows all Entries, not just those currently selected.

    • The File:Page SetUp dialog implements the platform-native setup dialog
    • Added a drag image when moving selected text.

    • On Windows, a hyperLink to a file on an unmounted volume (such as a missing CD) should now be gracefully reported and no longer throw a Windows disk access error.
    • Persistent arrowKey navigation (by holding down any of the keyboard arrow keys) is now correctly handled when the mouse hovers over the index.
    • The Context Options palette now immediately reflects an Entry name change.
    • Right-clicking a Memo no longer throws an error.
    • Registration requires Administrator privileges for XP. Non-Administrator registration access is now correctly handled.
  • 5.2.16
    This release focuses on external files, plugins and archive access.

    New Features
    • A Scrapbook Archive Browser is now included as a core plugin. Select "Browse Archives" from the Tools menu. Use it to select and search for what you've already saved, copy code as you need it, preview any attachments, or import any backup Entry into your current Scrapbook. Its color scheme will match your Scrapbook.

    • The PlugIn Manager has been updated and can now selectively display your own files, standard plugins and core plugins. Select it from the Tools: Organize PlugIns menu, or use the optional PlugIns toolbar icon.

    • All ssBk plugins (with the exception of ssBkChat) are now closed when your Scrapbook is parked or minimized.
    • The PlugIns manager has been updated to enable only secure options.
    • The creation date stored in an ssbf backup file is now unambiguous.

    • A parked Scrapbook can now be translucent so you can see what may be hidden beneath it on your desktop. Right-click to select the opacity level from 60% to 100%.

    • 'Export All' now exports all Entries as expected rather than the selected set only.
    • Attachment icons in the Index are now dynamically updated following an archive import as expected.
    • The Tools menu now correctly hilites the open core and optional plugins.
    • On Mac OSX the 'Import backup...' file menu now permits backup files to be selected as expected and avoids a spurious warning message on Cancel. The Drag and Drop method is not affected.
  • 5.2.15
    This release focuses on improvements to the HTML output from your Scrapbook. It also implements default language platforms, 'fast copy', an extension to the API, and enhanced backup import.

    • Importing backups:
    A 'classification system mismatch' warning is now displayed when either the languages of the imported Entries or the categories in the import file do not correspond with your Scrapbook. You can keep the existing classification system, or replace it with the classification system in the file, or cancel the import. If there are classification conflicts, you may prefer to create a new Scrapbook for the backup file. Also, any Entries that you choose not to be imported are greyed out with a strike-through line in the import preview list.

    • API enhancement:
    API v1.22 is released to include ssBkCopyToClip to place styled (htm formatted) or plain text onto the clipboard.

    • Fast copy:
    Ctrl/Cmd.C now copies the current section of an Entry when nothing specific is selected. If there is no cursor insertion point at all, the Content section is copied. This means you can quickly grab a section without time-consuming menu option selection. Use 'Copy to Clipboard' under the Entries menu for further options. Manually selected text is copied as expected.

    • Multiple monitors:
    'Negative screen space' is now supported for users whose main monitor is on the right.

    • Language platforms:
    Languages can now have default platforms so when setting the language context options for your Entries, the Scrapbook can select the platforms automatically. To define or adjust your default language platforms, click the MORE button in the 'Classification Languages' palette at any time. To disable the feature, simply remove any default language platform settings.

    • HTML enhancements:
    Export, preview and web publishing files now display a separate index on the left for convenience of access. Since this requires frames, saved files are placed in a self-contained folder along with a folder of any required graphics.

    What is generated
    In addition to a folder of required graphics, there are 3 locally referenced files: index.html or i.html (the frameset definition index), c.html (the content) and L.html (the index list of included Entries). If the selected output does not include an index list of Entries, only the c.html file is generated.

    'Print preview' and 'Save as HTML' offer user-defined presentation options including optional index list, page or Browser width and a range of colour schemes with standard content. 'Export as HTML' offers a standard presentation scheme with user-defined content.

    HTML Compliance
    Output is DTD HTML 4.01 Transitional compliant, although your own embedded code snippets may generate spurious markup errors with a validator. CSS is implemented by an internal style sheet with inline CSS adjustment for non-standard text styles. Courier and Courier New 12pt and 13pt (the default monospaced options for Win32 and OS X) will be rendered as 10pt in the html to accommodate font metric display differences between your Scrapbook and your Browser.

    HTML Printing Tips
    To avoid problems when printing framed layouts, exclude the index option or open the content file only (called c.html). Page breaks between Entries are automatically included. All the main Browsers offer a print-preview option so you can adjust the page setup, modify print margins, choose and define headers and footers etc.

    • 'Select:Show All' (or the keyboard shortcut Ctrl/Cmd.J) now empties the search field.

    • 'Web Publishing' is now called 'Save as HTML'. It remains available under the Entries menu and as an optional toolbar button.

    • The 'Export:Selected Entries' option now works for all formats as expected.
    • On Windows, moving the mouse into the header section of an Entry no longer loses the cursor insertion point. Due to a Windows engine bug, however, you may occasionally see a cursor artifact.
    • Updating from the Home screen will now exit as expected at the end of the process if the exit option is selected.
    • Index status icon preferences now transfered on update.
  • 5.2.14

    Automatic update
    An bug present in 5.2.10 to 5.2.13 has been resolved in this update. If you are updating from any of these versions, you should not use the 'Automatically' option in the update preferences but check manually.
  • 5.2.13

    This version is a substantial upgrade that resolves all known bugs, implements all feature requests from Users, and addresses the visual presentation for further cross platform compatibility. Amongst many, some of the key improvements include...

    • A smarter, faster and more flexible interface
    • New standalones for Windows, OSX PPC, OSX Intel and OSX UB
    • Support for Windows Vista
    • Multiple monitor support for independent work space and Scrapbook space
    • The ability to specify a 'primary' Scrapbook
    • The optional display of Entry status indicators in the indexes
    • Increased window 'real estate' with the 'icon only' toolbar option
    • The addition of the 'Frost' color scheme
    • Improved iconography with an updated 'Parked' Scrapbook artifact

    Details of these and other improvements, enhancements and bugfixes are below.

    New Standalones
    A new set of standalone application programs is released with this update that support the new 'Primary Scrapbook' feature. To define a primary Scrapbook in v5.2.13 and later, you will need to download a replacement standalone program. The standalone starter kits for all platform options already include the new application program.

    New Features
    • Windows VISTA is now suported.
    • Multiple monitors are now supported and windows honour the monitor in use by your Scrapbook. This means you can have an independent workspace from your Scrapbook.
    • Primary Scrapbook for Standalones:
    If you have more than one Scrapbook file you can now specify a 'Primary' Scrapbook that your standalone program should open by default (see Preferences:StartUp). This feature is only applicable if you are using a standalone. If your standalone ignores your Primary Scrapbook setting, download an updated standalone of your choice from the web site. There are three options when the standalone starts up, selected from the Scrapbook's StartUp preferences popup menu:

    1. 'Default setting' to open the first found of 'ssbk', 'ssbk.rev', '' or 'scrapbook.ssbk' if it is in the same folder as the standalone program.
    2. 'Current Scrapbook' to open the Scrapbook you are using.
    3. 'Specify...' to browse for the Scrapbook you want.

    If the standalone cannot locate your chosen Scrapbook, you will be asked to locate one. The setting is stored as a preference file so it is persistent across all sessions and Scrapbooks for your computer. For your own convenience, keep all your Scrapbooks together with the 'ssBk Plugins' in the same folder, preferably along with the standalone program as well.

    • When using a standalone, you can now rename your Scrapbooks with a .ssbk suffix in addition to .mc and .rev if you wish to differentiate your files on your desktop.
    • You can now match whole words or phrases in the Advanced Select text filter by enclosing the text in quotation marks.
    • The Summary will optionally resize to fit. Select the 'Auto resize Summary' checkbox in Preferences: Appearance.
    • A loading progress display is implemented on startup that will help to identify any launch issue should it occur.
    • When customizing the toolbar, the size of the toolbar is now reduced when 'Icons only' is selected to create more space for the rest of the window.
    • A keyboard shortcut to protect Entries (Ctrl/Cmd.D) has been implemented.
    • Relative path links to both files and folders are now supported on all platforms so relocated or shared Scrapbooks and backup files will continue to work (assuming you keep the same folder structure). When creating a relative link, use ./ to refer to the same folder as your Scrapbook and ../ to refer to the parent folder. Print previews and html web publishing will recognize and resolve relative paths as necessary.
    ./dox/myDoc.txt resolves a 'dox' folder located in the current Scrapbook's folder.
    ../dox/myDoc.txt resolves a 'dox' folder located in the next folder up from the current Scrapbook.
    • The Scrapbook API: The command ssBkGetPath has been added to the API that has been incremented to v1.21. It returns the pathname to the current Scrapbook, PlugIns folder or application folder.

    • Parking the Scrapbook is now instanteous with an automatic save implemented in the background. This is especially good news for users with large Scrapbooks that take while to save.
    • When using a standalone, only Scrapbooks can now be opened.
    • When using a standalone, the program no longer quits if you select an invalid file and will keep asking until you either select a valid file or cancel.
    • The option to show the default Mac menubar when in the LiveCode IDE has been removed due to menu restoration issues. The Appearance preferences have been modified to suit.
    • Thanks to pre-load caching, the first navigated Entry after launch is now immediately accessed. This primarly affects slower computers on some platform configurations.
    • The export fileSelector dialog now points to the same folder as the current Scrapbook rather than the application program.
    • The Concordance is now built into the Tools menu along with the other search utilities.
    • The 'Source' popup menu now only displays selected Entries.

    Interface improvements
    • All links now honor your chosen 'hover' color on mouseover as well as on mouseclick.
    • The 'parked' Scrapbook artifact has been updated and redesigned. OS X and Vista users will find that it fits their other dashboard gadgets.
    • Many icons have been modified and updated for improved iconographic presentation.
    • 'Frost' has been added to the color schemes so you should now be able to find a color scheme to match and complement almost any theme on OS X, XP and Vista.
    • The presentation of the 'Metal' color scheme on OS X has been improved.
    • Status tags (bookmarked, protected or attached) can be displayed in the alphabetical and history indexes. Use the Preferences:Appearance:'Index tags' popup menu to choose the style (none, icon, flag, blocks, tags, pages or oldies).
    • The title of each Entry has been adjusted to occupy less space and is now differentiated in dark blue.
    • The 'Index' popup menu in Page View now indicates the source of the listed Entries.
    • The 'source' now visually forms part of the main Entry details.
    • The 'Full page' view has been redesigned to display Entry details only. Access to search filtering remains under the 'Select' popup menu.
    • The index font is now consistent with other controls.
    • Text hiliting now conforms to the selected color scheme.

    • Exporting subsets no longer chokes on protected Entries.
    • An error when importing documents using the File:Import menu has been corrected.
    • Keyboard shortcuts are no longer spuriously passed by a parked Scrapbook.
    • The Concordance plugin has been fixed and updated.
    • After resizing, the summary section of an Entry could 'lock up'. This has been fixed.
    • Fixed a spurious ctrl key error when pointing to a menu.
    • In full page view, the deployment languages were not always displayed on the correct header line. This has been fixed.
    • When editing Categories, inserting a dash in sub-categories to show a separator line is now correctly handled. If your Category listing is affected by this, re-save your listing to correct any issues.
    • 'Copy to Clipboard' under the Entries menu now works as expected for all menu options.
    • Pasting text no longer removes text within angle brackets (inadvertantly introduced in 5.2.12).
    • Your Scrapbook's startup preferences are now retained when you update.
    • The new version number in the automatic update advice dialog is now displayed as expected rather than as a spurious variable name.
    • Issues with the appropriate display of menus and menu items on the Home Page have been addressed (Macintosh platforms only).
    • Print previews and saved html pages now honor the 'Browser Width' option.
    • Minor menu item anomolies have been fixed.
  • 5.2.12

    - Enhancement: Active Chat sessions are now better protected from unexpected closure.

    - Bugfix: Updates are now supplied in pre-set legacy format for early version runtime compatibility.
    - Bugfix: Your Scrapbook color scheme and the correct popup menu labels in the 'Customize Toolbar' palette will be retained when upgdating from 5.2.12.
    - Bugfix: Issues with pasting and dropping text from an external source have been addressed.
    - Bugfix: File menu shortcuts in the Home screen have been restored.
    - Bugfix: Unparking your Scrapbook now restores the original window.
  • 5.2.11

    - Enhancement: The API is further extended. In addition to the ssBkAskExport command introduced in 5.2.10...
    An additional parameter has been included to enable or disable the automatic display of the Context Options palette. The setting over-rides the Scrapbook's current default.
    The API for this command when setting languages has been fixed. The command implementation has also been modified; if a language is not recognized by the Scrapbook it is now ignored. This is now consistent with the other command parameters.

    - API Handbook v1.2 (released with ssBk 5.2.11)
    The API Handbook and online documentation have been updated to reflect changes in the ssBkCreateEntry and ssBkSetEntryData commands.

    - Interface: When used with a standAlone under Windows, "Quit" is now "Exit" and the shortcut Ctrl.Q removed to conform with standard menu expectations.

    - Interface: When there is no text insertion point, Ctrl.Del deletes an Entry without confirmation. You can also at any time click the "Delete Entry" icon with the control key down to delete the Entry without confirmation. For safety, confirmation is always needed when the Entry contains attachments.

    - Adjustment: The number of selected Categories (or 'None') is now displayed in the Context Options palette.

    - Adjustment: When using the global Context Options, a dialog is now presented when the process is completed.

    - Adjustment: Protected Entries are now immune to global Context Option changes.

    - Adjustment: The resuts of pasting and dropping text from an external source have been improved and with reduced impact on the system scrap.

    - Bugfix: The AltGr modifier key, as required by virtually all non-US keyboards, is now implemented correctly. Previously, AltGr was either ignored or resulted in unexpected behaviour.

    - Bugfix: When importing a backup and replacing existing Entries, the option to update existing Categories is now honoured.

    - Bugfix: Scrapbook updating from the User Support icon has been fixed (inadvertantly introduced in 5.2.10).
  • 5.2.10

    - Feature: The Advanced Select palette now supports a text filter. Useful to refine matching records, or to select the required Entries for the new Context Options feature described next.

    - Feature: The Context Options palette now supports a 'For all selected Entries' checkbox. When active, the chosen Context Options can be simultaneously applied to all selected Entries. Useful to quickly define the same deployment attributes (for example after a mass import), or to selectively add or remove the specified platforms, languages or categories for any chosen set of Entries. The 'Close' button becomes a 'Confirm' button that describes what will happen. The feature is automatically reset to unselected when the palette is closed.

    - Feature: You can now set up an automatic update check when your Scrapbook launches to be notified as soon as a new version is available. It is entirely optional, requires an active Internet connection, and works silently in the background so your Firewall should be given permission if needed. If you are not usually connected to the Internet, set the preference to Never or a Monthly Reminder then check manually from time to time. [See Preferences:Updates]

    - Enhancement: If you try to close your Scrapbook during an active Chat session a warning is now given with the option to cancel or continue.

    - Enhancement: Added ssBkAskExport to the API to automate data export. This complements ssBkImportFile and ssBkImportBackup. The API Handbook has been updated to v1.1.

    - Interface: Minor tooltip improvements have been made.

    - Bugfix: This has been fixed in 5.2.10 but still affects all releases between 5.25 and 5.29... The Home screen updater does not correctly support the "Cancel Download" option during the update process or the "Finish Later" option at the end of the update process. To avoid problems, please use the Scrapbook's Help menu option in these versions.

    - Bugfix: Backup filenames on OSX are now limited to the 32 character limitation in the Mac OSX FSSpec. You can rename these files on the desktop if you wish to make the file name longer after saving. If you have any past backup files that are not recognized using File:Import, use drag and drop instead.

    - Bugfix: The 'Select' menu now displays as expected when ordered by Language.

    - Bugfix: The Format palette now interacts as expected when opened.

    - Bugfix: History Options 'Clear Searches' now behaves as expected.

    - Bugfix: Auto-saving on exit on some platform configurations has been corrected.

    - Bugfix: Access to the Scrapbook's Mouse Shortcuts web page from the built-in User Support has been restored.

    - Bugfix: ExplicitVariables and tooltipDelay should now be correctly handled when switching between your Scrapbook and other windows. [Note: This only affects LiveCode plugin users and LiveCode programmers]

    - Bugfix: Minimizing the Scrapbook window now 'cleans up' by closing any open palettes, as it does when using the Park feature. [Note: Minimizing is not always available and depends on your Scrapbook configuration]
  • 5.2.9
    - Interface: Added 'Segoe UI' font support for Windows Vista in place of 'Tahoma'.
    - Enhancement: The Tree index now supports double-click preferences.
    - Bugfix: Documents that contain a comma in the file name now import as expected.
    - Bugfix: Unexpected double-pasting of copied text has been resolved.
    - Bugfix: The failure on some platform configurations to complete an update has been fixed.
  • 5.2.8
    - Interface: The hyperlink cursor now displays on standAlones.
    - Interface: The Home screen File menu is now active on Mac OSX.
    - Interface: The first Find match on a different Entry is now 'boxed' as expected.
    - Adjustment: All export files now default to a date and time stamped file name.
    - Bugfix: The Import window no longer throws a spurious error when closing.
    - Bugfix: The User Support now prints without overtyped text.
  • Online Scrapbook
    - Enhancement: There are now 240 languages in the online Publisher.
  • 5.2.7
    - Feature: A new 'Find...' palette is available at any time to locate instances of text. Access is available using the Ctrl/Cmd.F shortcut, the Tools menu or from the 'Advanced Select' palette. A black border is displayed around the successful match. Options include whether the text search should be constrained to the currently displayed Entry as well as case sensitivity and whole or partial matching. This complements the existing features to filter Entries and hilite text.
    - Interface: The search filter interface has been revised to better incorporate the search engine icon menu.
    - Adjustment: The first result of a text hilite search is now displayed instead of the last result.
    - Adjustment: html tags are now all lower case.
    - Adjustment: The error beep on Windows now defaults to the currently selected SystemExclamation.
    - Bugfix: The broken link to the LiveCode Archive in the Search popup has been fixed.
  • 5.2.6
    - Interface: The online Browser & online Publisher now reflect the Scrapbook's color scheme
    - Bugfix: File/Import/Documents now works as expected.
    - Bugfix: Tree View index Drag n Drop now works as expected.

    Online Scrapbook v1.2 (Publisher & Browser)
    - Interface: A general overhaul of the interface to align it with the Scrapbook style and color schemes.
  • 5.2.5
    - Feature: Home Page tasks provides acces to the new Online Support Library of resources and documentation.
    - Interface: Revised the final Online Update screen to more clearly explain the new files.
    - Bugfix: Fixed the inadvertantly introduced misdisplay of the Memo window on some platform configurations.
  • 5.241
    - Bugfix: Fixed Updater.
  • 5.2.4
    - Feature: Home Page tasks now include 'Park' and 'Save a Backup'.
    - Bugfix: Fixed Scrapbook misdisplay after restore from Park.
    - Bugfix: The 'Metal' color scheme now persists between sessions (OSX only).
    - Bugfix: The 'Silver' color scheme now correctly updates the User Support color scheme.
    - Bugfix: Fixed window-judder when setting IAC preference.
  • 5.2.3
    - Interface: A 'parked' Scrapbook now floats above all windows as a systemWindow so it is accessible in all applications.
    - Interface: Vanilla and Silver have been added to the color scheme options. Blueberry, Graphite and Metal (OSX only) options have all been revised.
    - Feature: The 'What's New' web page can be checked before updating.
    - Bugfix: OSX menu-flashing on startup has been rectified.
    - Bugfix: Issues with overflow toolbar icons have been resolved.
    - Bugfix: Spoken dialog messages has been re-instated.
    - LiveCode users only: Your Scrapbook should now be immune to RevIDE tools palette.
  • Standalone Options
    Application programs are available on the website for...
    • Windows
    • Mac OSX Intel
    • Mac OSX Universal
    • Mac OSX PPC
    • Mac OS 9 PPC
  • 5.2.2
    - Feature: Added Mouse Shortcuts to the User Support:Shortcuts page.
    - Bugfix: New, delete, omit and rename are now correctly handled in the Tree View.
  • 5.2.1
    - Bugfix: Updater fixed to correctly handle User's PlugIn and Tokens copying.
    - Interface bugfix: Temporary language placeholders in Prefs removed.

[Back to Contents]

New in 5.2

This is the first major upgrade since the release of version 5. Many features, interface improvements and functionality enhancements have been added, foremost among these a cross-platform API with Inter Application Communications support and the ability to create your own language colorization schemes. We hope you will enjoy and benefit from the result.

What's New in Brief...

  • A Start Page for key task access has been added
  • API: A fully-featured cross-platform API is implemented
  • IAC: Inter Application Communications is supported
  • Cutomizable Toolbar: Use the presets or customize your favorite shortcuts
  • Full-width Page View option is now available
  • A Tree Index option with combination display options has been added
  • Colorization: Add your own languages and exchange specifications using XML
  • Searching: Customizable Search Engine sites with user-embedded search parameters
  • Export: XML is now included as an export format
  • 'Metal' is now included as an OSX color scheme option
  • Direct access to both Language and Classification customizing

New Features

  • A 'Start Page' has been implemented with access to key tasks. Closing the Scrapbook or the Start Page will close all Scrapbook tasks and any plugin that starts with 'ssbk'.
  • An API-IAC has been implemented in so you can 'Script your own Scrapbook'. There are two ways to use it: By developing Rev plugins, and by using text files for inter-application communication (IAC). A Handbook covering the API and IAC is available in the TOOLS:PLUGINS menu. See the IAC options in the Scrapbook preferences that includes IAC sensitivity and disabling.
  • 'Display Mode': The ability to work in Page View (where content takes priority) or Index View (where index access takes priority). The optional 'Display' toolbar button toggles the display.
  • 'Customize Toolbar': The Toolbar can now be customized. Right-click in the toolbar for a contextual menu of preset options or select "Customize..." to make your own selection and simplify the layout if required. Also available in Tools menu and in the Preferences.
  • Custom language colorizing is now supported. This includes XML file exchange for sharing colorization definition tables.
  • A Tree View index is now available in addition to the alphabetical and history indexes.
  • An unobtrusive clock with 12hr or 24hr and seconds options is included.


  • Scrapbook backup files are now supported as text hyperlinks so you can keep an Entry that lists archived backups if you wish. This can be an alternative to maintaining multiple Scrapbooks.
  • 'Copy to Clipboard' now supports individual Entry sections so you can grab only what you need.
  • Tech note for plugin users: ssBk itself and all supplied components are automatically saved in legacy-compatible file format.
  • A preview menu has been added to the Categories options dialog so you can try it before you apply it.
  • XML has been added to the range of Export options.
  • The popup Search Engine selector has been revised. It now also supports an editable User menu for access to multiple custom websites.
  • The Index title now displays in full or with a dynamic ellipsis depending on width available.
  • A search icon is now displayed in the index title following a Scrapbook search.


  • Added 'Metal' to color scheme options on OSX.
  • Language Options are now displayed and managed in their own dialog window, consistent with Categories. The Tools menu has been updated to provide access, and the Context preferences screen has been revised accordingly.
  • The standard arrow cursor is implemented when a Scrapbook is run in non-IDE environments.
  • The Tools and Entries menus have been modified to accommodate the new features.
  • Ctrl/Cmd.H as a shortcut to toggle the History has been removed as it conflicts with OSX.
  • The User Support and 'parked' windows are now included in the color scheme options.
  • Automatic layout adjustment for optimum content display where the Summary adjusts to fit.
  • The 'index view' has been simplified. There are now just two menus to 'Select' and 'View' the Entries. The 'View' menu provides access to all three index options (Alphabetical, Tree and History) and is available as a contextual popup with a right/ctrl.Click on the index.
  • Live window resizing is now supported on Mac OS9 and OSX.


  • File names over 31 characters are now supported on Mac OSX.
  • Intermittent cursor mis-display has been corrected when contextual menus are selected.
  • The Attachment Files icon now updates immediately to reflect Entry status.
  • Intermittent misbeviour of the Search field has been corrected.
  • Print Preview is now supported on systems with more than one hard drive.
  • Incompatibilities of using 'reserved words' as names for Entries has been resolved. Reserved words include Back, Fwd, Next, Prev, First and Last.
  • OSX display anomolies have been addressed, including the truncated Search field, menu style consistency and cursor issues.
  • Shortcuts and aliases in the ssBkPlugins folder now work as expected.
  • A failed search no longer throws an indexing error with protected Entries.
  • Mac and OSX only: The 'Mac Default Menubar' option now displays menus in the style expected. Also selecting disabled menus now longer throws an error. OSX menus that are disabled now display the correct menuitems.
  • Fixed cursor mis-display on Win32 for Index popup contextual menu.
  • Fixed menu-judder on OSX when updating tabstops.
  • Sheet dialogs are no longer called from modal windows as this causes problems on OSX.
  • The Topics menu in the Prefs now displays as expected on OSX.

ssBkChat v1.063

  • File format is now legacy-compatible.
  • Selected text is no longer 'lost' when messaging occurs in an active Chat window.
  • Chat sessions automatically terminate when the Start Page or Scrapbook is closed..

OnLine Browser v1.12

  • The index display and Author options have been fixed when selecting the 'Show My Own' option.

[Back to Contents]

Introduced in 5.1

  • Interface Update: Complete review and update of the interface to be more consistent with XP and OSX, including a moderated color scheme, new toolBar icons with mouseOver hiliting option, speech avatars, panel splitters, resize corner (win32), modern menus with mouseOver hiliting (win32) and white menu backgrounds (all platforms), native OS button styling wherever possible, OS-default dialog button positioning and updated dialog icons (OSX). Also implemented two color schemes in the Appearance preferences, "Blueberry" and "Graphite" for Windows XP and Mac OSX, although you can choose which you wish to use on either platform.
  • File Attachments: Improved File attachments compression.
  • Ruler shortcut: Added double-click on horizontal splitter to toggle the Ruler.
  • New Entry Context: Added 'Ask Context' option for New Entries.
  • Parking: Fixed incorrect application of windowBoundingRect for parked ssBk and ssBkChat under XP.
  • Navigation: Corrected navigation management and display when a new Scrapbook is created.
  • PlugIns Menu: PlugIns menu no longer displays OSX system files.
  • Printing: User Support printing issues resolved.
  • Splitter Cursors: Hotspot corrected for vertical and horizontal splitter. The cursor now lines up correctly.
  • History Menu: Cleared History items no longer leave a spurious blank line in the index.
  • ssBkChat incremented to 1.05:
    • Interface: Graphics now fully independent of ssBk hosting.
    • Interface: Modal/Sheet dialog style now in line with ssBk.
    • Bugfix(OSX): Clear current chat history corrected (inadvertantly introduced in 1.04).
  • ssBkChat incremented to 1.04:
    • Interface: Revised GUI in line with ssBk and improved 'Settings' display.
    • Bugfix: Field focus is now maintained in external stackFiles.
    • Bugfix: Improved smilies recognition.
  • ssBkChat incremented to 1.03:
    • Bugfix: Enabled History Log file launch on OSX.
  • ssBk Publisher and Browser incremented to 1.1:
    • Interface: Implemented GUI style in line with ssBk.
    • Bugfix: ssBkBrowser now correctly responds to Internet off-line.
  • Interim release 5.02
    • Interface: Scrapbook now opens as a standard window style when a unique instance of the MC IDE.
    • ssBkChat incremented to 1.02:
      • Feature: Works independently of ssBk for use as a rev plugIn.
    • ssBkChat incremented to 1.01:
      • Bugfix: Server error 'Chat' during versionCheck is trapped.
      • Bugfix: If the color palettes are open, the popup menu for 'Other' colors now works.

[Back to Contents]

New in the v5 Series

  • On-Line Scrapbook: Publish, browse and download Entries with over 180 listed languages.
  • On-Line Chat and Forum Discussion: Includes 'one click' Scrapbook Entry exchange and File transfer
  • Easier Updates: Settings, Entries and preferences automatically transferred with v5 or later
  • Easier Feedback: Direct access to comment, request, bug and query feedback
  • Web Publishing: Multiple Entry print previews, with automatic page breaks, presentation style, color scheme and hyperlinked index options
  • Internet Search: Direct access to On-Line Resources, Archives and Search engines to integrate your Scrapbook with the Internet
  • Quick-find: by default Search engine option
  • Search History: Your search history is stored using a 'menu with memory' with preference options
  • Speech: 8 independent 'Voice Assistants' for speech-compatible computers
  • Fast backup restore: Drag & drop your backup files
  • Links: Contextual popup menu of options for easier hyperlink management
  • Multi-lingual programmers: Define your own 12 language classifications
  • Script & code colorization for an additional 10 languages:
       AppleScript, Flash, JavaScript, PERL, REALBasic, SQL, Toolbook, VB,, VBScript
  • Firewall: Internet access options
  • Select by Attachment: To list all Entries with embedded files
  • Global text wrapping options, whilst retaining individual Entry settings
  • Tabs Ruler: Click to insert, drag to move, drag off to delete
  • Vertical Grid: Show a tab grid that adjusts dynamically
  • Line Numbering: Dynamic, independent, self-adjusting code line numbering
  • Text Wrap: Set individual and global line wrapping
  • Window Layout: Horizontal re-sizing for longer index titles

[Back to Contents]

New in the v4 Series

  • Create new Scrapbooks to keep different work sets
  • Drag & drop batch conversion to import your existing notes
  • Drag & drop file and folder icons to create links automatically
  • Search Internet sites direct, including discussion list archives
  • 'Quick Copy' any Entry to the Clipboard to paste as required
  • 'Links' preferences - Define your own hyperlink color choices
  • Multiple Scrapbooks - maintain several Scrapbooks if you wish
  • Insert images, graphics, artwork, bullets (GIF, JPG and PNG)
  • Chose from the built-in image bank, or select your own
  • Interactive 'Nudge' to position text and images
  • Create image links with automatic text conversion
  • Choose Style or Editing as your popup contextual menu
  • MSWord-style Format palette for centralized options
  • Floating color-picker palettes to quickly change text color and hiliting
  • Concordance plugin to cross-reference your Scrapbook
  • Hot links between Entries are preserved in web page publishing
  • On-line link for feedback, bug reports and comments
  • HTML web publishing
  • Script colorization for 6 languages:
       Director, MetaCard, Revolution, SuperCard, HyperCard, HTML
  • On-Line updates, direct to your computer
  • Visual presentation of context deployment options
  • Unlimited user-defined categories to specify usage
  • Platform classification, including Internet
  • File attachment options to store, preview and retrieve your files
  • Plugins option for extended flexibility
  • Popup Memos for annotations
  • Bookmarks for access
  • 'Locked' Entry protection
  • 'Source' popup selection
  • Advanced Find for specific matches
  • Hyperlinks to files, networks, eMail addresses, websites, Internet resources
  • Hot Links to other Entries
  • 4-way Navigation to go back, forward, next and previous
  • Extended setup preferences for developers and advanced users
  • 'Tell me..' index in the Help to answer questions
  • LiveCode® plugin compatible
  • Standalone application program available for Win32, Mac Classic and Mac OSX
  • CSV export to other programs (such as Excel or FileMaker)

[Back to Contents]

Updating multiple Scrapbooks...

  1. Using your old Scrapbook(s), select FILE:EXPORT to backup your Entries.

  2. Close your old Scrapbook and open the new version.

  3. Drag and drop your backup file (or select FILE:IMPORT) to bring yourself up to date.

  4. If you have further Scrapbooks, use FILE:NEW and import your other backups.

[Back to Contents]

Due to the variation of user requirements, there is no 'installer' for the Scripter's Scrapbook. You choose the starter-kit download, with or without an application program and/or additional platform-specific application programs as and when you need them. The following are guidelines to help you decide how best to store your Scrapbook system.

There are two installation options: As a standalone or as a LiveCode plugin. If you want to use both systems on different computers, you can. Your Scrapbook will happily work in either environment and on any supported platform, so you do not need to keep separate data files. The only 'rule' is to make sure that the "ssbkPlugins" folder is located with any Scrapbook you use. Multiple Scrapbook data files should be kept in the same location for your own convenience.

Note: Although you can access a Scrapbook over a network, simultaneous multi-user access is not supported.

There are three components:
    1. An application program called Scripter's Scrapbook (optional for LiveCode users)
    2. A Scrapbook data file (initially called ssBk but you can rename it if you wish)
    3. A plugins folder called ssBkPlugIns (do not rename this; it is a required component)

1. Standalone Option
If you are using a Scripter's Scrapbook application program on Windows or MacOS X, lauching the application program will automatically open a Scrapbook if it is called "ssbk" or "ssbk.rev" and if the Scrapbook file is in the same folder. Alternatively, you can rename and/or relocate the Scrapbook, then select it when prompted.

2. LiveCode PlugIn Users...
If you use LiveCode, you do not need an application program unless you sometimes wish to run your Scrapbook independently.

To ensure that your Scrapbook appears in the LiveCode plugins menu...
- On MacOS X
Put your Scrapbook and ssbkPlugIns folder in Users:Name:My LiveCode:Plugins.
- On Windows
Put your Scrapbook and ssbkPlugIns folder in My Documents:My LiveCode:Plugins.

On-line Updates...
Your Scrapbook can automatically check if an update is available, but you can also check at any time under the HELP menu and on the HOME PAGE. You will find your new Scrapbook in a new folder with everything you need. This means that your old setup remains untouched and available. All your existing Entries, settings, custom language colorizing and personal plugin files will have been copied to the new setup for you.

What to do when the update finishes...

  1. Click 'Exit'
  2. Archive your old setup
  3. Replace your old items with everything in the new folder (including the updated ssBkPlugins folder).
  4. To update further Scrapbooks, see Updating multiple Scrapbooks.

[Back to Contents]

THE SCRIPTER'S SCRAPBOOK, the personal reference library for all programmers