Smart Title Script

Thanks @joaquinm13464128, it's always a good idea to post a link to the original script, so people can see where it came from, and a nice courtesy to include the author's name if posting the script listing.

I have added a new function that finds multiple paragraph styles, and also streamlined the changeToTitleCase function. I realised there wasn't much sense in having the distinction between "ignore" words and "intCap" words and it was simpler to just have a list of "overrides". If the word is found in the overrides list, then that is how it should be capitalized (unless first word in paragraph). I have left a visual distinction in the array literal so you can see the split between "a, and, the" etc and "PineRidge, VAT" etc, but these are the same for the script's purpose.

See how this goes for you. You may have to expand the overrides list quite a bit.

- Mark

function main() {

    // the paragraph style names
    var styleNames = [
        'Heading 1',
        'Heading 2',
        'Heading 3',
        'Heading 4'
    ];

    // gather all the paragraphs in these styles
    var found = findTextInParagraphStyles(app.activeDocument, styleNames);

    // change them all to Title Case
    for (var i = 0; i < found.length; i++)
        changeToTitleCase(found[i]);


    /**
     * Find text set in all multiple
     * paragraph styles.
     * @author m1b
     * @version 2022-10-16
     * @param {Document|Page|Story} findWhere - any Indesign Object with a findGrep method.
     * @param {Array<String>} styleNames - the paragraph style names to find.
     * @returns {Array<Paragraph>}
     */
    function findTextInParagraphStyles(findWhere, styleNames) {

        if (styleNames.constructor.name == 'String')
            styleNames = [styleNames];

        if (!findWhere.hasOwnProperty('findGrep'))
            throw Error('findTextInParagraphStyles cannot find in "' + findWhere + '".');

        // reset grep prefs
        app.findGrepPreferences = NothingEnum.NOTHING;
        app.changeGrepPreferences = NothingEnum.NOTHING;

        var found = [];

        for (var i = 0; i < styleNames.length; i++) {

            try {

                // find criterion
                app.findGrepPreferences.appliedParagraphStyle = styleNames[i];

                // do the find
                found = found.concat(findWhere.findGrep());

            } catch (error) {
                /* paragraph style not found */
            }

        }

        return found;

    };


    /**
     * Convert paragraph to title case
     * with some smarts.
     * @author Dave Saunders
     * @url http://jsid.blogspot.com/2005/08/script-of-day-smart-title-case.html
     * @author m1b
     * @version 2022-10-16
     * @discussion https://community.adobe.com/t5/indesign-discussions/smart-title-script/m-p/13268183
     * @param {Paragraph} para - an Indesign Paragraph.
     */
    function changeToTitleCase(para) {

        //DESCRIPTION: Converts selected text to title case smartly

        var overrides = [

            "a", "an", "and", "the", "to", "with", "in", "on", "as", "of", "or", "at", "into", "that",
            "by", "from", "their", "then", "for", "are", "not", "cannot", "be", "is", "which", "can",

            "PineRidge", "InDesign", "NJ", "UMC", "FCCLA", "SkillsUSA", "d’Oeuvres", "VAT", "VIES"

        ];

        // or by creating text files named overrides.txt in the same folder as the script

        var overrides = getOverrides(overrides);

        var words = para.words;

        for (var i = words.length - 1; i >= 0; i--) {

            var word = words[i],
                overrideIndex = isIn(overrides, word.contents);

            if (overrideIndex != -1)

                // override capitalization but do
                // capitalize first word of paragraph.

                word.contents = i == 0
                    ? initialCap(overrides[overrideIndex])
                    : overrides[overrideIndex];

            else

                word.contents = initialCap(word.contents.toLowerCase());

        }

    };

    // app.selection[0].texts[0].contents = words.join("/");

    // +++++++ Functions Start Here +++++++++++++++++++++++

    function getOverrides(theWords) {
        var myFile = File(File(getScriptPath()).parent.fsName + "/overrides.txt");
        if (!myFile.exists) { return theWords }
        // File exists, so use it instead
        myFile.open("r");
        var importedWords = myFile.read();
        myFile.close();
        return importedWords.split("\n"); // Could filter these, but what's the point?
    }

    function getScriptPath() {
        // This function returns the path to the active script, even when running ESTK
        try {
            return app.activeScript;
        } catch (e) {
            return e.fileName;
        }
    }

    function isIn(aList, aWord) {
        aWord = aWord.toLowerCase();
        for (var i = 0; aList.length > i; i++) {
            if (aList[i].toLowerCase() == aWord) {
                return i;
            }
        }
        return -1;
    }

    function initialCap(aWord) {
        if (aWord.length == 1) {
            return (aWord.toUpperCase());
        }
        return (aWord.substr(0, 1).toUpperCase() + aWord.substring(1, aWord.length));
    }

};

app.doScript(main, ScriptLanguage.JAVASCRIPT, undefined, UndoModes.ENTIRE_SCRIPT, "Find & Smart TitleCase");