Skip to content

[Docs] add explicit info about customization of homepage #8694

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Oct 28, 2019
Merged

[Docs] add explicit info about customization of homepage #8694

Changes from 7 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
dd8579f
first draft
6543 Oct 26, 2019
6b844ed
Update docs/content/doc/advanced/customizing-gitea.en-us.md
6543 Oct 26, 2019
4b928b4
Merge branch 'master' into docs_custom_startpage
6543 Oct 26, 2019
eb4063a
Merge branch 'master' into docs_custom_startpage
6543 Oct 27, 2019
ead6ac5
Merge branch 'master' into docs_custom_startpage
6543 Oct 28, 2019
591b6e6
add notice to restart
6543 Oct 28, 2019
28a7360
Merge branch 'master' into docs_custom_startpage
6543 Oct 28, 2019
7367e7b
Merge branch 'master' into docs_custom_startpage
techknowlogick Oct 28, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/content/doc/advanced/customizing-gitea.en-us.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,12 @@ matching source.
Any statement contained inside `{{` and `}}` are Gitea's template syntax and
shouldn't be touched without fully understanding these components.

### Customizing startpage / homepage

Copy [`home.tmpl`](https://github.com/go-gitea/gitea/blob/master/templates/home.tmpl) for your version of Gitea from `templates` to `custom/templates`.
Edit as you wish.
Dont forget to restart your gitea to apply the changes.

Copy link
Contributor

@jaqra jaqra Oct 28, 2019 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is that can be need to provide information about start/restart service/docker image ... ?

Edit: Because someone can try without restart service?

Copy link
Member Author

@6543 6543 Oct 28, 2019 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jaqra ?

diff --git a/docs/content/doc/advanced/customizing-gitea.en-us.md b/docs/content/doc/advanced/customizing-gitea.en-us.md
index 33e6ea8ee..362f4fb25 100644
--- a/docs/content/doc/advanced/customizing-gitea.en-us.md
+++ b/docs/content/doc/advanced/customizing-gitea.en-us.md
@@ -76,6 +76,7 @@ shouldn't be touched without fully understanding these components.
 
 Copy [`home.tmpl`](https://github.com/go-gitea/gitea/blob/master/templates/home.tmpl) for your version of Gitea from `templates` to `custom/templates`.
 Edit as you wish.
+Dont forget to restart your gitea to apply the changes.
 
 ### Adding links and tabs

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good to me. Make no sense how it is :) but others.

### Adding links and tabs

If all you want is to add extra links to the top navigation bar, or extra tabs to the repository view, you can put them in `extra_links.tmpl` and `extra_tabs.tmpl` inside your `custom/templates/custom/` directory.
Expand Down Expand Up @@ -140,7 +146,7 @@ To add a custom license, add a file with the license text to `custom/options/lic
Locales are managed via our [crowdin](https://crowdin.com/project/gitea).
You can override a locale by placing an altered locale file in `custom/options/locale`.
Gitea's default locale files can be found in the [`options/locale`](https://github.com/go-gitea/gitea/tree/master/options/locale) source folder and these should be used as examples for your changes.

To add a completely new locale, as well as placing the file in the above location, you will need to add the new lang and name to the `[i18n]` section in your `app.ini`. Keep in mind that Gitea will use those settings as **overrides**, so if you want to keep the other languages as well you will need to copy/paste the default values and add your own to them.

```
Expand Down