@@ -57,6 +57,68 @@ If you're not comfortable with Git, you can pitch or submit your article through
5757- Include a brief intro that tells readers what they'll learn
5858- Test any code examples before submitting
5959
60+ ## Adding Your Author Profile
61+
62+ Once you've been credited as an author, you can give yourself a richer profile page at
63+ ` /authors/<your-name>/ ` — an avatar, a tagline, social links, and a bio. Profiles are
64+ ** opt-in** : if you don't add one, your name still works as a byline exactly as before.
65+
66+ Your profile lives in a single file at ` content/authors/<slug>/_index.md ` , where ` <slug> `
67+ ** must** match your name as it appears in articles' ` authors: ` front matter (lowercased,
68+ spaces become hyphens, punctuation dropped — e.g. ` Jane Doe ` → ` jane-doe ` ). Getting the
69+ slug wrong creates a page that attaches to nothing, so let the helper script do it:
70+
71+ ``` powershell
72+ ./tools/new-author.ps1 "Jane Doe"
73+ ```
74+
75+ This scaffolds ` content/authors/jane-doe/_index.md ` with every field commented. Fill in
76+ what you want and delete the rest:
77+
78+ ``` yaml
79+ ---
80+ title : " Jane Doe" # required — keep this as your byline name
81+ preferred_name : " Jane" # optional — changes only how your name is displayed
82+ tagline : " Cloud automation, mostly."
83+ # --- Avatar (first one set wins) ---
84+ # avatar: "/images/authors/jane.jpg" # an image you host in this repo
85+ gravatar_hash : " ..." # MD5 of your lowercased email — keeps your email private
86+ # email: "jane@example.com" # convenient, but stored publicly in this repo
87+ # --- Links (full URLs) ---
88+ github : " https://github.com/janedoe"
89+ website : " https://janedoe.dev"
90+ # twitter / mastodon / linkedin / bluesky also supported
91+ ---
92+
93+ Your bio in Markdown goes here. It shows on your profile page.
94+ ```
95+
96+ ### Choosing an avatar
97+
98+ The avatar is resolved in this order: ` avatar ` → ` gravatar_hash ` → ` email ` → an
99+ auto-generated identicon. To use [ Gravatar] ( https://gravatar.com/ ) without putting your
100+ email in the repo, store the ** MD5 hash** of your lowercased email instead:
101+
102+ ``` powershell
103+ $email = "jane@example.com"
104+ [System.BitConverter]::ToString(
105+ [System.Security.Cryptography.MD5]::Create().ComputeHash(
106+ [System.Text.Encoding]::UTF8.GetBytes($email.Trim().ToLowerInvariant())
107+ )
108+ ).Replace("-", "").ToLowerInvariant()
109+ ```
110+
111+ ### Changed your name?
112+
113+ If your byline ever needs to change across all your content (and your profile URL), use:
114+
115+ ``` powershell
116+ ./tools/new-author.ps1 "Old Name" -To "New Name"
117+ ```
118+
119+ This rewrites the byline everywhere it appears and adds a redirect so your old profile
120+ URL keeps working. Open a PR with the result.
121+
60122## Submitting a Community Event
61123
62124Add your PowerShell-related event to our community calendar:
0 commit comments