Textbundle Format
Introduction
The Textbundle format is an open standard created to facilitate the handling of images in markup-formatted texts. In particular, the sandbox environment for applications under macOS makes it difficult to embed/link images into markup-formatted text files.
Textbundle-Structure
A textbundle-file is like the name implied, a "bundle", and is roughly speaking, a directory given the file extension textbundle. Under macOS, the content of such a Textbundle file can be viewed in the Finder by right-clicking and selecting the menu item "Show package contents". This shows that a Textbundle file is build up with the following three elements:
- text.txt (the actual text)
- info.json (A file that contains further information about the Textbundle, including the markup language used for documents)
- assets directory (this directory will contains all to this document associated files [e.g. Pictures])
Textpack special format
Textpack files are basically also Textbundle files, which however were zipped / compressed. This makes it easier to send such files using e-mail and messenger applications.
Create Textbundle files
To create a Textbundle file with MarkMyWords, simply create a new document and select the Textbundle option in the Save dialog below the directory selection. To add assets / attachments to the document, you must first save the Textbundle file (for more information about Attachments).
Opening Textbundle files
A Textbundle file can be opened in MarkMyWords like any other plain text file, either through the standard Open dialog or by dragging the file to be opened to the MarkMyWords dock icon.
Export documents as Textbundle / Textpack
MarkMyWords can export documents as a Textbundle as well as a Textpack file. There are two ways to do this:
- Menu > File > Export As ... > Texbundle Document
- Toolbar > Export Popup > Export As Text Bundle
For more information about Exporting Documents
For more information about the Textbundle Format
The complete Textbundle / Textpack specification can be viewed at http://textbundle.org. In addition, this page provides a list of applications that support the Textbundle format.