2023-07-24 11:21:31 -04:00
|
|
|
---
|
|
|
|
title: 'Profile customization'
|
|
|
|
license: 'Apache-2.0'
|
2024-04-21 09:56:01 -04:00
|
|
|
origin_url: 'https://github.com/go-gitea/gitea/blob/e865de1e9d65dc09797d165a51c8e705d2a86030/docs/content/usage/profile-readme.en-us.md'
|
2023-07-24 11:21:31 -04:00
|
|
|
---
|
|
|
|
|
2024-02-24 15:20:29 -05:00
|
|
|
By default the profile page of a user (or an organization) is the list of repositories they
|
2023-07-24 11:21:31 -04:00
|
|
|
own. It is possible to customize it with a short description that
|
|
|
|
shows to the left, under their avatar. It can now be fully
|
|
|
|
personalized with a markdown file that is displayed instead of the
|
|
|
|
list of repositories.
|
|
|
|
|
2023-08-30 20:08:10 -04:00
|
|
|
![Profile page](../_images/user/profile/profile-step1.png)
|
2023-07-24 11:21:31 -04:00
|
|
|
|
|
|
|
It uses the `README.md` file from the `.profile` repository of the
|
2024-02-24 15:20:29 -05:00
|
|
|
user (or organization), if it exists.
|
2023-07-24 11:21:31 -04:00
|
|
|
|
2023-08-30 20:08:10 -04:00
|
|
|
![Profile README.md](../_images/user/profile/profile-step2.png)
|
2023-07-24 11:21:31 -04:00
|
|
|
|
2023-10-08 09:11:22 -04:00
|
|
|
Making the `.profile` repository private will hide the Profile README.
|
2024-02-04 04:24:47 -05:00
|
|
|
|
|
|
|
Rather than supporting multiple social links on the profile card, under the user
|
|
|
|
avatar, such links - including
|
|
|
|
[`rel=me`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/me)
|
|
|
|
attributes - can be placed in the `.profile` readme instead. This gives a user a
|
|
|
|
lot of flexibility on how they wish to display these links. To add a `rel=me`
|
|
|
|
attribute, the link should be written in HTML, rather than in Markdown format,
|
|
|
|
for example: `<a rel="me"
|
|
|
|
href="https://social.example.com/@username">Fediverse</a>`.
|