Wolfram Language Paclet Repository
Community-contributed installable additions to the Wolfram Language
Where Stylesheets Come From  | |
This tutorial is intended to clarify how the front end finds stylesheets when determining style inheritance. It describes some built-in functionality as well as uses functions from the StylesheetTools package.
This loads the package:
<<StylesheetTools`
StyleSheetPath
is a list of directories where stylesheets are expected to be found. Most stylesheets are found on the StyleSheetPath. Individual entries are defined using FrontEnd`FileName. FrontEnd`FileName has the attribute and the first argument is a list of path elements. Some path elements may use to indicate any path element.
The front end searches the StyleSheetPath from top to bottom. The top entries within the StyleSheetPath are prepended by the paclet manager for any that contain a that sets . The paclet manager modifies the StyleSheetPath for the scope. Additional entries in the StyleSheetPath include subdirectories of , , and , as well as other paclets that define a FrontEnd extension but do not indicate that the paths should be prepended.
a global option that specifies which directories the Wolfram System searches to find stylesheets |
Finding a stylesheet's location.
In[317]:=
rawPaths=CurrentValue[$FrontEndSession,StyleSheetPath];Short[rawPaths,10]
Out[318]//Short=
{FrontEnd`FileName[{E:\WolframProjects\Personal\StylesheetTools\StylesheetTools\FrontEnd,StyleSheets},PacletManagerTrue,PrependTrue],FrontEnd`FileName[{E:\Mathematica\13.1\AddOns\Applications\ChatTools\FrontEnd,StyleSheets},PacletManagerTrue,PrependTrue],26,FrontEnd`FileName[{$UserBaseDirectory,Paclets,Repository,DocuTools-0.10.2476,FrontEnd,StyleSheets},PacletManagerTrue],FrontEnd`FileName[{E:\Mathematica\13.1\SystemFiles\Components\MUnit\FrontEnd,StyleSheets},PacletManagerTrue]}
Use ToFileName to convert the entries to a more conventional format where is replaced with a wildcard asterisk:
In[323]:=
Short[ToFileName/@rawPaths,10]
Out[323]//Short=
{E:\WolframProjects\Personal\StylesheetTools\StylesheetTools\FrontEnd\StyleSheets\,E:\Mathematica\13.1\AddOns\Applications\ChatTools\FrontEnd\StyleSheets\,C:\Users\kedai\AppData\Roaming\Mathematica\Paclets\Repository\CloudDialogs-2.2.10\FrontEnd\StyleSheets\,C:\Users\kedai\AppData\Roaming\Mathematica\Paclets\Repository\CodeFormatter-1.7.1\FrontEnd\StyleSheets\,22,E:\Mathematica\13.1\SystemFiles\Links\*\FrontEnd\StyleSheets\,E:\Mathematica\13.1\SystemFiles\FrontEnd\StyleSheets\,C:\Users\kedai\AppData\Roaming\Mathematica\Paclets\Repository\DocuTools-0.10.2476\FrontEnd\StyleSheets\,E:\Mathematica\13.1\SystemFiles\Components\MUnit\FrontEnd\StyleSheets\}
In[327]:=
FileNames["Default.nb",ToFileName/@rawPaths]
Out[327]=
{E:\Mathematica\13.1\SystemFiles\FrontEnd\StyleSheets\Default.nb}
If a stylesheet is in a subdirectory then use a deeper search depth:
In[335]:=
FileNames["Reference.nb",ToFileName/@rawPaths,2]
Out[335]=
{E:\Mathematica\13.1\SystemFiles\FrontEnd\StyleSheets\Wolfram\Reference.nb}
Instead of directly querying the StyleSheetPath to find a stylesheet location, use the StylesheetTools function StylesheetPathLocation.
finds the path of the input stylesheet |
Alternative to directly searching the StyleSheetPath.
Use StylesheetPathLocation to find the first stylesheet on StyleSheetPath with a given name:
In[328]:=
 | StylesheetPathFind |
Out[328]=
C:\Users\kedai\AppData\Roaming\Mathematica\Paclets\Repository\CodeFormatter-1.7.1\FrontEnd\StyleSheets\Package.nb
Include the second argument All to find all instances of the stylesheet as ordered within StyleSheetPath:
In[329]:=
| StylesheetPathFind |
Out[329]=
{C:\Users\kedai\AppData\Roaming\Mathematica\Paclets\Repository\CodeFormatter-1.7.1\FrontEnd\StyleSheets\Package.nb,E:\Mathematica\13.1\SystemFiles\Components\CodeFormatter\FrontEnd\StyleSheets\Package.nb,E:\Mathematica\13.1\SystemFiles\FrontEnd\StyleSheets\Package.nb}
Use path delimiters to find stylesheets that are in subdirectories of entries within the StyleSheetPath:
In[331]:=
| StylesheetPathFind |
Out[331]=
E:\Mathematica\13.1\SystemFiles\FrontEnd\StyleSheets\Wolfram\Reference.nb
Using a Local Stylesheet
Before the front end searches the StyleSheetPath for a stylesheet, the front end searches the of the working notebook. If the working notebook is not saved then only the StyleSheetPath is searched. The StylesheetTools package contains an example working notebook that exists within the same directory as example stylesheets. The directory structure looks like
TODO
StylesheetTools/
InheritanceExamples/
ExampleWorkingNotebook.nb
ExampleStylesheetA.nb
InheritanceExamples/
ExampleWorkingNotebook.nb
ExampleStylesheetA.nb
ExampleWorkingNotebook.nb
Th
2+2
 |
|
 |
|
""