gitlab-org--gitlab-foss/doc/user/profile/preferences.md
James Ramsay 4a6ec1e034 Add readme only default project view preference
The option to choose readme only as a users default project view was
restored in !14900
2017-11-15 21:00:52 -05:00

65 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Profile preferences
A user's profile preferences page allows the user to customize various aspects
of GitLab to their liking.
To navigate to your profile's preferences, click your avatar icon in the top
right corner and select **Settings**. From there on, choose the **Preferences**
tab.
## Syntax highlighting theme
>**Note:**
GitLab uses the [rouge Ruby library][rouge] for syntax highlighting. For a
list of supported languages visit the rouge website.
Changing this setting allows you to customize the color theme when viewing any
syntax highlighted code on GitLab.
The default one is **White**, and you can choose among 5 different colors:
- White
- Dark
- Solarized light
- Solarized dark
- Monokai
## Behavior
The following settings allow you to customize the behavior of GitLab's layout
and default views of your dashboard and the projects' landing pages.
### Layout width
GitLab can be set up to use different widths depending on your liking. Choose
between the fixed (max. 1200px) and the fluid (100%) application layout.
### Default dashboard
For users who have access to a large number of projects but only keep up with a
select few, the amount of activity on the default Dashboard page can be
overwhelming. Changing this setting allows you to redefine what your default
dashboard will be.
You have 6 options here that you can use for your default dashboard view:
- Your projects (default)
- Starred projects
- Your projects' activity
- Starred projects' activity
- Your groups
- Your [Todos]
### Project home page content
The project home page content setting allows you to choose what content you want to
see on a projects home page.
You can choose between 3 options:
- Show the files and the readme (default)
- Show the readme
- Show the projects activity
[rouge]: http://rouge.jneen.net/ "Rouge website"
[todos]: ../../workflow/todos.md