Maple Workbook URI Guide
What is a Maple Workbook URI?
URI Syntax: Basics
URI Syntax: Relative vs Absolute Paths
URI Syntax: Referencing Files in Another Workbook
The Workbook URI (Uniform Resource Identifier) is used to represent the identity and location of files within a Maple workbook or files residing inside another workbook in a given file directory.
A URI would look like this:
Using the URI mentioned above as an example,
The substring, "this://" identifies this URI as a reference to the current open workbook.
The third slash represents the root directory of the Maple workbook.
Finally, "MyCode.mpl" represents the Maple code file located in the root directory of the current workbook.
In general, the URI syntax is "this:///<path to file in workbook>/<filename>".
Consider the following URI:
This URI contains an absolute path to the image file "Sections.png". In other words, the complete file path is explicitly stated. Within the workbook that contains "Sections.png", the URI could also have been defined as
This URI contains a relative file path. With respect to the current open workbook, the file can be located anywhere, at any level in the workbook directory.
Note: Using a relative file path only works if there are no other files called "Sections.png" at any level in the workbook.
While URIs of the form "this:///<path to file>/<filename>" are used to represent files within a workbook, it is also possible to reference files contained in other workbooks.
The syntax for such a URI is:
"maple://<file path to workbook>/<path within other workbook>/<filename>"
Creating a Workbook URI on Windows
The file separator on a Windows operating system is backslash "\". However, the backslash is also an escape character. So in order to use the backslash as a file separator, a second backslash is required.
A example of a workbook URI on Windows would be:
Creating a Workbook URI on Linux or Mac OS X
The forward slash "/" character is the valid file separator on Linux or Mac OS X.
An example of a workbook URI on Linux or Mac OS X would be:
Linking to a Workbook Attachment
Download Help Document
What kind of issue would you like to report? (Optional)