-
Identify the author folder name.
Use the English canonical name as the folder name unless the repo already uses a legacy variant that other content depends on.
-
Check whether both language folders exist.
For a normal author profile, keep matching folders under content/en/authors/ and content/zh/authors/.
-
Update both _index.md files.
Keep structure parallel while translating user-facing fields like title, role, bio, interests, education text, and long biography body.
-
Keep identifiers stable.
Do not casually rename folder names or authors values. Post, publication, and author pages may depend on them.
-
Set the correct user_groups for each language.
If the author must appear on the homepage people section, assign the matching English and Chinese group labels used by the two people widgets.
-
Maintain the avatar file.
Store the portrait in the author folder, usually as avatar.jpg. If one language tree has a portrait, the other language tree should usually have the same portrait copied as well.
-
Preserve weight semantics.
This repo uses weight for author ordering, often tied to entry year or cohort ordering. Match nearby examples instead of inventing a new ordering scheme.
-
Validate special cases.
Check for legacy folders such as Vistors or name mismatches across en and zh before renaming anything. This repo already contains some historical inconsistencies, so prefer minimal, targeted fixes.