1. Take Flight! Explore little-known chapters of the Christian story from far-flung destinations around the globe.

Adding Harmonies and Lectionaries to Logos

Using Personal Book Builder for Harmonies and Lectionaries.

Article Details

Platform / Device

Windows Mac OS X

Operating System

Vista (or higher) OS X 10.6.8 (or higher)


Logos 5.1+ Logos 4.6c+


Related Tutorials

1:19 Interface Overview 1:41 Sermon Starter

Related Articles

How to use Personal Book Builder Adding Sermons and Illustrations

Logos 5.1 and 4.6c introduce two new Personal Book types: Harmonies and Lectionaries. It is now possible to create your own Lectionary and Harmony resources in Logos, by adding "Dynamic Text" to your source document. If you are not familiar with Personal Books or need a refresher, visit our Personal Book training page before reading this article.

Introducing Dynamic Text

The big feature driving Lectionary and Harmony support is the addition of a {{~ {{dtext ...}} }} syntax. Dynamic text can be used for any of the Personal Book resource types. If you create a Personal Book with this document and use the “Manuscript” type, the above verse will display using your preferred Bible.

Personal Books compiled using the Lectionary and Bible Harmony resource types get some special treatment in the resource display. If you change the resource type to “Bible Harmony”, the verse should still default to your preferred Bible, but you now have a dropdown at the top of the resource panel to select any version you prefer.


The syntax for dtext is {{~ {{dtext parameters}} }} where parameters takes the form of a=x | b=y | c=z and can appear in any order. The actual parameters are: ref, res, and filter.


Required – Must be a Bible reference. The exact syntax of the reference is flexible; anything that can be parsed as a reference will work.
{{dtext ref=Bible:1 Corinthians 4:6 }}

If the ref attribute is missing, PBB will issue a warning and not interpret the tag.
{{dtext res=LLS:1.0.3}} {{dtext}}


Optional – Forces dtext to be pulled from a specific resource. E.g. (Authorized Version):
{{dtext ref= 1 Co 4:6 | res=LLS:1.0.3}}


Optional – Specifies which text and formatting are brought over. Possible values are:

  • bible-text, bible-text-plain, bible-text-paragraphed
  • bible-text-and-verses, bible-text-and-verses-paragraphed
  • bible-text-and-following-verses, bible-text-and-following-verses-paragraphed
  • text-plain, text-paragraphed

If not specified, Lectionaries will default to bible-text-and-verses-paragraphed, and Harmonies to bible-text-and-verses.

E.g. (Notice the lack of verse numbers and italics compared to above):
{{dtext ref= 1 Corinthians 4:6 | filter=bible-text-plain | res=LLS:1.0.3}}

Bible Harmony Support

Personal Books compiled as “Bible Harmony” resources will appear with the Parallel Passages section of the Passage Guide, if there are Bible milestones and Dynamic text syntax present. The Personal Book compiler looks for dtext elements that are contained within tables or consecutive paragraphs and creates a parallel out of them.

For example, if you compile this book as a harmony, and open a [[passage guide to Matthew 3:1 >> logos4:Guide;t=Passage_Guide;ref=BibleESV.Mt3.1]], this comparison should show up:

[[@Mark 1:2-6]]Mark 1:2-6 [[@Matthew 3:1-6]]Matthew 3:1-6 [[@Luke 3:3-6]]Luke 3:3-6
{{dtext ref=Mk1.2-6}} {{dtext ref=Mt3.1-6}} {{dtext ref=Lk3.3-6}}

You will likely need to click the “more” link or prioritize this book in your library to see it.

Lectionary Support

The Dynamic text syntax can also be used for Lectionaries. For example, if you change the resource type of this document to Lectionary and recompile, the dynamic resource picker will display in the resource panel for this book.

[[@YearMonthDay:Feb 27, 2013]]

{{field-on:date}}Some Date{{field-off:date}}{{field-on:season}}The season{{field-off:season}}

{{field-on:day}}The day{{field-off:day}} {{field-on:year}}the year{{field-off:year}}

{{field-on:reading}}Psalm 25:1-3{{field-off:reading}} {{dtext ref=Ps 25:1-3}}

{{field-on:reading}}Exodus 20:1-6{{field-off:reading}} {{dtext ref=Ex 20:1-6}}

Last Updated: 9/29/2014