From f954e1e47b03583e8f0c43740c5dd7acb44373bc Mon Sep 17 00:00:00 2001 From: Pepijn Over Date: Wed, 6 Aug 2014 14:27:24 +0200 Subject: [PATCH] export changes --- Makefile | 8 +++++--- docs/developers.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++- docs/faq.rst | 2 +- 3 files changed, 53 insertions(+), 5 deletions(-) diff --git a/Makefile b/Makefile index 4736e484..e536cb75 100755 --- a/Makefile +++ b/Makefile @@ -2,7 +2,7 @@ tag = $(shell git describe) export_name = phpservermon-$(tag) help: - @echo ' PHP Server Monitor - $(tag) ' + @echo ' PHP Server Monitor - $(tag) ' @echo ' - make export [tag=...] - create a new release from tag ' @echo ' - make install - install all dependencies ' @@ -16,7 +16,8 @@ export: mkdir -p ./build ./build/$(export_name) rm -rf ./build/$(export_name)/* git archive $(tag) | tar -xf - -C ./build/$(export_name)/ - find ./build/$(export_name) -name "*.php" -exec sed -i "" "s/@package_version@/$(tag)/" {} \; + #find ./build/$(export_name) -name "*.php" -exec sed -i "" "s/@package_version@/$(tag)/" {} \; # for osx + find ./build/$(export_name) -name "*.php" -exec sed -i "s/@package_version@/$(tag)/" {} \; # for linux @echo 'Testing on syntax errors (thats all the automated testing your are going to get for now..) ' find ./build/$(export_name) -name "*.php" | xargs -I file php -l file @echo 'Downloading dependencies' @@ -24,7 +25,8 @@ export: rm -f ./build/$(export_name)/composer.phar rm -f ./build/$(export_name)/composer.json rm -f ./build/$(export_name)/composer.lock - @echo 'Building HTML documentation' + @echo 'Building HTML documentation using sphinx (http://sphinx-doc.org/)' + mkdir -p ./build/$(export_name)/docs/html cd ./build/$(export_name)/docs; make BUILDDIR=. html; cd ../../../; @echo 'Cleaning up docs dir' rm -f ./build/$(export_name)/Makefile diff --git a/docs/developers.rst b/docs/developers.rst index 66c5417c..d0e8ed38 100644 --- a/docs/developers.rst +++ b/docs/developers.rst @@ -8,4 +8,50 @@ There is a master branch, which is stable and always reflects the latest release The develop branch is used for ongoing development and should not be considered stable. If you would like to contribute a patch or feature, please fork the develop branch and send a pull request. -More information can be found in the wiki at https://github.com/phpservermon/phpservermon/wiki. \ No newline at end of file +Languages ++++++++++ + +The server monitor uses language files, which are stored in the directory "src/lang". +The name of the language file consists of the language code (ISO 639-1) and the country code (ISO 3166-1), separated by an underscore. +The extension is ".lang.php". + +Locales +------- + +Each language file should contain a 'locale' key which can be used for formatting dates and times. This 'locale' key must include the locales for different server environments: + +* Linux / OS X: same as filename (language code and country code separated by underscore) +* Windows: http://msdn.microsoft.com/en-US/library/39cwe7zf%28v=vs.80%29.aspx + +For more information, see http://www.php.net/manual/en/function.setlocale.php + +Adding a new language +--------------------- + +To add a new language, follow these steps: + +* Create a new file in the directory "src/lang" named "{locale}.lang.php". +* Copy the contents of the file "en_US.lang.php" to your new file. +* Your new language should now be available on the config page. +* Translate :-) +* Please send a pull request on github (https://github.com/phpservermon/phpservermon) so it can be included in the next release :-) + + +Getting started ++++++++++++++++ + +All code related to phpservermon lives in the "psm" namespace, which can be found under "src/psm". + +The Router (https://github.com/phpservermon/phpservermon/blob/develop/src/psm/Router.class.php) is used to load the modules. +All modules are registered inside the Router class with a unique ID (see getModules()), and can either be loaded manually ($router->run('mod')), or if no module is given it will attempt to discover the module from the $_GET['mod'] var. +If no valid module or controller is found, it will fall back to the default module. + +The module var may exist of 2 parts, separated by an underscore. The first part is the ID of the module, and the second part is the ID of the controller registered in the module. +If no controller ID is found, it will attempt to load the controller with the same ID as the module. + +Examples :: + + $router->run('config'); // module ID "config" and controller ID also "config" (same as $router->run('config_config')) + $router->run('server_status'); // module ID "server" and controller ID "status" + +If the user is not logged in and login is required, it will automatically load the user login controller without throwing an error. \ No newline at end of file diff --git a/docs/faq.rst b/docs/faq.rst index efcaee55..a0c216c5 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -53,7 +53,7 @@ When using tools such as Google Analytics, the monitor requests will not show up Tools that parse your raw access logs like Awstats, will include the requests made by the monitor. To make sure these requests can be identified, the monitor uses a custom user agent, which you can usually filter out. The user agent of the monitor looks like:: -Mozilla/5.0 (compatible; phpservermon/3.0.1; +http://www.phpservermonitor.org) + Mozilla/5.0 (compatible; phpservermon/3.0.1; +http://www.phpservermonitor.org) Configuration