The Texts panel will be one that users will often interact with, as this is the spot where texts are added, categorized, and updated.
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 a default text section (
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 is one fixed category—
Uncategorized—into which all texts will initially flow until a user moves them to a created category.
To move a text from one category to another, simply click on the horizontal “grab” bars on the far right side of the category container, beside the trash can and edit pencil icons.
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 to which custom categorized texts are subject.
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 (unless the Text is denoted as having been Published). Here we have an extract from the text titled For Thought in the Act, which we can see from the shots above is in the
Supporting Texts 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 horizontal grab bars to the right of the category name, which you can use to drag and drop the category to the desired placement.
Modifying Text Records
After a text has been ingested, you can modify its metadata, adjust associated Maker records, 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 edit button from the project’s text directory.
From there you will be taken to the text landing page with its own unique sidebar:
Text Menu Bar Options
The menu bar on the text landing page mirrors the functionality of the menu bar at the project level, along with contextual and added functionality.
When activated here, the Preview button opens a new tab with the text showing in the Manifold reader. This contrasts with this button’s behavior at the project level, where it opens a new tab to the project landing page instead of a specific text.
This button allows editors the means to delete the specific text that is presently being edited—versus deleting the entire project.
This option provides a means for a publisher to export from Manifold an EPUB of a specific text, regardless of the format it was ingested. If a publisher is creating texts using Word files or Google Docs, this provides the means to secure that same content in the EPUB format.
Every five minutes Manifold looks for texts that have this setting enabled. If a text is newly enabled, Manifold will generate an EPUB of the text. If the text has been updated since the last scan, Manifold will re-create the EPUB so that accurately reflects any changes that have been made.
Once generated, Manifold makes the EPUB available for download through the backend (see the next section). Looking ahead, we anticipate tying this to content blocks, so that publishers can provide readers the option to download specific texts as EPUBs to their own devices.
Download EPUBbutton does not appear on the menu after having been toggled on for at least five minutes.
Download EPUB (Conditional)
For texts that have
Enable EPUB toggled on, this button provides the means for the publisher to secure the Manifold-generated EPUB.
Presently this is the only means to secure the generated EPUB, but in the future we expect to make it possible to provide a way for readers to access the file through content blocks on the project landing page.
Enable EPUBon, Manifold will create its own EPUB. Those two files would be very similar but potentially not exact matches. The original source EPUB is still retained, however, and would be available through the
Download Sourcebutton (see below).
Download Source (Conditional)
Manifold retains the source files that were uploaded to create each text. This button allows a publisher to secure that file directly from the system.
In situations where multiple backend users are uploading and editing files, this provides the means to access source materials directly without having to go through an intermediary. Likewise, in situations where source files have been misplaced, this serves as a handy fallback.
When you access a text record in the backend, you’ll arrive first in the
General menu where you can adjust number of the text’s fundamental attributes:
Descriptionhave display options available in the text content block. To learn more about those options, see the Layout section.
Manifold will automatically populate this field if the source file that is ingested describes a title in its structure. The following table considers this for each of the available ingestion strategies:
|Source File||Location Notes|
|HTML||For individual HTML text ingests, title metadata will apear Within the
|Markdown||When loading individual Markdown files, the title will be formatted like this:
|Google Doc||While there is a paragraph style called
|MS Word (DOCX)||The text of the paragraph that has the Word Style
|Manifest Ingests||In the YAML file, nested in the
If Manifold cannot find title information it will automatically assign a random UUID as the title. That can be adjusted to a more appropriate title here.
The value entered here, whether coming from a source file’s metadata or from manual entry, will be properly encoded as the title in any EPUB that Manifold may make of the text for export or download.
If Manifold cannot determine a text’s subtitle during ingestion it will assume there is no subtitle. If that is not accurate, one can be supplied here.
This is a calendar entry field that allows a publisher to describe the publication date of a specific text, which may or may not coincide with the publication date of the Manifold project. That is to say, any publication date is somewhat arbitrary. This field could reflect the date of original publication in print or the date of publication onto Manifold.
The date stored in this field does not presently render on the site or function for any sorting purposes. We store it for likely future use and encourage publishers to maintain complete text records that are consistent with the publishing scheme.
A text slug describes the part of the URL for a specific text that appears between the
section components. In the following example,
furious-feminisms is the slug for a text on the University of Minnesota Press’s instance. The system will automatically create a slug for each new text based on the text title, unless your manually adjust this field.
This is a Markdown-enabled field where publishers can describe individual texts. The copy entered here can also appear in a text content block. See the Layout section for more details on how and where the content of this field can be displayed for readers.
This field allows publishers to associate a cover image with a text, which can then be made to render in the text content block beside the text title (as in this example). See the Layout section for details on how to configure your project for that setup.
Previously, only texts loaded in the EPUB format would render a cover in this space. With this field, customizable text covers are available for all texts, regardless of their ingestion file type.
In the Manifold reader, texts normally include the category name with which they are associated as a ribbon at the bottom of the screen.
When this field is toggled on, that ribbon is removed. Further, a published tag will also be associated with the text in a text content block:
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.
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).
Likewise, the text’s title and subtile, its makers (authors, contributors), and description can be toggled to be shown on the project landing page in a text content block. To learn more about all the customizations possible for display elements in a text block, see the Layout section.
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.
The 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” or “User”:
“Ingested” stylesheets are those that were part of the source document imported into Manifold. “User” stylesheets are those that have been created by a user after the initial ingestion.
If you need to adjust the styling of certain elements in a text, we suggest you add a new stylesheet to the project instead of modifying one that the system brought in with the text: if you ever need to reingest the text in question, any changes you have made to those stylesheets that were brought in with the text will be overridden by the reingest process, while added stylesheets will persist unaffected by that process.
To override styles in the source document, create a new stylesheet and move it to the bottom of the list by clicking the two horizontal grab bars. You can use those to drag and drop your new sheet or reorder existing ones.
When you create a new stylesheet, you’ll be taken to a 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. A field to document the name of your stylesheet. We suggest something brief but descriptive of its purpose (e.g., Blockquote Spacing).
- Source Styles. 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.
- Validated Styles. After you save your stylesheet, this 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.
After your style rules have been saved the Text Sections dropdown will become available. This dropdown allows a user to assign the new stylesheet to either the entire text—by clicking
Add All—or by selecting individual sections from the dropdown. Selected sections appear below and can be deselected by clicking the
x beside their names. Only those sections selected will have the new stylesheet applied to them. Thus it is possible assign style adjustments to specific parts of a text that was uploaded using the Manifest ingestion method.
In situations where you need to modify the content of a text you have already loaded into Manifold, you can use the Reingest process.
Presently there is no means to directly modify Manifold texts (though such authoring components are under discussion). Instead you will need to adjust the source document—the document(s) you originally uploaded into the system—and then reload (or in the parlance of Manifold, reingest) it, replacing the existing text with the modified version.
This process is not versioning control but a means to address the need to make minor corrections and modifications.
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 record’s 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.
It is important to note that the following fields associated with the specific text record—and not the project generally—will be overridden by a reingest:
- Publication Date
- Unique Identifier
If you have manually adjusted these fields after your text was initially loaded, the reingest will reset them to their initial state.