[PATCH 02 of 14] docs/usage: rework and rename section 'Visual settings in admin pannel'
Thomas De Schampheleire
patrickdepinguin at gmail.com
Mon Apr 6 15:11:56 EDT 2015
# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire at gmail.com>
# Date 1427918017 -7200
# Wed Apr 01 21:53:37 2015 +0200
# Node ID af0b55a8fc5c4872b4edfde1a16b58c83b95d21e
# Parent 18ad6695a60afc378bad5ca9dd07666a5c768d36
docs/usage: rework and rename section 'Visual settings in admin pannel'
- remove trivial items that are already explained on the settings page
- rename section to reflect this new scope
- general rewording
diff --git a/docs/usage/general.rst b/docs/usage/general.rst
@@ -119,47 +119,32 @@
-Visual settings in admin pannel
+Specific features configurable in the Admin settings
+In general, the Admin settings should be self-explanatory and will not be
+described in more detail in this documentation. However, there are a few
+features that merit further explanation.
-Visualisation settings in Kallithea settings view are extra customizations
-of server behavior. There are 3 main sections in the settings.
+Repository extra fields
+In the `Visual` tab, there is an option `Use repository extra
+fields`, which allows to set custom fields for each repository in the system.
+Each new field consists of 3 attributes: ``field key``, ``field label``,
-The `Use repository extra fields` option allows to set a custom fields
-for each repository in the system. Each new field consists of 3
-attributes: ``field key``, ``field label``, ``field
-description``. Example usage of such fields would be to define company
-specific information into repositories, e.g., defining a
-``repo_manager`` key that would give info about a manager of each
-repository. There's no limit for adding custom fields. Newly created
-fields are accessible via API.
-The `Show Kallithea version` option toggles displaying the exact
-Kallithea version in the footer
-Number of items in main page dashboard before pagination is displayed.
-Show public repo icon / Show private repo icon on repositories - defines if
-public/private icons should be shown in the UI.
+Example usage of such fields would be to define company-specific information
+into repositories, e.g., defining a ``repo_manager`` key that would give info
+about a manager of each repository. There's no limit for adding custom fields.
+Newly created fields are accessible via the API.
-With this option enabled, special metatags that are recognisible by Kallithea
-will be turned into colored tags. Currently available tags are::
+In the `Visual` tab, option `Stylify recognised meta tags` will cause Kallithea
+to turn certain meta-tags, detected in repository and repository group
+descriptions, into colored tags. Currently recognised tags are::
More information about the kallithea-general