The suicide of Seoul's mayor amid sexual harassment allegations shamed South Korea's male-dominated society and the election to replace him is now turning into a battle over women's rights.