NotebookConvertSettings

This function has not been fully integrated into the long-term Wolfram Language, and is subject to change.

NotebookConvertSettings

is a global option that specifies settings for converting imported legacy notebooks.

Details

  • The typical usage is NotebookConvertSettings->{opt1->val1,opt2->val2,…}.
  • The following options may be specified:
  • "GenerateBitmapCaches"Falsetoggle graphics and bitmap conversion
    "InputToStandardForm"Falsetoggle input cell conversion to standard form
    "OutputToStandardForm"Falsetoggle output cell conversion to standard form
    "PreserveStyleSheet"Falsecreate private stylesheet to preserve Version 2 styles in the converted notebook
  • "GenerateBitmapCaches", "InputToStandardForm", "OutputToStandardForm" and "PreserveStyleSheet" are associated with the Notebook Convert dialog box, which appears when you open a notebook created using Version 2.
  • With the default setting "GenerateBitmapCaches"->False, no bitmap caches are generated, so any graphics present in the notebook will have to be rendered when they are first displayed while scrolling through the notebook.
  • With the setting "GenerateBitmapCaches"->True, each graphic in the notebook will be fully rendered during the conversion process and a bitmap cache stored in the new file. This can take a long time and consume a lot of memory for a large notebook containing many graphics cells. However, it allows the resulting notebook to be opened more quickly.
  • With the default setting "InputToStandardForm"->False, input cells present in a Version 2 notebook are not converted to StandardForm.
  • With the setting "InputToStandardForm"->True, input cells present in a Version 2 notebook are automatically converted to StandardForm when the notebook is converted.
  • With the default setting "OutputToStandardForm"->False, output cells present in a Version 2 notebook are not converted to StandardForm.
  • With the setting "OutputToStandardForm"->True, output cells present in a Version 2 notebook are automatically converted to StandardForm when the notebook is converted.
  • With the default setting "PreserveStyleSheet"->False, a Version 2 notebook is automatically assigned the default stylesheet when it is converted. All style information about the original notebook is therefore lost in the conversion.
  • With the setting "PreserveStyleSheet"->True, a private stylesheet is generated that replicates the styles used in the Version 2 notebook.
  • Because the default settings in the current version of the Wolfram System are fairly similar to those in Version 2, a notebook that did not define its own custom styles will look quite similar when converted with this option set to False. It is recommended that you elect not to preserve styles unless your notebook defines many custom styles; it is generally better to start with a fresh set of default styles.
Wolfram Research (1999), NotebookConvertSettings, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookConvertSettings.html.

Text

Wolfram Research (1999), NotebookConvertSettings, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookConvertSettings.html.

CMS

Wolfram Language. 1999. "NotebookConvertSettings." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/NotebookConvertSettings.html.

APA

Wolfram Language. (1999). NotebookConvertSettings. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/NotebookConvertSettings.html

BibTeX

@misc{reference.wolfram_2023_notebookconvertsettings, author="Wolfram Research", title="{NotebookConvertSettings}", year="1999", howpublished="\url{https://reference.wolfram.com/language/ref/NotebookConvertSettings.html}", note=[Accessed: 19-April-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_notebookconvertsettings, organization={Wolfram Research}, title={NotebookConvertSettings}, year={1999}, url={https://reference.wolfram.com/language/ref/NotebookConvertSettings.html}, note=[Accessed: 19-April-2024 ]}