The Texts panel will be one that users will often interact with, as this is the spot where texts are added, categorized, updated, and set as the published version of record.
For new projects—or projects that haven’t yet ingested a text—the panel is composed of two buttons (
Add a new text and
Create a new category) and two category sections (
When texts are added to a project they will be oriented in the
Uncategorized section. New, custom, category sections can be added as required to suit the needs of a project.
This section is portioned along the following themes:
Adding Texts to Projects
To begin the process of adding a text to a project, click on the
Add a new text button. When you do, a drawer will open from the rights, allowing you to drag and drop a file onto the screen or select a file from your device using the file directory.
Alternatively, if the text you want to ingest is already being hosted remotely, you can designate the URL where Manifold can fetch it. For instance, the following is the URL to the Standard Ebooks Project’s copy of Edwin A. Abbott’s Flatland:
Note that the link is not to the page where you can download the file, but instead a direct link to the file itself.
Once you have selected a file or designated a URL, the
Continue button will change from gray to green when the system is ready to proceed. Click it and the drawer will change to a file analysis state.
File Analysis and Ingestion
Manifold will review the file you’ve suggested for ingestion, with the following output:
Current State: Sleeping Strategy: None Text ID: This ingestion will create a new text Log: Connecting to Manifold websocket...
Connecting to Manifold websocket appears in the Log section, the
Ingest button at the bottom right will turn green and the text can be ingested. When clicked Manifold will process your file. The
Current State field will read
Processing, and the log will stream details of what the system is doing. If everything goes correctly, when the process is finished the
Current State should say
Finished, a hexadecimal value should be listed under the
Text ID, and the last line of the log should read
If you get anything different from the log, reach out for support.
Otherwise, you can click on the green
Complete button, and you will now see the text you ingested in the
Uncategorized section of the panel.
Congratulations! Your text is now in Manifold!
Grouping Texts by Category
Categories are a means to group and label texts in the system. By default there are two fixed categories:
To move a text from one category to another, simply click on the up/down arrows to the right of the text name.
A text in the
Published category receives distinct treatment considered in the following section,
Uncategorized serves as the staging ground for all texts that are initially ingested. This category does not have a limit on the number of texts it can hold, nor are texts in this collection overlaid with a title ribbon.
If your project requires grouping texts in distinct clusters, or if you simply wish to indicate what state the text being presented is in (e.g., First Draft, Peer-Reviewed, etc.) you can create a custom category that will support those ends.
To create a custom category click on the
Create a new category button, and a drawer will open from the right asking you to name it. Click
Create Category, and the new section will appear in both the front- and backend interfaces:
By default new categories are empty. When you move a project into a custom category the reader will overlay the bottom of the text with a yellow ribbon the category name. Here we have War of the Worlds, which we can see from the shots above is in the
Markdown Sample category and displays a ribbon to the same effect:
You can rename a category by clicking on the
Edit button to the right of it’s name or delete the category entirely by clicking on the
X to the right of the
Texts that are in a custom category that is being deleted will return to
Uncategorized after the deletion has been confirmed.
To change the order in which the custom categories appear, click on the up/down arrows to the right of the category name.
Moving a text from
Uncategorized or a custom category to
Published, indicates the text in question represent the project’s version or record: the definitive published text.
Because of its nature, this category can only accept one text at a time.
When you move a text into this section, the cover image will automatically show on the banner image, along with a
Start Reading reading button and, if the document contains internal structuring, a link to view the title’s contents.
If the title is for sale, then a link to the online shopping cart and the purchase price will also appear beneath the cover if set in the Appearance section.
Managing a Text’s Details
After a text has been ingested, you can modify its metadata, which Maker records are associated with it, update how its constituent elements render in the reader, and also re-ingest its source file to accommodate any minor changes that may have been required after the initial ingest.
To edit a text, click on it’s name or the
Edit button, right of the name, in the category listing. From there you will be taken to the text landing page with its own unique sidebar:
When you access the text landing page in the backend, you’ll arrive first on the text’s
General panel where you can adjust it’s
Description, and the
Section Label that displays in the reader.
The content entered in the
Description fields are included when a URL from the text is shared with another platform capable of conveying that information to its readers (e.g., Facebook).
Section Label refers to the navigation header that appears at the bottom of a unit of text. By default the header reads
Next Chapter. Below that header is the title of the next unit of text. If your text is broken up by another conventions (e.g., article, part), you can specify that here to better orient readers to the nature of the content.
People sidebar element you can add, remove, and modify Maker records associated with the text just as you could for the project generally. For details on that process, which is the same here, see the People section.
In addition to the basic metadata available through
General sidebar element, there is also a separate menu (
Metadata) that allows users to modify a robust set of metadata elements associated with a particular text. See the Reference section for a list and description of all the fields available for texts.
Styles sidebar menu allows users who are versed in CSS (cascading stylesheets) to modify how certain elements in their text render in the reader by adjusting an existing—or associating a new—CSS file with the text.
Stylesheets are applied to texts in the order listed under the
Stylesheet heading and are classified as either
Ingested stylesheets are those that were part of the source document imported into Manifold (with some modification) during the text ingestion. We do not recommend you modify
Ingested stylesheets on the platform: if you happen to reingest the text, any changes you have made will be overridden by the reingest process.
“User” stylesheets are those that have been created by a user after the initial ingestion and will not be overridden by a text reingestion.
To override styles in the source document, create a new stylesheet and move it to the bottom of the list by clicking the
Add a New Stylesheet button. You’ll be taken to a new screen that is split into three sections:
Source Styles, and
Validated Styles. As a user you will only be able to modify the first two fields.
Name, provides a space for you to name your stylesheet.
Source Styles is the pane where you can add style rules to the various classes that make up your text. Rules should be in keeping with CSS standards.
After you save your stylesheet, the
Validated Styles pane will populate with the translation of your rules specific to the platform. This output is read-only and cannot be modified by a user.
If you have modified your source document—the document(s) you originally uploaded into the system—after it has already been ingested, you can use the reingestion process to replace the existing text with the new version.
This process is not versioning control but a means to address the need to make minor corrections and modifications to a text.
When you reingest a text, all the annotations, highlights, and resource placements that have been made will persist, unless such drastic changes were performed that the system can no longer identify their original anchors. In this unlikely case, annotations and highlights will be orphaned and no longer accessible.
To reingest a text, click on
Reingest from the text landing page sidebar. You will see the same readout as when you initially ingested the text. Follow the same steps from the
Adding Texts section above and when completed your text will have been replaced by the newer version.