Setup your Structure

In the structural phase, you will outline your content’s structure to ensure efficient navigation - like the arrangement of chapters in a book. Keep in mind that you can go back and edit any of these elements later. 

Structure 

This is where you define canon specifics and content order. The publications you identified during the descriptive phase will appear here. Click on ‘Begin’ to define the structure for that publication.

  • Content Order. Choose the order in which your content is arranged.
    • Canonical - the standard arrangement of books
    • Other - Chronological, thematic, or another order different from the traditional canonical order of books
  • Canon Type. The overall structure and order of this canon. Select the best option from the drop-down menu.
  • Canon Components.  Your selection here should match the canon type selected above.

  • Content List. This is a list of the content, usually called books. 
    • Every content list item contains the following fields:
      • Content ID. This is a unique identifier used to reference additional information about the content’s name. Typically, it includes the three-letter content code within the content.
      • Long Name. Long form name used to refer to the content in its official or native language, e.g. ‘Revelation of John’ or ‘Book of Genesis.’
      • Short Name. Short form name used to refer to the content in its official or native language, e.g. ‘Genesis’ or ‘Revelation.’
      • Abbreviation. This is the preferred or common abbreviation used to refer to the content, e.g. ‘Gn’ or ‘Rv’. 
      • Scripture reference. This is the book this content list item contains. Select a book from the dropdown list. The books shown in the list are determined by the Canon type and Canon components selected earlier.

  • Content list items can be generated automatically by DBL, or you can choose to manually add books to the list. 
    • Auto generate content list. Based on the Canon type and Canon components you selected, DBL can populate the content list for you.
      • Click ‘Generate’ to start.

      • If you wish to change content list items, click ‘edit’ next to that item.

      • Fill out each field and click ‘save.’
      • To cancel your edit, click ‘cancel.’
      • To delete the entry, click ‘delete.’

      • If you’ve changed a field in a content list item, click ‘Save.’
    • Manually add content list. You can add the fields manually. 
      • Click ‘Add Content’ to start. 

      • Fill out the fields mentioned above for each of the content list items.
      • Click ‘Add’ for each content list item you are ready to add.
      • Click ‘Cancel’ to undo adding a content list item.
      • Click ‘Delete’ to remove a previously added content list item.
      • Click ‘Add’ at the bottom of the page when all content list items have been added.

Once all content list items have been successfully added, click ‘Save Publication’ to continue. You can also click ‘back to structure’ to cancel your entry and go back to the previous step in this process.

Content Type Format

In this section, you will tell us about the format details of your content. The details you provide depend on the format of your content - whether it’s text, audio, video, braille, or print. Below, you will find instructions for each content type. 

Text Format

  • Select the Translation Type from a drop-down menu. Is it the first translation in the language, a new translation (not a revision), or an update to an existing translation? If most books were not translated before, choose ‘First.’
  • Select the Audience from a drop-down menu. Who is the group of the people for whom the translation or text is being prepared? The available options are as follows:
    • Basic - simple language for readers with limited education or reading ability.
    • Common - standard version for the general adult population.
    • Common - Literary - accessible for common readers, with a slightly more refined or literary style.
    • Literary - formal, elevated language for educated readers or those who prefer literary styles.
    • Liturgical - structured for use in worship services, with language suited for public reading.
    • Children - simplified for young readers, using age-appropriate language and concepts.
  • Answer the Versed Paragraph question - does each verse start a new paragraph? If so, select ‘True.’ Otherwise, select ‘False.’
  • Enter the USX Version (optional). This is the version of the United Scripture XML format being used. Most commonly, this is 3.0. If there is no value, 2.x. 

Audio Format

  • Dramatization Type - the style of audio production, from single-voice narration to full dramatization with multiple voices, sound effects, and music. (e.g. Dramatized, Non-Dramatized, Single-Voice).
  • Compression - the method used to compress the provided audio files. (e.g. mp3, wav, etc…).
  • Content by Chapter - does each audio file contain exactly one chapter of content? Select either true or false.
  • Timing Files (optional) - upload timing files to include with your content. Each uploaded timing file can be deleted by clicking ‘delete’ next to the file name.
  • Track Configuration - the arrangement and settings of audio tracks within a file, including how various elements like dialogue, music, sound effects, or different language options are organized for playback. (e.g. 1/0 (mono), Dual mono, 2/0 (stereo), 5.1 surround).
  • Bit Rate - the quality and file size. Higher rates mean better quality but larger files. (e.g. 128 kbps, 320 kbps).
  • Bit Depth - the number of bits used to represent each audio sample in a recording. (e.g. 16 bits, 24 bits).
  • Sample Rate - the frequency of audio sampling per second, affecting audio quality. Higher rates mean better quality (e.g. 44.1 kHz, 192 kHz).

Video Format

  • Content by Chapter - does each audio file contain exactly one chapter of content? Select true or false.
  • Timing files (optional) - upload timing files to include with your content. Each uploaded timing file can be deleted by clicking ‘delete’ next to the file name.
  • Video Stream - this section provides format information about the video stream for this content.
    • Codec - the file compression of the included content, crucial for streaming and playback.
    • Bit rate - the quality and file size; higher rates mean better quality but larger files
    • Frame rate - the number of individual frames or images displayed per second in a video.
    • Screen resolution - the number of pixels displayed on the screen determines the video image’s detail and clarity. Higher resolutions offer sharper and more detailed visuals.
  • Audio Stream - this section provides information about the audio stream for this content. 
    • Compression - the method used to compress the provided audio files.
    • Track configuration - the arrangement and settings of audio tracks within a file, including how various elements like dialogue, music, sound effects, or different language options are organized for playback. (e.g. 1/0 (mono), Dual mono, 2/0 (stereo), 5.1 surround)
    • Bit rate - the quality and file size. Higher rates mean better quality but larger files. (e.g. 128 kbps, 320 kbps).
    • Bit Depth - the number of bits used to represent each audio sample in a recording. (e.g. 16 bits, 24 bits).
    • Sampling Rate - the frequency of audio sampling per second, affecting audio quality. Higher rates mean better quality (e.g. 44.1 kHz, 192 kHz).
  • POD - is this item suitable for Print on Demand? Select true or false.
  • Page width - the width of the page in millimeters
  • Page height - the height of the page in millimeters
  • Scale - the sale of the page as a percentage
  • Orientation - the direction in which a document is printed or displayed (Portrait or Landscape)
  • Page Count - the number of printed pages
  • Color Model - the color model of the document (RGB or CMYK)
  • Fonts - this section gives information about the fonts used in this document
    • Name - the name of the front (optional)
    • Type - type of the font (optional)
  • Edge Space - information about the edge space of this document
    • Top - the space at the top of the pages.
    • Bottom - the space at the bottom of the pages.
    • Inside - the space on the inside of each page.
    • Outside - the space on the outside of each page.

Braille Format

  • Contracted - does the braille transliteration process include contractions? Select true or false.
  • Liblouis version - the version of Liblouis used for Braille conversion
  • Hyphenation dictionary
    • Source -  upload the hyphenation dictionary to include with your content
    • Name -  the version of Liblouis used for Braille conversion
  • Number sign 
    • Character - the symbol used to prefix numbers
    • Use in margin - select ‘True’ if the number sign should be used before numbers in the margin; otherwise, select ‘False’
  • Continuous poetry
    • Start indicator - character(s) to indicate the end of a line with in a section of continuous poetry
    • Line indicator -  character(s) to indicate the end of a line within a section of continuous poetry
    • Line indicator spacing - choose line indicator spacing: never spaced from last word in line, always spaced, or only spaced if the line doesn’t end in punctuation.
    • End indicator - character(s) to indicate the end of a section of poetry
  • Content
    • Chapter number dots - select ‘Upper’ to display chapter number normally or ‘Lower’ to use lower 4 dots of braille cell
    • Display chapter heading number first - choose ‘True’ if you want to display the chapter number before the word for ‘chapter’; choose ‘False’ if you want to display the word for ‘chapter’ before the chapter number.
    • Verse separator - character(s) to insert between verses if one verse follows another on the same line.
    • Include Introductions - Select ‘True’ to include book introductions; otherwise, select ‘False.’
  • Versed paragraphs
    • Book code. Fill in the Paratext Book code or ‘all’. Click ‘add another book code’ to add multiple book codes.
  • Character styles (all items in this section are optional)
    • Emphasized word - the symbol used to prefix emphasized words.
    • Start emphasized passage - the symbol used to start an emphasized passage
    • End emphasized passage - the symbol used to end an emphasized passage
  • Footnotes
    • Caller symbol - the maximum number of characters on a line
    • Lines -  the maximum number of lines on a page
    • Default margin width (optional) - the default margin width in number of characters
    • Leave last line of verso blank - select ‘True’ if you wish to leave the last line of the verso pages blank; otherwise select ‘False.’
    • Carry lines - A heading that starts within this number of lines from the bottom of the page will be carried over to the next page
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.