Compatibility

Compatibility

If you are cross-using ScrapBook X with ScrapBook Plus or ScrapBook, or are moving data between these versions, please pay attention to this section, to prevent unexpected problems.

"Old revisions" below means ScrapBook Plus (1.9.24.40) and ScrapBook (1.5.13). This section is talking about the compatibility of the latest version (ScrapBook X 1.13.0) with them.

Configs

• ScrapBook X has moved the preferences to extensions.scrapbook.*, and do not use them in common with the old revisions. To find the previous settings, type aboug:config in the address bar, and you can copy the values of scrapbook.* to the corresponding extensions.scrapbook.* manually.
• Old ScrapBook versions use the preference to persist several dialog options due to some ancient issues, ScrapBook X now uses native XUL persist techinque to persist them, and as a result, some configs may "be forgotten" when traveling from old to new or new to old version.
• The name of some preferences are modified, and this may cause some settings not persisted when switching the version.

Data file changes

Generally speaking, data of new revision can be browsed normally in the old revisions, and vise versa. But they may not be manipulated or edited normally. Known incompatibilities are as below:

• Data files with special or non-ASCII chars that are supported by ScrapBook X and not by the old revisions can not be saved correctly in the old revisions.
• Data items with sub folders cannot be deleted or calculated normally.

Item property changes

Some item properties are newly-added in ScrapBook X and do not exist in the old revisions. Known compatible conditions are as below:

• Items in an old revision can be imported to a new revision. It is suggested that "import as latest ScrapBook X format" be checked when you are importing to a new revision so that item properties are automatically added.
• Items in a new revision can be imported into an old revision, with non-supported properties missing. Since Scrapbook X 1.12.0a5, non-supported properties are imported but are missing on exporting. Since Scrapbook X 1.12.0a47, non-supported properties are imported, exported, and otherwise handled correctly.
• Since ScrapBook X 1.13 non-folder-type folders are supported. These items can be generally viewed in and older version but there may be issues on the GUI and these items cannot be searched or imported/exported correctly.
• Since ScrapBook X 1.13 notes supports plain text only. There could be some issues for HTML special chars (such as <, >, or &) in the content when switching the version.

Fulltext cache changes

ScrapBook X has changed the format of fulltext cache, which is incompatible with the old revisions. You have to update the fulltext cache before performing a fulltext search when shifting the revision to make it work normally.