rewrite customize/readme.md

This commit is contained in:
ansuz 2016-12-28 15:33:59 +01:00
parent 13e8bf5b5e
commit c9d99f101a
1 changed files with 14 additions and 7 deletions

View File

@ -1,18 +1,25 @@
# Customizing CryptPad # Customizing CryptPad
In order allow the content of the main page to be changed and to allow site-specific changes In order allow a variety of features to be changed and to allow site-specific changes
to the pad and sheet while still keeping the git repository pristine, this directory exists to CryptPad apps while still keeping the git repository pristine, this directory exists
to allow a set of hooks to be run. to allow a set of hooks to be run.
The server is configured to check for a directory called `/customize/` and if that is not The server is configured to load files from the `/customize/` path preferentially from
found, to fallback on `/customize.dist/`. In order to customize cryptpad, please **copy** `cryptpad/customize/`, and to fall back to `cryptpad/customize.dist/` if they are not found
If you wish to customize cryptpad, please **copy**
`/customize.dist/` to `/customize` and then edit it there, this way you will still be able `/customize.dist/` to `/customize` and then edit it there, this way you will still be able
to pull from (and make pull requests to (!) the git repository. to pull from (and make pull requests to (!) the git repository.
## Files you may be interested in
* pad.js will be run whenever the (CKEditor) **pad** is loaded. * index.html is the main page
* sheet.js will be run whenever the (JQuery.sheet) **spreadsheet** is loaded. * main.js contains javascript for the home page
* index.html is the main page. * application_config.js allows you to modify settings used by the various applications
* messages.js contains functions for applying translations to various pages
* look inside `/translations/` for the rest of the files which contain translated strings
* `/share/` implements an iframe RPC which allows multiple domains to access the same localStorage
* `/src/` contains source files for html and css (in the form of html templates and .less stylesheets)
All other content which is placed in this directory will be referencable at the `/customize/` All other content which is placed in this directory will be referencable at the `/customize/`
URL location. URL location.