]> gitweb.ps.run Git - ps-cgit/blobdiff - cgitrc.5.txt
git: update to v2.39.1
[ps-cgit] / cgitrc.5.txt
index 4ad3e6444613b0592f8133f0e2196af61c8eac4b..6f3e9520c76b490756fe4096122ca07bc5efdca1 100644 (file)
@@ -126,7 +126,8 @@ commit-sort::
 
 css::
        Url which specifies the css document to include in all cgit pages.
-       Default value: "/cgit.css".
+       Default value: "/cgit.css".  May be given multiple times, each
+       css URL path is added in the head section of the document in turn.
 
 email-filter::
        Specifies a command which will be invoked to format names and email
@@ -238,6 +239,11 @@ include::
        Name of a configfile to include before the rest of the current config-
        file is parsed. Default value: none. See also: "MACRO EXPANSION".
 
+js::
+       Url which specifies the javascript script document to include in all cgit
+       pages.  Default value: "/cgit.js".  Setting this to an empty string will
+       disable generation of the link to this file in the head section.
+
 local-time::
        Flag which, if set to "1", makes cgit print commit and tag times in the
        servers timezone. Default value: "0".
@@ -269,7 +275,8 @@ max-message-length::
 
 max-repo-count::
        Specifies the number of entries to list per page on the repository
-       index page. Default value: "50".
+       index page. The value "0" shows all repositories without limitation.
+       Default value: "50".
 
 max-repodesc-length::
        Specifies the maximum number of repo description characters to display
@@ -407,9 +414,12 @@ side-by-side-diffs::
 snapshots::
        Text which specifies the default set of snapshot formats that cgit
        generates links for. The value is a space-separated list of zero or
-       more of the values "tar", "tar.gz", "tar.bz2", "tar.xz", "tar.lz" and
-       "zip". The special value "all" enables all snapshot formats.
-       Default value: none.
+       more of the values "tar", "tar.gz", "tar.bz2", "tar.lz", "tar.xz",
+       "tar.zst" and "zip". The special value "all" enables all snapshot
+       formats. Default value: none.
+       All compressors use default settings. Some settings can be influenced
+       with environment variables, for example set ZSTD_CLEVEL=10 in web
+       server environment for higher (but slower) zstd compression.
 
 source-filter::
        Specifies a command which will be invoked to format plaintext blobs
@@ -576,11 +586,11 @@ repo.readme::
        verbatim as the "About" page for this repo. You may also specify a
        git refspec by head or by hash by prepending the refspec followed by
        a colon. For example, "master:docs/readme.mkd". If the value begins
-       with a colon, i.e. ":docs/readme.rst", the default branch of the
-       repository will be used. Sharing any file will expose that entire
-       directory tree to the "/about/PATH" endpoints, so be sure that there
-       are no non-public files located in the same directory as the readme
-       file. Default value: <readme>.
+       with a colon, i.e. ":docs/readme.rst", the head giving in query or
+       the default branch of the repository will be used. Sharing any file
+       will expose that entire directory tree to the "/about/PATH" endpoints,
+       so be sure that there are no non-public files located in the same
+       directory as the readme file. Default value: <readme>.
 
 repo.section::
        Override the current section name for this repository. Default value: