[Share] Convert title field to Title Case in multiple languages

[ArthurPavezzi]

Description

Changes titles to Title Case, leaving common articles, prepositions and conjunctions in lowercase.

Works with bulk selection.

Requires the language field to work.

Event

None

Operation

Script

Data

/**
 * @name Title Case Conversion for Zotero
 * @author Arthur Pavezzi
 * @usage Converts titles to Title Case while preserving common lowercase words
 * @usage Uses Zotero's language field to determine which rules to apply
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/
 * @see https://github.com/windingwind/zotero-actions-tags/discussions/
 */

// Lists of words that should remain lowercase unless they're the first word
const lowercaseWords = {
    en: [
        "a", "an", "and", "as", "at", "but", "by", "for", "from", "in", "into", 
        "of", "on", "or", "the", "to", "with", "via"
    ],
    pt: [
        "a", "as", "o", "os", "um", "uma", "uns", "umas", "de", "do", "da", "dos", "das",
        "em", "no", "na", "nos", "nas", "por", "para", "com", "e", "mas", "ou", "que",
        "se", "ao", "aos", "à", "às", "pelo", "pela", "pelos", "pelas", "num", "numa",
        "nuns", "numas"
    ],
	es: [
        "a", "al", "ante", "bajo", "cabe", "con", "contra", "de", "del", "desde",
        "durante", "en", "entre", "hacia", "hasta", "mediante", "para", "por",
        "según", "sin", "sobre", "tras", "y", "o", "u", "e", "ni", "que", "el",
        "la", "los", "las", "un", "una", "unos", "unas"
    ]
};

let log = [];

// Get selected items
var items = Zotero.getActiveZoteroPane().getSelectedItems();

for (let item of items) {
    let title = item.getField('title');
    if (!title) continue;

    // Get language from Zotero
    let language = item.getField("language").toLowerCase();
    
    // If the language field is empty, 
    if (!language) {
        log.push("Language field empty.");
	continue;
    }

    if (!lowercaseWords[language]) {
	log.push("Language lowercase words unspecified");
	continue;
    }
    
    // Split the title into words
    let words = title.split(/\s+/);
    
    // Process each word
    let newWords = words.map((word, index) => {
        // Skip HTML tags
        if (word.includes('<')) return word;
        
        // Always capitalize first word
        if (index === 0) {
            return capitalizeFirst(word);
        }
        
        // Check if word should be lowercase
        if (lowercaseWords[language].includes(word.toLowerCase())) {
            return word.toLowerCase();
        }
        
        // Capitalize first letter of other words
        return capitalizeFirst(word);
    });

    // Join words back together
    let newTitle = newWords.join(' ');
    
    // Update if title changed
    if (newTitle !== title) {
        item.setField('title', newTitle);
        await item.saveTx();
    }
}

// Helper function to capitalize first letter
function capitalizeFirst(word) {
    if (word.length === 0) return word;
    return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
}

log.push("Script ended.");
return log;

Anything else

No response