diff --git a/Customizing/README.md b/Customizing/README.md new file mode 100644 index 000000000000..d6c9063b3437 --- /dev/null +++ b/Customizing/README.md @@ -0,0 +1,68 @@ +# Customizing + + + +1. [Introduction](#introduction) +1. [User Agreements](#user-agreements) +1. [System Language Changes](#system-language-changes) +1. [Skins and Styles](#skins-and-styles) + + + + +# Introduction + +This directory holds all customized files for this ilias installation. + +On the top level two directories may be created: ```/Customizing/global``` for global +changes and ```/Customizing/clients``` for changes that should be applied to clients. + +The clients directory holds a subdirectory for each client: + +```/Customizing/clients/``` + +At the time being, only user agreements can be offered for clients! Customized skins and languages are only supported globally. + + + +# User Agreements + +User agreement texts are stored within html files. They can be defined globally +for all clients or on a client level. + +**Global user agreements:** + +```/global/agreement/agreement_.html``` + +Example: + +```/global/agreement/agreement_fr.html``` + +**Client specific user agreements:** + +```/clients//agreement/agreement_.html``` + +Example: + +```/clients/default/agreement/agreement_fr.html``` + + + +# System Language Changes + +You may change terms used in the user interface of ILIAS. To do this, use the +same format as is used in the language files in directory ```/lang```. Store the +values to be overwritten in files ending with ```.lang.local``` and put them into +the ```/global/lang``` directory. Client specific changes are not supported yet. + +```/global/lang/ilias_.lang.local``` + +Example: + +```/global/lang/ilias_en.lang.local``` + + +# Skins and Styles + +You find all information about how to create your own skin in the +[Custom Styles](/templates/Readme.md#custom-styles) documentation. diff --git a/Customizing/README.txt b/Customizing/README.txt deleted file mode 100644 index 80c0565a87e1..000000000000 --- a/Customizing/README.txt +++ /dev/null @@ -1,75 +0,0 @@ -This directory holds all customized files for this ilias installation. - -On the top level two directories may be created: /Customizing/global for global -changes and /Customizing/clients for changes that should be applied to clients. -The clients directory holds a subdirectory for each client: -/Customizing/clients/ -At the time being, only user agreements can be offered for clients! Customized skins and languages are only supported globally. - - -1. User Agreements - -User agreement texts are stored within html files. They can be defined globally -for all clients or on a client level. - -Global user agreements: -/global/agreement/agreement_.html -E.g. /global/agreement/agreement_fr.html - -Client specific user agreements: -/clients//agreement/agreement_.html -E.g. /clients/default/agreement/agreement_fr.html - - -2. System Language Changes - -You may change terms used in the user interface of ILIAS. To do this, use the -same format as is used in the language files in directory /lang. Store the -values to be overwritten in files ending with ".lang.local" and put them into -the /global/lang directory. Client specific changes are not supported yet. - -/global/lang/ilias_.lang.local -E.g. /global/lang/ilias_en.lang.local - - -3. Skins and Styles - -Skins are applied through changes of HTML template files that are stored in the -/skin directory. Currently they can be defined only globally. - -/global/skin//tpl.xxx.html - -The skin directory must include a template.xml description file, example: - - -