##// END OF EJS Templates
upstream » kallithea
RSS

Clone from https://kallithea-scm.org/repos/kallithea

TurboGears2 migration: update ini files for error email settings...
TurboGears2 migration: update ini files for error email settings Error emails are now handled by backlash, which is configured through TurboGears2's ErrorReporter. ErrorReporter expects different configuration key names than Pylons did, moreover under a new 'trace_errors' namespace. Since some of the email-related settings are shared between application and error emails, we cannot just rename the existing settings (it would be very odd to have application settings under a 'trace_errors' namespace). Requiring the user to duplicate its settings is also undesirable. Instead, use 'get' to populate the trace_errors namespace based on the existing settings we already had. Unfortunately, 'get' expects the setting to be actually present, so we need to provide an out-of-the-box value for the error-related email settings or there will be an error at startup. We use empty values because there is no realistic default value we can provide.
Mads Kiilerich - - Load All Authors

File last commit:

r6509:2c3d3009 default
r6529:b4c27fe6 default
Show More
customization.rst
50 lines | 1.7 KiB | text/x-rst | RstLexer
/ docs / usage / customization.rst
History | Annotation | Raw |Copy content |Copy permalink

Customization

There are several ways to customize Kallithea to your needs depending on what you want to achieve.

HTML/JavaScript/CSS customization

To customize the look-and-feel of the web interface (for example to add a company banner or some JavaScript widget or to tweak the CSS style definitions) you can enter HTML code (possibly with JavaScript and/or CSS) directly via the Admin > Settings > Global > HTML/JavaScript customization block.

Behavioral customization: rcextensions

Some behavioral customization can be done in Python using rcextensions, a custom Python package that can extend Kallithea functionality.

With rcextensions it's possible to add additional mappings for Whoosh indexing and statistics, to add additional code into the push/pull/create/delete repository hooks (for example to send signals to build bots such as Jenkins) and even to monkey-patch certain parts of the Kallithea source code (for example overwrite an entire function, change a global variable, ...).

To generate a skeleton extensions package, run:

gearbox make-rcext -c my.ini

This will create an rcextensions package next to the specified ini file. See the __init__.py file inside the generated rcextensions package for more details.

Behavioral customization: code changes

As Kallithea is open-source software, you can make any changes you like directly in the source code.

We encourage you to send generic improvements back to the community so that Kallithea can become better. See :ref:`contributing` for more details.