docs: document setup with read-only config

[nodiscc]

Ref. #5704

I don't know what the process to update doc translations is. I could update the french docs if needed.

[codecov-io]

Codecov Report

Merging #6348 into master will increase coverage by <.01%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master    #6348      +/-   ##
==========================================
+ Coverage   38.86%   38.86%   +<.01%     
==========================================
  Files         365      365              
  Lines       51389    51389              
==========================================
+ Hits        19970    19972       +2     
+ Misses      28551    28549       -2     
  Partials     2868     2868

Impacted Files	Coverage Δ
models/repo_list.go	66.84% <0%> (-1.06%)	⬇️
routers/repo/view.go	42.07% <0%> (+0.99%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 57ecf09...08278a3. Read the comment docs.

[sapk]

@nodiscc translation of docs is done directly by updating the file. The french doc is far outdated and a refresh could really be great. Don't hesitate to ping me in your PR if you do so I would gladly review it.

[nodiscc]

@jolheiser @axifive Thank you, fixed following your review.

@sapk I will work on it, sure.

Wouldn't it make sense for the docs to use a localization system like gettext/transifex (looks like https://github.com/go-gitea/gitea/tree/master/options/locale uses https://crowdin.com/) the one already in use by gitea? Else localized docs will keep lagging behind english ones.

Untranslated/out-of-date paragraphs would simply be displayed in english.

A minimalist alternative is a small banner on all localized pages This documentation may be out of date, please refer to the [english documentation]($pagename.en-us.md) for latest information.

[jolheiser]

For consistency, should use Hugo relref function.

[jolheiser]

CI is failing.
My bad, I gave you a wrong filename. It should be command-line.md and not command-line.en-us.md

[techknowlogick]

@jolheiser updated.

[techknowlogick]

Seems build is failing from untouched pages. I wonder if version of hugo in image we use has been updated.

[sapk]

@techknowlogick I run the test on master and seems fine as the PR branch failed. It maybe related to the relative path.
I think it may need to use a relative ../usage/command-line.md or an absolute /doc/usage/command-line.md relref but that strange since it seems to work on other parts. I will try to look into it.

[sapk]

With those changes it should work.

[sapk]

It seems that for relref you need to include the language. So this should be like this.

Suggested change

If you don't want the web installer to be able to write the config file at all, it is also possible to make the config file read-only for the gitea user (owner/group `root:root`, mode `0660`), and set `INSTALL_LOCK = true`. In that case all database configuration details must be set beforehand in the config file, as well as the `SECRET_KEY` and `INTERNAL_TOKEN` values. See the [command line documentation]({{< relref "doc/usage/command-line.md" >}}) for information on using `gitea generate secret INTERNAL_TOKEN`.

If you don't want the web installer to be able to write the config file at all, it is also possible to make the config file read-only for the gitea user (owner/group `root:root`, mode `0660`), and set `INSTALL_LOCK = true`. In that case all database configuration details must be set beforehand in the config file, as well as the `SECRET_KEY` and `INTERNAL_TOKEN` values. See the [command line documentation]({{< relref "doc/usage/command-line.en-us.md" >}}) for information on using `gitea generate secret INTERNAL_TOKEN`.

And rename the file doc/usage/command-line.md to doc/usage/command-line.en-us.md