Easy way to format my .docx file for correct import as Logos Personal Bible?

Hi all, I have several .txt files with Hebrew New Testament translations. These are ready formatted for importing to eSword and very close to what's needed for Accordance. However, if they are imported into Logos, it does not behave like a Bible.

I want to know whether there is a program or semi-automatic way to add the tags needed to make these files compatible with the Logos Bible format?

Any advice will be appreciated!

HSG+.txt

HNT+.txt

HMNT.txt

HSP-.txt

Find more posts tagged with

Files

Resources

Features

Desktop App

Comments

John

We found a way to do this with an English Bible and I documented how to do it here:

https://community.logos.com/discussion/comment/1352114#Comment_1352114

the entire thread contains a wealth of information that might be helpful, but that particular post will give you step-by-step.

I would assume it would work with languages other than English if it is formatted correctly, but I’m not sure.

LogosTester

Hi and thanks for the help so far.

I used Chat GPT and after about 10 trials it got it right.

Here is the suggested final script:

🧾 Script: TXT → Logos-ready DOCX (your final format)

# save as: make_logos_hebrew_nt.py
# usage: python make_logos_hebrew_nt.py
#
# Requirements:
#   pip install python-docx
#
# This script:
#   - Reads a text file with lines like: "Mat 1:1 TEXT..."
#   - Produces a DOCX with:
#       Matthew
#       Chapter 1
#       [@Bible:Matt 1:1 ]][[1:1 >> Matt 1:1]] {{field-on:Bible}}  TEXT  {{field-off:Bible}}
#   - Replaces a final ASCII ":" in the Hebrew TEXT with sof pasuq "׃"
#   - Makes headings LTR and verse lines RTL

from docx import Document

# ---------- CONFIG ----------

INPUT_TXT  = "HSG+.txt"                     # your source text
OUTPUT_DOCX = "HSG_headings_LTR_verses_RTL.docx"  # final Logos-ready file

# Abbreviations used in Logos references
abbr = {
    'Mat':'Matt','Mar':'Mark','Luk':'Luke','Joh':'John','Act':'Acts',
    'Rom':'Rom','1Co':'1Cor','2Co':'2Cor','Gal':'Gal','Eph':'Eph','Php':'Phil',
    'Col':'Col','1Th':'1Thess','2Th':'2Thess','1Ti':'1Tim','2Ti':'2Tim',
    'Tit':'Titus','Phm':'Phlm','Heb':'Heb','Jam':'Jas','1Pe':'1Pet','2Pe':'2Pet',
    '1Jo':'1John','2Jo':'2John','3Jo':'3John','Jud':'Jude','Rev':'Rev'
}

# English book names for headings
names = {
    'Mat':'Matthew','Mar':'Mark','Luk':'Luke','Joh':'John','Act':'Acts',
    'Rom':'Romans','1Co':'1 Corinthians','2Co':'2 Corinthians','Gal':'Galatians','Eph':'Ephesians',
    'Php':'Philippians','Col':'Colossians','1Th':'1 Thessalonians','2Th':'2 Thessalonians',
    '1Ti':'1 Timothy','2Ti':'2 Timothy','Tit':'Titus','Phm':'Philemon','Heb':'Hebrews',
    'Jam':'James','1Pe':'1 Peter','2Pe':'2 Peter','1Jo':'1 John','2Jo':'2 John',
    '3Jo':'3 John','Jud':'Jude','Rev':'Revelation'
}

HEB_COLON = "׃"  # sof pasuq (U+05C3)

# ---------- BUILD DOCX ----------

doc = Document()
current_book = None
current_chapter = None

with open(INPUT_TXT, "r", encoding="utf-8") as f:
    for raw in f:
        line = raw.strip()
        if not line:
            continue

        # Expected pattern: "Mat 1:1 TEXT..."
        try:
            ref, rest = line.split(" ", 1)
            chapverse, text = rest.split(" ", 1)
            chap, verse = chapverse.split(":")
            book = ref
        except ValueError:
            # Skip lines that don't match the reference pattern
            continue

        # New book -> Heading 1 (LTR)
        if book != current_book:
            current_book = book
            book_title = names.get(book, book)
            h1 = doc.add_heading(book_title, level=1)

            # Ensure heading is LTR
            pf = h1.paragraph_format
            for attr in ("right_to_left", "bidi", "rtl"):
                if hasattr(pf, attr):
                    setattr(pf, attr, False)

            current_chapter = None

        # New chapter -> Heading 2 (LTR)
        if chap != current_chapter:
            current_chapter = chap
            h2 = doc.add_heading(f"Chapter {chap}", level=2)

            pf = h2.paragraph_format
            for attr in ("right_to_left", "bidi", "rtl"):
                if hasattr(pf, attr):
                    setattr(pf, attr, False)

        # Prepare verse text (Hebrew) and fix final colon if needed
        # Keep any trailing spaces, only change a final ASCII ':'
        original_text = text
        stripped = original_text.rstrip()
        trailing_spaces = len(original_text) - len(stripped)

        if stripped.endswith(":"):
            stripped = stripped[:-1] + HEB_COLON

        fixed_text = stripped + (" " * trailing_spaces)

        book_ab = abbr.get(book, book)

        # Build Logos verse line EXACTLY as you wanted:
        # [@Bible:Matt 1:1 ]][[1:1 >> Matt 1:1]] {{field-on:Bible}}  TEXT  {{field-off:Bible}}
        verse_line = (
            f"[[@Bible:{book_ab} {chap}:{verse} ]][[{chap}:{verse} >> {book_ab} {chap}:{verse}]] "
            + "{{field-on:Bible}}  "
            + fixed_text
            + "  {{field-off:Bible}}"
        )

        p = doc.add_paragraph(verse_line)

        # Verse lines → RTL
        pf = p.paragraph_format
        for attr in ("right_to_left", "bidi", "rtl"):
            if hasattr(pf, attr):
                setattr(pf, attr, True)

# ---------- SAVE ----------

doc.save(OUTPUT_DOCX)
print("Saved:", OUTPUT_DOCX)

Bernhard

This tool might also have helped:

GitHub - schierlm/BibleMultiConverter: Converter written in Java to convert between different Bible program formats

LogosTester

Not sure how similar this is, but it's the final one I'm using.

from docx import Document


# Config for HMNT file

INPUT_TXT = "/mnt/data/HMNT.txt"

OUTPUT_DOCX = "/mnt/data/HMNT_headings_LTR_verses_RTL.docx"


# Abbreviations and English book names (same as previous perfect spec)

abbr = {

    'Mat':'Matt','Mar':'Mark','Luk':'Luke','Joh':'John','Act':'Acts',

    'Rom':'Rom','1Co':'1Cor','2Co':'2Cor','Gal':'Gal','Eph':'Eph','Php':'Phil',

    'Col':'Col','1Th':'1Thess','2Th':'2Thess','1Ti':'1Tim','2Ti':'2Tim',

    'Tit':'Titus','Phm':'Phlm','Heb':'Heb','Jam':'Jas','1Pe':'1Pet','2Pe':'2Pet',

    '1Jo':'1John','2Jo':'2John','3Jo':'3John','Jud':'Jude','Rev':'Rev'

}


names = {

    'Mat':'Matthew','Mar':'Mark','Luk':'Luke','Joh':'John','Act':'Acts',

    'Rom':'Romans','1Co':'1 Corinthians','2Co':'2 Corinthians','Gal':'Galatians','Eph':'Ephesians',

    'Php':'Philippians','Col':'Colossians','1Th':'1 Thessalonians','2Th':'2 Thessalonians',

    '1Ti':'1 Timothy','2Ti':'2 Timothy','Tit':'Titus','Phm':'Philemon','Heb':'Hebrews',

    'Jam':'James','1Pe':'1 Peter','2Pe':'2 Peter','1Jo':'1 John','2Jo':'2 John',

    '3Jo':'3 John','Jud':'Jude','Rev':'Revelation'

}


HEB_COLON = "׃"  # sof pasuq


doc = Document()

current_book = None

current_chapter = None


with open(INPUT_TXT, "r", encoding="utf-8") as f:

    for raw in f:

        line = raw.strip()

        if not line:

            continue


        # Skip metadata / comment / define lines

        if line.startswith("#define") or line.startswith("#") or line.startswith(";"):

            continue


        try:

            ref, rest = line.split(" ", 1)

            # Handle possible leading marker like '÷Mat'

            ref_clean = ref.lstrip("÷")

            chapverse, text = rest.split(" ", 1)

            chap, verse = chapverse.split(":", 1)

            book = ref_clean

        except ValueError:

            continue


        # New book -> Heading 1 (LTR)

        if book != current_book:

            current_book = book

            book_title = names.get(book, book)

            h1 = doc.add_heading(book_title, level=1)

            pf = h1.paragraph_format

            for attr in ("right_to_left", "bidi", "rtl"):

                if hasattr(pf, attr):

                    setattr(pf, attr, False)

            current_chapter = None


        # New chapter -> Heading 2 (LTR)

        if chap != current_chapter:

            current_chapter = chap

            h2 = doc.add_heading(f"Chapter {chap}", level=2)

            pf = h2.paragraph_format

            for attr in ("right_to_left", "bidi", "rtl"):

                if hasattr(pf, attr):

                    setattr(pf, attr, False)


        # Fix final ASCII colon at the end of the Hebrew text only

        original_text = text

        stripped = original_text.rstrip()

        trailing_spaces = len(original_text) - len(stripped)

        if stripped.endswith(":"):

            stripped = stripped[:-1] + HEB_COLON

        fixed_text = stripped + (" " * trailing_spaces)


        book_ab = abbr.get(book, book)


        verse_line = (

            f"[[@Bible:{book_ab} {chap}:{verse} ]][[{chap}:{verse} >> {book_ab} {chap}:{verse}]] "

            + "{{field-on:Bible}}  "

            + fixed_text

            + "  {{field-off:Bible}}"

        )


        p = doc.add_paragraph(verse_line)

        pf = p.paragraph_format

        for attr in ("right_to_left", "bidi", "rtl"):

            if hasattr(pf, attr):

                setattr(pf, attr, True)


doc.save(OUTPUT_DOCX)

OUTPUT_DOCX

Fabian

Hello @LogosTester

Do you have an image how it looks like in Logos?

Thanks

John

Nice. I guess to be a programmer these days you use AI to do the thinking. Not sure if I would enjoy that.

How are you running the script? Looks like either macOS or Linux?

LogosTester

https://community.logos.com/discussion/comment/1385770#Comment_1385770

Hi John, I let ChatGPT5 run the script as well. After many trials it's the script it came up with, but it can also run it somehow…

LogosTester

https://community.logos.com/discussion/comment/1385762#Comment_1385762

Hi @Fabian, I just changed the layout from alight left to align right and set the font size to 16pt before importing it:

Fabian

https://community.logos.com/discussion/comment/1385818#Comment_1385818

Thanks, I tried in the past to import Hebrew, but was not happy with the outcome. Yours looks great.