The Portuguese coastal capital lures savvy travelers with its inspiring architecture, lively food scene, and casual charms