Added KH 3.3.0
This commit is contained in:
Deon George
69
includes/kohana/modules/userguide/README.md
Normal file
69
includes/kohana/modules/userguide/README.md
Normal file
@@ -0,0 +1,69 @@
|
||||
## What needs to be done?
|
||||
|
||||
Most articles are stubs, with a couple links to pages to be used as a reference when writing the page. The idea is to use the information on those links to help write the new ones. Some of the old userguide pages can probably be mostly copied, with a few improvements, others will be better to be completely rewritten. If you ever have questions, please feel free to jump in the kohana irc channel.
|
||||
|
||||
## Guidelines
|
||||
|
||||
Documentation should use complete sentences, good grammar, and be as clear as possible. Use lots of example code, but make sure the examples follow the Kohana conventions and style.
|
||||
|
||||
Try to commit often, with each commit only changing a file or two, rather than changing a ton of files and commiting it all at once. This will make it easier to offer feedback and merge your changes. Make sure your commit messages are clear and descriptive. Good: "Added initial draft of hello world tutorial." Bad: "working on docs".
|
||||
|
||||
If you feel a menu needs to be rearranged or a module needs new pages, please open a [bug report](http://dev.kohanaframework.org/projects/userguide3/issues/new) to discuss it.
|
||||
|
||||
## A brief explanation of how the userguide works:
|
||||
|
||||
The userguide uses [Markdown](http://daringfireball.net/projects/markdown/) and [Markdown Extra](http://michelf.com/projects/php-markdown/extra/) for the documentation. Here is a short intro to [Markdown syntax](http://kohanut.com/docs/using.markdown), as well as the [complete guide](http://daringfireball.net/projects/markdown/syntax), and the things [Markdown Extra adds](http://michelf.com/projects/php-markdown/extra/). Also read what the userguide adds to markdown at the end of this readme.
|
||||
|
||||
### Userguide pages
|
||||
|
||||
Userguide pages are in the module they apply to, in `guide/<module>`. Documentation for Kohana is in `system/guide/kohana` and documentation for orm is in `modules/orm/guide/orm`, etc.
|
||||
|
||||
Each module has an index page at `guide/<module>/index.md`.
|
||||
|
||||
Each module's menu is in `guide/<module>/menu.md`.
|
||||
|
||||
### Images
|
||||
|
||||
Any images used in the userguide pages must be in `media/guide/<module>/`. For example, if a userguide page has `` the image would be located at `media/guide/<module>/hello-world.jpg`. Images for the ORM module are in `modules/orm/media/guide/orm`, and images for the Kohana docs are in `system/media/guide/kohana`.
|
||||
|
||||
### API browser
|
||||
|
||||
The API browser is generated from the actual source code. The descriptions for classes, constants, properties, and methods is extracted from the comments and parsed in Markdown. For example if you look in the comment for [Kohana_Core::init](http://github.com/kohana/core/blob/c443c44922ef13421f4a/classes/kohana/core.php#L5) you can see a markdown list and table. These are parsed and show correctly in the API browser. `@param`, `@uses`, `@throws`, `@returns` and other tags are parsed as well.
|
||||
|
||||
# What the userguide adds to markdown:
|
||||
|
||||
In addition to the features and syntax of [Markdown](http://daringfireball.net/projects/markdown/) and [Markdown Extra](http://michelf.com/projects/php-markdown/extra/) the following apply to userguide pages and api documentation:
|
||||
|
||||
### Namespacing
|
||||
|
||||
The first thing to note is that all urls are "namespaced". The name of the module is automatically added to links and image urls, you do not need to include it. For example, to link to the hello world tutorial page from another page in the Kohana userguide, you should use `[Hello World Tutorial](tutorials/hello-world)` rather than `(kohana/tutorials/hello-world)`. To link to pages in a different section of the guide, you can use `../`, for example `[Cache](../cache/usage)`.
|
||||
|
||||
### Notes
|
||||
|
||||
If you put [!!] in front of line it will be a note, put in a box with a lightbulb.
|
||||
|
||||
[!!] This is a note.
|
||||
|
||||
### Headers automatically get IDs
|
||||
|
||||
Headers are automatically assigned an id, based on the content of the header, so each header can be linked to. You can manually assign a different id using the syntax as defined in Markdown Extra. If multiple headers have the same content, like if more than one header is "Examples", only the first will get be automatically assigned an id, so you should manually assign more descriptive ids. For example:
|
||||
|
||||
### Examples {#header-id-examples}
|
||||
|
||||
### API links
|
||||
|
||||
You can make links to the api browser by wrapping any class name in brackets. You may also include a function and it will link to that function. All of the following will link to the API browser:
|
||||
|
||||
[Request]
|
||||
[Request::factory]
|
||||
[Request::factory()]
|
||||
|
||||
If you want to have parameters, only put the brackets around the class and function (not the params), and put a backslash in front of the opening parenthesis.
|
||||
|
||||
[Kohana::$config]\('foobar','baz')
|
||||
|
||||
### Including Views
|
||||
|
||||
You may include a view by putting the name of the view in double curly brackets. **If the view is not found, no exception or error will be shown!** The curly brackets and view will simply be shown an the page as is.
|
||||
|
||||
{{some/view}}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') OR die('No direct script access.');
|
||||
|
||||
class Controller_Userguide extends Kohana_Controller_Userguide {}
|
||||
3
includes/kohana/modules/userguide/classes/Kodoc.php
Normal file
3
includes/kohana/modules/userguide/classes/Kodoc.php
Normal file
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc extends Kohana_Kodoc {}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc_Class extends Kohana_Kodoc_Class {}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc_Markdown extends Kohana_Kodoc_Markdown {}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc_Method extends Kohana_Kodoc_Method {}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc_Method_Param extends Kohana_Kodoc_Method_Param {}
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
abstract class Kodoc_Missing extends Kohana_Kodoc_Missing { }
|
||||
@@ -0,0 +1,3 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Kodoc_Property extends Kohana_Kodoc_Property {}
|
||||
@@ -0,0 +1,398 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Kohana user guide and api browser.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Controllers
|
||||
* @author Kohana Team
|
||||
*/
|
||||
abstract class Kohana_Controller_Userguide extends Controller_Template {
|
||||
|
||||
public $template = 'userguide/template';
|
||||
|
||||
// Routes
|
||||
protected $media;
|
||||
protected $api;
|
||||
protected $guide;
|
||||
|
||||
public function before()
|
||||
{
|
||||
parent::before();
|
||||
|
||||
if ($this->request->action() === 'media')
|
||||
{
|
||||
// Do not template media files
|
||||
$this->auto_render = FALSE;
|
||||
}
|
||||
else
|
||||
{
|
||||
// Grab the necessary routes
|
||||
$this->media = Route::get('docs/media');
|
||||
$this->guide = Route::get('docs/guide');
|
||||
|
||||
// Set the base URL for links and images
|
||||
Kodoc_Markdown::$base_url = URL::site($this->guide->uri()).'/';
|
||||
Kodoc_Markdown::$image_url = URL::site($this->media->uri()).'/';
|
||||
}
|
||||
|
||||
// Default show_comments to config value
|
||||
$this->template->show_comments = Kohana::$config->load('userguide.show_comments');
|
||||
}
|
||||
|
||||
// List all modules that have userguides
|
||||
public function index()
|
||||
{
|
||||
$this->template->title = "Userguide";
|
||||
$this->template->breadcrumb = array('User Guide');
|
||||
$this->template->content = View::factory('userguide/index', array('modules' => $this->_modules()));
|
||||
$this->template->menu = View::factory('userguide/menu', array('modules' => $this->_modules()));
|
||||
|
||||
// Don't show disqus on the index page
|
||||
$this->template->show_comments = FALSE;
|
||||
}
|
||||
|
||||
// Display an error if a page isn't found
|
||||
public function error($message)
|
||||
{
|
||||
$this->response->status(404);
|
||||
$this->template->title = "Userguide - Error";
|
||||
$this->template->content = View::factory('userguide/error',array('message' => $message));
|
||||
|
||||
// Don't show disqus on error pages
|
||||
$this->template->show_comments = FALSE;
|
||||
|
||||
// If we are in a module and that module has a menu, show that
|
||||
if ($module = $this->request->param('module') AND $menu = $this->file($module.'/menu') AND Kohana::$config->load('userguide.modules.'.$module.'.enabled'))
|
||||
{
|
||||
// Namespace the markdown parser
|
||||
Kodoc_Markdown::$base_url = URL::site($this->guide->uri()).'/'.$module.'/';
|
||||
Kodoc_Markdown::$image_url = URL::site($this->media->uri()).'/'.$module.'/';
|
||||
|
||||
$this->template->menu = Kodoc_Markdown::markdown($this->_get_all_menu_markdown());
|
||||
$this->template->breadcrumb = array(
|
||||
$this->guide->uri() => 'User Guide',
|
||||
$this->guide->uri(array('module' => $module)) => Kohana::$config->load('userguide.modules.'.$module.'.name'),
|
||||
'Error'
|
||||
);
|
||||
}
|
||||
// If we are in the api browser, show the menu and show the api browser in the breadcrumbs
|
||||
else if (Route::name($this->request->route()) == 'docs/api')
|
||||
{
|
||||
$this->template->menu = Kodoc::menu();
|
||||
|
||||
// Bind the breadcrumb
|
||||
$this->template->breadcrumb = array(
|
||||
$this->guide->uri(array('page' => NULL)) => 'User Guide',
|
||||
$this->request->route()->uri() => 'API Browser',
|
||||
'Error'
|
||||
);
|
||||
}
|
||||
// Otherwise, show the userguide module menu on the side
|
||||
else
|
||||
{
|
||||
$this->template->menu = View::factory('userguide/menu',array('modules' => $this->_modules()));
|
||||
$this->template->breadcrumb = array($this->request->route()->uri() => 'User Guide','Error');
|
||||
}
|
||||
}
|
||||
|
||||
public function action_docs()
|
||||
{
|
||||
$module = $this->request->param('module');
|
||||
$page = $this->request->param('page');
|
||||
|
||||
// Trim trailing slash
|
||||
$page = rtrim($page, '/');
|
||||
|
||||
// If no module provided in the url, show the user guide index page, which lists the modules.
|
||||
if ( ! $module)
|
||||
{
|
||||
return $this->index();
|
||||
}
|
||||
|
||||
// If this module's userguide pages are disabled, show the error page
|
||||
if ( ! Kohana::$config->load('userguide.modules.'.$module.'.enabled'))
|
||||
{
|
||||
return $this->error('That module doesn\'t exist, or has userguide pages disabled.');
|
||||
}
|
||||
|
||||
// Prevent "guide/module" and "guide/module/index" from having duplicate content
|
||||
if ( $page == 'index')
|
||||
{
|
||||
return $this->error('Userguide page not found');
|
||||
}
|
||||
|
||||
// If a module is set, but no page was provided in the url, show the index page
|
||||
if ( ! $page )
|
||||
{
|
||||
$page = 'index';
|
||||
}
|
||||
|
||||
// Find the markdown file for this page
|
||||
$file = $this->file($module.'/'.$page);
|
||||
|
||||
// If it's not found, show the error page
|
||||
if ( ! $file)
|
||||
{
|
||||
return $this->error('Userguide page not found');
|
||||
}
|
||||
|
||||
// Namespace the markdown parser
|
||||
Kodoc_Markdown::$base_url = URL::site($this->guide->uri()).'/'.$module.'/';
|
||||
Kodoc_Markdown::$image_url = URL::site($this->media->uri()).'/'.$module.'/';
|
||||
|
||||
// Set the page title
|
||||
$this->template->title = $page == 'index' ? Kohana::$config->load('userguide.modules.'.$module.'.name') : $this->title($page);
|
||||
|
||||
// Parse the page contents into the template
|
||||
Kodoc_Markdown::$show_toc = true;
|
||||
$this->template->content = Kodoc_Markdown::markdown(file_get_contents($file));
|
||||
Kodoc_Markdown::$show_toc = false;
|
||||
|
||||
// Attach this module's menu to the template
|
||||
$this->template->menu = Kodoc_Markdown::markdown($this->_get_all_menu_markdown());
|
||||
|
||||
// Bind the breadcrumb
|
||||
$this->template->bind('breadcrumb', $breadcrumb);
|
||||
|
||||
// Bind the copyright
|
||||
$this->template->copyright = Kohana::$config->load('userguide.modules.'.$module.'.copyright');
|
||||
|
||||
// Add the breadcrumb trail
|
||||
$breadcrumb = array();
|
||||
$breadcrumb[$this->guide->uri()] = 'User Guide';
|
||||
$breadcrumb[$this->guide->uri(array('module' => $module))] = Kohana::$config->load('userguide.modules.'.$module.'.name');
|
||||
|
||||
// TODO try and get parent category names (from menu). Regex magic or javascript dom stuff perhaps?
|
||||
|
||||
// Only add the current page title to breadcrumbs if it isn't the index, otherwise we get repeats.
|
||||
if ($page != 'index')
|
||||
{
|
||||
$breadcrumb[] = $this->template->title;
|
||||
}
|
||||
}
|
||||
|
||||
public function action_api()
|
||||
{
|
||||
// Enable the missing class autoloader. If a class cannot be found a
|
||||
// fake class will be created that extends Kodoc_Missing
|
||||
spl_autoload_register(array('Kodoc_Missing', 'create_class'));
|
||||
|
||||
// Get the class from the request
|
||||
$class = $this->request->param('class');
|
||||
|
||||
// If no class was passed to the url, display the API index page
|
||||
if ( ! $class)
|
||||
{
|
||||
$this->template->title = 'Table of Contents';
|
||||
|
||||
$this->template->content = View::factory('userguide/api/toc')
|
||||
->set('classes', Kodoc::class_methods())
|
||||
->set('route', $this->request->route());
|
||||
}
|
||||
else
|
||||
{
|
||||
// Create the Kodoc_Class version of this class.
|
||||
$_class = Kodoc_Class::factory($class);
|
||||
|
||||
// If the class requested and the actual class name are different
|
||||
// (different case, orm vs ORM, auth vs Auth) redirect
|
||||
if ($_class->class->name != $class)
|
||||
{
|
||||
$this->request->redirect($this->request->route()->uri(array('class'=>$_class->class->name)));
|
||||
}
|
||||
|
||||
// If this classes immediate parent is Kodoc_Missing, then it should 404
|
||||
if ($_class->class->getParentClass() AND $_class->class->getParentClass()->name == 'Kodoc_Missing')
|
||||
return $this->error('That class was not found. Check your url and make sure that the module with that class is enabled.');
|
||||
|
||||
// If this classes package has been disabled via the config, 404
|
||||
if ( ! Kodoc::show_class($_class))
|
||||
return $this->error('That class is in package that is hidden. Check the <code>api_packages</code> config setting.');
|
||||
|
||||
// Everything is fine, display the class.
|
||||
$this->template->title = $class;
|
||||
|
||||
$this->template->content = View::factory('userguide/api/class')
|
||||
->set('doc', $_class)
|
||||
->set('route', $this->request->route());
|
||||
}
|
||||
|
||||
// Attach the menu to the template
|
||||
$this->template->menu = Kodoc::menu();
|
||||
|
||||
// Bind the breadcrumb
|
||||
$this->template->bind('breadcrumb', $breadcrumb);
|
||||
|
||||
// Add the breadcrumb
|
||||
$breadcrumb = array();
|
||||
$breadcrumb[$this->guide->uri(array('page' => NULL))] = 'User Guide';
|
||||
$breadcrumb[$this->request->route()->uri()] = 'API Browser';
|
||||
$breadcrumb[] = $this->template->title;
|
||||
}
|
||||
|
||||
public function action_media()
|
||||
{
|
||||
// Get the file path from the request
|
||||
$file = $this->request->param('file');
|
||||
|
||||
// Find the file extension
|
||||
$ext = pathinfo($file, PATHINFO_EXTENSION);
|
||||
|
||||
// Remove the extension from the filename
|
||||
$file = substr($file, 0, -(strlen($ext) + 1));
|
||||
|
||||
if ($file = Kohana::find_file('media/guide', $file, $ext))
|
||||
{
|
||||
// Check if the browser sent an "if-none-match: <etag>" header, and tell if the file hasn't changed
|
||||
$this->check_cache(sha1($this->request->uri()).filemtime($file));
|
||||
|
||||
// Send the file content as the response
|
||||
$this->response->body(file_get_contents($file));
|
||||
|
||||
// Set the proper headers to allow caching
|
||||
$this->response->headers('content-type', File::mime_by_ext($ext));
|
||||
$this->response->headers('last-modified', date('r', filemtime($file)));
|
||||
}
|
||||
else
|
||||
{
|
||||
// Return a 404 status
|
||||
$this->response->status(404);
|
||||
}
|
||||
}
|
||||
|
||||
public function after()
|
||||
{
|
||||
if ($this->auto_render)
|
||||
{
|
||||
// Get the media route
|
||||
$media = Route::get('docs/media');
|
||||
|
||||
// Add styles
|
||||
$this->template->styles = array(
|
||||
$media->uri(array('file' => 'css/print.css')) => 'print',
|
||||
$media->uri(array('file' => 'css/screen.css')) => 'screen',
|
||||
$media->uri(array('file' => 'css/kodoc.css')) => 'screen',
|
||||
$media->uri(array('file' => 'css/shCore.css')) => 'screen',
|
||||
$media->uri(array('file' => 'css/shThemeKodoc.css')) => 'screen',
|
||||
);
|
||||
|
||||
// Add scripts
|
||||
$this->template->scripts = array(
|
||||
$media->uri(array('file' => 'js/jquery.min.js')),
|
||||
$media->uri(array('file' => 'js/jquery.cookie.js')),
|
||||
$media->uri(array('file' => 'js/kodoc.js')),
|
||||
// Syntax Highlighter
|
||||
$media->uri(array('file' => 'js/shCore.js')),
|
||||
$media->uri(array('file' => 'js/shBrushPhp.js')),
|
||||
);
|
||||
|
||||
// Add languages
|
||||
$this->template->translations = Kohana::message('userguide', 'translations');
|
||||
}
|
||||
|
||||
return parent::after();
|
||||
}
|
||||
|
||||
/**
|
||||
* Locates the appropriate markdown file for a given guide page. Page URLS
|
||||
* can be specified in one of three forms:
|
||||
*
|
||||
* * userguide/adding
|
||||
* * userguide/adding.md
|
||||
* * userguide/adding.markdown
|
||||
*
|
||||
* In every case, the userguide will search the cascading file system paths
|
||||
* for the file guide/userguide/adding.md.
|
||||
*
|
||||
* @param string $page The relative URL of the guide page
|
||||
* @return string
|
||||
*/
|
||||
public function file($page)
|
||||
{
|
||||
|
||||
// Strip optional .md or .markdown suffix from the passed filename
|
||||
$info = pathinfo($page);
|
||||
if (isset($info['extension'])
|
||||
AND (($info['extension'] === 'md') OR ($info['extension'] === 'markdown')))
|
||||
{
|
||||
$page = $info['dirname'].DIRECTORY_SEPARATOR.$info['filename'];
|
||||
}
|
||||
return Kohana::find_file('guide', $page, 'md');
|
||||
}
|
||||
|
||||
public function section($page)
|
||||
{
|
||||
$markdown = $this->_get_all_menu_markdown();
|
||||
|
||||
if (preg_match('~\*{2}(.+?)\*{2}[^*]+\[[^\]]+\]\('.preg_quote($page).'\)~mu', $markdown, $matches))
|
||||
{
|
||||
return $matches[1];
|
||||
}
|
||||
|
||||
return $page;
|
||||
}
|
||||
|
||||
public function title($page)
|
||||
{
|
||||
$markdown = $this->_get_all_menu_markdown();
|
||||
|
||||
if (preg_match('~\[([^\]]+)\]\('.preg_quote($page).'\)~mu', $markdown, $matches))
|
||||
{
|
||||
// Found a title for this link
|
||||
return $matches[1];
|
||||
}
|
||||
|
||||
return $page;
|
||||
}
|
||||
|
||||
protected function _get_all_menu_markdown()
|
||||
{
|
||||
// Only do this once per request...
|
||||
static $markdown = '';
|
||||
|
||||
if (empty($markdown))
|
||||
{
|
||||
// Get menu items
|
||||
$file = $this->file($this->request->param('module').'/menu');
|
||||
|
||||
if ($file AND $text = file_get_contents($file))
|
||||
{
|
||||
// Add spans around non-link categories. This is a terrible hack.
|
||||
//echo Debug::vars($text);
|
||||
|
||||
//$text = preg_replace('/(\s*[\-\*\+]\s*)(.*)/','$1<span>$2</span>',$text);
|
||||
$text = preg_replace('/^(\s*[\-\*\+]\s*)([^\[\]]+)$/m','$1<span>$2</span>',$text);
|
||||
//echo Debug::vars($text);
|
||||
$markdown .= $text;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
return $markdown;
|
||||
}
|
||||
|
||||
// Get the list of modules from the config, and reverses it so it displays in the order the modules are added, but move Kohana to the top.
|
||||
protected function _modules()
|
||||
{
|
||||
$modules = array_reverse(Kohana::$config->load('userguide.modules'));
|
||||
|
||||
if (isset($modules['kohana']))
|
||||
{
|
||||
$kohana = $modules['kohana'];
|
||||
unset($modules['kohana']);
|
||||
$modules = array_merge(array('kohana' => $kohana), $modules);
|
||||
}
|
||||
|
||||
// Remove modules that have been disabled via config
|
||||
foreach ($modules as $key => $value)
|
||||
{
|
||||
if ( ! Kohana::$config->load('userguide.modules.'.$key.'.enabled'))
|
||||
{
|
||||
unset($modules[$key]);
|
||||
}
|
||||
}
|
||||
|
||||
return $modules;
|
||||
}
|
||||
|
||||
} // End Userguide
|
||||
466
includes/kohana/modules/userguide/classes/Kohana/Kodoc.php
Normal file
466
includes/kohana/modules/userguide/classes/Kohana/Kodoc.php
Normal file
@@ -0,0 +1,466 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Documentation generator.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2008-2012 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc {
|
||||
|
||||
/**
|
||||
* @var string PCRE fragment for matching 'Class', 'Class::method', 'Class::method()' or 'Class::$property'
|
||||
*/
|
||||
public static $regex_class_member = '((\w++)(?:::(\$?\w++))?(?:\(\))?)';
|
||||
|
||||
/**
|
||||
* Make a class#member API link using an array of matches from [Kodoc::$regex_class_member]
|
||||
*
|
||||
* @param array $matches array( 1 => link text, 2 => class name, [3 => member name] )
|
||||
* @return string
|
||||
*/
|
||||
public static function link_class_member($matches)
|
||||
{
|
||||
$link = $matches[1];
|
||||
$class = $matches[2];
|
||||
$member = NULL;
|
||||
|
||||
if (isset($matches[3]))
|
||||
{
|
||||
// If the first char is a $ it is a property, e.g. Kohana::$base_url
|
||||
if ($matches[3][0] === '$')
|
||||
{
|
||||
$member = '#property:'.substr($matches[3], 1);
|
||||
}
|
||||
else
|
||||
{
|
||||
$member = '#'.$matches[3];
|
||||
}
|
||||
}
|
||||
|
||||
return HTML::anchor(Route::get('docs/api')->uri(array('class' => $class)).$member, $link, NULL, NULL, TRUE);
|
||||
}
|
||||
|
||||
public static function factory($class)
|
||||
{
|
||||
return new Kodoc_Class($class);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates an html list of all classes sorted by category (or package if no category)
|
||||
*
|
||||
* @return string the html for the menu
|
||||
*/
|
||||
public static function menu()
|
||||
{
|
||||
$classes = Kodoc::classes();
|
||||
|
||||
ksort($classes);
|
||||
|
||||
$menu = array();
|
||||
|
||||
$route = Route::get('docs/api');
|
||||
|
||||
foreach ($classes as $class)
|
||||
{
|
||||
if (Kodoc::is_transparent($class, $classes))
|
||||
continue;
|
||||
|
||||
$class = Kodoc_Class::factory($class);
|
||||
|
||||
// Test if we should show this class
|
||||
if ( ! Kodoc::show_class($class))
|
||||
continue;
|
||||
|
||||
$link = HTML::anchor($route->uri(array('class' => $class->class->name)), $class->class->name);
|
||||
|
||||
if (isset($class->tags['package']))
|
||||
{
|
||||
foreach ($class->tags['package'] as $package)
|
||||
{
|
||||
if (isset($class->tags['category']))
|
||||
{
|
||||
foreach ($class->tags['category'] as $category)
|
||||
{
|
||||
$menu[$package][$category][] = $link;
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
$menu[$package]['Base'][] = $link;
|
||||
}
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
$menu['[Unknown]']['Base'][] = $link;
|
||||
}
|
||||
}
|
||||
|
||||
// Sort the packages
|
||||
ksort($menu);
|
||||
|
||||
return View::factory('userguide/api/menu')
|
||||
->bind('menu', $menu);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns an array of all the classes available, built by listing all files in the classes folder.
|
||||
*
|
||||
* @param array array of files, obtained using Kohana::list_files
|
||||
* @return array an array of all the class names
|
||||
*/
|
||||
public static function classes(array $list = NULL)
|
||||
{
|
||||
if ($list === NULL)
|
||||
{
|
||||
$list = Kohana::list_files('classes');
|
||||
}
|
||||
|
||||
$classes = array();
|
||||
|
||||
// This will be used a lot!
|
||||
$ext_length = strlen(EXT);
|
||||
|
||||
foreach ($list as $name => $path)
|
||||
{
|
||||
if (is_array($path))
|
||||
{
|
||||
$classes += Kodoc::classes($path);
|
||||
}
|
||||
elseif (substr($name, -$ext_length) === EXT)
|
||||
{
|
||||
// Remove "classes/" and the extension
|
||||
$class = substr($name, 8, -$ext_length);
|
||||
|
||||
// Convert slashes to underscores
|
||||
$class = str_replace(DIRECTORY_SEPARATOR, '_', $class);
|
||||
|
||||
$classes[$class] = $class;
|
||||
}
|
||||
}
|
||||
|
||||
return $classes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all classes and methods of files in a list.
|
||||
*
|
||||
* > I personally don't like this as it was used on the index page. Way too much stuff on one page. It has potential for a package index page though.
|
||||
* > For example: class_methods( Kohana::list_files('classes/sprig') ) could make a nice index page for the sprig package in the api browser
|
||||
* > ~bluehawk
|
||||
*
|
||||
*/
|
||||
public static function class_methods(array $list = NULL)
|
||||
{
|
||||
$list = Kodoc::classes($list);
|
||||
|
||||
$classes = array();
|
||||
|
||||
foreach ($list as $class)
|
||||
{
|
||||
// Skip transparent extension classes
|
||||
if (Kodoc::is_transparent($class))
|
||||
continue;
|
||||
|
||||
$_class = new ReflectionClass($class);
|
||||
|
||||
$methods = array();
|
||||
|
||||
foreach ($_class->getMethods() as $_method)
|
||||
{
|
||||
$declares = $_method->getDeclaringClass()->name;
|
||||
|
||||
// Remove the transparent prefix from declaring classes
|
||||
if ($child = Kodoc::is_transparent($declares))
|
||||
{
|
||||
$declares = $child;
|
||||
}
|
||||
|
||||
if ($declares === $_class->name OR $declares === "Core")
|
||||
{
|
||||
$methods[] = $_method->name;
|
||||
}
|
||||
}
|
||||
|
||||
sort($methods);
|
||||
|
||||
$classes[$_class->name] = $methods;
|
||||
}
|
||||
|
||||
return $classes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate HTML for the content of a tag.
|
||||
*
|
||||
* @param string $tag Name of the tag without @
|
||||
* @param string $text Content of the tag
|
||||
* @return string HTML
|
||||
*/
|
||||
public static function format_tag($tag, $text)
|
||||
{
|
||||
if ($tag === 'license')
|
||||
{
|
||||
if (strpos($text, '://') !== FALSE)
|
||||
return HTML::anchor($text);
|
||||
}
|
||||
elseif ($tag === 'link')
|
||||
{
|
||||
$split = preg_split('/\s+/', $text, 2);
|
||||
|
||||
return HTML::anchor(
|
||||
$split[0],
|
||||
isset($split[1]) ? $split[1] : $split[0]
|
||||
);
|
||||
}
|
||||
elseif ($tag === 'copyright')
|
||||
{
|
||||
// Convert the copyright symbol
|
||||
return str_replace('(c)', '©', $text);
|
||||
}
|
||||
elseif ($tag === 'throws')
|
||||
{
|
||||
$route = Route::get('docs/api');
|
||||
|
||||
if (preg_match('/^(\w+)\W(.*)$/D', $text, $matches))
|
||||
{
|
||||
return HTML::anchor(
|
||||
$route->uri(array('class' => $matches[1])),
|
||||
$matches[1]
|
||||
).' '.$matches[2];
|
||||
}
|
||||
|
||||
return HTML::anchor(
|
||||
$route->uri(array('class' => $text)),
|
||||
$text
|
||||
);
|
||||
}
|
||||
elseif ($tag === 'see' OR $tag === 'uses')
|
||||
{
|
||||
if (preg_match('/^'.Kodoc::$regex_class_member.'/', $text, $matches))
|
||||
return Kodoc::link_class_member($matches);
|
||||
}
|
||||
|
||||
return $text;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse a comment to extract the description and the tags
|
||||
*
|
||||
* [!!] Converting the output to HTML in this method is deprecated in 3.3
|
||||
*
|
||||
* @param string $comment The DocBlock to parse
|
||||
* @param boolean $html Whether or not to convert the return values
|
||||
* to HTML (deprecated)
|
||||
* @return array array(string $description, array $tags)
|
||||
*/
|
||||
public static function parse($comment, $html = TRUE)
|
||||
{
|
||||
// Normalize all new lines to \n
|
||||
$comment = str_replace(array("\r\n", "\n"), "\n", $comment);
|
||||
|
||||
// Split into lines while capturing without leading whitespace
|
||||
preg_match_all('/^\s*\* ?(.*)\n/m', $comment, $lines);
|
||||
|
||||
// Tag content
|
||||
$tags = array();
|
||||
|
||||
/**
|
||||
* Process a tag and add it to $tags
|
||||
*
|
||||
* @param string $tag Name of the tag without @
|
||||
* @param string $text Content of the tag
|
||||
* @return void
|
||||
*/
|
||||
$add_tag = function($tag, $text) use ($html, &$tags)
|
||||
{
|
||||
// Don't show @access lines, they are shown elsewhere
|
||||
if ($tag !== 'access')
|
||||
{
|
||||
if ($html)
|
||||
{
|
||||
$text = Kodoc::format_tag($tag, $text);
|
||||
}
|
||||
|
||||
// Add the tag
|
||||
$tags[$tag][] = $text;
|
||||
}
|
||||
};
|
||||
|
||||
$comment = $tag = null;
|
||||
$end = count($lines[1]) - 1;
|
||||
|
||||
foreach ($lines[1] as $i => $line)
|
||||
{
|
||||
// Search this line for a tag
|
||||
if (preg_match('/^@(\S+)\s*(.+)?$/', $line, $matches))
|
||||
{
|
||||
if ($tag)
|
||||
{
|
||||
// Previous tag is finished
|
||||
$add_tag($tag, $text);
|
||||
}
|
||||
|
||||
$tag = $matches[1];
|
||||
$text = isset($matches[2]) ? $matches[2] : '';
|
||||
|
||||
if ($i === $end)
|
||||
{
|
||||
// No more lines
|
||||
$add_tag($tag, $text);
|
||||
}
|
||||
}
|
||||
elseif ($tag)
|
||||
{
|
||||
// This is the continuation of the previous tag
|
||||
$text .= "\n".$line;
|
||||
|
||||
if ($i === $end)
|
||||
{
|
||||
// No more lines
|
||||
$add_tag($tag, $text);
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
$comment .= "\n".$line;
|
||||
}
|
||||
}
|
||||
|
||||
$comment = trim($comment, "\n");
|
||||
|
||||
if ($comment AND $html)
|
||||
{
|
||||
// Parse the comment with Markdown
|
||||
$comment = Kodoc_Markdown::markdown($comment);
|
||||
}
|
||||
|
||||
return array($comment, $tags);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the source of a function
|
||||
*
|
||||
* @param string the filename
|
||||
* @param int start line?
|
||||
* @param int end line?
|
||||
*/
|
||||
public static function source($file, $start, $end)
|
||||
{
|
||||
if ( ! $file) return FALSE;
|
||||
|
||||
$file = file($file, FILE_IGNORE_NEW_LINES);
|
||||
|
||||
$file = array_slice($file, $start - 1, $end - $start + 1);
|
||||
|
||||
if (preg_match('/^(\s+)/', $file[0], $matches))
|
||||
{
|
||||
$padding = strlen($matches[1]);
|
||||
|
||||
foreach ($file as & $line)
|
||||
{
|
||||
$line = substr($line, $padding);
|
||||
}
|
||||
}
|
||||
|
||||
return implode("\n", $file);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test whether a class should be shown, based on the api_packages config option
|
||||
*
|
||||
* @param Kodoc_Class the class to test
|
||||
* @return bool whether this class should be shown
|
||||
*/
|
||||
public static function show_class(Kodoc_Class $class)
|
||||
{
|
||||
$api_packages = Kohana::$config->load('userguide.api_packages');
|
||||
|
||||
// If api_packages is true, all packages should be shown
|
||||
if ($api_packages === TRUE)
|
||||
return TRUE;
|
||||
|
||||
// Get the package tags for this class (as an array)
|
||||
$packages = Arr::get($class->tags, 'package', array('None'));
|
||||
|
||||
$show_this = FALSE;
|
||||
|
||||
// Loop through each package tag
|
||||
foreach ($packages as $package)
|
||||
{
|
||||
// If this package is in the allowed packages, set show this to true
|
||||
if (in_array($package, explode(',', $api_packages)))
|
||||
$show_this = TRUE;
|
||||
}
|
||||
|
||||
return $show_this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks whether a class is a transparent extension class or not.
|
||||
*
|
||||
* This method takes an optional $classes parameter, a list of all defined
|
||||
* class names. If provided, the method will return false unless the extension
|
||||
* class exists. If not, the method will only check known transparent class
|
||||
* prefixes.
|
||||
*
|
||||
* Transparent prefixes are defined in the userguide.php config file:
|
||||
*
|
||||
* 'transparent_prefixes' => array(
|
||||
* 'Kohana' => TRUE,
|
||||
* );
|
||||
*
|
||||
* Module developers can therefore add their own transparent extension
|
||||
* namespaces and exclude them from the userguide.
|
||||
*
|
||||
* @param string $class The name of the class to check for transparency
|
||||
* @param array $classes An optional list of all defined classes
|
||||
* @return false If this is not a transparent extension class
|
||||
* @return string The name of the class that extends this (in the case provided)
|
||||
* @throws InvalidArgumentException If the $classes array is provided and the $class variable is not lowercase
|
||||
*/
|
||||
public static function is_transparent($class, $classes = NULL)
|
||||
{
|
||||
|
||||
static $transparent_prefixes = NULL;
|
||||
|
||||
if ( ! $transparent_prefixes)
|
||||
{
|
||||
$transparent_prefixes = Kohana::$config->load('userguide.transparent_prefixes');
|
||||
}
|
||||
|
||||
// Split the class name at the first underscore
|
||||
$segments = explode('_',$class,2);
|
||||
|
||||
if ((count($segments) == 2) AND (isset($transparent_prefixes[$segments[0]])))
|
||||
{
|
||||
if ($segments[1] === 'Core')
|
||||
{
|
||||
// Cater for Module extends Module_Core naming
|
||||
$child_class = $segments[0];
|
||||
}
|
||||
else
|
||||
{
|
||||
// Cater for Foo extends Module_Foo naming
|
||||
$child_class = $segments[1];
|
||||
}
|
||||
|
||||
// It is only a transparent class if the unprefixed class also exists
|
||||
if ($classes AND ! isset($classes[$child_class]))
|
||||
return FALSE;
|
||||
|
||||
// Return the name of the child class
|
||||
return $child_class;
|
||||
}
|
||||
else
|
||||
{
|
||||
// Not a transparent class
|
||||
return FALSE;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
} // End Kodoc
|
||||
279
includes/kohana/modules/userguide/classes/Kohana/Kodoc/Class.php
Normal file
279
includes/kohana/modules/userguide/classes/Kohana/Kodoc/Class.php
Normal file
@@ -0,0 +1,279 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Class documentation generator.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2009-2012 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc_Class extends Kodoc {
|
||||
|
||||
/**
|
||||
* @var ReflectionClass The ReflectionClass for this class
|
||||
*/
|
||||
public $class;
|
||||
|
||||
/**
|
||||
* @var string modifiers like abstract, final
|
||||
*/
|
||||
public $modifiers;
|
||||
|
||||
/**
|
||||
* @var string description of the class from the comment
|
||||
*/
|
||||
public $description;
|
||||
|
||||
/**
|
||||
* @var array array of tags, retrieved from the comment
|
||||
*/
|
||||
public $tags = array();
|
||||
|
||||
/**
|
||||
* @var array array of this classes constants
|
||||
*/
|
||||
public $constants = array();
|
||||
|
||||
/**
|
||||
* @var array Parent classes/interfaces of this class/interface
|
||||
*/
|
||||
public $parents = array();
|
||||
|
||||
/**
|
||||
* Loads a class and uses [reflection](http://php.net/reflection) to parse
|
||||
* the class. Reads the class modifiers, constants and comment. Parses the
|
||||
* comment to find the description and tags.
|
||||
*
|
||||
* @param string class name
|
||||
* @return void
|
||||
*/
|
||||
public function __construct($class)
|
||||
{
|
||||
$this->class = new ReflectionClass($class);
|
||||
|
||||
if ($modifiers = $this->class->getModifiers())
|
||||
{
|
||||
$this->modifiers = '<small>'.implode(' ', Reflection::getModifierNames($modifiers)).'</small> ';
|
||||
}
|
||||
|
||||
$this->constants = $this->class->getConstants();
|
||||
|
||||
// If ReflectionClass::getParentClass() won't work if the class in
|
||||
// question is an interface
|
||||
if ($this->class->isInterface())
|
||||
{
|
||||
$this->parents = $this->class->getInterfaces();
|
||||
}
|
||||
else
|
||||
{
|
||||
$parent = $this->class;
|
||||
|
||||
while ($parent = $parent->getParentClass())
|
||||
{
|
||||
$this->parents[] = $parent;
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $comment = $this->class->getDocComment())
|
||||
{
|
||||
foreach ($this->parents as $parent)
|
||||
{
|
||||
if ($comment = $parent->getDocComment())
|
||||
{
|
||||
// Found a description for this class
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
list($this->description, $this->tags) = Kodoc::parse($comment, FALSE);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the constants of this class as HTML.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function constants()
|
||||
{
|
||||
$result = array();
|
||||
|
||||
foreach ($this->constants as $name => $value)
|
||||
{
|
||||
$result[$name] = Debug::vars($value);
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the description of this class as HTML. Includes a warning when the
|
||||
* class or one of its parents could not be found.
|
||||
*
|
||||
* @return string HTML
|
||||
*/
|
||||
public function description()
|
||||
{
|
||||
$result = $this->description;
|
||||
|
||||
// If this class extends Kodoc_Missing, add a warning about possible
|
||||
// incomplete documentation
|
||||
foreach ($this->parents as $parent)
|
||||
{
|
||||
if ($parent->name == 'Kodoc_Missing')
|
||||
{
|
||||
$result .= "[!!] **This class, or a class parent, could not be
|
||||
found or loaded. This could be caused by a missing
|
||||
module or other dependancy. The documentation for
|
||||
class may not be complete!**";
|
||||
}
|
||||
}
|
||||
|
||||
return Kodoc_Markdown::markdown($result);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a list of the class properties as [Kodoc_Property] objects.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function properties()
|
||||
{
|
||||
$props = $this->class->getProperties();
|
||||
|
||||
$defaults = $this->class->getDefaultProperties();
|
||||
|
||||
usort($props, array($this,'_prop_sort'));
|
||||
|
||||
foreach ($props as $key => $property)
|
||||
{
|
||||
// Create Kodoc Properties for each property
|
||||
$props[$key] = new Kodoc_Property($this->class->name, $property->name, Arr::get($defaults, $property->name));
|
||||
}
|
||||
|
||||
return $props;
|
||||
}
|
||||
|
||||
protected function _prop_sort($a, $b)
|
||||
{
|
||||
// If one property is public, and the other is not, it goes on top
|
||||
if ($a->isPublic() AND ( ! $b->isPublic()))
|
||||
return -1;
|
||||
if ($b->isPublic() AND ( ! $a->isPublic()))
|
||||
return 1;
|
||||
|
||||
// If one property is protected and the other is private, it goes on top
|
||||
if ($a->isProtected() AND $b->isPrivate())
|
||||
return -1;
|
||||
if ($b->isProtected() AND $a->isPrivate())
|
||||
return 1;
|
||||
|
||||
// Otherwise just do alphabetical
|
||||
return strcmp($a->name, $b->name);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a list of the class properties as [Kodoc_Method] objects.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function methods()
|
||||
{
|
||||
$methods = $this->class->getMethods();
|
||||
|
||||
usort($methods, array($this,'_method_sort'));
|
||||
|
||||
foreach ($methods as $key => $method)
|
||||
{
|
||||
$methods[$key] = new Kodoc_Method($this->class->name, $method->name);
|
||||
}
|
||||
|
||||
return $methods;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sort methods based on their visibility and declaring class based on:
|
||||
* - methods will be sorted public, protected, then private.
|
||||
* - methods that are declared by an ancestor will be after classes
|
||||
* declared by the current class
|
||||
* - lastly, they will be sorted alphabetically
|
||||
*
|
||||
*/
|
||||
protected function _method_sort($a, $b)
|
||||
{
|
||||
// If one method is public, and the other is not, it goes on top
|
||||
if ($a->isPublic() AND ( ! $b->isPublic()))
|
||||
return -1;
|
||||
if ($b->isPublic() AND ( ! $a->isPublic()))
|
||||
return 1;
|
||||
|
||||
// If one method is protected and the other is private, it goes on top
|
||||
if ($a->isProtected() AND $b->isPrivate())
|
||||
return -1;
|
||||
if ($b->isProtected() AND $a->isPrivate())
|
||||
return 1;
|
||||
|
||||
// The methods have the same visibility, so check the declaring class depth:
|
||||
|
||||
|
||||
/*
|
||||
echo Debug::vars('a is '.$a->class.'::'.$a->name,'b is '.$b->class.'::'.$b->name,
|
||||
'are the classes the same?', $a->class == $b->class,'if they are, the result is:',strcmp($a->name, $b->name),
|
||||
'is a this class?', $a->name == $this->class->name,-1,
|
||||
'is b this class?', $b->name == $this->class->name,1,
|
||||
'otherwise, the result is:',strcmp($a->class, $b->class)
|
||||
);
|
||||
*/
|
||||
|
||||
// If both methods are defined in the same class, just compare the method names
|
||||
if ($a->class == $b->class)
|
||||
return strcmp($a->name, $b->name);
|
||||
|
||||
// If one of them was declared by this class, it needs to be on top
|
||||
if ($a->name == $this->class->name)
|
||||
return -1;
|
||||
if ($b->name == $this->class->name)
|
||||
return 1;
|
||||
|
||||
// Otherwise, get the parents of each methods declaring class, then compare which function has more "ancestors"
|
||||
$adepth = 0;
|
||||
$bdepth = 0;
|
||||
|
||||
$parent = $a->getDeclaringClass();
|
||||
do
|
||||
{
|
||||
$adepth++;
|
||||
}
|
||||
while ($parent = $parent->getParentClass());
|
||||
|
||||
$parent = $b->getDeclaringClass();
|
||||
do
|
||||
{
|
||||
$bdepth++;
|
||||
}
|
||||
while ($parent = $parent->getParentClass());
|
||||
|
||||
return $bdepth - $adepth;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the tags of this class as HTML.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function tags()
|
||||
{
|
||||
$result = array();
|
||||
|
||||
foreach ($this->tags as $name => $set)
|
||||
{
|
||||
foreach ($set as $text)
|
||||
{
|
||||
$result[$name][] = Kodoc::format_tag($name, $text);
|
||||
}
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,289 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Custom Markdown parser for Kohana documentation.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2009-2012 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc_Markdown extends MarkdownExtra_Parser {
|
||||
|
||||
/**
|
||||
* @var string base url for links
|
||||
*/
|
||||
public static $base_url = '';
|
||||
|
||||
/**
|
||||
* @var string base url for images
|
||||
*/
|
||||
public static $image_url = '';
|
||||
|
||||
/**
|
||||
* Currently defined heading ids.
|
||||
* Used to prevent creating multiple headings with same id.
|
||||
* @var array
|
||||
*/
|
||||
protected $_heading_ids = array();
|
||||
|
||||
/**
|
||||
* @var string the generated table of contents
|
||||
*/
|
||||
protected static $_toc = "";
|
||||
|
||||
/**
|
||||
* Slightly less terrible way to make it so the TOC only shows up when we
|
||||
* want it to. set this to true to show the toc.
|
||||
*/
|
||||
public static $show_toc = false;
|
||||
|
||||
/**
|
||||
* Transform some text using [Kodoc_Markdown]
|
||||
*
|
||||
* @see Markdown()
|
||||
*
|
||||
* @param string Text to parse
|
||||
* @return string Transformed text
|
||||
*/
|
||||
public static function markdown($text)
|
||||
{
|
||||
static $instance;
|
||||
|
||||
if ($instance === NULL)
|
||||
{
|
||||
$instance = new Kodoc_Markdown;
|
||||
}
|
||||
|
||||
return $instance->transform($text);
|
||||
}
|
||||
|
||||
public function __construct()
|
||||
{
|
||||
// doImage is 10, add image url just before
|
||||
$this->span_gamut['doImageURL'] = 9;
|
||||
|
||||
// doLink is 20, add base url just before
|
||||
$this->span_gamut['doBaseURL'] = 19;
|
||||
|
||||
// Add API links
|
||||
$this->span_gamut['doAPI'] = 90;
|
||||
|
||||
// Add note spans last
|
||||
$this->span_gamut['doNotes'] = 100;
|
||||
|
||||
// Parse Kohana view inclusions at the very end
|
||||
$this->document_gamut['doIncludeViews'] = 99;
|
||||
|
||||
// Show table of contents for userguide pages
|
||||
$this->document_gamut['doTOC'] = 100;
|
||||
|
||||
// PHP4 makes me sad.
|
||||
parent::MarkdownExtra_Parser();
|
||||
}
|
||||
|
||||
/**
|
||||
* Callback for the heading setext style
|
||||
*
|
||||
* Heading 1
|
||||
* =========
|
||||
*
|
||||
* @param array Matches from regex call
|
||||
* @return string Generated html
|
||||
*/
|
||||
function _doHeaders_callback_setext($matches)
|
||||
{
|
||||
if ($matches[3] == '-' && preg_match('{^- }', $matches[1]))
|
||||
return $matches[0];
|
||||
$level = $matches[3]{0} == '=' ? 1 : 2;
|
||||
$attr = $this->_doHeaders_attr($id =& $matches[2]);
|
||||
|
||||
// Only auto-generate id if one doesn't exist
|
||||
if(empty($attr))
|
||||
$attr = ' id="'.$this->make_heading_id($matches[1]).'"';
|
||||
|
||||
// Add this header to the page toc
|
||||
$this->_add_to_toc($level,$matches[1],$this->make_heading_id($matches[1]));
|
||||
|
||||
$block = "<h$level$attr>".$this->runSpanGamut($matches[1])."</h$level>";
|
||||
return "\n" . $this->hashBlock($block) . "\n\n";
|
||||
}
|
||||
|
||||
/**
|
||||
* Callback for the heading atx style
|
||||
*
|
||||
* # Heading 1
|
||||
*
|
||||
* @param array Matches from regex call
|
||||
* @return string Generated html
|
||||
*/
|
||||
function _doHeaders_callback_atx($matches)
|
||||
{
|
||||
$level = strlen($matches[1]);
|
||||
$attr = $this->_doHeaders_attr($id =& $matches[3]);
|
||||
|
||||
// Only auto-generate id if one doesn't exist
|
||||
if(empty($attr))
|
||||
$attr = ' id="'.$this->make_heading_id($matches[2]).'"';
|
||||
|
||||
// Add this header to the page toc
|
||||
$this->_add_to_toc($level, $matches[2], $this->make_heading_id(empty($matches[3]) ? $matches[2] : $matches[3]));
|
||||
|
||||
$block = "<h$level$attr>".$this->runSpanGamut($matches[2])."</h$level>";
|
||||
return "\n" . $this->hashBlock($block) . "\n\n";
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Makes a heading id from the heading text
|
||||
* If any heading share the same name then subsequent headings will have an integer appended
|
||||
*
|
||||
* @param string The heading text
|
||||
* @return string ID for the heading
|
||||
*/
|
||||
function make_heading_id($heading)
|
||||
{
|
||||
$id = url::title($heading, '-', TRUE);
|
||||
|
||||
if(isset($this->_heading_ids[$id]))
|
||||
{
|
||||
$id .= '-';
|
||||
|
||||
$count = 0;
|
||||
|
||||
while (isset($this->_heading_ids[$id]) AND ++$count)
|
||||
{
|
||||
$id .= $count;
|
||||
}
|
||||
}
|
||||
|
||||
return $id;
|
||||
}
|
||||
|
||||
public function doIncludeViews($text)
|
||||
{
|
||||
if (preg_match_all('/{{([^\s{}]++)}}/', $text, $matches, PREG_SET_ORDER))
|
||||
{
|
||||
$replace = array();
|
||||
|
||||
$replace = array();
|
||||
|
||||
foreach ($matches as $set)
|
||||
{
|
||||
list($search, $view) = $set;
|
||||
|
||||
if (Kohana::find_file('views', $view))
|
||||
{
|
||||
try
|
||||
{
|
||||
$replace[$search] = View::factory($view)->render();
|
||||
}
|
||||
catch (Exception $e)
|
||||
{
|
||||
/**
|
||||
* Capture the exception handler output and insert it instead.
|
||||
*
|
||||
* NOTE: Is this really the correct way to handle an exception?
|
||||
*/
|
||||
$response = Kohana_exception::_handler($e);
|
||||
|
||||
$replace[$search] = $response->body();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$text = strtr($text, $replace);
|
||||
}
|
||||
|
||||
return $text;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the current base url to all local links.
|
||||
*
|
||||
* [filesystem](about.filesystem "Optional title")
|
||||
*
|
||||
* @param string span text
|
||||
* @return string
|
||||
*/
|
||||
public function doBaseURL($text)
|
||||
{
|
||||
// URLs containing "://" are left untouched
|
||||
return preg_replace('~(?<!!)(\[.+?\]\()(?!\w++://)(?!#)(\S*(?:\s*+".+?")?\))~', '$1'.Kodoc_Markdown::$base_url.'$2', $text);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the current base url to all local images.
|
||||
*
|
||||
* 
|
||||
*
|
||||
* @param string span text
|
||||
* @return string
|
||||
*/
|
||||
public function doImageURL($text)
|
||||
{
|
||||
// URLs containing "://" are left untouched
|
||||
return preg_replace('~(!\[.+?\]\()(?!\w++://)(\S*(?:\s*+".+?")?\))~', '$1'.Kodoc_Markdown::$image_url.'$2', $text);
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses links to the API browser.
|
||||
*
|
||||
* [Class_Name], [Class::method] or [Class::$property]
|
||||
*
|
||||
* @param string span text
|
||||
* @return string
|
||||
*/
|
||||
public function doAPI($text)
|
||||
{
|
||||
return preg_replace_callback('/\['.Kodoc::$regex_class_member.'\]/i', 'Kodoc::link_class_member', $text);
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrap notes in the applicable markup. Notes can contain single newlines.
|
||||
*
|
||||
* [!!] Remember the milk!
|
||||
*
|
||||
* @param string span text
|
||||
* @return string
|
||||
*/
|
||||
public function doNotes($text)
|
||||
{
|
||||
if ( ! preg_match('/^\[!!\]\s*+(.+?)(?=\n{2,}|$)/s', $text, $match))
|
||||
{
|
||||
return $text;
|
||||
}
|
||||
|
||||
return $this->hashBlock('<p class="note">'.$match[1].'</p>');
|
||||
}
|
||||
|
||||
protected function _add_to_toc($level, $name, $id)
|
||||
{
|
||||
self::$_toc[] = array(
|
||||
'level' => $level,
|
||||
'name' => $name,
|
||||
'id' => $id);
|
||||
}
|
||||
|
||||
public function doTOC($text)
|
||||
{
|
||||
// Only add the toc do userguide pages, not api since they already have one
|
||||
if (self::$show_toc AND Route::name(Request::current()->route()) == "docs/guide")
|
||||
{
|
||||
$toc = View::factory('userguide/page-toc')
|
||||
->set('array', self::$_toc)
|
||||
->render()
|
||||
;
|
||||
|
||||
if (($offset = strpos($text, '<p>')) !== FALSE)
|
||||
{
|
||||
// Insert the page TOC just before the first <p>, which every
|
||||
// Markdown page should (will?) have.
|
||||
$text = substr_replace($text, $toc, $offset, 0);
|
||||
}
|
||||
}
|
||||
|
||||
return $text;
|
||||
}
|
||||
|
||||
} // End Kodoc_Markdown
|
||||
@@ -0,0 +1,141 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Class method documentation generator.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2009 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc_Method extends Kodoc {
|
||||
|
||||
/**
|
||||
* @var ReflectionMethod The ReflectionMethod for this class
|
||||
*/
|
||||
public $method;
|
||||
|
||||
/**
|
||||
* @var array array of Kodoc_Method_Param
|
||||
*/
|
||||
public $params;
|
||||
|
||||
/**
|
||||
* @var array the things this function can return
|
||||
*/
|
||||
public $return = array();
|
||||
|
||||
/**
|
||||
* @var string the source code for this function
|
||||
*/
|
||||
public $source;
|
||||
|
||||
public function __construct($class, $method)
|
||||
{
|
||||
$this->method = new ReflectionMethod($class, $method);
|
||||
|
||||
$this->class = $parent = $this->method->getDeclaringClass();
|
||||
|
||||
if ($modifiers = $this->method->getModifiers())
|
||||
{
|
||||
$this->modifiers = '<small>'.implode(' ', Reflection::getModifierNames($modifiers)).'</small> ';
|
||||
}
|
||||
|
||||
do
|
||||
{
|
||||
if ($parent->hasMethod($method) AND $comment = $parent->getMethod($method)->getDocComment())
|
||||
{
|
||||
// Found a description for this method
|
||||
break;
|
||||
}
|
||||
}
|
||||
while ($parent = $parent->getParentClass());
|
||||
|
||||
list($this->description, $tags) = Kodoc::parse($comment);
|
||||
|
||||
if ($file = $this->class->getFileName())
|
||||
{
|
||||
$this->source = Kodoc::source($file, $this->method->getStartLine(), $this->method->getEndLine());
|
||||
}
|
||||
|
||||
if (isset($tags['param']))
|
||||
{
|
||||
$params = array();
|
||||
|
||||
foreach ($this->method->getParameters() as $i => $param)
|
||||
{
|
||||
$param = new Kodoc_Method_Param(array($this->method->class, $this->method->name),$i);
|
||||
|
||||
if (isset($tags['param'][$i]))
|
||||
{
|
||||
preg_match('/^(\S+)(?:\s*(?:\$'.$param->name.'\s*)?(.+))?$/s', $tags['param'][$i], $matches);
|
||||
|
||||
$param->type = $matches[1];
|
||||
|
||||
if (isset($matches[2]))
|
||||
{
|
||||
$param->description = ucfirst($matches[2]);
|
||||
}
|
||||
}
|
||||
$params[] = $param;
|
||||
}
|
||||
|
||||
$this->params = $params;
|
||||
|
||||
unset($tags['param']);
|
||||
}
|
||||
|
||||
if (isset($tags['return']))
|
||||
{
|
||||
foreach ($tags['return'] as $return)
|
||||
{
|
||||
if (preg_match('/^(\S*)(?:\s*(.+?))?$/', $return, $matches))
|
||||
{
|
||||
$this->return[] = array($matches[1], isset($matches[2]) ? $matches[2] : '');
|
||||
}
|
||||
}
|
||||
|
||||
unset($tags['return']);
|
||||
}
|
||||
|
||||
$this->tags = $tags;
|
||||
}
|
||||
|
||||
public function params_short()
|
||||
{
|
||||
$out = '';
|
||||
$required = TRUE;
|
||||
$first = TRUE;
|
||||
foreach ($this->params as $param)
|
||||
{
|
||||
if ($required AND $param->default AND $first)
|
||||
{
|
||||
$out .= '[ '.$param;
|
||||
$required = FALSE;
|
||||
$first = FALSE;
|
||||
}
|
||||
elseif ($required AND $param->default)
|
||||
{
|
||||
$out .= '[, '.$param;
|
||||
$required = FALSE;
|
||||
}
|
||||
elseif ($first)
|
||||
{
|
||||
$out .= $param;
|
||||
$first = FALSE;
|
||||
}
|
||||
else
|
||||
{
|
||||
$out .= ', '.$param;
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $required)
|
||||
{
|
||||
$out .= '] ';
|
||||
}
|
||||
|
||||
return $out;
|
||||
}
|
||||
|
||||
} // End Kodoc_Method
|
||||
@@ -0,0 +1,101 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Class method parameter documentation generator.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2009 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc_Method_Param extends Kodoc {
|
||||
|
||||
/**
|
||||
* @var object ReflectionParameter for this property
|
||||
*/
|
||||
public $param;
|
||||
|
||||
/**
|
||||
* @var string name of this var
|
||||
*/
|
||||
public $name;
|
||||
|
||||
/**
|
||||
* @var string variable type, retrieved from the comment
|
||||
*/
|
||||
public $type;
|
||||
|
||||
/**
|
||||
* @var string default value of this param
|
||||
*/
|
||||
public $default;
|
||||
|
||||
/**
|
||||
* @var string description of this parameter
|
||||
*/
|
||||
public $description;
|
||||
|
||||
/**
|
||||
* @var boolean is the parameter passed by reference?
|
||||
*/
|
||||
public $reference = FALSE;
|
||||
|
||||
/**
|
||||
* @var boolean is the parameter optional?
|
||||
*/
|
||||
public $optional = FALSE;
|
||||
|
||||
public function __construct($method, $param)
|
||||
{
|
||||
$this->param = new ReflectionParameter($method, $param);
|
||||
|
||||
$this->name = $this->param->name;
|
||||
|
||||
if ($this->param->isDefaultValueAvailable())
|
||||
{
|
||||
$this->default = Debug::dump($this->param->getDefaultValue());
|
||||
}
|
||||
|
||||
if ($this->param->isPassedByReference())
|
||||
{
|
||||
$this->reference = TRUE;
|
||||
}
|
||||
|
||||
if ($this->param->isOptional())
|
||||
{
|
||||
$this->optional = TRUE;
|
||||
}
|
||||
}
|
||||
|
||||
public function __toString()
|
||||
{
|
||||
$display = '';
|
||||
|
||||
if ($this->type)
|
||||
{
|
||||
$display .= '<small>'.$this->type.'</small> ';
|
||||
}
|
||||
|
||||
if ($this->reference)
|
||||
{
|
||||
$display .= '<small><abbr title="passed by reference">&</abbr></small> ';
|
||||
}
|
||||
|
||||
if ($this->description)
|
||||
{
|
||||
$display .= '<span class="param" title="'.preg_replace('/\s+/', ' ', $this->description).'">$'.$this->name.'</span> ';
|
||||
}
|
||||
else
|
||||
{
|
||||
$display .= '$'.$this->name.' ';
|
||||
}
|
||||
|
||||
if ($this->default)
|
||||
{
|
||||
$display .= '<small>= '.$this->default.'</small> ';
|
||||
}
|
||||
|
||||
return $display;
|
||||
}
|
||||
|
||||
} // End Kodoc_Method_Param
|
||||
@@ -0,0 +1,36 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Set Kodoc_Missing::create_class as an autoloading to prevent missing classes
|
||||
* from crashing the api browser. Classes that are missing a parent will
|
||||
* extend this class, and get a warning in the API browser.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Undocumented
|
||||
* @author Kohana Team
|
||||
* @since 3.0.7
|
||||
*/
|
||||
abstract class Kohana_Kodoc_Missing {
|
||||
|
||||
/**
|
||||
* Creates classes when they are otherwise not found.
|
||||
*
|
||||
* Kodoc::create_class('ThisClassDoesNotExist');
|
||||
*
|
||||
* [!!] All classes created will extend [Kodoc_Missing].
|
||||
*
|
||||
* @param string class name
|
||||
* @return boolean
|
||||
* @since 3.0.7
|
||||
*/
|
||||
public static function create_class($class)
|
||||
{
|
||||
if ( ! class_exists($class))
|
||||
{
|
||||
// Create a new missing class
|
||||
eval("class {$class} extends Kodoc_Missing {}");
|
||||
}
|
||||
|
||||
return TRUE;
|
||||
}
|
||||
|
||||
} // End Kohana_Kodoc_Missing
|
||||
@@ -0,0 +1,90 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Class property documentation generator.
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2009-2012 Kohana Team
|
||||
* @license http://kohanaphp.com/license
|
||||
*/
|
||||
class Kohana_Kodoc_Property extends Kodoc {
|
||||
|
||||
/**
|
||||
* @var object ReflectionProperty
|
||||
*/
|
||||
public $property;
|
||||
|
||||
/**
|
||||
* @var string modifiers: public, private, static, etc
|
||||
*/
|
||||
public $modifiers = 'public';
|
||||
|
||||
/**
|
||||
* @var string variable type, retrieved from the comment
|
||||
*/
|
||||
public $type;
|
||||
|
||||
/**
|
||||
* @var string value of the property
|
||||
*/
|
||||
public $value;
|
||||
|
||||
/**
|
||||
* @var string default value of the property
|
||||
*/
|
||||
public $default;
|
||||
|
||||
public function __construct($class, $property, $default = NULL)
|
||||
{
|
||||
$property = new ReflectionProperty($class, $property);
|
||||
|
||||
list($description, $tags) = Kodoc::parse($property->getDocComment());
|
||||
|
||||
$this->description = $description;
|
||||
|
||||
if ($modifiers = $property->getModifiers())
|
||||
{
|
||||
$this->modifiers = '<small>'.implode(' ', Reflection::getModifierNames($modifiers)).'</small> ';
|
||||
}
|
||||
|
||||
if (isset($tags['var']))
|
||||
{
|
||||
if (preg_match('/^(\S*)(?:\s*(.+?))?$/s', $tags['var'][0], $matches))
|
||||
{
|
||||
$this->type = $matches[1];
|
||||
|
||||
if (isset($matches[2]))
|
||||
{
|
||||
$this->description = Kodoc_Markdown::markdown($matches[2]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$this->property = $property;
|
||||
|
||||
// Show the value of static properties, but only if they are public or we are php 5.3 or higher and can force them to be accessible
|
||||
if ($property->isStatic() AND ($property->isPublic() OR version_compare(PHP_VERSION, '5.3', '>=')))
|
||||
{
|
||||
// Force the property to be accessible
|
||||
if (version_compare(PHP_VERSION, '5.3', '>='))
|
||||
{
|
||||
$property->setAccessible(TRUE);
|
||||
}
|
||||
|
||||
// Don't debug the entire object, just say what kind of object it is
|
||||
if (is_object($property->getValue($class)))
|
||||
{
|
||||
$this->value = '<pre>object '.get_class($property->getValue($class)).'()</pre>';
|
||||
}
|
||||
else
|
||||
{
|
||||
$this->value = Debug::vars($property->getValue($class));
|
||||
}
|
||||
}
|
||||
|
||||
// Store the defult property
|
||||
$this->default = Debug::vars($default);;
|
||||
}
|
||||
|
||||
} // End Kodoc_Property
|
||||
39
includes/kohana/modules/userguide/config/userguide.php
Normal file
39
includes/kohana/modules/userguide/config/userguide.php
Normal file
@@ -0,0 +1,39 @@
|
||||
<?php defined('SYSPATH') OR die('No direct access allowed.');
|
||||
|
||||
return array
|
||||
(
|
||||
// Enable the API browser. TRUE or FALSE
|
||||
'api_browser' => TRUE,
|
||||
|
||||
// Enable these packages in the API browser. TRUE for all packages, or a string of comma seperated packages, using 'None' for a class with no @package
|
||||
// Example: 'api_packages' => 'Kohana,Kohana/Database,Kohana/ORM,None',
|
||||
'api_packages' => TRUE,
|
||||
|
||||
// Enables Disqus comments on the API and User Guide pages
|
||||
'show_comments' => Kohana::$environment === Kohana::PRODUCTION,
|
||||
|
||||
// Leave this alone
|
||||
'modules' => array(
|
||||
|
||||
// This should be the path to this modules userguide pages, without the 'guide/'. Ex: '/guide/modulename/' would be 'modulename'
|
||||
'userguide' => array(
|
||||
|
||||
// Whether this modules userguide pages should be shown
|
||||
'enabled' => TRUE,
|
||||
|
||||
// The name that should show up on the userguide index page
|
||||
'name' => 'Userguide',
|
||||
|
||||
// A short description of this module, shown on the index page
|
||||
'description' => 'Documentation viewer and api generation.',
|
||||
|
||||
// Copyright message, shown in the footer for this module
|
||||
'copyright' => '© 2008–2012 Kohana Team',
|
||||
)
|
||||
),
|
||||
|
||||
// Set transparent class name segments
|
||||
'transparent_prefixes' => array(
|
||||
'Kohana' => TRUE,
|
||||
)
|
||||
);
|
||||
@@ -0,0 +1,300 @@
|
||||
# Regeln
|
||||
|
||||
Es wird dazu ermutigt, dem Kohana [Programmierstil](http://dev.kohanaframework.org/wiki/kohana2/CodingStyle) zu folgen. Dieser benutzt den [Allman/BSD](http://de.wikipedia.org/wiki/Einr%C3%BCckungsstil#Allman_.2F_BSD_.2F_.E2.80.9EEast_Coast.E2.80.9C_.2F_Horstmann)-Stil.
|
||||
|
||||
## Klassennamen und Dateilage {#classes}
|
||||
|
||||
Das automatische Laden von Klassen wird durch ihre strengen Namensregeln erm<72>glicht. Die Klassen beginnen mit einem Gro<72>buchstaben und ihre W<>rter werden durch Unterstriche getrennt. Diese sind entscheidend, an welcher Stelle die Klasse im Dateisystem gefunden wird.
|
||||
|
||||
Folgende Regeln gelten:
|
||||
|
||||
1. Binnenversalien (camelCase) sollten nicht benutzt werden, au<61>er wenn eine weitere Ordner-Ebene unerw<72>nscht ist
|
||||
2. alle Datei- und Verzeichnisnamen in Kleinbuchstaben
|
||||
3. alle Klassen werden im `classes`-Verzeichnis in jeder Ebene des [Kaskaden-Dateisystem](about.filesystem) zusammengefasst
|
||||
|
||||
[!!] Im Gegensatz zu Kohana v2.x besteht keine Unterteilung zwischen "Controllern", "Models", "Bibliotheken" und "Helfern". Alle Klassen befinden sich im "classes/"-Verzeichnis, unabh<62>ngig ob es statische "Helfer" oder Objekt-"Bibliotheken" sind. Man kann irgendeinen Klassen-Aufbau (statische Klasse, Singleton, Adapter) verwenden, den man mag.
|
||||
|
||||
## Beispiele
|
||||
|
||||
Denk daran, dass der Unterstrich in Klassennamen eine tiefere Verzeichnisebene bedeutet. Beachte folgende Beispiele:
|
||||
|
||||
Klassenname | Dateipfad
|
||||
----------------------|-------------------------------
|
||||
Controller_Template | classes/controller/template.php
|
||||
Model_User | classes/model/user.php
|
||||
Database | classes/database.php
|
||||
Database_Query | classes/database/query.php
|
||||
Form | classes/form.php
|
||||
|
||||
## Programmierstil {#coding_standards}
|
||||
|
||||
Um einen sehr konsistenten Quelltext zu produzieren, bitten wir jeden den folgenden Programmierstil so genau wie m<>glich umzusetzen.
|
||||
|
||||
### Klammerung
|
||||
|
||||
Bitte benutze den den [Allman/BSD](http://de.wikipedia.org/wiki/Einr%C3%BCckungsstil#Allman_.2F_BSD_.2F_.E2.80.9EEast_Coast.E2.80.9C_.2F_Horstmann)-Stil.
|
||||
|
||||
### Namensregeln
|
||||
|
||||
Kohana benutzt f<>r Namen Unter_striche, keine BinnenVersalien (camelCase).
|
||||
|
||||
#### Klassen
|
||||
|
||||
// Libary
|
||||
class Beer {
|
||||
|
||||
// Libary extension, uses Kohana_ prefix
|
||||
class Beer extends Kohana_Beer {
|
||||
|
||||
// Controller class, uses Controller_ prefix
|
||||
class Controller_Apple extends Controller {
|
||||
|
||||
// Model class, uses Model_ prefix
|
||||
class Model_Cheese extends Model {
|
||||
|
||||
// Helper class, cf. libary
|
||||
class peanut {
|
||||
|
||||
Benutze keine Klammern, wenn eine Klasseninstanz erstellt, aber keine Parameter <20>bergibt:
|
||||
|
||||
// Correct:
|
||||
$db = new Database;
|
||||
|
||||
// Incorrect:
|
||||
$db = new Database();
|
||||
|
||||
#### Funktionen und Methoden
|
||||
|
||||
Funktionen sollten kleingeschrieben sein und Unter_striche zur Worttrennung benutzen:
|
||||
|
||||
function drink_beverage($beverage)
|
||||
{
|
||||
|
||||
#### Variablen
|
||||
|
||||
Alle Variablen sollten ebenfalls kleingeschrieben sein und Unter_striche benutzen, keine BinnenVersalien (camelCase):
|
||||
|
||||
// Correct:
|
||||
$foo = 'bar';
|
||||
$long_example = 'uses underscores';
|
||||
|
||||
// Incorrect:
|
||||
$weDontWantThis = 'understood?';
|
||||
|
||||
### Einr<6E>ckung
|
||||
|
||||
Du musst zur Einr<6E>ckung deines Quelltextes Tabulatoren benutzen. Leerzeichen f<>r Tabellarisierung zu verwenden, ist strengstens verboten.
|
||||
|
||||
Vertikaler Abstand (bei Mehrzeiligkeit) wird mit Leerzeichen gemacht. Tabulatoren sind schlecht f<>r die vertikale Ausrichtung, weil verschiedene Leute unterschiedliche Tabulatoren-Breiten haben.
|
||||
|
||||
$text = 'this is a long text block that is wrapped. Normally, we aim for '
|
||||
. 'wrapping at 80 chars. Vertical alignment is very important for '
|
||||
. 'code readability. Remember that all indentation is done with tabs,'
|
||||
. 'but vertical alignment should be completed with spaces, after '
|
||||
. 'indenting with tabs.';
|
||||
|
||||
### Zeichenkettenverkn<6B>pfung
|
||||
|
||||
Setze keine Leerzeichen um den Verkn<6B>pfungsoperator:
|
||||
|
||||
// Correct:
|
||||
$str = 'one'.$var.'two';
|
||||
|
||||
// Incorrect:
|
||||
$str = 'one'. $var .'two';
|
||||
$str = 'one' . $var . 'two';
|
||||
|
||||
### Einzeilige Ausdr<64>cke
|
||||
|
||||
Einzeilige IF-Bedingungen sollten nur bei Anweisungen benutzt werden, die die normale Verarbeitung unterbrechen (z.B. return oder continue):
|
||||
|
||||
// Acceptable:
|
||||
if ($foo == $bar)
|
||||
return $foo;
|
||||
|
||||
if ($foo == $bar)
|
||||
continue;
|
||||
|
||||
if ($foo == $bar)
|
||||
break;
|
||||
|
||||
if ($foo == $bar)
|
||||
throw new Exception('You screwed up!');
|
||||
|
||||
// Not acceptable:
|
||||
if ($baz == $bun)
|
||||
$baz = $bar + 2;
|
||||
|
||||
### Vergleichsoperatoren
|
||||
|
||||
Bitte benutze OR and AND:
|
||||
|
||||
// Correct:
|
||||
if (($foo AND $bar) OR ($b AND $c))
|
||||
|
||||
// Incorrect:
|
||||
if (($foo && $bar) || ($b && $c))
|
||||
|
||||
Bitte benutze elseif, nicht else if:
|
||||
|
||||
// Correct:
|
||||
elseif ($bar)
|
||||
|
||||
// Incorrect:
|
||||
else if($bar)
|
||||
|
||||
### Switch structures
|
||||
|
||||
Each case, break and default should be on a separate line. The block inside a case or default must be indented by 1 tab.
|
||||
|
||||
switch ($var)
|
||||
{
|
||||
case 'bar':
|
||||
case 'foo':
|
||||
echo 'hello';
|
||||
break;
|
||||
case 1:
|
||||
echo 'one';
|
||||
break;
|
||||
default:
|
||||
echo 'bye';
|
||||
break;
|
||||
}
|
||||
|
||||
### Parentheses
|
||||
|
||||
There should be one space after statement name, followed by a parenthesis. The ! (bang) character must have a space on either side to ensure maximum readability. Except in the case of a bang or type casting, there should be no whitespace after an opening parenthesis or before a closing parenthesis.
|
||||
|
||||
// Correct:
|
||||
if ($foo == $bar)
|
||||
if ( ! $foo)
|
||||
|
||||
// Incorrect:
|
||||
if($foo == $bar)
|
||||
if(!$foo)
|
||||
if ((int) $foo)
|
||||
if ( $foo == $bar )
|
||||
if (! $foo)
|
||||
|
||||
### Ternaries
|
||||
|
||||
All ternary operations should follow a standard format. Use parentheses around expressions only, not around just variables.
|
||||
|
||||
$foo = ($bar == $foo) ? $foo : $bar;
|
||||
$foo = $bar ? $foo : $bar;
|
||||
|
||||
All comparisons and operations must be done inside of a parentheses group:
|
||||
|
||||
$foo = ($bar > 5) ? ($bar + $foo) : strlen($bar);
|
||||
|
||||
When separating complex ternaries (ternaries where the first part goes beyond ~80 chars) into multiple lines, spaces should be used to line up operators, which should be at the front of the successive lines:
|
||||
|
||||
$foo = ($bar == $foo)
|
||||
? $foo
|
||||
: $bar;
|
||||
|
||||
### Type Casting
|
||||
|
||||
Type casting should be done with spaces on each side of the cast:
|
||||
|
||||
// Correct:
|
||||
$foo = (string) $bar;
|
||||
if ( (string) $bar)
|
||||
|
||||
// Incorrect:
|
||||
$foo = (string)$bar;
|
||||
|
||||
When possible, please use type casting instead of ternary operations:
|
||||
|
||||
// Correct:
|
||||
$foo = (bool) $bar;
|
||||
|
||||
// Incorrect:
|
||||
$foo = ($bar == TRUE) ? TRUE : FALSE;
|
||||
|
||||
When casting type to integer or boolean, use the short format:
|
||||
|
||||
// Correct:
|
||||
$foo = (int) $bar;
|
||||
$foo = (bool) $bar;
|
||||
|
||||
// Incorrect:
|
||||
$foo = (integer) $bar;
|
||||
$foo = (boolean) $bar;
|
||||
|
||||
### Constants
|
||||
|
||||
Always use uppercase for constants:
|
||||
|
||||
// Correct:
|
||||
define('MY_CONSTANT', 'my_value');
|
||||
$a = TRUE;
|
||||
$b = NULL;
|
||||
|
||||
// Incorrect:
|
||||
define('MyConstant', 'my_value');
|
||||
$a = True;
|
||||
$b = null;
|
||||
|
||||
Place constant comparisons at the end of tests:
|
||||
|
||||
// Correct:
|
||||
if ($foo !== FALSE)
|
||||
|
||||
// Incorrect:
|
||||
if (FALSE !== $foo)
|
||||
|
||||
This is a slightly controversial choice, so I will explain the reasoning. If we were to write the previous example in plain English, the correct example would read:
|
||||
|
||||
if variable $foo is not exactly FALSE
|
||||
|
||||
And the incorrect example would read:
|
||||
|
||||
if FALSE is not exactly variable $foo
|
||||
|
||||
Since we are reading left to right, it simply doesn't make sense to put the constant first.
|
||||
|
||||
### Comments
|
||||
|
||||
#### One-line comments
|
||||
|
||||
Use //, preferably above the line of code you're commenting on. Leave a space after it and start with a capital. Never use #.
|
||||
|
||||
// Correct
|
||||
|
||||
//Incorrect
|
||||
// incorrect
|
||||
# Incorrect
|
||||
|
||||
### Regular expressions
|
||||
|
||||
When coding regular expressions please use PCRE rather than the POSIX flavor. PCRE is considered more powerful and faster.
|
||||
|
||||
// Correct:
|
||||
if (preg_match('/abc/i'), $str)
|
||||
|
||||
// Incorrect:
|
||||
if (eregi('abc', $str))
|
||||
|
||||
Use single quotes around your regular expressions rather than double quotes. Single-quoted strings are more convenient because of their simplicity. Unlike double-quoted strings they don't support variable interpolation nor integrated backslash sequences like \n or \t, etc.
|
||||
|
||||
// Correct:
|
||||
preg_match('/abc/', $str);
|
||||
|
||||
// Incorrect:
|
||||
preg_match("/abc/", $str);
|
||||
|
||||
When performing a regular expression search and replace, please use the $n notation for backreferences. This is preferred over \\n.
|
||||
|
||||
// Correct:
|
||||
preg_replace('/(\d+) dollar/', '$1 euro', $str);
|
||||
|
||||
// Incorrect:
|
||||
preg_replace('/(\d+) dollar/', '\\1 euro', $str);
|
||||
|
||||
Finally, please note that the $ character for matching the position at the end of the line allows for a following newline character. Use the D modifier to fix this if needed. [More info](http://blog.php-security.org/archives/76-Holes-in-most-preg_match-filters.html).
|
||||
|
||||
$str = "email@example.com\n";
|
||||
|
||||
preg_match('/^.+@.+$/', $str); // TRUE
|
||||
preg_match('/^.+@.+$/D', $str); // FALSE
|
||||
@@ -0,0 +1,15 @@
|
||||
# Was ist Kohana?
|
||||
|
||||
Kohana ist ein Open-Source-basiertes, [objektorientiertes](http://de.wikipedia.org/wiki/Objektorientierte_Programmierung) [MVC](http://de.wikipedia.org/wiki/Model_View_Controller "Model View Controller")-[Webframework](http://de.wikipedia.org/wiki/Web_Application_Framework) unter Verwendung von [PHP5](http://php.net/manual/de/intro-whatis "PHP Hypertext Preprocessor"). Es wird von Freiwilligen entwickelt, das darauf abzielt schnell, sicher und schlank zu sein.
|
||||
|
||||
[!!] Kohana ist unter der [BSD-Lizenz](http://kohanaframework.org/license) ver<65>ffentlicht, so dass man es rechtlich f<>r alle Arten von Open-Source-, kommerzieller oder privater Projekte nutzen kann.
|
||||
|
||||
## Was macht Kohana besonders?
|
||||
|
||||
Durch den einzigartigen [Dateisystem](about.filesystem)-Aufbau ist alles erweiterbar und man braucht wenige oder keine [Einstellungen](about.configuration) vornehmen. Die [Fehlerbehandlung](debugging.errors) hilft, die Fehlerquelle schnell zu finden, und die [Fehlersuche](debugging) und [Programmanalyse](debugging.profiling) erm<72>glichen einen Einblick in die Anwendung.
|
||||
|
||||
Um die Sicherheit deiner Anwendung zu unterst<73>tzen, enth<74>lt Kohana Werkzeuge f<>r [XSS-Entfernung](security.xss), [Eingabe-<2D>berpr<70>fung](security.validation), [signierte Cookies](security.cookies), [Formular](security.forms)- und [HTML](security.html)-Erstellung. Die [Datenbank](security.database)-Schicht bietet Schutz vor [SQL-Injection](http://de.wikipedia.org/wiki/SQL-Injection). Nat<61>rlich wurde der gesamte offizielle Quelltext sorgf<67>ltig geschrieben und auf Sicherheit gepr<70>ft.
|
||||
|
||||
## Diese Dokumentation ist schei<65>e!
|
||||
|
||||
Wir bem<65>hen uns um eine vollst<73>ndige Dokumentation. Wenn eine Frage trotzdem offen bleibt, versuche es beim [inoffiziellen Wiki](http://kerkness.ca/wiki/doku.php). Wenn du etwas zum Handbuch beitragen oder <20>ndern willst, erstelle bitte [eine Kopie](http://github.com/kohana/userguide), bearbeite sie und stelle eine Anfrage zur Zusammenf<6E>hrung. Falls du nicht mit git vertraut bist, kannst du auch ein [Feature-Vorschlag](http://dev.kohanaframework.org/projects/kohana3/issues) (Anmeldung erforderlich) machen.
|
||||
150
includes/kohana/modules/userguide/guide/developers.md
Normal file
150
includes/kohana/modules/userguide/guide/developers.md
Normal file
@@ -0,0 +1,150 @@
|
||||
# Distributed Source Control Management
|
||||
|
||||
Unlike SVN, git does not used a central repository. This is why git is "distributed" and SVN is
|
||||
"centralized". Although this makes git an extremely powerful system for collaborators, tracking
|
||||
changes between various collaborators can quickly become difficult as multiple forks are created.
|
||||
|
||||
Please read the following before working with this code:
|
||||
|
||||
1. [Dealing with newlines](http://github.com/guides/dealing-with-newlines-in-git)
|
||||
2. [Submitting changes from your fork](http://github.com/guides/fork-a-project-and-submit-your-modifications)
|
||||
3. [Using SSH keys with github](http://github.com/guides/how-to-not-have-to-type-your-password-for-every-push)
|
||||
|
||||
## Managing Remote Repositories
|
||||
|
||||
First, you will need to tell git about the remote repository:
|
||||
|
||||
> git remote add kohana git://github.com/kohana/kohana.git
|
||||
|
||||
This tells git about the kohana repository and gives it a name which we can use to refer to it when
|
||||
fetching changes from the repository.
|
||||
|
||||
## Developing locally
|
||||
|
||||
There are 3 branches in all the kohana repositories:
|
||||
|
||||
* **master** This branch always points to the latest release tag. In essence it points to the last stable edition of the codebase
|
||||
* **3.0.x** This is a release branch for development of the 3.0.x series, i.e. 3.0, 3.0.3, 3.0.8 etc.
|
||||
* **3.1.x** This is a release branch for development of the 3.1.x series, i.e. 3.1, 3.1.4, 3.1.14 etc.
|
||||
|
||||
To work on a specific release branch you need to check it out then check out the appropriate branches.
|
||||
Release branch names follow the same convention in both kohana/kohana and kohana/core.
|
||||
|
||||
To work on 3.0.x you'd do the following:
|
||||
|
||||
> git clone git://github.com/kohana/kohana.git
|
||||
....
|
||||
|
||||
> cd kohana
|
||||
> git submodule update --init
|
||||
....
|
||||
|
||||
> git checkout 3.0.x
|
||||
Switched to branch '3.0.x'
|
||||
> git submodule update
|
||||
|
||||
> cd system
|
||||
> git checkout 3.0.x
|
||||
# Switched to branch 3.0.x
|
||||
|
||||
It's important that you follow the last step, because unlike svn, git submodules point at a
|
||||
specific commit rather than the tip of a branch. If you cd into the system folder after
|
||||
a `git submodule update` and run `git status` you'll be told:
|
||||
|
||||
# Not currently on any branch.
|
||||
nothing to commit (working directory clean)
|
||||
|
||||
Similarly, if you want to work on modules, make sure you checkout the correct branch before you start working.
|
||||
|
||||
**IMPORTANT:** It is highly recommended that you run the unit tests whilst developing to
|
||||
ensure that any changes you make do not break the api. *See TESTING.md for more info*
|
||||
|
||||
### Creating new features
|
||||
|
||||
New features or API breaking modifications should be developed in separate branches so as to isolate them
|
||||
until they're stable and **tests have been written for the feature**.
|
||||
|
||||
The naming convention for feature branches is:
|
||||
|
||||
feature/{issue number}-{short hyphenated description}
|
||||
|
||||
// i.e.
|
||||
|
||||
feature/4045-rewriting-config-system
|
||||
|
||||
When a new feature is complete and tested it can be merged into its respective release branch using
|
||||
`git pull --no-ff`. The `--no-ff` switch is important as it tells git to always create a commit
|
||||
detailing what branch you're merging from. This makes it a lot easier to analyse a feature's history.
|
||||
|
||||
Here's a quick example:
|
||||
|
||||
> git status
|
||||
# On branch feature/4045-rewriting-everything
|
||||
|
||||
> git checkout 3.1.x
|
||||
# Switched to branch '3.1.x'
|
||||
|
||||
> git merge --no-ff feature/4045-rewriting-everything
|
||||
|
||||
**If a change you make intentionally breaks the api then please correct the relevant tests before pushing!**
|
||||
|
||||
### Bug fixing
|
||||
|
||||
If you're making a bugfix then before you start create a unit test which reproduces the bug,
|
||||
using the `@ticket` notation in the test to reference the bug's issue number
|
||||
(i.e. `@ticket 4045` for issue #4045).
|
||||
|
||||
If you run the test then the one you've just made should fail.
|
||||
|
||||
Once you've written the bugfix, run the tests again before you commit to make sure that the
|
||||
fix actually works,then commiti both the fix and the test.
|
||||
|
||||
There is no need to create separate branches for bugfixes, creating them in the main release
|
||||
branch is perfectly acceptable.
|
||||
|
||||
## Merging Changes from Remote Repositories
|
||||
|
||||
Now that you have a remote repository, you can pull changes in the remote "kohana" repository
|
||||
into your local repository:
|
||||
|
||||
> git pull kohana master
|
||||
|
||||
**Note:** Before you pull changes you should make sure that any modifications you've made locally
|
||||
have been committed.
|
||||
|
||||
Sometimes a commit you've made locally will conflict with one made in the "kohana" one.
|
||||
|
||||
There are a couple of scenarios where this might happen:
|
||||
|
||||
### The conflict is to do with a few unrelated commits and you want to keep changes made in both commits
|
||||
|
||||
You'll need to manually modify the files to resolve the conflict, see the "Resolving a merge"
|
||||
section [in the git-scm book](http://book.git-scm.com/3_basic_branching_and_merging.html) for more info
|
||||
|
||||
### You've fixed something locally which someone else has already done in the remote repo
|
||||
|
||||
The simplest way to fix this is to remove all the changes that you've made locally.
|
||||
|
||||
You can do this using
|
||||
|
||||
> git reset --hard kohana
|
||||
|
||||
### You've fixed something locally which someone else has already fixed but you also have separate commits you'd like to keep
|
||||
|
||||
If this is the case then you'll want to use a tool called rebase. First of all we need to
|
||||
get rid of the conflicts created due to the merge:
|
||||
|
||||
> git reset --hard HEAD
|
||||
|
||||
Then find the hash of the offending local commit and run:
|
||||
|
||||
> git rebase -i {offending commit hash}
|
||||
|
||||
i.e.
|
||||
|
||||
> git rebase -i 57d0b28
|
||||
|
||||
A text editor will open with a list of commits, delete the line containing the offending commit
|
||||
before saving the file & closing your editor.
|
||||
|
||||
Git will remove the commit and you can then pull/merge the remote changes.
|
||||
55
includes/kohana/modules/userguide/guide/userguide/adding.md
Normal file
55
includes/kohana/modules/userguide/guide/userguide/adding.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Adding your module to the userguide
|
||||
|
||||
Making your module work with the userguide is simple.
|
||||
|
||||
First, copy this config and place in it `<module>/config/userguide.php`, replacing anything in `<>` with the appropriate things:
|
||||
|
||||
return array
|
||||
(
|
||||
// Leave this alone
|
||||
'modules' => array(
|
||||
|
||||
// This should be the path to this modules userguide pages, without the 'guide/'. Ex: '/guide/modulename/' would be 'modulename'
|
||||
'<modulename>' => array(
|
||||
|
||||
// Whether this modules userguide pages should be shown
|
||||
'enabled' => TRUE,
|
||||
|
||||
// The name that should show up on the userguide index page
|
||||
'name' => '<Module Name>',
|
||||
|
||||
// A short description of this module, shown on the index page
|
||||
'description' => '<Description goes here.>',
|
||||
|
||||
// Copyright message, shown in the footer for this module
|
||||
'copyright' => '© 2010–2011 <Your Name>',
|
||||
)
|
||||
),
|
||||
|
||||
/*
|
||||
* If you use transparent extension outside the Kohana_ namespace,
|
||||
* add your class prefix here. Both common Kohana naming conventions are
|
||||
* excluded:
|
||||
* - Modulename extends Modulename_Core
|
||||
* - Foo extends Modulename_Foo
|
||||
*
|
||||
* For example, if you use Modulename_<class_name> for your base classes
|
||||
* then you would define:
|
||||
*/
|
||||
'transparent_prefixes' => array(
|
||||
'Modulename' => TRUE,
|
||||
)
|
||||
);
|
||||
|
||||
Next, create a folder in your module directory called `guide/<modulename>` and create `index.md` and `menu.md`. All userguide pages use [Markdown](markdown). The index page is what is shown on the index of your module, the menu is what shows up in the side column. The menu should be formatted like this:
|
||||
|
||||
## [Module Name]()
|
||||
- [Page name](page-path)
|
||||
- [This is a Category](category)
|
||||
- [Sub Page](category/sub-page)
|
||||
- [Another](category/another)
|
||||
- [Sub sub page](category/another/sub-page)
|
||||
- Categories do not have to be a link to a page
|
||||
- [Etcetera](etc)
|
||||
|
||||
Page paths are relative to `guide/<modulename>`. So `[Page name](path-path)` would look for `guide/<modulename>/page-name.md` and `[Another](category/another)` would look for `guide/<modulename>/page-name.md`. The guide pages can be named or arranged any way you want within that folder (with the exception of `menu.md` and `index.md`). The breadcrumbs and page titles are pulled from the `menu.md file`, not the file names or paths. You can have items that are not pages (a category that doesn't have a corresponding page). To link to the `index.md` page, you should have an empty link, e.g. `[Module Name]()`. Do not include `.md` in your links.
|
||||
35
includes/kohana/modules/userguide/guide/userguide/config.md
Normal file
35
includes/kohana/modules/userguide/guide/userguide/config.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# Configuration
|
||||
|
||||
The userguide has the following config options, available in `config/userguide.php`.
|
||||
|
||||
return array
|
||||
(
|
||||
// Enable the API browser. TRUE or FALSE
|
||||
'api_browser' => TRUE,
|
||||
|
||||
// Enable these packages in the API browser. TRUE for all packages, or a string of comma seperated packages, using 'None' for a class with no @package
|
||||
// Example: 'api_packages' => 'Kohana,Kohana/Database,Kohana/ORM,None',
|
||||
'api_packages' => TRUE,
|
||||
|
||||
);
|
||||
|
||||
You can enable or disable the entire API browser, or limit it to only show certain packages. To disable a module from showing pages in the userguide, simply change that module's `enabled` option using the cascading filesystem. For example:
|
||||
|
||||
`application/config/userguide.php`
|
||||
|
||||
return array
|
||||
(
|
||||
'modules' => array
|
||||
(
|
||||
'kohana' => array
|
||||
(
|
||||
'enabled' => FALSE,
|
||||
),
|
||||
'database' => array
|
||||
(
|
||||
'enabled' => FALSE,
|
||||
)
|
||||
)
|
||||
)
|
||||
|
||||
Using this you could make the userguide only show your modules and classes in the API browser, if you wanted to host your own documentation on your site. Feel free to change the styles and views as well, but be sure to give credit where credit is due!
|
||||
@@ -0,0 +1,75 @@
|
||||
# Contributing
|
||||
|
||||
Kohana is community driven, and we rely on community contributions for the documentation.
|
||||
|
||||
## Guidelines
|
||||
|
||||
Documentation should use complete sentences, good grammar, and be as clear as possible. Use lots of example code, but make sure the examples follow the Kohana conventions and style.
|
||||
|
||||
Try to commit often, with each commit only changing a file or two, rather than changing a ton of files and commiting it all at once. This will make it easier to offer feedback and merge your changes. Make sure your commit messages are clear and descriptive. Bad: "Added docs", Good: "Added initial draft of hello world tutorial", Bad: "Fixed typos", Good: "Fixed typos on the query builder page"
|
||||
|
||||
If you feel a menu needs to be rearranged or a module needs new pages, please open a [bug report](http://dev.kohanaframework.org/projects/userguide3/issues/new) to discuss it.
|
||||
|
||||
## Quick Method
|
||||
|
||||
To quickly point out something that needs improvement, report a [bug report](http://dev.kohanaframework.org/projects/userguide3/issues/new).
|
||||
|
||||
If you want to contribute some changes, you can do so right from your browser without even knowing git!
|
||||
|
||||
First create an account on [GitHub](https://github.com/signup/free).
|
||||
|
||||
You will need to fork the module for the area you want to improve. For example, to improve the [ORM documentation](../orm) fork <http://github.com/kohana/orm>. To improve the [Kohana documentation](../kohana), fork <http://github.com/kohana/core>, etc. So, find the module you want to improve and click on the Fork button in the top right.
|
||||
|
||||
|
||||
|
||||
The files that make the User Guide portion are found in `guide/<module>/`, and the API browser portion is made from the comments in the source code itself. Navigate to one of the files you want to change and click the edit button in the top right of the file viewer.
|
||||
|
||||
|
||||
|
||||
Make the changes and add a **detailed commit message**. Repeat this for as many files as you want to improve. (Note that you can't preview what the changes will look unless you actually test it locally.)
|
||||
|
||||
After you have made your changes, send a pull request so your improvements can be reviewed to be merged into the official documentation.
|
||||
|
||||
|
||||
|
||||
Once your pull request has been accepted, you can delete your repository if you want. Your commit will have been copied to the official branch.
|
||||
|
||||
## If you know Git
|
||||
|
||||
### Short version
|
||||
|
||||
Fork the module whose docs you wish to improve (e.g. `git://github.com/kohana/orm.git` or `git://github.com/kohana/core.git`), checkout the `3.2/develop` branch (for the 3.2 docs), make changes, and then send a pull request.
|
||||
|
||||
### Long version
|
||||
|
||||
(This still assumes you at least know your way around Git, especially how submodules work.)
|
||||
|
||||
1. Fork the specific repo you want to contribute to on GitHub. (For example, go to http://github.com/kohana/core and click the fork button.)
|
||||
|
||||
1. Now you need to add your fork as a "git remote" to your application and ensure you are on the right branch. An example for the [ORM](../orm) module and 3.2 docs:
|
||||
|
||||
cd my-kohana-app/modules/orm
|
||||
|
||||
# add your repository as a new remote
|
||||
git remote add <your name> git://github.com/<your name>/orm.git
|
||||
|
||||
# Get the correct branch
|
||||
git checkout 3.2/develop
|
||||
|
||||
1. Now go into the repo of the area of docs you want to contribute to and add your forked repo as a new remote, and push to it.
|
||||
|
||||
cd my-kohana-app/modules/orm
|
||||
|
||||
# Make some changes to the docs
|
||||
nano file.md
|
||||
|
||||
# Commit your changes - Use a descriptive commit message! If there is a redmine ticket for the changes you are making include "Fixes #XXXXX" in the commit message so its tracked.
|
||||
git commit -a -m "Corrected a typo in the ORM docs. Fixes #12345."
|
||||
|
||||
# make sure we are up to date with the latest changes
|
||||
git merge origin/3.2/develop
|
||||
|
||||
# Now push your changes to your fork.
|
||||
git push <your name> 3.2/develop
|
||||
|
||||
1. Finally, send a pull request on GitHub.
|
||||
@@ -0,0 +1,3 @@
|
||||
# Userguide
|
||||
|
||||
The userguide module provides documentation viewing including browsing the source code comments.
|
||||
237
includes/kohana/modules/userguide/guide/userguide/markdown.md
Normal file
237
includes/kohana/modules/userguide/guide/userguide/markdown.md
Normal file
@@ -0,0 +1,237 @@
|
||||
# Markdown Syntax
|
||||
|
||||
The userguide uses [Markdown](http://daringfireball.net/projects/markdown/) and [Markdown Extra](http://michelf.com/projects/php-markdown/extra/) for the userguide pages, and the in-code comments used to generate the API browser. This is a brief summary of most of Markdown and Markdown extra features. It does not cover everything, and it does not cover all the caveats.
|
||||
|
||||
[!!] Be sure to check out the **[Userguide Specific Syntax](#userguide-specific-syntax)** for things that Userguide adds to markdown.
|
||||
|
||||
## Headers
|
||||
|
||||
# Header 1
|
||||
|
||||
## Header 2
|
||||
|
||||
### Header 3
|
||||
|
||||
#### Header 4
|
||||
|
||||
## Paragraphs
|
||||
~~~
|
||||
Regular text will be transformed into paragraphs.
|
||||
Single returns will not make a new paragraph, this
|
||||
allows for wrapping (especially for in-code
|
||||
comments).
|
||||
|
||||
A new paragraph will start if there is a blank line between
|
||||
blocks of text. Chars like > and & are escaped for you.
|
||||
|
||||
To make a line break,
|
||||
put two spaces at the
|
||||
end of a line.
|
||||
~~~
|
||||
Regular text will be transformed into paragraphs.
|
||||
Single returns will not make a new paragraph, this
|
||||
allows for wrapping (especially for in-code
|
||||
comments).
|
||||
|
||||
A new paragraph will start if there is a blank line between
|
||||
blocks of text. Chars like > and & are escaped for you.
|
||||
|
||||
To make a line break,
|
||||
put two spaces at the
|
||||
end of a line.
|
||||
|
||||
## Links
|
||||
~~~
|
||||
This is a normal link: [Kohana](http://kohanaframework.org).
|
||||
|
||||
This link has a title: [Kohana](http://kohanaframework.org "The swift PHP framework")
|
||||
~~~
|
||||
This is a normal link: [Kohana](http://kohanaframework.org)
|
||||
|
||||
This link has a title: [Kohana](http://kohanaframework.org "The swift PHP framework")
|
||||
|
||||
## Code blocks
|
||||
|
||||
For inline code simply surround some `text with tick marks.`
|
||||
|
||||
For inline code simply surround some `text with tick marks.`
|
||||
|
||||
// For a block of code,
|
||||
// indent in four spaces,
|
||||
// or with a tab
|
||||
|
||||
You can also do a "fenced" code block:
|
||||
|
||||
~~~
|
||||
A fenced code block has tildes
|
||||
above and below it
|
||||
This is sometimes useful when code is near lists
|
||||
~~~
|
||||
~~~
|
||||
A fenced code block has tildes
|
||||
above and below it
|
||||
This is sometimes useful when code is near lists
|
||||
~~~
|
||||
|
||||
## Unordered Lists
|
||||
|
||||
~~~
|
||||
* To make a unordered list, put an asterisk, minus, or + at the beginning
|
||||
- of each line, surrounded by spaces. You can mix * - and +, but it
|
||||
+ makes no difference.
|
||||
~~~
|
||||
* To make a unordered list, put an asterisk, minus, or + at the beginning
|
||||
- of each line, surrounded by spaces. You can mix * - and +, but it
|
||||
+ makes no difference.
|
||||
|
||||
## Ordered Lists
|
||||
|
||||
~~~
|
||||
1. For ordered lists, put a number and a period
|
||||
2. On each line that you want numbered.
|
||||
9. It doesn't actually have to be the correct number order
|
||||
5. Just as long as each line has a number
|
||||
~~~
|
||||
1. For ordered lists, put a number and a period
|
||||
2. On each line that you want numbered.
|
||||
9. It doesn't actually have to be the correct number order
|
||||
5. Just as long as each line has a number
|
||||
|
||||
## Nested Lists
|
||||
|
||||
~~~
|
||||
* To nest lists you just add four spaces before the * or number
|
||||
1. Like this
|
||||
* It's pretty basic, this line has eight spaces, so its nested twice
|
||||
1. And this line is back to the second level
|
||||
* Out to third level again
|
||||
* And back to the first level
|
||||
~~~
|
||||
* To nest lists you just add four spaces before the * or number
|
||||
1. Like this
|
||||
* It's pretty basic, this line has eight spaces, so its nested twice
|
||||
1. And this line is back to the second level
|
||||
* Out to third level again
|
||||
* And back to the first level
|
||||
|
||||
## Italics and Bold
|
||||
|
||||
~~~
|
||||
Surround text you want *italics* with *asterisks* or _underscores_.
|
||||
|
||||
**Double asterisks** or __double underscores__ makes text bold.
|
||||
|
||||
***Triple*** will do *both at the same **time***.
|
||||
~~~
|
||||
Surround text you want *italics* with *asterisks* or _underscores_.
|
||||
|
||||
**Double asterisks** or __double underscores__ makes text **bold**.
|
||||
|
||||
___Triple___ will do *both at the same **time***.
|
||||
|
||||
## Horizontal Rules
|
||||
|
||||
Horizontal rules are made by placing 3 or more hyphens, asterisks, or underscores on a line by themselves.
|
||||
~~~
|
||||
---
|
||||
* * * *
|
||||
_____________________
|
||||
~~~
|
||||
---
|
||||
* * * *
|
||||
_____________________
|
||||
|
||||
## Images
|
||||
|
||||
Image syntax looks like this:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
[!!] Note that the images in userguide are [namespaced](#namespacing).
|
||||
|
||||
## Tables
|
||||
~~~
|
||||
First Header | Second Header
|
||||
------------- | -------------
|
||||
Content Cell | Content Cell
|
||||
Content Cell | Content Cell
|
||||
~~~
|
||||
|
||||
First Header | Second Header
|
||||
------------- | -------------
|
||||
Content Cell | Content Cell
|
||||
Content Cell | Content Cell
|
||||
|
||||
Note that the pipes on the very left and very right side are optional, and you can change the text-alignment by adding a colon on the right, or on both sides for center.
|
||||
~~~
|
||||
| Item | Value | Savings |
|
||||
| --------- | -----:|:-------:|
|
||||
| Computer | $1600 | 40% |
|
||||
| Phone | $12 | 30% |
|
||||
| Pipe | $1 | 0% |
|
||||
~~~
|
||||
| Item | Value | Savings |
|
||||
| --------- | -----:|:-------:|
|
||||
| Computer | $1600 | 40% |
|
||||
| Phone | $12 | 30% |
|
||||
| Pipe | $1 | 0% |
|
||||
|
||||
# Userguide Specific Syntax
|
||||
|
||||
In addition to the features and syntax of [Markdown](http://daringfireball.net/projects/markdown/) and [Markdown Extra](http://michelf.com/projects/php-markdown/extra/) the following apply to userguide pages and api documentation:
|
||||
|
||||
## Namespacing
|
||||
|
||||
The first thing to note is that all links are "namespaced" to the current module. For example, from anywhere within the Kohana core docs you do not need to include `kohana` at the beginning of a link url. For example: `[Hello World Tutorial](tutorials/hello-world)` rather than `(kohana/tutorials/hello-world)`.
|
||||
|
||||
To link to a modules index page, have an empty url like: `[Kohana]()`.
|
||||
|
||||
To link to page in a different module, prefix your url with `../` and the module name. For example: `[Kohana Routes](../kohana/routing)`
|
||||
|
||||
**Images are also namespaced**, using `` would look for `media/guide/<modulename>/imagename.jpg`.
|
||||
|
||||
[!!] If you want your userguide pages to be browsable on github or similar sites outside Kohana's own userguide module, specify the optional .md file extension in your links
|
||||
|
||||
## API Links
|
||||
|
||||
You can make links to the api browser by wrapping any class name in brackets. You may also include a function name, or propery name to link to that specifically. All of the following will link to the API browser:
|
||||
|
||||
[Request]
|
||||
[Request::execute]
|
||||
[Request::execute()]
|
||||
[Request::$status]
|
||||
|
||||
[Request]
|
||||
[Request::execute]
|
||||
[Request::execute()]
|
||||
[Request::$status]
|
||||
|
||||
If you want to have parameters and have the function be clickable, only put the brackets around the class and function (not the params), and put a backslash in front of the opening parenthesis.
|
||||
|
||||
[Kohana::$config]\('foobar','baz')
|
||||
|
||||
[Kohana::$config]\('foobar','baz')
|
||||
|
||||
## Notes
|
||||
|
||||
If you put `[!!]` in front of a line it will be a "note" and be placed in a box with a lightbulb.
|
||||
|
||||
[!!] This is a note
|
||||
|
||||
will display as:
|
||||
|
||||
[!!] This is a note
|
||||
|
||||
## Headers automatically get IDs
|
||||
|
||||
Headers are automatically assigned an id, based on the content of the header, so each header can be linked to. You can manually assign a different id using the syntax as defined in Markdown Extra. If multiple headers have the same content (e.g. more than one "Examples" header), only the first will get be automatically assigned an id, so you should manually assign more descriptive ids. For example:
|
||||
|
||||
### Examples {#more-descriptive-id}
|
||||
|
||||
## Including Views
|
||||
|
||||
If you need you may include a regular Kohana View file by placing the name of the view in double curly brackets. **If the view is not found, no error or exception will be shown, the curly brackets and view name will simply remain there!**
|
||||
|
||||
{{some/view/file}}
|
||||
@@ -0,0 +1,7 @@
|
||||
## [Userguide]()
|
||||
- [Using the Userguide](using)
|
||||
- [How userguide works](works)
|
||||
- [Contributing](contributing)
|
||||
- [Markdown Syntax](markdown)
|
||||
- [Configuration](config)
|
||||
- [Adding your module](adding)
|
||||
@@ -0,0 +1 @@
|
||||
Give tips on how to most effectively use the user guide. How to navigate around, how things are organized, etc.
|
||||
25
includes/kohana/modules/userguide/guide/userguide/works.md
Normal file
25
includes/kohana/modules/userguide/guide/userguide/works.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# How the Userguide works
|
||||
|
||||
The userguide uses [Markdown](markdown) for the documentation. Both the userguide pages, and the in code comments for the API browser are written in markdown.
|
||||
|
||||
## Userguide pages
|
||||
|
||||
Userguide pages are in the module they apply to, in `guide/<module>`. For example, documentation for Kohana is in `system/guide/kohana` and documentation for orm is in `modules/orm/guide/orm`, database is in `modules/database/guide/database`, etc.
|
||||
|
||||
Each module has an index page at `guide/<module>/index.md`.
|
||||
|
||||
Each module's menu is at `guide/<module>/menu.md`.
|
||||
|
||||
All other pages are are in `guide/<module>` and can be organized in subfolders and named however you want.
|
||||
|
||||
For more info on how to make your module have userguide pages, see [Adding your module](adding).
|
||||
|
||||
### Images
|
||||
|
||||
Any images used in the userguide pages must be in `media/guide/<module>/`. For example, if a page has `` the image would be located at `media/guide/<module>/hello-world.jpg`. Images for the ORM module are in `modules/orm/media/guide/orm`, and images for the Kohana docs are in `system/media/guide/kohana`.
|
||||
|
||||
### API browser
|
||||
|
||||
The API browser is generated from the actual source code. The descriptions for classes, constants, properties, and methods is extracted from the comments and parsed in Markdown. For example if you look in the comment for [Kohana_Core::init](http://github.com/kohana/core/blob/c443c44922ef13421f4a/classes/kohana/core.php#L5) you can see a markdown list and table. These are parsed and show correctly in the API browser. `@param`, `@uses`, `@throws`, `@returns` and other tags are parsed as well.
|
||||
|
||||
TODO: give more specific details on how to comment your classes, constants, methods, etc. including package and how it relates to the api module.
|
||||
44
includes/kohana/modules/userguide/init.php
Normal file
44
includes/kohana/modules/userguide/init.php
Normal file
@@ -0,0 +1,44 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
// Static file serving (CSS, JS, images)
|
||||
Route::set('docs/media', 'guide-media(/<file>)', array('file' => '.+'))
|
||||
->defaults(array(
|
||||
'controller' => 'Userguide',
|
||||
'action' => 'media',
|
||||
'file' => NULL,
|
||||
));
|
||||
|
||||
// API Browser, if enabled
|
||||
if (Kohana::$config->load('userguide.api_browser') === TRUE)
|
||||
{
|
||||
Route::set('docs/api', 'guide-api(/<class>)', array('class' => '[a-zA-Z0-9_]+'))
|
||||
->defaults(array(
|
||||
'controller' => 'Userguide',
|
||||
'action' => 'api',
|
||||
'class' => NULL,
|
||||
));
|
||||
}
|
||||
|
||||
// User guide pages, in modules
|
||||
Route::set('docs/guide', 'guide(/<module>(/<page>))', array(
|
||||
'page' => '.+',
|
||||
))
|
||||
->defaults(array(
|
||||
'controller' => 'Userguide',
|
||||
'action' => 'docs',
|
||||
'module' => '',
|
||||
));
|
||||
|
||||
// Simple autoloader used to encourage PHPUnit to behave itself.
|
||||
class Markdown_Autoloader {
|
||||
public static function autoload($class)
|
||||
{
|
||||
if ($class == 'Markdown_Parser' OR $class == 'MarkdownExtra_Parser')
|
||||
{
|
||||
include_once Kohana::find_file('vendor', 'markdown/markdown');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Register the autoloader
|
||||
spl_autoload_register(array('Markdown_Autoloader', 'autoload'));
|
||||
34
includes/kohana/modules/userguide/media/guide/css/api.css
Normal file
34
includes/kohana/modules/userguide/media/guide/css/api.css
Normal file
@@ -0,0 +1,34 @@
|
||||
/* Api browser stuff */
|
||||
|
||||
/* api index page */
|
||||
div.class-list div.class { width: 50%; }
|
||||
div.class-list div.class.left { float: left; clear: both; }
|
||||
div.class-list div.class.right { float: right; }
|
||||
div.class-list div.class h2 { background:none; }
|
||||
|
||||
/* table of contents at the top of each class */
|
||||
div.toc { }
|
||||
div.toc div {float:left; width: 33%;}
|
||||
div.toc div h3 {margin-top:0; background:none; }
|
||||
|
||||
|
||||
/* constants */
|
||||
div.constants dl dt {font-weight:bold; margin-bottom:1.5em;}
|
||||
div.constants dl dd {margin-left:1.5em; margin-bottom:1.5em;}
|
||||
|
||||
/* properties */
|
||||
div.properties dl dt { font-weight:bold; margin-top:1.5em; margin-bottom:1.5em;}
|
||||
div.properties dl dt small, div.properties dl dt code { font-weight:normal; font-size:0.9em; }
|
||||
div.properties dl dd {margin-left:1.5em; margin-bottom:1.5em;}
|
||||
|
||||
/* functions */
|
||||
|
||||
div.method { padding:0 1.5em; border:1px solid #c8cfaf; border-radius:5px; margin-bottom:1.5em; }
|
||||
div.method h3 { background:none; margin-top:0; margin-left:-1em; margin-right:-1em; padding:.75em 0 .75em 1.17em; background:#e8efcf; border-top-left-radius:5px; border-top-right-radius:5px; }
|
||||
div.method h3 .param { font-weight: normal; cursor: help; border-bottom:1px dashed #666;}
|
||||
div.method h3 abbr.param { text-transform: none; font-size: 1em; }
|
||||
|
||||
dl.tags { overflow: auto; background: #e8efcf; padding: 1em; border: solid 6px #d8dfbf; margin-bottom:1.5em; }
|
||||
dl.tags dt { margin: 0; clear: both; float: left; width: 25%; }
|
||||
dl.tags dd { margin: 0; padding: 0; clear: right; float: right; }
|
||||
|
||||
142
includes/kohana/modules/userguide/media/guide/css/kodoc.css
Normal file
142
includes/kohana/modules/userguide/media/guide/css/kodoc.css
Normal file
@@ -0,0 +1,142 @@
|
||||
@import url('api.css');
|
||||
|
||||
html { background: #00262f; font-size: 70%; }
|
||||
body { margin: 0; }
|
||||
ol ol, ol ul, ul ul, ul ol { margin-bottom: 0; }
|
||||
a img { border: 0; }
|
||||
|
||||
h1 small,
|
||||
h2 small,
|
||||
h3 small,
|
||||
h4 small { font-weight: normal; font-size: 0.7em; }
|
||||
h5 small,
|
||||
h6 small { font-weight: normal; font-size: 0.8em; }
|
||||
|
||||
dl dd { margin-left: 0; }
|
||||
|
||||
code {
|
||||
color:#6BAA3D;
|
||||
font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;
|
||||
}
|
||||
|
||||
pre {
|
||||
background:#fff;
|
||||
border-radius:10px;
|
||||
padding:1.5em;
|
||||
font-size:0.9em;
|
||||
margin-top:1.5em;
|
||||
margin-bottom:1.5em;
|
||||
overflow:auto;
|
||||
}
|
||||
|
||||
.highlighted div.line {
|
||||
font-size:1em;
|
||||
line-height:1.3 !important;
|
||||
}
|
||||
|
||||
table {
|
||||
background:#eee;
|
||||
border-left: 1px solid #CCC;
|
||||
border-top: 1px solid #CCC;
|
||||
margin-bottom:1.5em;
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
table td, table th {
|
||||
padding:0.4em 0.8em;
|
||||
line-height:1.4286;
|
||||
border-right: 1px solid #CCC;
|
||||
border-bottom: 1px solid #CCC;
|
||||
}
|
||||
|
||||
table th {
|
||||
background: #ddd;
|
||||
}
|
||||
|
||||
table tr:nth-child(even) {
|
||||
background: #fff;
|
||||
}
|
||||
|
||||
.caps { text-transform: uppercase; font-size: 0.8em; font-weight: normal; }
|
||||
.status { text-transform: lowercase; font-variant: small-caps; font-weight: bold; color: #911; }
|
||||
.container .colborder { border-color: #d3d8bc; }
|
||||
|
||||
.note {
|
||||
padding: 1.5em;
|
||||
padding-left: 5em;
|
||||
background: #e8efcf url('../img/lightbulb_48.png') no-repeat 1em center;
|
||||
border-radius: 0.6em;
|
||||
overflow: auto;
|
||||
}
|
||||
|
||||
h1 a.permalink,
|
||||
h2 a.permalink,
|
||||
h3 a.permalink,
|
||||
h4 a.permalink,
|
||||
h5 a.permalink,
|
||||
h6 a.permalink {
|
||||
font-size: 0.6em;
|
||||
line-height: 100%;
|
||||
vertical-align: middle;
|
||||
margin-left: 1em;
|
||||
padding: 0;
|
||||
font-weight: normal;
|
||||
display: none;
|
||||
position: inherit;
|
||||
}
|
||||
|
||||
h1:hover a.permalink,
|
||||
h2:hover a.permalink,
|
||||
h3:hover a.permalink,
|
||||
h4:hover a.permalink,
|
||||
h5:hover a.permalink,
|
||||
h6:hover a.permalink {
|
||||
display: inline;
|
||||
}
|
||||
|
||||
|
||||
#kodoc-header,
|
||||
#kodoc-content,
|
||||
#kodoc-footer { float: left; clear: both; width: 100%; }
|
||||
|
||||
#kodoc-header { padding: 58px 0 2em; background: #77c244 url(../img/header.png) center top repeat-x; }
|
||||
#kodoc-logo { display: block; float: left; }
|
||||
#kodoc-menu { float: right; margin-top: 12px; background: #113c32; -moz-border-radius: 5px; -webkit-border-radius: 5px; }
|
||||
#kodoc-menu ul { float: left; margin: 0; padding: 0 0.5em 0 0; }
|
||||
#kodoc-menu li { display: block; float: left; margin: 0; padding: 0; }
|
||||
#kodoc-menu li.first { padding-left: 0.5em; }
|
||||
#kodoc-menu li a { display: block; height: 32px; line-height: 32px; padding: 0 0.8em; border-right: solid 1px #0f362d; border-left: solid 1px #144539; letter-spacing: 0.05em; text-decoration: none; text-transform: uppercase; color: #efefef; font-size: 90%; }
|
||||
#kodoc-menu li.first a { border-left: 0; }
|
||||
#kodoc-menu li.last a { border-right: 0; }
|
||||
#kodoc-menu li a:hover { background: #164e41; border-left-color: #195a4b; color: #fff; text-shadow: #fff 0 0 1px; }
|
||||
|
||||
#kodoc-content { background: #f1f8db url(../img/content.png) center top repeat-x; }
|
||||
#kodoc-content .wrapper { min-height: 390px; padding: 1em 0; background: transparent url(../img/wrapper.png) center top no-repeat; }
|
||||
#kodoc-content div.page-toc { float: right; margin: 1em; margin-top: 0; padding: 1em; background: #fff; border: solid 0.1em #e8efcf; border-radius: 0.6em; }
|
||||
#kodoc-content p.intro { padding: 1em 20px; padding-left: 20px; margin: 0 -20px; font-size: 1.2em; }
|
||||
#kodoc-content a { color: #004352; }
|
||||
#kodoc-content a:hover { color: #00758f; }
|
||||
#kodoc-content a:active { text-decoration: none; }
|
||||
|
||||
#kodoc-breadcrumb { margin: 0 0 1em; padding: 0 0 0.5em; list-style: none; border-bottom: solid 1px #e8efcf; }
|
||||
#kodoc-breadcrumb li { display: inline-block; margin: 0; padding: 0 0.4em 0 0; text-transform: uppercase; font-size: 11px; }
|
||||
#kodoc-breadcrumb li:before { content: '»'; padding-right: 0.4em; }
|
||||
#kodoc-breadcrumb li a { color: #999; text-decoration: none; }
|
||||
|
||||
#kodoc-topics { }
|
||||
#kodoc-topics ul,
|
||||
#kodoc-topics ol { list-style-type:none; margin: 0; padding: 0;}
|
||||
#kodoc-topics ul li,
|
||||
#kodoc-topics ol li { margin:0; padding: 0; margin-left: 1em; }
|
||||
#kodoc-topics ul li a.current,
|
||||
#kodoc-topics ol li a.current { font-weight: bold; }
|
||||
#kodoc-topics span,
|
||||
#kodoc-topics a { display: block; padding: 0; margin: 0; }
|
||||
#kodoc-topics span { cursor: pointer; }
|
||||
#kodoc-topics span.toggle { display: block; float: left; width: 1em; padding-right: 0.4em; margin-left: -1.4em; text-align: center; }
|
||||
|
||||
#kodoc-topics li span { cursor:pointer; }
|
||||
|
||||
#kodoc-footer { padding: 1em 0; background: #00262f; color: #405c63; text-shadow: #00262f 0.1em 0.1em 1px; font-size: 0.9em; }
|
||||
#kodoc-footer a { color: #809397; }
|
||||
#kodoc-footer div.last { text-align: right; }
|
||||
50
includes/kohana/modules/userguide/media/guide/css/print.css
Normal file
50
includes/kohana/modules/userguide/media/guide/css/print.css
Normal file
@@ -0,0 +1,50 @@
|
||||
|
||||
/* Smaller font for printing */
|
||||
body {
|
||||
font:14px/1.5 Helvetica,Arial;
|
||||
}
|
||||
|
||||
/* Show link urls, imitating markdown syntax */
|
||||
a:link, a:visited { text-decoration:none; }
|
||||
a:link:before, a:visited:before { content:"["; }
|
||||
a:link:after, a:visited:after { content:"](" attr(href) ")"; }
|
||||
|
||||
/* Hide things like navigation, header links, etc. */
|
||||
#kodoc-header,
|
||||
#kodoc-nav,
|
||||
#kodoc-menu,
|
||||
#kodoc-page-toc,
|
||||
.syntaxhighlighter .toolbar,
|
||||
h1 a.permalink,
|
||||
h2 a.permalink,
|
||||
h3 a.permalink,
|
||||
h4 a.permalink,
|
||||
h5 a.permalink,
|
||||
h6 a.permalink
|
||||
{ display:none; }
|
||||
|
||||
pre {
|
||||
padding:1em;
|
||||
border:1px dashed #999;
|
||||
}
|
||||
|
||||
table {
|
||||
border-left: 1px solid #999;
|
||||
border-top: 1px solid #999;
|
||||
}
|
||||
|
||||
table td, table th {
|
||||
padding:0.4em 0.8em;
|
||||
border-right: 1px solid #999;
|
||||
border-bottom: 1px solid #999;
|
||||
}
|
||||
|
||||
/* syntax highlighter tables inside pre cause problems */
|
||||
pre table, pre table td, pre table th {
|
||||
padding:0;
|
||||
border:none;
|
||||
}
|
||||
|
||||
p.note { padding:1em; border: 1px solid black; }
|
||||
|
||||
p.note:before { content:"Note: "; font-weight:bold; }
|
||||
267
includes/kohana/modules/userguide/media/guide/css/screen.css
Normal file
267
includes/kohana/modules/userguide/media/guide/css/screen.css
Normal file
@@ -0,0 +1,267 @@
|
||||
/* -----------------------------------------------------------------------
|
||||
|
||||
BlueTrip CSS Framework
|
||||
|
||||
Mike Crittenden
|
||||
mike@capsizedesigns.com
|
||||
Copyright 2008 Mike Crittenden
|
||||
|
||||
License - MIT or GPL (whichever suits you better)
|
||||
|
||||
----------------------------------------------------------------------- */
|
||||
|
||||
/* MEYER RESET v1.0 */
|
||||
|
||||
html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,font,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td{margin:0;padding:0;border:0;outline:0;font-size:100%;vertical-align:baseline;background:transparent}body{line-height:1}blockquote,q{quotes:none}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none}:focus{outline:0}ins{text-decoration:none}del{text-decoration:line-through}table{border-collapse:collapse;border-spacing:0}
|
||||
|
||||
/* BASIC TYPOGRAPHY */
|
||||
|
||||
html { font-size: 62.5%; font-family: "Liberation Sans", Helvetica, Arial, sans-serif; }
|
||||
strong, th, thead td, h1, h2, h3, h4, h5, h6 { font-weight: bold; }
|
||||
cite, em, dfn { font-style: italic; }
|
||||
code, kbd, samp, pre, tt, var, input[type='text'], input[type='password'], textarea { font-size: 92%; font-family: monaco, "Lucida Console", courier, monospace; }
|
||||
del { text-decoration: line-through; color: #666; }
|
||||
ins, dfn { border-bottom: 1px solid #ccc; }
|
||||
small, sup, sub { font-size: 85%; }
|
||||
abbr, acronym { text-transform: uppercase; font-size: 85%; letter-spacing: .1em; }
|
||||
a abbr, a acronym { border: none; }
|
||||
abbr[title], acronym[title], dfn[title] { cursor: help; border-bottom: 1px solid #ccc; }
|
||||
sup { vertical-align: super; }
|
||||
sub { vertical-align: sub; }
|
||||
|
||||
/* QUOTES */
|
||||
|
||||
blockquote { border-top: 1px solid #ccc; border-bottom: 1px solid #ccc; color: #666; }
|
||||
blockquote *:first-child:before { content: "\201C"; }
|
||||
blockquote *:first-child:after { content: "\201D"; }
|
||||
|
||||
/* FORMS */
|
||||
|
||||
fieldset { padding:1.4em; margin: 0 0 1.5em 0; border: 1px solid #ccc; }
|
||||
legend { font-weight: bold; font-size:1.2em; }
|
||||
label { font-weight: bold; }
|
||||
textarea, input[type='text'], input[type='password'], select { border: 1px solid #ccc; background: #fff; }
|
||||
textarea:hover, input[type='text']:hover, input[type='password']:hover, select:hover { border-color: #aaa; }
|
||||
textarea:focus, input[type='text']:focus, input[type='password']:focus, select:focus { border-color: #888; outline: 2px solid #ffffaa; }
|
||||
input, select { cursor: pointer; }
|
||||
input[type='text'],input[type='password'] { cursor: text; }
|
||||
|
||||
/* BASE SIZES */
|
||||
|
||||
.container { font-size: 1.2em; line-height: 1.6em; }
|
||||
h1 { font-size: 1.9em; }
|
||||
h2 { font-size: 1.7em; }
|
||||
h3 { font-size: 1.5em; }
|
||||
h4 { font-size: 1.3em; }
|
||||
h5 { font-size: 1.2em; }
|
||||
h6 { font-size: 1em; }
|
||||
|
||||
/* LISTS */
|
||||
|
||||
ul li { margin-left: .85em; }
|
||||
ul { list-style-type: disc; }
|
||||
ul ul { list-style-type: square; }
|
||||
ul ul ul { list-style-type: circle; }
|
||||
ol { list-style-position: outside; list-style-type: decimal; }
|
||||
dt { font-weight: bold; }
|
||||
|
||||
/* TABLES */
|
||||
|
||||
table { border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
|
||||
th, td { border-bottom: 1px solid #ddd; border-right: 1px solid #ccc; }
|
||||
|
||||
/* MARGINS & PADDINGS */
|
||||
|
||||
blockquote *:first-child { margin: .8em 0; }
|
||||
hr, p, ul, ol, dl, pre, blockquote, address, table, form { margin-bottom: 1.6em; }
|
||||
/* NOTE: Calulate header margins: TOP: 1.6em/size, BOTTOM: 1.6em/size/2 */
|
||||
h1 { margin: 1em 0 .5em; }
|
||||
h2 { margin: 1.07em 0 .535em; }
|
||||
h3 { margin: 1.14em 0 .57em; }
|
||||
h4 { margin: 1.23em 0 .615em; }
|
||||
h5 { margin: 1.33em 0 .67em; }
|
||||
h6 { margin: 1.6em 0 .8em; }
|
||||
th, td { padding: .8em; }
|
||||
caption { padding-bottom: .8em; } /* padding instead of margin for IE */
|
||||
blockquote { padding: 0 1em; margin: 1.6em 0; }
|
||||
fieldset { padding: 0 1em 1em 1em; margin: 1.6em 0; } /* padding-top is margin-top for fieldsets in Opera */
|
||||
legend { padding-left: .8em; padding-right: .8em; }
|
||||
legend+* { margin-top: 1em; } /* compensates for the opera margin bug */
|
||||
textarea, input { padding: .3em .4em .15em .4em; }
|
||||
select { padding: .1em .2em 0 .2em; }
|
||||
option { padding: 0 .4em; }
|
||||
a { position: relative; padding: 0.3em 0 .1em 0; } /* for larger click-area */
|
||||
dt { margin-top: .8em; margin-bottom: .4em; }
|
||||
ul { margin-left: 1.5em; }
|
||||
ol { margin-left: 2.35em; }
|
||||
ol ol, ul ol { margin-left: 2.5em; }
|
||||
form div { margin-bottom: .8em; }
|
||||
|
||||
/* COLORS */
|
||||
|
||||
a:link { text-decoration: underline; color: #36c; }
|
||||
a:visited { text-decoration: underline; color: #99c; }
|
||||
a:hover { text-decoration: underline; color: #c33; }
|
||||
a:active, a:focus { text-decoration: underline; color: #000; }
|
||||
code, pre { color: #c33; } /* very optional, but still useful. W3C uses about the same colors for codes */
|
||||
|
||||
/* 24 COLUMN GRID */
|
||||
|
||||
.container {width:950px;margin:0 auto;overflow:hidden;}
|
||||
.showgrid {background:url(../img/grid.png);}
|
||||
body {margin:1.5em 0;}
|
||||
div.span-1, div.span-2, div.span-3, div.span-4, div.span-5, div.span-6, div.span-7, div.span-8, div.span-9, div.span-10, div.span-11, div.span-12, div.span-13, div.span-14, div.span-15, div.span-16, div.span-17, div.span-18, div.span-19, div.span-20, div.span-21, div.span-22, div.span-23 {float:left;margin-right:10px;}
|
||||
div.span-24 {float:left;}
|
||||
div.last {margin-right:0;}
|
||||
.span-1 {width:30px;}
|
||||
.span-2 {width:70px;}
|
||||
.span-3 {width:110px;}
|
||||
.span-4 {width:150px;}
|
||||
.span-5 {width:190px;}
|
||||
.span-6 {width:230px;}
|
||||
.span-7 {width:270px;}
|
||||
.span-8 {width:310px;}
|
||||
.span-9 {width:350px;}
|
||||
.span-10 {width:390px;}
|
||||
.span-11 {width:430px;}
|
||||
.span-12 {width:470px;}
|
||||
.span-13 {width:510px;}
|
||||
.span-14 {width:550px;}
|
||||
.span-15 {width:590px;}
|
||||
.span-16 {width:630px;}
|
||||
.span-17 {width:670px;}
|
||||
.span-18 {width:710px;}
|
||||
.span-19 {width:750px;}
|
||||
.span-20 {width:790px;}
|
||||
.span-21 {width:830px;}
|
||||
.span-22 {width:870px;}
|
||||
.span-23 {width:910px;}
|
||||
.span-24, div.span-24 {width:950px;}
|
||||
.suffix-1 {padding-right:40px;}
|
||||
.suffix-2 {padding-right:80px;}
|
||||
.suffix-3 {padding-right:120px;}
|
||||
.suffix-4 {padding-right:160px;}
|
||||
.suffix-5 {padding-right:200px;}
|
||||
.suffix-6 {padding-right:240px;}
|
||||
.suffix-7 {padding-right:280px;}
|
||||
.suffix-8 {padding-right:320px;}
|
||||
.suffix-9 {padding-right:360px;}
|
||||
.suffix-10 {padding-right:400px;}
|
||||
.suffix-11 {padding-right:440px;}
|
||||
.suffix-12 {padding-right:480px;}
|
||||
.suffix-13 {padding-right:520px;}
|
||||
.suffix-14 {padding-right:560px;}
|
||||
.suffix-15 {padding-right:600px;}
|
||||
.suffix-16 {padding-right:640px;}
|
||||
.suffix-17 {padding-right:680px;}
|
||||
.suffix-18 {padding-right:720px;}
|
||||
.suffix-19 {padding-right:760px;}
|
||||
.suffix-20 {padding-right:800px;}
|
||||
.suffix-21 {padding-right:840px;}
|
||||
.suffix-22 {padding-right:880px;}
|
||||
.suffix-23 {padding-right:920px;}
|
||||
.prefix-1 {padding-left:40px;}
|
||||
.prefix-2 {padding-left:80px;}
|
||||
.prefix-3 {padding-left:120px;}
|
||||
.prefix-4 {padding-left:160px;}
|
||||
.prefix-5 {padding-left:200px;}
|
||||
.prefix-6 {padding-left:240px;}
|
||||
.prefix-7 {padding-left:280px;}
|
||||
.prefix-8 {padding-left:320px;}
|
||||
.prefix-9 {padding-left:360px;}
|
||||
.prefix-10 {padding-left:400px;}
|
||||
.prefix-11 {padding-left:440px;}
|
||||
.prefix-12 {padding-left:480px;}
|
||||
.prefix-13 {padding-left:520px;}
|
||||
.prefix-14 {padding-left:560px;}
|
||||
.prefix-15 {padding-left:600px;}
|
||||
.prefix-16 {padding-left:640px;}
|
||||
.prefix-17 {padding-left:680px;}
|
||||
.prefix-18 {padding-left:720px;}
|
||||
.prefix-19 {padding-left:760px;}
|
||||
.prefix-20 {padding-left:800px;}
|
||||
.prefix-21 {padding-left:840px;}
|
||||
.prefix-22 {padding-left:880px;}
|
||||
.prefix-23 {padding-left:920px;}
|
||||
div.border {padding-right:4px;margin-right:5px;border-right:1px solid #eee;}
|
||||
div.colborder {padding-right:24px;margin-right:25px;border-right:1px solid #eee;}
|
||||
.pull-1 {margin-left:-40px;}
|
||||
.pull-2 {margin-left:-80px;}
|
||||
.pull-3 {margin-left:-120px;}
|
||||
.pull-4 {margin-left:-160px;}
|
||||
.pull-5 {margin-left:-200px;}
|
||||
.pull-6 {margin-left:-240px;}
|
||||
.pull-7 {margin-left:-280px;}
|
||||
.pull-8 {margin-left:-320px;}
|
||||
.pull-9 {margin-left:-360px;}
|
||||
.pull-10 {margin-left:-400px;}
|
||||
.pull-11 {margin-left:-440px;}
|
||||
.pull-12 {margin-left:-480px;}
|
||||
.pull-13 {margin-left:-520px;}
|
||||
.pull-14 {margin-left:-560px;}
|
||||
.pull-15 {margin-left:-600px;}
|
||||
.pull-16 {margin-left:-640px;}
|
||||
.pull-17 {margin-left:-680px;}
|
||||
.pull-18 {margin-left:-720px;}
|
||||
.pull-19 {margin-left:-760px;}
|
||||
.pull-20 {margin-left:-800px;}
|
||||
.pull-21 {margin-left:-840px;}
|
||||
.pull-22 {margin-left:-880px;}
|
||||
.pull-23 {margin-left:-920px;}
|
||||
.pull-24 {margin-left:-960px;}
|
||||
.pull-1, .pull-2, .pull-3, .pull-4, .pull-5, .pull-6, .pull-7, .pull-8, .pull-9, .pull-10, .pull-11, .pull-12, .pull-13, .pull-14, .pull-15, .pull-16, .pull-17, .pull-18, .pull-19, .pull-20, .pull-21, .pull-22, .pull-23, .pull-24 {float:left;position:relative;}
|
||||
.push-1 {margin:0 -40px 1.5em 40px;}
|
||||
.push-2 {margin:0 -80px 1.5em 80px;}
|
||||
.push-3 {margin:0 -120px 1.5em 120px;}
|
||||
.push-4 {margin:0 -160px 1.5em 160px;}
|
||||
.push-5 {margin:0 -200px 1.5em 200px;}
|
||||
.push-6 {margin:0 -240px 1.5em 240px;}
|
||||
.push-7 {margin:0 -280px 1.5em 280px;}
|
||||
.push-8 {margin:0 -320px 1.5em 320px;}
|
||||
.push-9 {margin:0 -360px 1.5em 360px;}
|
||||
.push-10 {margin:0 -400px 1.5em 400px;}
|
||||
.push-11 {margin:0 -440px 1.5em 440px;}
|
||||
.push-12 {margin:0 -480px 1.5em 480px;}
|
||||
.push-13 {margin:0 -520px 1.5em 520px;}
|
||||
.push-14 {margin:0 -560px 1.5em 560px;}
|
||||
.push-15 {margin:0 -600px 1.5em 600px;}
|
||||
.push-16 {margin:0 -640px 1.5em 640px;}
|
||||
.push-17 {margin:0 -680px 1.5em 680px;}
|
||||
.push-18 {margin:0 -720px 1.5em 720px;}
|
||||
.push-19 {margin:0 -760px 1.5em 760px;}
|
||||
.push-20 {margin:0 -800px 1.5em 800px;}
|
||||
.push-21 {margin:0 -840px 1.5em 840px;}
|
||||
.push-22 {margin:0 -880px 1.5em 880px;}
|
||||
.push-23 {margin:0 -920px 1.5em 920px;}
|
||||
.push-24 {margin:0 -960px 1.5em 960px;}
|
||||
.push-1, .push-2, .push-3, .push-4, .push-5, .push-6, .push-7, .push-8, .push-9, .push-10, .push-11, .push-12, .push-13, .push-14, .push-15, .push-16, .push-17, .push-18, .push-19, .push-20, .push-21, .push-22, .push-23, .push-24 {float:right;position:relative;}
|
||||
hr {background:#ddd;color:#ddd;clear:both;float:none;width:100%;height:.1em;margin:0 0 1.45em;border:none;}
|
||||
hr.space {background:#fff;color:#fff;}
|
||||
.clearfix:after {content:".";display:block;height:0;clear:both;visibility:hidden;max-height:0;}
|
||||
.clearfix, .container {display:inline-block;}
|
||||
* html .clearfix, * html .container {height:1%;}
|
||||
.clearfix, .container {display:block;}
|
||||
.clear {clear:both;}
|
||||
|
||||
/* Creates fancy serif style type */
|
||||
.fancy { color: #666; font-family: "Warnock Pro", "Goudy Old Style","Palatino","Book Antiqua", Georgia, serif; font-style: italic; font-weight: normal; }
|
||||
|
||||
/* TEXT CLASSES */
|
||||
|
||||
.small {font-size:.8em;margin-bottom:1.875em;line-height:1.875em;}
|
||||
.large {font-size:1.2em;line-height:2.5em;margin-bottom:1.25em;}
|
||||
.hide {display:none;}
|
||||
.quiet {color:#666;}
|
||||
.loud {color:#000;}
|
||||
.highlight {background:#ff0;}
|
||||
.top {margin-top:0;padding-top:0;}
|
||||
.bottom {margin-bottom:0;padding-bottom:0;}
|
||||
.thin {font-weight: lighter;}
|
||||
.error, .notice, .success {padding:.8em;margin-bottom:1.6em;border:2px solid #ddd;}
|
||||
.error {background:#FBE3E4;color:#8a1f11;border-color:#FBC2C4;}
|
||||
.notice {background:#FFF6BF;color:#514721;border-color:#FFD324;}
|
||||
.success {background:#E6EFC2;color:#264409;border-color:#C6D880;}
|
||||
.error a {color:#8a1f11; background:none; padding:0; margin:0; }
|
||||
.notice a {color:#514721; background:none; padding:0; margin:0; }
|
||||
.success a {color:#264409; background:none; padding:0; margin:0; }
|
||||
.center {text-align: center;}
|
||||
226
includes/kohana/modules/userguide/media/guide/css/shCore.css
Normal file
226
includes/kohana/modules/userguide/media/guide/css/shCore.css
Normal file
@@ -0,0 +1,226 @@
|
||||
/**
|
||||
* SyntaxHighlighter
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter
|
||||
*
|
||||
* SyntaxHighlighter is donationware. If you are using it, please donate.
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter/donate.html
|
||||
*
|
||||
* @version
|
||||
* 3.0.83 (July 02 2010)
|
||||
*
|
||||
* @copyright
|
||||
* Copyright (C) 2004-2010 Alex Gorbatchev.
|
||||
*
|
||||
* @license
|
||||
* Dual licensed under the MIT and GPL licenses.
|
||||
*/
|
||||
.syntaxhighlighter a,
|
||||
.syntaxhighlighter div,
|
||||
.syntaxhighlighter code,
|
||||
.syntaxhighlighter table,
|
||||
.syntaxhighlighter table td,
|
||||
.syntaxhighlighter table tr,
|
||||
.syntaxhighlighter table tbody,
|
||||
.syntaxhighlighter table thead,
|
||||
.syntaxhighlighter table caption,
|
||||
.syntaxhighlighter textarea {
|
||||
-moz-border-radius: 0 0 0 0 !important;
|
||||
-webkit-border-radius: 0 0 0 0 !important;
|
||||
background: none !important;
|
||||
border: 0 !important;
|
||||
bottom: auto !important;
|
||||
float: none !important;
|
||||
height: auto !important;
|
||||
left: auto !important;
|
||||
line-height: 1.1em !important;
|
||||
margin: 0 !important;
|
||||
outline: 0 !important;
|
||||
overflow: visible !important;
|
||||
padding: 0 !important;
|
||||
position: static !important;
|
||||
right: auto !important;
|
||||
text-align: left !important;
|
||||
top: auto !important;
|
||||
vertical-align: baseline !important;
|
||||
width: auto !important;
|
||||
box-sizing: content-box !important;
|
||||
font-family: "Consolas", "Bitstream Vera Sans Mono", "Courier New", Courier, monospace !important;
|
||||
font-weight: normal !important;
|
||||
font-style: normal !important;
|
||||
font-size: 1em !important;
|
||||
min-height: inherit !important;
|
||||
min-height: auto !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter {
|
||||
width: 100% !important;
|
||||
margin: 1em 0 1em 0 !important;
|
||||
position: relative !important;
|
||||
overflow: auto !important;
|
||||
font-size: 1em !important;
|
||||
}
|
||||
.syntaxhighlighter.source {
|
||||
overflow: hidden !important;
|
||||
}
|
||||
.syntaxhighlighter .bold {
|
||||
font-weight: bold !important;
|
||||
}
|
||||
.syntaxhighlighter .italic {
|
||||
font-style: italic !important;
|
||||
}
|
||||
.syntaxhighlighter .line {
|
||||
white-space: pre !important;
|
||||
}
|
||||
.syntaxhighlighter table {
|
||||
width: 100% !important;
|
||||
}
|
||||
.syntaxhighlighter table caption {
|
||||
text-align: left !important;
|
||||
padding: .5em 0 0.5em 1em !important;
|
||||
}
|
||||
.syntaxhighlighter table td.code {
|
||||
width: 100% !important;
|
||||
}
|
||||
.syntaxhighlighter table td.code .container {
|
||||
position: relative !important;
|
||||
}
|
||||
.syntaxhighlighter table td.code .container textarea {
|
||||
box-sizing: border-box !important;
|
||||
position: absolute !important;
|
||||
left: 0 !important;
|
||||
top: 0 !important;
|
||||
width: 100% !important;
|
||||
height: 100% !important;
|
||||
border: none !important;
|
||||
background: white !important;
|
||||
padding-left: 1em !important;
|
||||
overflow: hidden !important;
|
||||
white-space: pre !important;
|
||||
}
|
||||
.syntaxhighlighter table td.gutter .line {
|
||||
text-align: right !important;
|
||||
padding: 0 0.5em 0 1em !important;
|
||||
}
|
||||
.syntaxhighlighter table td.code .line {
|
||||
padding: 0 1em !important;
|
||||
}
|
||||
.syntaxhighlighter.nogutter td.code .container textarea, .syntaxhighlighter.nogutter td.code .line {
|
||||
padding-left: 0em !important;
|
||||
}
|
||||
.syntaxhighlighter.show {
|
||||
display: block !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed table {
|
||||
display: none !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar {
|
||||
padding: 0.1em 0.8em 0em 0.8em !important;
|
||||
font-size: 1em !important;
|
||||
position: static !important;
|
||||
width: auto !important;
|
||||
height: auto !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar span {
|
||||
display: inline !important;
|
||||
margin-right: 1em !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar span a {
|
||||
padding: 0 !important;
|
||||
display: none !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar span a.expandSource {
|
||||
display: inline !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar {
|
||||
position: absolute !important;
|
||||
right: 1px !important;
|
||||
top: 1px !important;
|
||||
width: 11px !important;
|
||||
height: 11px !important;
|
||||
font-size: 10px !important;
|
||||
z-index: 10 !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar span.title {
|
||||
display: inline !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar a {
|
||||
display: block !important;
|
||||
text-align: center !important;
|
||||
text-decoration: none !important;
|
||||
padding-top: 1px !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar a.expandSource {
|
||||
display: none !important;
|
||||
}
|
||||
.syntaxhighlighter.ie {
|
||||
font-size: .9em !important;
|
||||
padding: 1px 0 1px 0 !important;
|
||||
}
|
||||
.syntaxhighlighter.ie .toolbar {
|
||||
line-height: 8px !important;
|
||||
}
|
||||
.syntaxhighlighter.ie .toolbar a {
|
||||
padding-top: 0px !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .line.alt1 .content,
|
||||
.syntaxhighlighter.printing .line.alt2 .content,
|
||||
.syntaxhighlighter.printing .line.highlighted .number,
|
||||
.syntaxhighlighter.printing .line.highlighted.alt1 .content,
|
||||
.syntaxhighlighter.printing .line.highlighted.alt2 .content {
|
||||
background: none !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .line .number {
|
||||
color: #bbbbbb !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .line .content {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .toolbar {
|
||||
display: none !important;
|
||||
}
|
||||
.syntaxhighlighter.printing a {
|
||||
text-decoration: none !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .plain, .syntaxhighlighter.printing .plain a {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .comments, .syntaxhighlighter.printing .comments a {
|
||||
color: #008200 !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .string, .syntaxhighlighter.printing .string a {
|
||||
color: blue !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .keyword {
|
||||
color: #006699 !important;
|
||||
font-weight: bold !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .preprocessor {
|
||||
color: gray !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .variable {
|
||||
color: #aa7700 !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .value {
|
||||
color: #009900 !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .functions {
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .constants {
|
||||
color: #0066cc !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .script {
|
||||
font-weight: bold !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .color1, .syntaxhighlighter.printing .color1 a {
|
||||
color: gray !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .color2, .syntaxhighlighter.printing .color2 a {
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .color3, .syntaxhighlighter.printing .color3 a {
|
||||
color: red !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .break, .syntaxhighlighter.printing .break a {
|
||||
color: black !important;
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
/**
|
||||
* SyntaxHighlighter
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter
|
||||
*
|
||||
* SyntaxHighlighter is donationware. If you are using it, please donate.
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter/donate.html
|
||||
*
|
||||
* @version
|
||||
* 3.0.83 (July 02 2010)
|
||||
*
|
||||
* @copyright
|
||||
* Copyright (C) 2004-2010 Alex Gorbatchev.
|
||||
*
|
||||
* @license
|
||||
* Dual licensed under the MIT and GPL licenses.
|
||||
*/
|
||||
.syntaxhighlighter {
|
||||
background-color: white !important;
|
||||
}
|
||||
.syntaxhighlighter .line.alt1 {
|
||||
background-color: white !important;
|
||||
}
|
||||
.syntaxhighlighter .line.alt2 {
|
||||
background-color: white !important;
|
||||
}
|
||||
.syntaxhighlighter .line.highlighted.alt1, .syntaxhighlighter .line.highlighted.alt2 {
|
||||
background-color: #e0e0e0 !important;
|
||||
}
|
||||
.syntaxhighlighter .line.highlighted.number {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter table caption {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter .gutter {
|
||||
color: #afafaf !important;
|
||||
}
|
||||
.syntaxhighlighter .gutter .line {
|
||||
border-right: 3px solid #6ce26c !important;
|
||||
}
|
||||
.syntaxhighlighter .gutter .line.highlighted {
|
||||
background-color: #6ce26c !important;
|
||||
color: white !important;
|
||||
}
|
||||
.syntaxhighlighter.printing .line .content {
|
||||
border: none !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed {
|
||||
overflow: visible !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar {
|
||||
color: blue !important;
|
||||
background: white !important;
|
||||
border: 1px solid #6ce26c !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar a {
|
||||
color: blue !important;
|
||||
}
|
||||
.syntaxhighlighter.collapsed .toolbar a:hover {
|
||||
color: red !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar {
|
||||
color: white !important;
|
||||
background: #6ce26c !important;
|
||||
border: none !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar a {
|
||||
color: white !important;
|
||||
}
|
||||
.syntaxhighlighter .toolbar a:hover {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter .plain, .syntaxhighlighter .plain a {
|
||||
color: black !important;
|
||||
}
|
||||
.syntaxhighlighter .comments, .syntaxhighlighter .comments a {
|
||||
color: #008200 !important;
|
||||
}
|
||||
.syntaxhighlighter .string, .syntaxhighlighter .string a {
|
||||
color: blue !important;
|
||||
}
|
||||
.syntaxhighlighter .keyword {
|
||||
color: #006699 !important;
|
||||
}
|
||||
.syntaxhighlighter .preprocessor {
|
||||
color: gray !important;
|
||||
}
|
||||
.syntaxhighlighter .variable {
|
||||
color: #aa7700 !important;
|
||||
}
|
||||
.syntaxhighlighter .value {
|
||||
color: #009900 !important;
|
||||
}
|
||||
.syntaxhighlighter .functions {
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
.syntaxhighlighter .constants {
|
||||
color: #0066cc !important;
|
||||
}
|
||||
.syntaxhighlighter .script {
|
||||
font-weight: bold !important;
|
||||
color: #006699 !important;
|
||||
background-color: none !important;
|
||||
}
|
||||
.syntaxhighlighter .color1, .syntaxhighlighter .color1 a {
|
||||
color: gray !important;
|
||||
}
|
||||
.syntaxhighlighter .color2, .syntaxhighlighter .color2 a {
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
.syntaxhighlighter .color3, .syntaxhighlighter .color3 a {
|
||||
color: red !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .keyword {
|
||||
font-weight: bold !important;
|
||||
}
|
||||
@@ -0,0 +1,183 @@
|
||||
/**
|
||||
* SyntaxHighlighter
|
||||
* http://alexgorbatchev.com/
|
||||
*
|
||||
* SyntaxHighlighter is donationware. If you are using it, please donate.
|
||||
* http://alexgorbatchev.com/wiki/SyntaxHighlighter:Donate
|
||||
*
|
||||
* @version
|
||||
* 2.1.364 (October 15 2009)
|
||||
*
|
||||
* @copyright
|
||||
* Copyright (C) 2004-2009 Alex Gorbatchev.
|
||||
*
|
||||
* @license
|
||||
* This file is part of SyntaxHighlighter.
|
||||
*
|
||||
* SyntaxHighlighter is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Lesser General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* SyntaxHighlighter is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License
|
||||
* along with SyntaxHighlighter. If not, see <http://www.gnu.org/copyleft/lesser.html>.
|
||||
*/
|
||||
/************************************
|
||||
* Default Syntax Highlighter theme.
|
||||
*
|
||||
* Interface elements.
|
||||
************************************/
|
||||
|
||||
.syntaxhighlighter
|
||||
{
|
||||
|
||||
}
|
||||
|
||||
.syntaxhighlighter
|
||||
{
|
||||
width: 100% !important;
|
||||
margin: 0 !important;
|
||||
padding: 1px !important; /* adds a little border on top and bottom */
|
||||
position: relative !important;
|
||||
/*background-color: #fff !important;*/
|
||||
}
|
||||
|
||||
/* Highlighed line number */
|
||||
.syntaxhighlighter .line.highlighted .number
|
||||
{
|
||||
color: black !important;
|
||||
}
|
||||
|
||||
/* Highlighed line */
|
||||
.syntaxhighlighter .line.highlighted.alt1,
|
||||
.syntaxhighlighter .line.highlighted.alt2
|
||||
{
|
||||
background-color: #e0e0e0 !important;
|
||||
}
|
||||
|
||||
/* Gutter line numbers */
|
||||
.syntaxhighlighter .line .number
|
||||
{
|
||||
color: #afafaf !important;
|
||||
}
|
||||
|
||||
/* Add border to the lines */
|
||||
.syntaxhighlighter .line .content
|
||||
{
|
||||
border-left: none !important;
|
||||
padding-left: 0 !important;
|
||||
color: #000 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter.printing .line .content
|
||||
{
|
||||
border: 0 !important;
|
||||
}
|
||||
|
||||
/* First line */
|
||||
.syntaxhighlighter .line.alt1
|
||||
{
|
||||
/*background-color: #fff !important;*/
|
||||
}
|
||||
|
||||
/* Second line */
|
||||
.syntaxhighlighter .line.alt2
|
||||
{
|
||||
/*background-color: #F8F8F8 !important;*/
|
||||
}
|
||||
|
||||
.syntaxhighlighter .toolbar
|
||||
{
|
||||
background-color: #F8F8F8 !important;
|
||||
border: #E7E5DC solid 1px !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .toolbar a
|
||||
{
|
||||
color: #a0a0a0 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .toolbar a:hover
|
||||
{
|
||||
color: red !important;
|
||||
}
|
||||
|
||||
/************************************
|
||||
* Actual syntax highlighter colors.
|
||||
************************************/
|
||||
.syntaxhighlighter .plain,
|
||||
.syntaxhighlighter .plain a
|
||||
{
|
||||
color: #000 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .comments,
|
||||
.syntaxhighlighter .comments a
|
||||
{
|
||||
color: #008200 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .string,
|
||||
.syntaxhighlighter .string a
|
||||
{
|
||||
color: blue !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .keyword
|
||||
{
|
||||
color: #069 !important;
|
||||
font-weight: bold !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .preprocessor
|
||||
{
|
||||
color: gray !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .variable
|
||||
{
|
||||
color: #a70 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .value
|
||||
{
|
||||
color: #090 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .functions
|
||||
{
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .constants
|
||||
{
|
||||
color: #0066CC !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .script
|
||||
{
|
||||
background-color: yellow !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .color1,
|
||||
.syntaxhighlighter .color1 a
|
||||
{
|
||||
color: #808080 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .color2,
|
||||
.syntaxhighlighter .color2 a
|
||||
{
|
||||
color: #ff1493 !important;
|
||||
}
|
||||
|
||||
.syntaxhighlighter .color3,
|
||||
.syntaxhighlighter .color3 a
|
||||
{
|
||||
color: red !important;
|
||||
}
|
||||
BIN
includes/kohana/modules/userguide/media/guide/img/arrows.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/arrows.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 357 B |
Binary file not shown.
|
After Width: | Height: | Size: 195 B |
BIN
includes/kohana/modules/userguide/media/guide/img/content.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/content.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.9 KiB |
BIN
includes/kohana/modules/userguide/media/guide/img/ext_link.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/ext_link.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 144 B |
BIN
includes/kohana/modules/userguide/media/guide/img/h2_line.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/h2_line.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 184 B |
BIN
includes/kohana/modules/userguide/media/guide/img/h3_line.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/h3_line.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 184 B |
BIN
includes/kohana/modules/userguide/media/guide/img/header.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/header.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.9 KiB |
BIN
includes/kohana/modules/userguide/media/guide/img/kohana.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/kohana.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 8.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 4.7 KiB |
BIN
includes/kohana/modules/userguide/media/guide/img/lines.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/lines.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 181 B |
BIN
includes/kohana/modules/userguide/media/guide/img/orange-tab.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/orange-tab.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 215 B |
BIN
includes/kohana/modules/userguide/media/guide/img/wrapper.png
Normal file
BIN
includes/kohana/modules/userguide/media/guide/img/wrapper.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
@@ -0,0 +1,96 @@
|
||||
/**
|
||||
* Cookie plugin
|
||||
*
|
||||
* Copyright (c) 2006 Klaus Hartl (stilbuero.de)
|
||||
* Dual licensed under the MIT and GPL licenses:
|
||||
* http://www.opensource.org/licenses/mit-license.php
|
||||
* http://www.gnu.org/licenses/gpl.html
|
||||
*
|
||||
*/
|
||||
|
||||
/**
|
||||
* Create a cookie with the given name and value and other optional parameters.
|
||||
*
|
||||
* @example $.cookie('the_cookie', 'the_value');
|
||||
* @desc Set the value of a cookie.
|
||||
* @example $.cookie('the_cookie', 'the_value', { expires: 7, path: '/', domain: 'jquery.com', secure: true });
|
||||
* @desc Create a cookie with all available options.
|
||||
* @example $.cookie('the_cookie', 'the_value');
|
||||
* @desc Create a session cookie.
|
||||
* @example $.cookie('the_cookie', null);
|
||||
* @desc Delete a cookie by passing null as value. Keep in mind that you have to use the same path and domain
|
||||
* used when the cookie was set.
|
||||
*
|
||||
* @param String name The name of the cookie.
|
||||
* @param String value The value of the cookie.
|
||||
* @param Object options An object literal containing key/value pairs to provide optional cookie attributes.
|
||||
* @option Number|Date expires Either an integer specifying the expiration date from now on in days or a Date object.
|
||||
* If a negative value is specified (e.g. a date in the past), the cookie will be deleted.
|
||||
* If set to null or omitted, the cookie will be a session cookie and will not be retained
|
||||
* when the the browser exits.
|
||||
* @option String path The value of the path atribute of the cookie (default: path of page that created the cookie).
|
||||
* @option String domain The value of the domain attribute of the cookie (default: domain of page that created the cookie).
|
||||
* @option Boolean secure If true, the secure attribute of the cookie will be set and the cookie transmission will
|
||||
* require a secure protocol (like HTTPS).
|
||||
* @type undefined
|
||||
*
|
||||
* @name $.cookie
|
||||
* @cat Plugins/Cookie
|
||||
* @author Klaus Hartl/klaus.hartl@stilbuero.de
|
||||
*/
|
||||
|
||||
/**
|
||||
* Get the value of a cookie with the given name.
|
||||
*
|
||||
* @example $.cookie('the_cookie');
|
||||
* @desc Get the value of a cookie.
|
||||
*
|
||||
* @param String name The name of the cookie.
|
||||
* @return The value of the cookie.
|
||||
* @type String
|
||||
*
|
||||
* @name $.cookie
|
||||
* @cat Plugins/Cookie
|
||||
* @author Klaus Hartl/klaus.hartl@stilbuero.de
|
||||
*/
|
||||
jQuery.cookie = function(name, value, options) {
|
||||
if (typeof value != 'undefined') { // name and value given, set cookie
|
||||
options = options || {};
|
||||
if (value === null) {
|
||||
value = '';
|
||||
options.expires = -1;
|
||||
}
|
||||
var expires = '';
|
||||
if (options.expires && (typeof options.expires == 'number' || options.expires.toUTCString)) {
|
||||
var date;
|
||||
if (typeof options.expires == 'number') {
|
||||
date = new Date();
|
||||
date.setTime(date.getTime() + (options.expires * 24 * 60 * 60 * 1000));
|
||||
} else {
|
||||
date = options.expires;
|
||||
}
|
||||
expires = '; expires=' + date.toUTCString(); // use expires attribute, max-age is not supported by IE
|
||||
}
|
||||
// CAUTION: Needed to parenthesize options.path and options.domain
|
||||
// in the following expressions, otherwise they evaluate to undefined
|
||||
// in the packed version for some reason...
|
||||
var path = options.path ? '; path=' + (options.path) : '';
|
||||
var domain = options.domain ? '; domain=' + (options.domain) : '';
|
||||
var secure = options.secure ? '; secure' : '';
|
||||
document.cookie = [name, '=', encodeURIComponent(value), expires, path, domain, secure].join('');
|
||||
} else { // only name given, get cookie
|
||||
var cookieValue = null;
|
||||
if (document.cookie && document.cookie != '') {
|
||||
var cookies = document.cookie.split(';');
|
||||
for (var i = 0; i < cookies.length; i++) {
|
||||
var cookie = jQuery.trim(cookies[i]);
|
||||
// Does this cookie string begin with the name we want?
|
||||
if (cookie.substring(0, name.length + 1) == (name + '=')) {
|
||||
cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
return cookieValue;
|
||||
}
|
||||
};
|
||||
167
includes/kohana/modules/userguide/media/guide/js/jquery.min.js
vendored
Normal file
167
includes/kohana/modules/userguide/media/guide/js/jquery.min.js
vendored
Normal file
@@ -0,0 +1,167 @@
|
||||
/*!
|
||||
* jQuery JavaScript Library v1.4.4
|
||||
* http://jquery.com/
|
||||
*
|
||||
* Copyright 2010, John Resig
|
||||
* Dual licensed under the MIT or GPL Version 2 licenses.
|
||||
* http://jquery.org/license
|
||||
*
|
||||
* Includes Sizzle.js
|
||||
* http://sizzlejs.com/
|
||||
* Copyright 2010, The Dojo Foundation
|
||||
* Released under the MIT, BSD, and GPL Licenses.
|
||||
*
|
||||
* Date: Thu Nov 11 19:04:53 2010 -0500
|
||||
*/
|
||||
(function(E,B){function ka(a,b,d){if(d===B&&a.nodeType===1){d=a.getAttribute("data-"+b);if(typeof d==="string"){try{d=d==="true"?true:d==="false"?false:d==="null"?null:!c.isNaN(d)?parseFloat(d):Ja.test(d)?c.parseJSON(d):d}catch(e){}c.data(a,b,d)}else d=B}return d}function U(){return false}function ca(){return true}function la(a,b,d){d[0].type=a;return c.event.handle.apply(b,d)}function Ka(a){var b,d,e,f,h,l,k,o,x,r,A,C=[];f=[];h=c.data(this,this.nodeType?"events":"__events__");if(typeof h==="function")h=
|
||||
h.events;if(!(a.liveFired===this||!h||!h.live||a.button&&a.type==="click")){if(a.namespace)A=RegExp("(^|\\.)"+a.namespace.split(".").join("\\.(?:.*\\.)?")+"(\\.|$)");a.liveFired=this;var J=h.live.slice(0);for(k=0;k<J.length;k++){h=J[k];h.origType.replace(X,"")===a.type?f.push(h.selector):J.splice(k--,1)}f=c(a.target).closest(f,a.currentTarget);o=0;for(x=f.length;o<x;o++){r=f[o];for(k=0;k<J.length;k++){h=J[k];if(r.selector===h.selector&&(!A||A.test(h.namespace))){l=r.elem;e=null;if(h.preType==="mouseenter"||
|
||||
h.preType==="mouseleave"){a.type=h.preType;e=c(a.relatedTarget).closest(h.selector)[0]}if(!e||e!==l)C.push({elem:l,handleObj:h,level:r.level})}}}o=0;for(x=C.length;o<x;o++){f=C[o];if(d&&f.level>d)break;a.currentTarget=f.elem;a.data=f.handleObj.data;a.handleObj=f.handleObj;A=f.handleObj.origHandler.apply(f.elem,arguments);if(A===false||a.isPropagationStopped()){d=f.level;if(A===false)b=false;if(a.isImmediatePropagationStopped())break}}return b}}function Y(a,b){return(a&&a!=="*"?a+".":"")+b.replace(La,
|
||||
"`").replace(Ma,"&")}function ma(a,b,d){if(c.isFunction(b))return c.grep(a,function(f,h){return!!b.call(f,h,f)===d});else if(b.nodeType)return c.grep(a,function(f){return f===b===d});else if(typeof b==="string"){var e=c.grep(a,function(f){return f.nodeType===1});if(Na.test(b))return c.filter(b,e,!d);else b=c.filter(b,e)}return c.grep(a,function(f){return c.inArray(f,b)>=0===d})}function na(a,b){var d=0;b.each(function(){if(this.nodeName===(a[d]&&a[d].nodeName)){var e=c.data(a[d++]),f=c.data(this,
|
||||
e);if(e=e&&e.events){delete f.handle;f.events={};for(var h in e)for(var l in e[h])c.event.add(this,h,e[h][l],e[h][l].data)}}})}function Oa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function oa(a,b,d){var e=b==="width"?a.offsetWidth:a.offsetHeight;if(d==="border")return e;c.each(b==="width"?Pa:Qa,function(){d||(e-=parseFloat(c.css(a,"padding"+this))||0);if(d==="margin")e+=parseFloat(c.css(a,
|
||||
"margin"+this))||0;else e-=parseFloat(c.css(a,"border"+this+"Width"))||0});return e}function da(a,b,d,e){if(c.isArray(b)&&b.length)c.each(b,function(f,h){d||Ra.test(a)?e(a,h):da(a+"["+(typeof h==="object"||c.isArray(h)?f:"")+"]",h,d,e)});else if(!d&&b!=null&&typeof b==="object")c.isEmptyObject(b)?e(a,""):c.each(b,function(f,h){da(a+"["+f+"]",h,d,e)});else e(a,b)}function S(a,b){var d={};c.each(pa.concat.apply([],pa.slice(0,b)),function(){d[this]=a});return d}function qa(a){if(!ea[a]){var b=c("<"+
|
||||
a+">").appendTo("body"),d=b.css("display");b.remove();if(d==="none"||d==="")d="block";ea[a]=d}return ea[a]}function fa(a){return c.isWindow(a)?a:a.nodeType===9?a.defaultView||a.parentWindow:false}var t=E.document,c=function(){function a(){if(!b.isReady){try{t.documentElement.doScroll("left")}catch(j){setTimeout(a,1);return}b.ready()}}var b=function(j,s){return new b.fn.init(j,s)},d=E.jQuery,e=E.$,f,h=/^(?:[^<]*(<[\w\W]+>)[^>]*$|#([\w\-]+)$)/,l=/\S/,k=/^\s+/,o=/\s+$/,x=/\W/,r=/\d/,A=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,
|
||||
C=/^[\],:{}\s]*$/,J=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,w=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,I=/(?:^|:|,)(?:\s*\[)+/g,L=/(webkit)[ \/]([\w.]+)/,g=/(opera)(?:.*version)?[ \/]([\w.]+)/,i=/(msie) ([\w.]+)/,n=/(mozilla)(?:.*? rv:([\w.]+))?/,m=navigator.userAgent,p=false,q=[],u,y=Object.prototype.toString,F=Object.prototype.hasOwnProperty,M=Array.prototype.push,N=Array.prototype.slice,O=String.prototype.trim,D=Array.prototype.indexOf,R={};b.fn=b.prototype={init:function(j,
|
||||
s){var v,z,H;if(!j)return this;if(j.nodeType){this.context=this[0]=j;this.length=1;return this}if(j==="body"&&!s&&t.body){this.context=t;this[0]=t.body;this.selector="body";this.length=1;return this}if(typeof j==="string")if((v=h.exec(j))&&(v[1]||!s))if(v[1]){H=s?s.ownerDocument||s:t;if(z=A.exec(j))if(b.isPlainObject(s)){j=[t.createElement(z[1])];b.fn.attr.call(j,s,true)}else j=[H.createElement(z[1])];else{z=b.buildFragment([v[1]],[H]);j=(z.cacheable?z.fragment.cloneNode(true):z.fragment).childNodes}return b.merge(this,
|
||||
j)}else{if((z=t.getElementById(v[2]))&&z.parentNode){if(z.id!==v[2])return f.find(j);this.length=1;this[0]=z}this.context=t;this.selector=j;return this}else if(!s&&!x.test(j)){this.selector=j;this.context=t;j=t.getElementsByTagName(j);return b.merge(this,j)}else return!s||s.jquery?(s||f).find(j):b(s).find(j);else if(b.isFunction(j))return f.ready(j);if(j.selector!==B){this.selector=j.selector;this.context=j.context}return b.makeArray(j,this)},selector:"",jquery:"1.4.4",length:0,size:function(){return this.length},
|
||||
toArray:function(){return N.call(this,0)},get:function(j){return j==null?this.toArray():j<0?this.slice(j)[0]:this[j]},pushStack:function(j,s,v){var z=b();b.isArray(j)?M.apply(z,j):b.merge(z,j);z.prevObject=this;z.context=this.context;if(s==="find")z.selector=this.selector+(this.selector?" ":"")+v;else if(s)z.selector=this.selector+"."+s+"("+v+")";return z},each:function(j,s){return b.each(this,j,s)},ready:function(j){b.bindReady();if(b.isReady)j.call(t,b);else q&&q.push(j);return this},eq:function(j){return j===
|
||||
-1?this.slice(j):this.slice(j,+j+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(N.apply(this,arguments),"slice",N.call(arguments).join(","))},map:function(j){return this.pushStack(b.map(this,function(s,v){return j.call(s,v,s)}))},end:function(){return this.prevObject||b(null)},push:M,sort:[].sort,splice:[].splice};b.fn.init.prototype=b.fn;b.extend=b.fn.extend=function(){var j,s,v,z,H,G=arguments[0]||{},K=1,Q=arguments.length,ga=false;
|
||||
if(typeof G==="boolean"){ga=G;G=arguments[1]||{};K=2}if(typeof G!=="object"&&!b.isFunction(G))G={};if(Q===K){G=this;--K}for(;K<Q;K++)if((j=arguments[K])!=null)for(s in j){v=G[s];z=j[s];if(G!==z)if(ga&&z&&(b.isPlainObject(z)||(H=b.isArray(z)))){if(H){H=false;v=v&&b.isArray(v)?v:[]}else v=v&&b.isPlainObject(v)?v:{};G[s]=b.extend(ga,v,z)}else if(z!==B)G[s]=z}return G};b.extend({noConflict:function(j){E.$=e;if(j)E.jQuery=d;return b},isReady:false,readyWait:1,ready:function(j){j===true&&b.readyWait--;
|
||||
if(!b.readyWait||j!==true&&!b.isReady){if(!t.body)return setTimeout(b.ready,1);b.isReady=true;if(!(j!==true&&--b.readyWait>0))if(q){var s=0,v=q;for(q=null;j=v[s++];)j.call(t,b);b.fn.trigger&&b(t).trigger("ready").unbind("ready")}}},bindReady:function(){if(!p){p=true;if(t.readyState==="complete")return setTimeout(b.ready,1);if(t.addEventListener){t.addEventListener("DOMContentLoaded",u,false);E.addEventListener("load",b.ready,false)}else if(t.attachEvent){t.attachEvent("onreadystatechange",u);E.attachEvent("onload",
|
||||
b.ready);var j=false;try{j=E.frameElement==null}catch(s){}t.documentElement.doScroll&&j&&a()}}},isFunction:function(j){return b.type(j)==="function"},isArray:Array.isArray||function(j){return b.type(j)==="array"},isWindow:function(j){return j&&typeof j==="object"&&"setInterval"in j},isNaN:function(j){return j==null||!r.test(j)||isNaN(j)},type:function(j){return j==null?String(j):R[y.call(j)]||"object"},isPlainObject:function(j){if(!j||b.type(j)!=="object"||j.nodeType||b.isWindow(j))return false;if(j.constructor&&
|
||||
!F.call(j,"constructor")&&!F.call(j.constructor.prototype,"isPrototypeOf"))return false;for(var s in j);return s===B||F.call(j,s)},isEmptyObject:function(j){for(var s in j)return false;return true},error:function(j){throw j;},parseJSON:function(j){if(typeof j!=="string"||!j)return null;j=b.trim(j);if(C.test(j.replace(J,"@").replace(w,"]").replace(I,"")))return E.JSON&&E.JSON.parse?E.JSON.parse(j):(new Function("return "+j))();else b.error("Invalid JSON: "+j)},noop:function(){},globalEval:function(j){if(j&&
|
||||
l.test(j)){var s=t.getElementsByTagName("head")[0]||t.documentElement,v=t.createElement("script");v.type="text/javascript";if(b.support.scriptEval)v.appendChild(t.createTextNode(j));else v.text=j;s.insertBefore(v,s.firstChild);s.removeChild(v)}},nodeName:function(j,s){return j.nodeName&&j.nodeName.toUpperCase()===s.toUpperCase()},each:function(j,s,v){var z,H=0,G=j.length,K=G===B||b.isFunction(j);if(v)if(K)for(z in j){if(s.apply(j[z],v)===false)break}else for(;H<G;){if(s.apply(j[H++],v)===false)break}else if(K)for(z in j){if(s.call(j[z],
|
||||
z,j[z])===false)break}else for(v=j[0];H<G&&s.call(v,H,v)!==false;v=j[++H]);return j},trim:O?function(j){return j==null?"":O.call(j)}:function(j){return j==null?"":j.toString().replace(k,"").replace(o,"")},makeArray:function(j,s){var v=s||[];if(j!=null){var z=b.type(j);j.length==null||z==="string"||z==="function"||z==="regexp"||b.isWindow(j)?M.call(v,j):b.merge(v,j)}return v},inArray:function(j,s){if(s.indexOf)return s.indexOf(j);for(var v=0,z=s.length;v<z;v++)if(s[v]===j)return v;return-1},merge:function(j,
|
||||
s){var v=j.length,z=0;if(typeof s.length==="number")for(var H=s.length;z<H;z++)j[v++]=s[z];else for(;s[z]!==B;)j[v++]=s[z++];j.length=v;return j},grep:function(j,s,v){var z=[],H;v=!!v;for(var G=0,K=j.length;G<K;G++){H=!!s(j[G],G);v!==H&&z.push(j[G])}return z},map:function(j,s,v){for(var z=[],H,G=0,K=j.length;G<K;G++){H=s(j[G],G,v);if(H!=null)z[z.length]=H}return z.concat.apply([],z)},guid:1,proxy:function(j,s,v){if(arguments.length===2)if(typeof s==="string"){v=j;j=v[s];s=B}else if(s&&!b.isFunction(s)){v=
|
||||
s;s=B}if(!s&&j)s=function(){return j.apply(v||this,arguments)};if(j)s.guid=j.guid=j.guid||s.guid||b.guid++;return s},access:function(j,s,v,z,H,G){var K=j.length;if(typeof s==="object"){for(var Q in s)b.access(j,Q,s[Q],z,H,v);return j}if(v!==B){z=!G&&z&&b.isFunction(v);for(Q=0;Q<K;Q++)H(j[Q],s,z?v.call(j[Q],Q,H(j[Q],s)):v,G);return j}return K?H(j[0],s):B},now:function(){return(new Date).getTime()},uaMatch:function(j){j=j.toLowerCase();j=L.exec(j)||g.exec(j)||i.exec(j)||j.indexOf("compatible")<0&&n.exec(j)||
|
||||
[];return{browser:j[1]||"",version:j[2]||"0"}},browser:{}});b.each("Boolean Number String Function Array Date RegExp Object".split(" "),function(j,s){R["[object "+s+"]"]=s.toLowerCase()});m=b.uaMatch(m);if(m.browser){b.browser[m.browser]=true;b.browser.version=m.version}if(b.browser.webkit)b.browser.safari=true;if(D)b.inArray=function(j,s){return D.call(s,j)};if(!/\s/.test("\u00a0")){k=/^[\s\xA0]+/;o=/[\s\xA0]+$/}f=b(t);if(t.addEventListener)u=function(){t.removeEventListener("DOMContentLoaded",u,
|
||||
false);b.ready()};else if(t.attachEvent)u=function(){if(t.readyState==="complete"){t.detachEvent("onreadystatechange",u);b.ready()}};return E.jQuery=E.$=b}();(function(){c.support={};var a=t.documentElement,b=t.createElement("script"),d=t.createElement("div"),e="script"+c.now();d.style.display="none";d.innerHTML=" <link/><table></table><a href='/a' style='color:red;float:left;opacity:.55;'>a</a><input type='checkbox'/>";var f=d.getElementsByTagName("*"),h=d.getElementsByTagName("a")[0],l=t.createElement("select"),
|
||||
k=l.appendChild(t.createElement("option"));if(!(!f||!f.length||!h)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(h.getAttribute("style")),hrefNormalized:h.getAttribute("href")==="/a",opacity:/^0.55$/.test(h.style.opacity),cssFloat:!!h.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:k.selected,deleteExpando:true,optDisabled:false,checkClone:false,
|
||||
scriptEval:false,noCloneEvent:true,boxModel:null,inlineBlockNeedsLayout:false,shrinkWrapBlocks:false,reliableHiddenOffsets:true};l.disabled=true;c.support.optDisabled=!k.disabled;b.type="text/javascript";try{b.appendChild(t.createTextNode("window."+e+"=1;"))}catch(o){}a.insertBefore(b,a.firstChild);if(E[e]){c.support.scriptEval=true;delete E[e]}try{delete b.test}catch(x){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function r(){c.support.noCloneEvent=
|
||||
false;d.detachEvent("onclick",r)});d.cloneNode(true).fireEvent("onclick")}d=t.createElement("div");d.innerHTML="<input type='radio' name='radiotest' checked='checked'/>";a=t.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var r=t.createElement("div");r.style.width=r.style.paddingLeft="1px";t.body.appendChild(r);c.boxModel=c.support.boxModel=r.offsetWidth===2;if("zoom"in r.style){r.style.display="inline";r.style.zoom=
|
||||
1;c.support.inlineBlockNeedsLayout=r.offsetWidth===2;r.style.display="";r.innerHTML="<div style='width:4px;'></div>";c.support.shrinkWrapBlocks=r.offsetWidth!==2}r.innerHTML="<table><tr><td style='padding:0;display:none'></td><td>t</td></tr></table>";var A=r.getElementsByTagName("td");c.support.reliableHiddenOffsets=A[0].offsetHeight===0;A[0].style.display="";A[1].style.display="none";c.support.reliableHiddenOffsets=c.support.reliableHiddenOffsets&&A[0].offsetHeight===0;r.innerHTML="";t.body.removeChild(r).style.display=
|
||||
"none"});a=function(r){var A=t.createElement("div");r="on"+r;var C=r in A;if(!C){A.setAttribute(r,"return;");C=typeof A[r]==="function"}return C};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=f=h=null}})();var ra={},Ja=/^(?:\{.*\}|\[.*\])$/;c.extend({cache:{},uuid:0,expando:"jQuery"+c.now(),noData:{embed:true,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:true},data:function(a,b,d){if(c.acceptData(a)){a=a==E?ra:a;var e=a.nodeType,f=e?a[c.expando]:null,h=
|
||||
c.cache;if(!(e&&!f&&typeof b==="string"&&d===B)){if(e)f||(a[c.expando]=f=++c.uuid);else h=a;if(typeof b==="object")if(e)h[f]=c.extend(h[f],b);else c.extend(h,b);else if(e&&!h[f])h[f]={};a=e?h[f]:h;if(d!==B)a[b]=d;return typeof b==="string"?a[b]:a}}},removeData:function(a,b){if(c.acceptData(a)){a=a==E?ra:a;var d=a.nodeType,e=d?a[c.expando]:a,f=c.cache,h=d?f[e]:e;if(b){if(h){delete h[b];d&&c.isEmptyObject(h)&&c.removeData(a)}}else if(d&&c.support.deleteExpando)delete a[c.expando];else if(a.removeAttribute)a.removeAttribute(c.expando);
|
||||
else if(d)delete f[e];else for(var l in a)delete a[l]}},acceptData:function(a){if(a.nodeName){var b=c.noData[a.nodeName.toLowerCase()];if(b)return!(b===true||a.getAttribute("classid")!==b)}return true}});c.fn.extend({data:function(a,b){var d=null;if(typeof a==="undefined"){if(this.length){var e=this[0].attributes,f;d=c.data(this[0]);for(var h=0,l=e.length;h<l;h++){f=e[h].name;if(f.indexOf("data-")===0){f=f.substr(5);ka(this[0],f,d[f])}}}return d}else if(typeof a==="object")return this.each(function(){c.data(this,
|
||||
a)});var k=a.split(".");k[1]=k[1]?"."+k[1]:"";if(b===B){d=this.triggerHandler("getData"+k[1]+"!",[k[0]]);if(d===B&&this.length){d=c.data(this[0],a);d=ka(this[0],a,d)}return d===B&&k[1]?this.data(k[0]):d}else return this.each(function(){var o=c(this),x=[k[0],b];o.triggerHandler("setData"+k[1]+"!",x);c.data(this,a,b);o.triggerHandler("changeData"+k[1]+"!",x)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var e=
|
||||
c.data(a,b);if(!d)return e||[];if(!e||c.isArray(d))e=c.data(a,b,c.makeArray(d));else e.push(d);return e}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),e=d.shift();if(e==="inprogress")e=d.shift();if(e){b==="fx"&&d.unshift("inprogress");e.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b===B)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,
|
||||
a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var sa=/[\n\t]/g,ha=/\s+/,Sa=/\r/g,Ta=/^(?:href|src|style)$/,Ua=/^(?:button|input)$/i,Va=/^(?:button|input|object|select|textarea)$/i,Wa=/^a(?:rea)?$/i,ta=/^(?:radio|checkbox)$/i;c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",
|
||||
colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};c.fn.extend({attr:function(a,b){return c.access(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(x){var r=c(this);r.addClass(a.call(this,x,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ha),d=0,e=this.length;d<e;d++){var f=this[d];if(f.nodeType===
|
||||
1)if(f.className){for(var h=" "+f.className+" ",l=f.className,k=0,o=b.length;k<o;k++)if(h.indexOf(" "+b[k]+" ")<0)l+=" "+b[k];f.className=c.trim(l)}else f.className=a}return this},removeClass:function(a){if(c.isFunction(a))return this.each(function(o){var x=c(this);x.removeClass(a.call(this,o,x.attr("class")))});if(a&&typeof a==="string"||a===B)for(var b=(a||"").split(ha),d=0,e=this.length;d<e;d++){var f=this[d];if(f.nodeType===1&&f.className)if(a){for(var h=(" "+f.className+" ").replace(sa," "),
|
||||
l=0,k=b.length;l<k;l++)h=h.replace(" "+b[l]+" "," ");f.className=c.trim(h)}else f.className=""}return this},toggleClass:function(a,b){var d=typeof a,e=typeof b==="boolean";if(c.isFunction(a))return this.each(function(f){var h=c(this);h.toggleClass(a.call(this,f,h.attr("class"),b),b)});return this.each(function(){if(d==="string")for(var f,h=0,l=c(this),k=b,o=a.split(ha);f=o[h++];){k=e?k:!l.hasClass(f);l[k?"addClass":"removeClass"](f)}else if(d==="undefined"||d==="boolean"){this.className&&c.data(this,
|
||||
"__className__",this.className);this.className=this.className||a===false?"":c.data(this,"__className__")||""}})},hasClass:function(a){a=" "+a+" ";for(var b=0,d=this.length;b<d;b++)if((" "+this[b].className+" ").replace(sa," ").indexOf(a)>-1)return true;return false},val:function(a){if(!arguments.length){var b=this[0];if(b){if(c.nodeName(b,"option")){var d=b.attributes.value;return!d||d.specified?b.value:b.text}if(c.nodeName(b,"select")){var e=b.selectedIndex;d=[];var f=b.options;b=b.type==="select-one";
|
||||
if(e<0)return null;var h=b?e:0;for(e=b?e+1:f.length;h<e;h++){var l=f[h];if(l.selected&&(c.support.optDisabled?!l.disabled:l.getAttribute("disabled")===null)&&(!l.parentNode.disabled||!c.nodeName(l.parentNode,"optgroup"))){a=c(l).val();if(b)return a;d.push(a)}}return d}if(ta.test(b.type)&&!c.support.checkOn)return b.getAttribute("value")===null?"on":b.value;return(b.value||"").replace(Sa,"")}return B}var k=c.isFunction(a);return this.each(function(o){var x=c(this),r=a;if(this.nodeType===1){if(k)r=
|
||||
a.call(this,o,x.val());if(r==null)r="";else if(typeof r==="number")r+="";else if(c.isArray(r))r=c.map(r,function(C){return C==null?"":C+""});if(c.isArray(r)&&ta.test(this.type))this.checked=c.inArray(x.val(),r)>=0;else if(c.nodeName(this,"select")){var A=c.makeArray(r);c("option",this).each(function(){this.selected=c.inArray(c(this).val(),A)>=0});if(!A.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},
|
||||
attr:function(a,b,d,e){if(!a||a.nodeType===3||a.nodeType===8)return B;if(e&&b in c.attrFn)return c(a)[b](d);e=a.nodeType!==1||!c.isXMLDoc(a);var f=d!==B;b=e&&c.props[b]||b;var h=Ta.test(b);if((b in a||a[b]!==B)&&e&&!h){if(f){b==="type"&&Ua.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed");if(d===null)a.nodeType===1&&a.removeAttribute(b);else a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&
|
||||
b.specified?b.value:Va.test(a.nodeName)||Wa.test(a.nodeName)&&a.href?0:B;return a[b]}if(!c.support.style&&e&&b==="style"){if(f)a.style.cssText=""+d;return a.style.cssText}f&&a.setAttribute(b,""+d);if(!a.attributes[b]&&a.hasAttribute&&!a.hasAttribute(b))return B;a=!c.support.hrefNormalized&&e&&h?a.getAttribute(b,2):a.getAttribute(b);return a===null?B:a}});var X=/\.(.*)$/,ia=/^(?:textarea|input|select)$/i,La=/\./g,Ma=/ /g,Xa=/[^\w\s.|`]/g,Ya=function(a){return a.replace(Xa,"\\$&")},ua={focusin:0,focusout:0};
|
||||
c.event={add:function(a,b,d,e){if(!(a.nodeType===3||a.nodeType===8)){if(c.isWindow(a)&&a!==E&&!a.frameElement)a=E;if(d===false)d=U;else if(!d)return;var f,h;if(d.handler){f=d;d=f.handler}if(!d.guid)d.guid=c.guid++;if(h=c.data(a)){var l=a.nodeType?"events":"__events__",k=h[l],o=h.handle;if(typeof k==="function"){o=k.handle;k=k.events}else if(!k){a.nodeType||(h[l]=h=function(){});h.events=k={}}if(!o)h.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,
|
||||
arguments):B};o.elem=a;b=b.split(" ");for(var x=0,r;l=b[x++];){h=f?c.extend({},f):{handler:d,data:e};if(l.indexOf(".")>-1){r=l.split(".");l=r.shift();h.namespace=r.slice(0).sort().join(".")}else{r=[];h.namespace=""}h.type=l;if(!h.guid)h.guid=d.guid;var A=k[l],C=c.event.special[l]||{};if(!A){A=k[l]=[];if(!C.setup||C.setup.call(a,e,r,o)===false)if(a.addEventListener)a.addEventListener(l,o,false);else a.attachEvent&&a.attachEvent("on"+l,o)}if(C.add){C.add.call(a,h);if(!h.handler.guid)h.handler.guid=
|
||||
d.guid}A.push(h);c.event.global[l]=true}a=null}}},global:{},remove:function(a,b,d,e){if(!(a.nodeType===3||a.nodeType===8)){if(d===false)d=U;var f,h,l=0,k,o,x,r,A,C,J=a.nodeType?"events":"__events__",w=c.data(a),I=w&&w[J];if(w&&I){if(typeof I==="function"){w=I;I=I.events}if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(f in I)c.event.remove(a,f+b)}else{for(b=b.split(" ");f=b[l++];){r=f;k=f.indexOf(".")<0;o=[];if(!k){o=f.split(".");f=o.shift();x=RegExp("(^|\\.)"+
|
||||
c.map(o.slice(0).sort(),Ya).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(A=I[f])if(d){r=c.event.special[f]||{};for(h=e||0;h<A.length;h++){C=A[h];if(d.guid===C.guid){if(k||x.test(C.namespace)){e==null&&A.splice(h--,1);r.remove&&r.remove.call(a,C)}if(e!=null)break}}if(A.length===0||e!=null&&A.length===1){if(!r.teardown||r.teardown.call(a,o)===false)c.removeEvent(a,f,w.handle);delete I[f]}}else for(h=0;h<A.length;h++){C=A[h];if(k||x.test(C.namespace)){c.event.remove(a,r,C.handler,h);A.splice(h--,1)}}}if(c.isEmptyObject(I)){if(b=
|
||||
w.handle)b.elem=null;delete w.events;delete w.handle;if(typeof w==="function")c.removeData(a,J);else c.isEmptyObject(w)&&c.removeData(a)}}}}},trigger:function(a,b,d,e){var f=a.type||a;if(!e){a=typeof a==="object"?a[c.expando]?a:c.extend(c.Event(f),a):c.Event(f);if(f.indexOf("!")>=0){a.type=f=f.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[f]&&c.each(c.cache,function(){this.events&&this.events[f]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===
|
||||
8)return B;a.result=B;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(e=d.nodeType?c.data(d,"handle"):(c.data(d,"__events__")||{}).handle)&&e.apply(d,b);e=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+f]&&d["on"+f].apply(d,b)===false){a.result=false;a.preventDefault()}}catch(h){}if(!a.isPropagationStopped()&&e)c.event.trigger(a,b,e,true);else if(!a.isDefaultPrevented()){var l;e=a.target;var k=f.replace(X,""),o=c.nodeName(e,"a")&&k===
|
||||
"click",x=c.event.special[k]||{};if((!x._default||x._default.call(d,a)===false)&&!o&&!(e&&e.nodeName&&c.noData[e.nodeName.toLowerCase()])){try{if(e[k]){if(l=e["on"+k])e["on"+k]=null;c.event.triggered=true;e[k]()}}catch(r){}if(l)e["on"+k]=l;c.event.triggered=false}}},handle:function(a){var b,d,e,f;d=[];var h=c.makeArray(arguments);a=h[0]=c.event.fix(a||E.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive;if(!b){e=a.type.split(".");a.type=e.shift();d=e.slice(0).sort();e=RegExp("(^|\\.)"+
|
||||
d.join("\\.(?:.*\\.)?")+"(\\.|$)")}a.namespace=a.namespace||d.join(".");f=c.data(this,this.nodeType?"events":"__events__");if(typeof f==="function")f=f.events;d=(f||{})[a.type];if(f&&d){d=d.slice(0);f=0;for(var l=d.length;f<l;f++){var k=d[f];if(b||e.test(k.namespace)){a.handler=k.handler;a.data=k.data;a.handleObj=k;k=k.handler.apply(this,h);if(k!==B){a.result=k;if(k===false){a.preventDefault();a.stopPropagation()}}if(a.isImmediatePropagationStopped())break}}}return a.result},props:"altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode layerX layerY metaKey newValue offsetX offsetY pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target toElement view wheelDelta which".split(" "),
|
||||
fix:function(a){if(a[c.expando])return a;var b=a;a=c.Event(b);for(var d=this.props.length,e;d;){e=this.props[--d];a[e]=b[e]}if(!a.target)a.target=a.srcElement||t;if(a.target.nodeType===3)a.target=a.target.parentNode;if(!a.relatedTarget&&a.fromElement)a.relatedTarget=a.fromElement===a.target?a.toElement:a.fromElement;if(a.pageX==null&&a.clientX!=null){b=t.documentElement;d=t.body;a.pageX=a.clientX+(b&&b.scrollLeft||d&&d.scrollLeft||0)-(b&&b.clientLeft||d&&d.clientLeft||0);a.pageY=a.clientY+(b&&b.scrollTop||
|
||||
d&&d.scrollTop||0)-(b&&b.clientTop||d&&d.clientTop||0)}if(a.which==null&&(a.charCode!=null||a.keyCode!=null))a.which=a.charCode!=null?a.charCode:a.keyCode;if(!a.metaKey&&a.ctrlKey)a.metaKey=a.ctrlKey;if(!a.which&&a.button!==B)a.which=a.button&1?1:a.button&2?3:a.button&4?2:0;return a},guid:1E8,proxy:c.proxy,special:{ready:{setup:c.bindReady,teardown:c.noop},live:{add:function(a){c.event.add(this,Y(a.origType,a.selector),c.extend({},a,{handler:Ka,guid:a.handler.guid}))},remove:function(a){c.event.remove(this,
|
||||
Y(a.origType,a.selector),a)}},beforeunload:{setup:function(a,b,d){if(c.isWindow(this))this.onbeforeunload=d},teardown:function(a,b){if(this.onbeforeunload===b)this.onbeforeunload=null}}}};c.removeEvent=t.removeEventListener?function(a,b,d){a.removeEventListener&&a.removeEventListener(b,d,false)}:function(a,b,d){a.detachEvent&&a.detachEvent("on"+b,d)};c.Event=function(a){if(!this.preventDefault)return new c.Event(a);if(a&&a.type){this.originalEvent=a;this.type=a.type}else this.type=a;this.timeStamp=
|
||||
c.now();this[c.expando]=true};c.Event.prototype={preventDefault:function(){this.isDefaultPrevented=ca;var a=this.originalEvent;if(a)if(a.preventDefault)a.preventDefault();else a.returnValue=false},stopPropagation:function(){this.isPropagationStopped=ca;var a=this.originalEvent;if(a){a.stopPropagation&&a.stopPropagation();a.cancelBubble=true}},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=ca;this.stopPropagation()},isDefaultPrevented:U,isPropagationStopped:U,isImmediatePropagationStopped:U};
|
||||
var va=function(a){var b=a.relatedTarget;try{for(;b&&b!==this;)b=b.parentNode;if(b!==this){a.type=a.data;c.event.handle.apply(this,arguments)}}catch(d){}},wa=function(a){a.type=a.data;c.event.handle.apply(this,arguments)};c.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(a,b){c.event.special[a]={setup:function(d){c.event.add(this,b,d&&d.selector?wa:va,a)},teardown:function(d){c.event.remove(this,b,d&&d.selector?wa:va)}}});if(!c.support.submitBubbles)c.event.special.submit={setup:function(){if(this.nodeName.toLowerCase()!==
|
||||
"form"){c.event.add(this,"click.specialSubmit",function(a){var b=a.target,d=b.type;if((d==="submit"||d==="image")&&c(b).closest("form").length){a.liveFired=B;return la("submit",this,arguments)}});c.event.add(this,"keypress.specialSubmit",function(a){var b=a.target,d=b.type;if((d==="text"||d==="password")&&c(b).closest("form").length&&a.keyCode===13){a.liveFired=B;return la("submit",this,arguments)}})}else return false},teardown:function(){c.event.remove(this,".specialSubmit")}};if(!c.support.changeBubbles){var V,
|
||||
xa=function(a){var b=a.type,d=a.value;if(b==="radio"||b==="checkbox")d=a.checked;else if(b==="select-multiple")d=a.selectedIndex>-1?c.map(a.options,function(e){return e.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},Z=function(a,b){var d=a.target,e,f;if(!(!ia.test(d.nodeName)||d.readOnly)){e=c.data(d,"_change_data");f=xa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data",f);if(!(e===B||f===e))if(e!=null||f){a.type="change";a.liveFired=
|
||||
B;return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:Z,beforedeactivate:Z,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return Z.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return Z.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a,"_change_data",xa(a))}},setup:function(){if(this.type===
|
||||
"file")return false;for(var a in V)c.event.add(this,a+".specialChange",V[a]);return ia.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return ia.test(this.nodeName)}};V=c.event.special.change.filters;V.focus=V.beforeactivate}t.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(e){e=c.event.fix(e);e.type=b;return c.event.trigger(e,null,e.target)}c.event.special[b]={setup:function(){ua[b]++===0&&t.addEventListener(a,d,true)},teardown:function(){--ua[b]===
|
||||
0&&t.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,e,f){if(typeof d==="object"){for(var h in d)this[b](h,e,d[h],f);return this}if(c.isFunction(e)||e===false){f=e;e=B}var l=b==="one"?c.proxy(f,function(o){c(this).unbind(o,l);return f.apply(this,arguments)}):f;if(d==="unload"&&b!=="one")this.one(d,e,f);else{h=0;for(var k=this.length;h<k;h++)c.event.add(this[h],d,l,e)}return this}});c.fn.extend({unbind:function(a,b){if(typeof a==="object"&&!a.preventDefault)for(var d in a)this.unbind(d,
|
||||
a[d]);else{d=0;for(var e=this.length;d<e;d++)c.event.remove(this[d],a,b)}return this},delegate:function(a,b,d,e){return this.live(b,d,e,a)},undelegate:function(a,b,d){return arguments.length===0?this.unbind("live"):this.die(b,null,d,a)},trigger:function(a,b){return this.each(function(){c.event.trigger(a,b,this)})},triggerHandler:function(a,b){if(this[0]){var d=c.Event(a);d.preventDefault();d.stopPropagation();c.event.trigger(d,b,this[0]);return d.result}},toggle:function(a){for(var b=arguments,d=
|
||||
1;d<b.length;)c.proxy(a,b[d++]);return this.click(c.proxy(a,function(e){var f=(c.data(this,"lastToggle"+a.guid)||0)%d;c.data(this,"lastToggle"+a.guid,f+1);e.preventDefault();return b[f].apply(this,arguments)||false}))},hover:function(a,b){return this.mouseenter(a).mouseleave(b||a)}});var ya={focus:"focusin",blur:"focusout",mouseenter:"mouseover",mouseleave:"mouseout"};c.each(["live","die"],function(a,b){c.fn[b]=function(d,e,f,h){var l,k=0,o,x,r=h||this.selector;h=h?this:c(this.context);if(typeof d===
|
||||
"object"&&!d.preventDefault){for(l in d)h[b](l,e,d[l],r);return this}if(c.isFunction(e)){f=e;e=B}for(d=(d||"").split(" ");(l=d[k++])!=null;){o=X.exec(l);x="";if(o){x=o[0];l=l.replace(X,"")}if(l==="hover")d.push("mouseenter"+x,"mouseleave"+x);else{o=l;if(l==="focus"||l==="blur"){d.push(ya[l]+x);l+=x}else l=(ya[l]||l)+x;if(b==="live"){x=0;for(var A=h.length;x<A;x++)c.event.add(h[x],"live."+Y(l,r),{data:e,selector:r,handler:f,origType:l,origHandler:f,preType:o})}else h.unbind("live."+Y(l,r),f)}}return this}});
|
||||
c.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error".split(" "),function(a,b){c.fn[b]=function(d,e){if(e==null){e=d;d=null}return arguments.length>0?this.bind(b,d,e):this.trigger(b)};if(c.attrFn)c.attrFn[b]=true});E.attachEvent&&!E.addEventListener&&c(E).bind("unload",function(){for(var a in c.cache)if(c.cache[a].handle)try{c.event.remove(c.cache[a].handle.elem)}catch(b){}});
|
||||
(function(){function a(g,i,n,m,p,q){p=0;for(var u=m.length;p<u;p++){var y=m[p];if(y){var F=false;for(y=y[g];y;){if(y.sizcache===n){F=m[y.sizset];break}if(y.nodeType===1&&!q){y.sizcache=n;y.sizset=p}if(y.nodeName.toLowerCase()===i){F=y;break}y=y[g]}m[p]=F}}}function b(g,i,n,m,p,q){p=0;for(var u=m.length;p<u;p++){var y=m[p];if(y){var F=false;for(y=y[g];y;){if(y.sizcache===n){F=m[y.sizset];break}if(y.nodeType===1){if(!q){y.sizcache=n;y.sizset=p}if(typeof i!=="string"){if(y===i){F=true;break}}else if(k.filter(i,
|
||||
[y]).length>0){F=y;break}}y=y[g]}m[p]=F}}}var d=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,e=0,f=Object.prototype.toString,h=false,l=true;[0,0].sort(function(){l=false;return 0});var k=function(g,i,n,m){n=n||[];var p=i=i||t;if(i.nodeType!==1&&i.nodeType!==9)return[];if(!g||typeof g!=="string")return n;var q,u,y,F,M,N=true,O=k.isXML(i),D=[],R=g;do{d.exec("");if(q=d.exec(R)){R=q[3];D.push(q[1]);if(q[2]){F=q[3];
|
||||
break}}}while(q);if(D.length>1&&x.exec(g))if(D.length===2&&o.relative[D[0]])u=L(D[0]+D[1],i);else for(u=o.relative[D[0]]?[i]:k(D.shift(),i);D.length;){g=D.shift();if(o.relative[g])g+=D.shift();u=L(g,u)}else{if(!m&&D.length>1&&i.nodeType===9&&!O&&o.match.ID.test(D[0])&&!o.match.ID.test(D[D.length-1])){q=k.find(D.shift(),i,O);i=q.expr?k.filter(q.expr,q.set)[0]:q.set[0]}if(i){q=m?{expr:D.pop(),set:C(m)}:k.find(D.pop(),D.length===1&&(D[0]==="~"||D[0]==="+")&&i.parentNode?i.parentNode:i,O);u=q.expr?k.filter(q.expr,
|
||||
q.set):q.set;if(D.length>0)y=C(u);else N=false;for(;D.length;){q=M=D.pop();if(o.relative[M])q=D.pop();else M="";if(q==null)q=i;o.relative[M](y,q,O)}}else y=[]}y||(y=u);y||k.error(M||g);if(f.call(y)==="[object Array]")if(N)if(i&&i.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&k.contains(i,y[g])))n.push(u[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&n.push(u[g]);else n.push.apply(n,y);else C(y,n);if(F){k(F,p,n,m);k.uniqueSort(n)}return n};k.uniqueSort=function(g){if(w){h=
|
||||
l;g.sort(w);if(h)for(var i=1;i<g.length;i++)g[i]===g[i-1]&&g.splice(i--,1)}return g};k.matches=function(g,i){return k(g,null,null,i)};k.matchesSelector=function(g,i){return k(i,null,null,[g]).length>0};k.find=function(g,i,n){var m;if(!g)return[];for(var p=0,q=o.order.length;p<q;p++){var u,y=o.order[p];if(u=o.leftMatch[y].exec(g)){var F=u[1];u.splice(1,1);if(F.substr(F.length-1)!=="\\"){u[1]=(u[1]||"").replace(/\\/g,"");m=o.find[y](u,i,n);if(m!=null){g=g.replace(o.match[y],"");break}}}}m||(m=i.getElementsByTagName("*"));
|
||||
return{set:m,expr:g}};k.filter=function(g,i,n,m){for(var p,q,u=g,y=[],F=i,M=i&&i[0]&&k.isXML(i[0]);g&&i.length;){for(var N in o.filter)if((p=o.leftMatch[N].exec(g))!=null&&p[2]){var O,D,R=o.filter[N];D=p[1];q=false;p.splice(1,1);if(D.substr(D.length-1)!=="\\"){if(F===y)y=[];if(o.preFilter[N])if(p=o.preFilter[N](p,F,n,y,m,M)){if(p===true)continue}else q=O=true;if(p)for(var j=0;(D=F[j])!=null;j++)if(D){O=R(D,p,j,F);var s=m^!!O;if(n&&O!=null)if(s)q=true;else F[j]=false;else if(s){y.push(D);q=true}}if(O!==
|
||||
B){n||(F=y);g=g.replace(o.match[N],"");if(!q)return[];break}}}if(g===u)if(q==null)k.error(g);else break;u=g}return F};k.error=function(g){throw"Syntax error, unrecognized expression: "+g;};var o=k.selectors={order:["ID","NAME","TAG"],match:{ID:/#((?:[\w\u00c0-\uFFFF\-]|\\.)+)/,CLASS:/\.((?:[\w\u00c0-\uFFFF\-]|\\.)+)/,NAME:/\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|\\.)+)['"]*\]/,ATTR:/\[\s*((?:[\w\u00c0-\uFFFF\-]|\\.)+)\s*(?:(\S?=)\s*(['"]*)(.*?)\3|)\s*\]/,TAG:/^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/,CHILD:/:(only|nth|last|first)-child(?:\((even|odd|[\dn+\-]*)\))?/,
|
||||
POS:/:(nth|eq|gt|lt|first|last|even|odd)(?:\((\d*)\))?(?=[^\-]|$)/,PSEUDO:/:((?:[\w\u00c0-\uFFFF\-]|\\.)+)(?:\((['"]?)((?:\([^\)]+\)|[^\(\)]*)+)\2\))?/},leftMatch:{},attrMap:{"class":"className","for":"htmlFor"},attrHandle:{href:function(g){return g.getAttribute("href")}},relative:{"+":function(g,i){var n=typeof i==="string",m=n&&!/\W/.test(i);n=n&&!m;if(m)i=i.toLowerCase();m=0;for(var p=g.length,q;m<p;m++)if(q=g[m]){for(;(q=q.previousSibling)&&q.nodeType!==1;);g[m]=n||q&&q.nodeName.toLowerCase()===
|
||||
i?q||false:q===i}n&&k.filter(i,g,true)},">":function(g,i){var n,m=typeof i==="string",p=0,q=g.length;if(m&&!/\W/.test(i))for(i=i.toLowerCase();p<q;p++){if(n=g[p]){n=n.parentNode;g[p]=n.nodeName.toLowerCase()===i?n:false}}else{for(;p<q;p++)if(n=g[p])g[p]=m?n.parentNode:n.parentNode===i;m&&k.filter(i,g,true)}},"":function(g,i,n){var m,p=e++,q=b;if(typeof i==="string"&&!/\W/.test(i)){m=i=i.toLowerCase();q=a}q("parentNode",i,p,g,m,n)},"~":function(g,i,n){var m,p=e++,q=b;if(typeof i==="string"&&!/\W/.test(i)){m=
|
||||
i=i.toLowerCase();q=a}q("previousSibling",i,p,g,m,n)}},find:{ID:function(g,i,n){if(typeof i.getElementById!=="undefined"&&!n)return(g=i.getElementById(g[1]))&&g.parentNode?[g]:[]},NAME:function(g,i){if(typeof i.getElementsByName!=="undefined"){for(var n=[],m=i.getElementsByName(g[1]),p=0,q=m.length;p<q;p++)m[p].getAttribute("name")===g[1]&&n.push(m[p]);return n.length===0?null:n}},TAG:function(g,i){return i.getElementsByTagName(g[1])}},preFilter:{CLASS:function(g,i,n,m,p,q){g=" "+g[1].replace(/\\/g,
|
||||
"")+" ";if(q)return g;q=0;for(var u;(u=i[q])!=null;q++)if(u)if(p^(u.className&&(" "+u.className+" ").replace(/[\t\n]/g," ").indexOf(g)>=0))n||m.push(u);else if(n)i[q]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()},CHILD:function(g){if(g[1]==="nth"){var i=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=i[1]+(i[2]||1)-0;g[3]=i[3]-0}g[0]=e++;return g},ATTR:function(g,i,n,
|
||||
m,p,q){i=g[1].replace(/\\/g,"");if(!q&&o.attrMap[i])g[1]=o.attrMap[i];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,i,n,m,p){if(g[1]==="not")if((d.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,i);else{g=k.filter(g[3],i,n,true^p);n||m.push.apply(m,g);return false}else if(o.match.POS.test(g[0])||o.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===
|
||||
true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,i,n){return!!k(n[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)},text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===
|
||||
g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}},setFilters:{first:function(g,i){return i===0},last:function(g,i,n,m){return i===m.length-1},even:function(g,i){return i%2===0},odd:function(g,i){return i%2===1},lt:function(g,i,n){return i<n[3]-0},gt:function(g,i,n){return i>n[3]-0},nth:function(g,i,n){return n[3]-
|
||||
0===i},eq:function(g,i,n){return n[3]-0===i}},filter:{PSEUDO:function(g,i,n,m){var p=i[1],q=o.filters[p];if(q)return q(g,n,i,m);else if(p==="contains")return(g.textContent||g.innerText||k.getText([g])||"").indexOf(i[3])>=0;else if(p==="not"){i=i[3];n=0;for(m=i.length;n<m;n++)if(i[n]===g)return false;return true}else k.error("Syntax error, unrecognized expression: "+p)},CHILD:function(g,i){var n=i[1],m=g;switch(n){case "only":case "first":for(;m=m.previousSibling;)if(m.nodeType===1)return false;if(n===
|
||||
"first")return true;m=g;case "last":for(;m=m.nextSibling;)if(m.nodeType===1)return false;return true;case "nth":n=i[2];var p=i[3];if(n===1&&p===0)return true;var q=i[0],u=g.parentNode;if(u&&(u.sizcache!==q||!g.nodeIndex)){var y=0;for(m=u.firstChild;m;m=m.nextSibling)if(m.nodeType===1)m.nodeIndex=++y;u.sizcache=q}m=g.nodeIndex-p;return n===0?m===0:m%n===0&&m/n>=0}},ID:function(g,i){return g.nodeType===1&&g.getAttribute("id")===i},TAG:function(g,i){return i==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===
|
||||
i},CLASS:function(g,i){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(i)>-1},ATTR:function(g,i){var n=i[1];n=o.attrHandle[n]?o.attrHandle[n](g):g[n]!=null?g[n]:g.getAttribute(n);var m=n+"",p=i[2],q=i[4];return n==null?p==="!=":p==="="?m===q:p==="*="?m.indexOf(q)>=0:p==="~="?(" "+m+" ").indexOf(q)>=0:!q?m&&n!==false:p==="!="?m!==q:p==="^="?m.indexOf(q)===0:p==="$="?m.substr(m.length-q.length)===q:p==="|="?m===q||m.substr(0,q.length+1)===q+"-":false},POS:function(g,i,n,m){var p=o.setFilters[i[2]];
|
||||
if(p)return p(g,n,i,m)}}},x=o.match.POS,r=function(g,i){return"\\"+(i-0+1)},A;for(A in o.match){o.match[A]=RegExp(o.match[A].source+/(?![^\[]*\])(?![^\(]*\))/.source);o.leftMatch[A]=RegExp(/(^(?:.|\r|\n)*?)/.source+o.match[A].source.replace(/\\(\d+)/g,r))}var C=function(g,i){g=Array.prototype.slice.call(g,0);if(i){i.push.apply(i,g);return i}return g};try{Array.prototype.slice.call(t.documentElement.childNodes,0)}catch(J){C=function(g,i){var n=0,m=i||[];if(f.call(g)==="[object Array]")Array.prototype.push.apply(m,
|
||||
g);else if(typeof g.length==="number")for(var p=g.length;n<p;n++)m.push(g[n]);else for(;g[n];n++)m.push(g[n]);return m}}var w,I;if(t.documentElement.compareDocumentPosition)w=function(g,i){if(g===i){h=true;return 0}if(!g.compareDocumentPosition||!i.compareDocumentPosition)return g.compareDocumentPosition?-1:1;return g.compareDocumentPosition(i)&4?-1:1};else{w=function(g,i){var n,m,p=[],q=[];n=g.parentNode;m=i.parentNode;var u=n;if(g===i){h=true;return 0}else if(n===m)return I(g,i);else if(n){if(!m)return 1}else return-1;
|
||||
for(;u;){p.unshift(u);u=u.parentNode}for(u=m;u;){q.unshift(u);u=u.parentNode}n=p.length;m=q.length;for(u=0;u<n&&u<m;u++)if(p[u]!==q[u])return I(p[u],q[u]);return u===n?I(g,q[u],-1):I(p[u],i,1)};I=function(g,i,n){if(g===i)return n;for(g=g.nextSibling;g;){if(g===i)return-1;g=g.nextSibling}return 1}}k.getText=function(g){for(var i="",n,m=0;g[m];m++){n=g[m];if(n.nodeType===3||n.nodeType===4)i+=n.nodeValue;else if(n.nodeType!==8)i+=k.getText(n.childNodes)}return i};(function(){var g=t.createElement("div"),
|
||||
i="script"+(new Date).getTime(),n=t.documentElement;g.innerHTML="<a name='"+i+"'/>";n.insertBefore(g,n.firstChild);if(t.getElementById(i)){o.find.ID=function(m,p,q){if(typeof p.getElementById!=="undefined"&&!q)return(p=p.getElementById(m[1]))?p.id===m[1]||typeof p.getAttributeNode!=="undefined"&&p.getAttributeNode("id").nodeValue===m[1]?[p]:B:[]};o.filter.ID=function(m,p){var q=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&q&&q.nodeValue===p}}n.removeChild(g);
|
||||
n=g=null})();(function(){var g=t.createElement("div");g.appendChild(t.createComment(""));if(g.getElementsByTagName("*").length>0)o.find.TAG=function(i,n){var m=n.getElementsByTagName(i[1]);if(i[1]==="*"){for(var p=[],q=0;m[q];q++)m[q].nodeType===1&&p.push(m[q]);m=p}return m};g.innerHTML="<a href='#'></a>";if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")o.attrHandle.href=function(i){return i.getAttribute("href",2)};g=null})();t.querySelectorAll&&
|
||||
function(){var g=k,i=t.createElement("div");i.innerHTML="<p class='TEST'></p>";if(!(i.querySelectorAll&&i.querySelectorAll(".TEST").length===0)){k=function(m,p,q,u){p=p||t;m=m.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!u&&!k.isXML(p))if(p.nodeType===9)try{return C(p.querySelectorAll(m),q)}catch(y){}else if(p.nodeType===1&&p.nodeName.toLowerCase()!=="object"){var F=p.getAttribute("id"),M=F||"__sizzle__";F||p.setAttribute("id",M);try{return C(p.querySelectorAll("#"+M+" "+m),q)}catch(N){}finally{F||
|
||||
p.removeAttribute("id")}}return g(m,p,q,u)};for(var n in g)k[n]=g[n];i=null}}();(function(){var g=t.documentElement,i=g.matchesSelector||g.mozMatchesSelector||g.webkitMatchesSelector||g.msMatchesSelector,n=false;try{i.call(t.documentElement,"[test!='']:sizzle")}catch(m){n=true}if(i)k.matchesSelector=function(p,q){q=q.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!k.isXML(p))try{if(n||!o.match.PSEUDO.test(q)&&!/!=/.test(q))return i.call(p,q)}catch(u){}return k(q,null,null,[p]).length>0}})();(function(){var g=
|
||||
t.createElement("div");g.innerHTML="<div class='test e'></div><div class='test'></div>";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){o.order.splice(1,0,"CLASS");o.find.CLASS=function(i,n,m){if(typeof n.getElementsByClassName!=="undefined"&&!m)return n.getElementsByClassName(i[1])};g=null}}})();k.contains=t.documentElement.contains?function(g,i){return g!==i&&(g.contains?g.contains(i):true)}:t.documentElement.compareDocumentPosition?
|
||||
function(g,i){return!!(g.compareDocumentPosition(i)&16)}:function(){return false};k.isXML=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false};var L=function(g,i){for(var n,m=[],p="",q=i.nodeType?[i]:i;n=o.match.PSEUDO.exec(g);){p+=n[0];g=g.replace(o.match.PSEUDO,"")}g=o.relative[g]?g+"*":g;n=0;for(var u=q.length;n<u;n++)k(g,q[n],m);return k.filter(p,m)};c.find=k;c.expr=k.selectors;c.expr[":"]=c.expr.filters;c.unique=k.uniqueSort;c.text=k.getText;c.isXMLDoc=k.isXML;
|
||||
c.contains=k.contains})();var Za=/Until$/,$a=/^(?:parents|prevUntil|prevAll)/,ab=/,/,Na=/^.[^:#\[\.,]*$/,bb=Array.prototype.slice,cb=c.expr.match.POS;c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,e=0,f=this.length;e<f;e++){d=b.length;c.find(a,this[e],b);if(e>0)for(var h=d;h<b.length;h++)for(var l=0;l<d;l++)if(b[l]===b[h]){b.splice(h--,1);break}}return b},has:function(a){var b=c(a);return this.filter(function(){for(var d=0,e=b.length;d<e;d++)if(c.contains(this,b[d]))return true})},
|
||||
not:function(a){return this.pushStack(ma(this,a,false),"not",a)},filter:function(a){return this.pushStack(ma(this,a,true),"filter",a)},is:function(a){return!!a&&c.filter(a,this).length>0},closest:function(a,b){var d=[],e,f,h=this[0];if(c.isArray(a)){var l,k={},o=1;if(h&&a.length){e=0;for(f=a.length;e<f;e++){l=a[e];k[l]||(k[l]=c.expr.match.POS.test(l)?c(l,b||this.context):l)}for(;h&&h.ownerDocument&&h!==b;){for(l in k){e=k[l];if(e.jquery?e.index(h)>-1:c(h).is(e))d.push({selector:l,elem:h,level:o})}h=
|
||||
h.parentNode;o++}}return d}l=cb.test(a)?c(a,b||this.context):null;e=0;for(f=this.length;e<f;e++)for(h=this[e];h;)if(l?l.index(h)>-1:c.find.matchesSelector(h,a)){d.push(h);break}else{h=h.parentNode;if(!h||!h.ownerDocument||h===b)break}d=d.length>1?c.unique(d):d;return this.pushStack(d,"closest",a)},index:function(a){if(!a||typeof a==="string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var d=typeof a==="string"?c(a,b||this.context):
|
||||
c.makeArray(a),e=c.merge(this.get(),d);return this.pushStack(!d[0]||!d[0].parentNode||d[0].parentNode.nodeType===11||!e[0]||!e[0].parentNode||e[0].parentNode.nodeType===11?e:c.unique(e))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode",d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,
|
||||
2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,
|
||||
b){c.fn[a]=function(d,e){var f=c.map(this,b,d);Za.test(a)||(e=d);if(e&&typeof e==="string")f=c.filter(e,f);f=this.length>1?c.unique(f):f;if((this.length>1||ab.test(e))&&$a.test(a))f=f.reverse();return this.pushStack(f,a,bb.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return b.length===1?c.find.matchesSelector(b[0],a)?[b[0]]:[]:c.find.matches(a,b)},dir:function(a,b,d){var e=[];for(a=a[b];a&&a.nodeType!==9&&(d===B||a.nodeType!==1||!c(a).is(d));){a.nodeType===1&&
|
||||
e.push(a);a=a[b]}return e},nth:function(a,b,d){b=b||1;for(var e=0;a;a=a[d])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var za=/ jQuery\d+="(?:\d+|null)"/g,$=/^\s+/,Aa=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Ba=/<([\w:]+)/,db=/<tbody/i,eb=/<|&#?\w+;/,Ca=/<(?:script|object|embed|option|style)/i,Da=/checked\s*(?:[^=]|=\s*.checked.)/i,fb=/\=([^="'>\s]+\/)>/g,P={option:[1,
|
||||
"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],area:[1,"<map>","</map>"],_default:[0,"",""]};P.optgroup=P.option;P.tbody=P.tfoot=P.colgroup=P.caption=P.thead;P.th=P.td;if(!c.support.htmlSerialize)P._default=[1,"div<div>","</div>"];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d=
|
||||
c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==B)return this.empty().append((this[0]&&this[0].ownerDocument||t).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this},
|
||||
wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})},
|
||||
prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,
|
||||
this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,e;(e=this[d])!=null;d++)if(!a||c.filter(a,[e]).length){if(!b&&e.nodeType===1){c.cleanData(e.getElementsByTagName("*"));c.cleanData([e])}e.parentNode&&e.parentNode.removeChild(e)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild);
|
||||
return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,e=this.ownerDocument;if(!d){d=e.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(za,"").replace(fb,'="$1">').replace($,"")],e)[0]}else return this.cloneNode(true)});if(a===true){na(this,b);na(this.find("*"),b.find("*"))}return b},html:function(a){if(a===B)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(za,""):null;
|
||||
else if(typeof a==="string"&&!Ca.test(a)&&(c.support.leadingWhitespace||!$.test(a))&&!P[(Ba.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Aa,"<$1></$2>");try{for(var b=0,d=this.length;b<d;b++)if(this[b].nodeType===1){c.cleanData(this[b].getElementsByTagName("*"));this[b].innerHTML=a}}catch(e){this.empty().append(a)}}else c.isFunction(a)?this.each(function(f){var h=c(this);h.html(a.call(this,f,h.html()))}):this.empty().append(a);return this},replaceWith:function(a){if(this[0]&&this[0].parentNode){if(c.isFunction(a))return this.each(function(b){var d=
|
||||
c(this),e=d.html();d.replaceWith(a.call(this,b,e))});if(typeof a!=="string")a=c(a).detach();return this.each(function(){var b=this.nextSibling,d=this.parentNode;c(this).remove();b?c(b).before(a):c(d).append(a)})}else return this.pushStack(c(c.isFunction(a)?a():a),"replaceWith",a)},detach:function(a){return this.remove(a,true)},domManip:function(a,b,d){var e,f,h,l=a[0],k=[];if(!c.support.checkClone&&arguments.length===3&&typeof l==="string"&&Da.test(l))return this.each(function(){c(this).domManip(a,
|
||||
b,d,true)});if(c.isFunction(l))return this.each(function(x){var r=c(this);a[0]=l.call(this,x,b?r.html():B);r.domManip(a,b,d)});if(this[0]){e=l&&l.parentNode;e=c.support.parentNode&&e&&e.nodeType===11&&e.childNodes.length===this.length?{fragment:e}:c.buildFragment(a,this,k);h=e.fragment;if(f=h.childNodes.length===1?h=h.firstChild:h.firstChild){b=b&&c.nodeName(f,"tr");f=0;for(var o=this.length;f<o;f++)d.call(b?c.nodeName(this[f],"table")?this[f].getElementsByTagName("tbody")[0]||this[f].appendChild(this[f].ownerDocument.createElement("tbody")):
|
||||
this[f]:this[f],f>0||e.cacheable||this.length>1?h.cloneNode(true):h)}k.length&&c.each(k,Oa)}return this}});c.buildFragment=function(a,b,d){var e,f,h;b=b&&b[0]?b[0].ownerDocument||b[0]:t;if(a.length===1&&typeof a[0]==="string"&&a[0].length<512&&b===t&&!Ca.test(a[0])&&(c.support.checkClone||!Da.test(a[0]))){f=true;if(h=c.fragments[a[0]])if(h!==1)e=h}if(!e){e=b.createDocumentFragment();c.clean(a,b,e,d)}if(f)c.fragments[a[0]]=h?e:1;return{fragment:e,cacheable:f}};c.fragments={};c.each({appendTo:"append",
|
||||
prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var e=[];d=c(d);var f=this.length===1&&this[0].parentNode;if(f&&f.nodeType===11&&f.childNodes.length===1&&d.length===1){d[b](this[0]);return this}else{f=0;for(var h=d.length;f<h;f++){var l=(f>0?this.clone(true):this).get();c(d[f])[b](l);e=e.concat(l)}return this.pushStack(e,a,d.selector)}}});c.extend({clean:function(a,b,d,e){b=b||t;if(typeof b.createElement==="undefined")b=b.ownerDocument||
|
||||
b[0]&&b[0].ownerDocument||t;for(var f=[],h=0,l;(l=a[h])!=null;h++){if(typeof l==="number")l+="";if(l){if(typeof l==="string"&&!eb.test(l))l=b.createTextNode(l);else if(typeof l==="string"){l=l.replace(Aa,"<$1></$2>");var k=(Ba.exec(l)||["",""])[1].toLowerCase(),o=P[k]||P._default,x=o[0],r=b.createElement("div");for(r.innerHTML=o[1]+l+o[2];x--;)r=r.lastChild;if(!c.support.tbody){x=db.test(l);k=k==="table"&&!x?r.firstChild&&r.firstChild.childNodes:o[1]==="<table>"&&!x?r.childNodes:[];for(o=k.length-
|
||||
1;o>=0;--o)c.nodeName(k[o],"tbody")&&!k[o].childNodes.length&&k[o].parentNode.removeChild(k[o])}!c.support.leadingWhitespace&&$.test(l)&&r.insertBefore(b.createTextNode($.exec(l)[0]),r.firstChild);l=r.childNodes}if(l.nodeType)f.push(l);else f=c.merge(f,l)}}if(d)for(h=0;f[h];h++)if(e&&c.nodeName(f[h],"script")&&(!f[h].type||f[h].type.toLowerCase()==="text/javascript"))e.push(f[h].parentNode?f[h].parentNode.removeChild(f[h]):f[h]);else{f[h].nodeType===1&&f.splice.apply(f,[h+1,0].concat(c.makeArray(f[h].getElementsByTagName("script"))));
|
||||
d.appendChild(f[h])}return f},cleanData:function(a){for(var b,d,e=c.cache,f=c.event.special,h=c.support.deleteExpando,l=0,k;(k=a[l])!=null;l++)if(!(k.nodeName&&c.noData[k.nodeName.toLowerCase()]))if(d=k[c.expando]){if((b=e[d])&&b.events)for(var o in b.events)f[o]?c.event.remove(k,o):c.removeEvent(k,o,b.handle);if(h)delete k[c.expando];else k.removeAttribute&&k.removeAttribute(c.expando);delete e[d]}}});var Ea=/alpha\([^)]*\)/i,gb=/opacity=([^)]*)/,hb=/-([a-z])/ig,ib=/([A-Z])/g,Fa=/^-?\d+(?:px)?$/i,
|
||||
jb=/^-?\d/,kb={position:"absolute",visibility:"hidden",display:"block"},Pa=["Left","Right"],Qa=["Top","Bottom"],W,Ga,aa,lb=function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){if(arguments.length===2&&b===B)return this;return c.access(this,a,b,true,function(d,e,f){return f!==B?c.style(d,e,f):c.css(d,e)})};c.extend({cssHooks:{opacity:{get:function(a,b){if(b){var d=W(a,"opacity","opacity");return d===""?"1":d}else return a.style.opacity}}},cssNumber:{zIndex:true,fontWeight:true,opacity:true,
|
||||
zoom:true,lineHeight:true},cssProps:{"float":c.support.cssFloat?"cssFloat":"styleFloat"},style:function(a,b,d,e){if(!(!a||a.nodeType===3||a.nodeType===8||!a.style)){var f,h=c.camelCase(b),l=a.style,k=c.cssHooks[h];b=c.cssProps[h]||h;if(d!==B){if(!(typeof d==="number"&&isNaN(d)||d==null)){if(typeof d==="number"&&!c.cssNumber[h])d+="px";if(!k||!("set"in k)||(d=k.set(a,d))!==B)try{l[b]=d}catch(o){}}}else{if(k&&"get"in k&&(f=k.get(a,false,e))!==B)return f;return l[b]}}},css:function(a,b,d){var e,f=c.camelCase(b),
|
||||
h=c.cssHooks[f];b=c.cssProps[f]||f;if(h&&"get"in h&&(e=h.get(a,true,d))!==B)return e;else if(W)return W(a,b,f)},swap:function(a,b,d){var e={},f;for(f in b){e[f]=a.style[f];a.style[f]=b[f]}d.call(a);for(f in b)a.style[f]=e[f]},camelCase:function(a){return a.replace(hb,lb)}});c.curCSS=c.css;c.each(["height","width"],function(a,b){c.cssHooks[b]={get:function(d,e,f){var h;if(e){if(d.offsetWidth!==0)h=oa(d,b,f);else c.swap(d,kb,function(){h=oa(d,b,f)});if(h<=0){h=W(d,b,b);if(h==="0px"&&aa)h=aa(d,b,b);
|
||||
if(h!=null)return h===""||h==="auto"?"0px":h}if(h<0||h==null){h=d.style[b];return h===""||h==="auto"?"0px":h}return typeof h==="string"?h:h+"px"}},set:function(d,e){if(Fa.test(e)){e=parseFloat(e);if(e>=0)return e+"px"}else return e}}});if(!c.support.opacity)c.cssHooks.opacity={get:function(a,b){return gb.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var d=a.style;d.zoom=1;var e=c.isNaN(b)?"":"alpha(opacity="+b*100+")",f=
|
||||
d.filter||"";d.filter=Ea.test(f)?f.replace(Ea,e):d.filter+" "+e}};if(t.defaultView&&t.defaultView.getComputedStyle)Ga=function(a,b,d){var e;d=d.replace(ib,"-$1").toLowerCase();if(!(b=a.ownerDocument.defaultView))return B;if(b=b.getComputedStyle(a,null)){e=b.getPropertyValue(d);if(e===""&&!c.contains(a.ownerDocument.documentElement,a))e=c.style(a,d)}return e};if(t.documentElement.currentStyle)aa=function(a,b){var d,e,f=a.currentStyle&&a.currentStyle[b],h=a.style;if(!Fa.test(f)&&jb.test(f)){d=h.left;
|
||||
e=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;h.left=b==="fontSize"?"1em":f||0;f=h.pixelLeft+"px";h.left=d;a.runtimeStyle.left=e}return f===""?"auto":f};W=Ga||aa;if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b=a.offsetHeight;return a.offsetWidth===0&&b===0||!c.support.reliableHiddenOffsets&&(a.style.display||c.css(a,"display"))==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var mb=c.now(),nb=/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,
|
||||
ob=/^(?:select|textarea)/i,pb=/^(?:color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,qb=/^(?:GET|HEAD)$/,Ra=/\[\]$/,T=/\=\?(&|$)/,ja=/\?/,rb=/([?&])_=[^&]*/,sb=/^(\w+:)?\/\/([^\/?#]+)/,tb=/%20/g,ub=/#.*$/,Ha=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!=="string"&&Ha)return Ha.apply(this,arguments);else if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var f=a.slice(e,a.length);a=a.slice(0,e)}e="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b===
|
||||
"object"){b=c.param(b,c.ajaxSettings.traditional);e="POST"}var h=this;c.ajax({url:a,type:e,dataType:"html",data:b,complete:function(l,k){if(k==="success"||k==="notmodified")h.html(f?c("<div>").append(l.responseText.replace(nb,"")).find(f):l.responseText);d&&h.each(d,[l.responseText,k,l])}});return this},serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&
|
||||
!this.disabled&&(this.checked||ob.test(this.nodeName)||pb.test(this.type))}).map(function(a,b){var d=c(this).val();return d==null?null:c.isArray(d)?c.map(d,function(e){return{name:b.name,value:e}}):{name:b.name,value:d}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,e){if(c.isFunction(b)){e=e||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:e})},
|
||||
getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,e){if(c.isFunction(b)){e=e||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:e})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href,global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:function(){return new E.XMLHttpRequest},accepts:{xml:"application/xml, text/xml",html:"text/html",
|
||||
script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},ajax:function(a){var b=c.extend(true,{},c.ajaxSettings,a),d,e,f,h=b.type.toUpperCase(),l=qb.test(h);b.url=b.url.replace(ub,"");b.context=a&&a.context!=null?a.context:b;if(b.data&&b.processData&&typeof b.data!=="string")b.data=c.param(b.data,b.traditional);if(b.dataType==="jsonp"){if(h==="GET")T.test(b.url)||(b.url+=(ja.test(b.url)?"&":"?")+(b.jsonp||"callback")+"=?");else if(!b.data||
|
||||
!T.test(b.data))b.data=(b.data?b.data+"&":"")+(b.jsonp||"callback")+"=?";b.dataType="json"}if(b.dataType==="json"&&(b.data&&T.test(b.data)||T.test(b.url))){d=b.jsonpCallback||"jsonp"+mb++;if(b.data)b.data=(b.data+"").replace(T,"="+d+"$1");b.url=b.url.replace(T,"="+d+"$1");b.dataType="script";var k=E[d];E[d]=function(m){if(c.isFunction(k))k(m);else{E[d]=B;try{delete E[d]}catch(p){}}f=m;c.handleSuccess(b,w,e,f);c.handleComplete(b,w,e,f);r&&r.removeChild(A)}}if(b.dataType==="script"&&b.cache===null)b.cache=
|
||||
false;if(b.cache===false&&l){var o=c.now(),x=b.url.replace(rb,"$1_="+o);b.url=x+(x===b.url?(ja.test(b.url)?"&":"?")+"_="+o:"")}if(b.data&&l)b.url+=(ja.test(b.url)?"&":"?")+b.data;b.global&&c.active++===0&&c.event.trigger("ajaxStart");o=(o=sb.exec(b.url))&&(o[1]&&o[1].toLowerCase()!==location.protocol||o[2].toLowerCase()!==location.host);if(b.dataType==="script"&&h==="GET"&&o){var r=t.getElementsByTagName("head")[0]||t.documentElement,A=t.createElement("script");if(b.scriptCharset)A.charset=b.scriptCharset;
|
||||
A.src=b.url;if(!d){var C=false;A.onload=A.onreadystatechange=function(){if(!C&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){C=true;c.handleSuccess(b,w,e,f);c.handleComplete(b,w,e,f);A.onload=A.onreadystatechange=null;r&&A.parentNode&&r.removeChild(A)}}}r.insertBefore(A,r.firstChild);return B}var J=false,w=b.xhr();if(w){b.username?w.open(h,b.url,b.async,b.username,b.password):w.open(h,b.url,b.async);try{if(b.data!=null&&!l||a&&a.contentType)w.setRequestHeader("Content-Type",
|
||||
b.contentType);if(b.ifModified){c.lastModified[b.url]&&w.setRequestHeader("If-Modified-Since",c.lastModified[b.url]);c.etag[b.url]&&w.setRequestHeader("If-None-Match",c.etag[b.url])}o||w.setRequestHeader("X-Requested-With","XMLHttpRequest");w.setRequestHeader("Accept",b.dataType&&b.accepts[b.dataType]?b.accepts[b.dataType]+", */*; q=0.01":b.accepts._default)}catch(I){}if(b.beforeSend&&b.beforeSend.call(b.context,w,b)===false){b.global&&c.active--===1&&c.event.trigger("ajaxStop");w.abort();return false}b.global&&
|
||||
c.triggerGlobal(b,"ajaxSend",[w,b]);var L=w.onreadystatechange=function(m){if(!w||w.readyState===0||m==="abort"){J||c.handleComplete(b,w,e,f);J=true;if(w)w.onreadystatechange=c.noop}else if(!J&&w&&(w.readyState===4||m==="timeout")){J=true;w.onreadystatechange=c.noop;e=m==="timeout"?"timeout":!c.httpSuccess(w)?"error":b.ifModified&&c.httpNotModified(w,b.url)?"notmodified":"success";var p;if(e==="success")try{f=c.httpData(w,b.dataType,b)}catch(q){e="parsererror";p=q}if(e==="success"||e==="notmodified")d||
|
||||
c.handleSuccess(b,w,e,f);else c.handleError(b,w,e,p);d||c.handleComplete(b,w,e,f);m==="timeout"&&w.abort();if(b.async)w=null}};try{var g=w.abort;w.abort=function(){w&&Function.prototype.call.call(g,w);L("abort")}}catch(i){}b.async&&b.timeout>0&&setTimeout(function(){w&&!J&&L("timeout")},b.timeout);try{w.send(l||b.data==null?null:b.data)}catch(n){c.handleError(b,w,null,n);c.handleComplete(b,w,e,f)}b.async||L();return w}},param:function(a,b){var d=[],e=function(h,l){l=c.isFunction(l)?l():l;d[d.length]=
|
||||
encodeURIComponent(h)+"="+encodeURIComponent(l)};if(b===B)b=c.ajaxSettings.traditional;if(c.isArray(a)||a.jquery)c.each(a,function(){e(this.name,this.value)});else for(var f in a)da(f,a[f],b,e);return d.join("&").replace(tb,"+")}});c.extend({active:0,lastModified:{},etag:{},handleError:function(a,b,d,e){a.error&&a.error.call(a.context,b,d,e);a.global&&c.triggerGlobal(a,"ajaxError",[b,a,e])},handleSuccess:function(a,b,d,e){a.success&&a.success.call(a.context,e,d,b);a.global&&c.triggerGlobal(a,"ajaxSuccess",
|
||||
[b,a])},handleComplete:function(a,b,d){a.complete&&a.complete.call(a.context,b,d);a.global&&c.triggerGlobal(a,"ajaxComplete",[b,a]);a.global&&c.active--===1&&c.event.trigger("ajaxStop")},triggerGlobal:function(a,b,d){(a.context&&a.context.url==null?c(a.context):c.event).trigger(b,d)},httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status===1223}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),
|
||||
e=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(e)c.etag[b]=e;return a.status===304},httpData:function(a,b,d){var e=a.getResponseHeader("content-type")||"",f=b==="xml"||!b&&e.indexOf("xml")>=0;a=f?a.responseXML:a.responseText;f&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b==="json"||!b&&e.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&e.indexOf("javascript")>=0)c.globalEval(a);return a}});
|
||||
if(E.ActiveXObject)c.ajaxSettings.xhr=function(){if(E.location.protocol!=="file:")try{return new E.XMLHttpRequest}catch(a){}try{return new E.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}};c.support.ajax=!!c.ajaxSettings.xhr();var ea={},vb=/^(?:toggle|show|hide)$/,wb=/^([+\-]=)?([\d+.\-]+)(.*)$/,ba,pa=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b,d){if(a||a===0)return this.animate(S("show",
|
||||
3),a,b,d);else{d=0;for(var e=this.length;d<e;d++){a=this[d];b=a.style.display;if(!c.data(a,"olddisplay")&&b==="none")b=a.style.display="";b===""&&c.css(a,"display")==="none"&&c.data(a,"olddisplay",qa(a.nodeName))}for(d=0;d<e;d++){a=this[d];b=a.style.display;if(b===""||b==="none")a.style.display=c.data(a,"olddisplay")||""}return this}},hide:function(a,b,d){if(a||a===0)return this.animate(S("hide",3),a,b,d);else{a=0;for(b=this.length;a<b;a++){d=c.css(this[a],"display");d!=="none"&&c.data(this[a],"olddisplay",
|
||||
d)}for(a=0;a<b;a++)this[a].style.display="none";return this}},_toggle:c.fn.toggle,toggle:function(a,b,d){var e=typeof a==="boolean";if(c.isFunction(a)&&c.isFunction(b))this._toggle.apply(this,arguments);else a==null||e?this.each(function(){var f=e?a:c(this).is(":hidden");c(this)[f?"show":"hide"]()}):this.animate(S("toggle",3),a,b,d);return this},fadeTo:function(a,b,d,e){return this.filter(":hidden").css("opacity",0).show().end().animate({opacity:b},a,d,e)},animate:function(a,b,d,e){var f=c.speed(b,
|
||||
d,e);if(c.isEmptyObject(a))return this.each(f.complete);return this[f.queue===false?"each":"queue"](function(){var h=c.extend({},f),l,k=this.nodeType===1,o=k&&c(this).is(":hidden"),x=this;for(l in a){var r=c.camelCase(l);if(l!==r){a[r]=a[l];delete a[l];l=r}if(a[l]==="hide"&&o||a[l]==="show"&&!o)return h.complete.call(this);if(k&&(l==="height"||l==="width")){h.overflow=[this.style.overflow,this.style.overflowX,this.style.overflowY];if(c.css(this,"display")==="inline"&&c.css(this,"float")==="none")if(c.support.inlineBlockNeedsLayout)if(qa(this.nodeName)===
|
||||
"inline")this.style.display="inline-block";else{this.style.display="inline";this.style.zoom=1}else this.style.display="inline-block"}if(c.isArray(a[l])){(h.specialEasing=h.specialEasing||{})[l]=a[l][1];a[l]=a[l][0]}}if(h.overflow!=null)this.style.overflow="hidden";h.curAnim=c.extend({},a);c.each(a,function(A,C){var J=new c.fx(x,h,A);if(vb.test(C))J[C==="toggle"?o?"show":"hide":C](a);else{var w=wb.exec(C),I=J.cur()||0;if(w){var L=parseFloat(w[2]),g=w[3]||"px";if(g!=="px"){c.style(x,A,(L||1)+g);I=(L||
|
||||
1)/J.cur()*I;c.style(x,A,I+g)}if(w[1])L=(w[1]==="-="?-1:1)*L+I;J.custom(I,L,g)}else J.custom(I,C,"")}});return true})},stop:function(a,b){var d=c.timers;a&&this.queue([]);this.each(function(){for(var e=d.length-1;e>=0;e--)if(d[e].elem===this){b&&d[e](true);d.splice(e,1)}});b||this.dequeue();return this}});c.each({slideDown:S("show",1),slideUp:S("hide",1),slideToggle:S("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(a,b){c.fn[a]=function(d,e,f){return this.animate(b,
|
||||
d,e,f)}});c.extend({speed:function(a,b,d){var e=a&&typeof a==="object"?c.extend({},a):{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};e.duration=c.fx.off?0:typeof e.duration==="number"?e.duration:e.duration in c.fx.speeds?c.fx.speeds[e.duration]:c.fx.speeds._default;e.old=e.complete;e.complete=function(){e.queue!==false&&c(this).dequeue();c.isFunction(e.old)&&e.old.call(this)};return e},easing:{linear:function(a,b,d,e){return d+e*a},swing:function(a,b,d,e){return(-Math.cos(a*
|
||||
Math.PI)/2+0.5)*e+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]||c.fx.step._default)(this)},cur:function(){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];var a=parseFloat(c.css(this.elem,this.prop));return a&&a>-1E4?a:0},custom:function(a,b,d){function e(l){return f.step(l)}
|
||||
var f=this,h=c.fx;this.startTime=c.now();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start;this.pos=this.state=0;e.elem=this.elem;if(e()&&c.timers.push(e)&&!ba)ba=setInterval(h.tick,h.interval)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;
|
||||
this.custom(this.cur(),0)},step:function(a){var b=c.now(),d=true;if(a||b>=this.options.duration+this.startTime){this.now=this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var e in this.options.curAnim)if(this.options.curAnim[e]!==true)d=false;if(d){if(this.options.overflow!=null&&!c.support.shrinkWrapBlocks){var f=this.elem,h=this.options;c.each(["","X","Y"],function(k,o){f.style["overflow"+o]=h.overflow[k]})}this.options.hide&&c(this.elem).hide();if(this.options.hide||
|
||||
this.options.show)for(var l in this.options.curAnim)c.style(this.elem,l,this.options.orig[l]);this.options.complete.call(this.elem)}return false}else{a=b-this.startTime;this.state=a/this.options.duration;b=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||b](this.state,a,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=
|
||||
c.timers,b=0;b<a.length;b++)a[b]()||a.splice(b--,1);a.length||c.fx.stop()},interval:13,stop:function(){clearInterval(ba);ba=null},speeds:{slow:600,fast:200,_default:400},step:{opacity:function(a){c.style(a.elem,"opacity",a.now)},_default:function(a){if(a.elem.style&&a.elem.style[a.prop]!=null)a.elem.style[a.prop]=(a.prop==="width"||a.prop==="height"?Math.max(0,a.now):a.now)+a.unit;else a.elem[a.prop]=a.now}}});if(c.expr&&c.expr.filters)c.expr.filters.animated=function(a){return c.grep(c.timers,function(b){return a===
|
||||
b.elem}).length};var xb=/^t(?:able|d|h)$/i,Ia=/^(?:body|html)$/i;c.fn.offset="getBoundingClientRect"in t.documentElement?function(a){var b=this[0],d;if(a)return this.each(function(l){c.offset.setOffset(this,a,l)});if(!b||!b.ownerDocument)return null;if(b===b.ownerDocument.body)return c.offset.bodyOffset(b);try{d=b.getBoundingClientRect()}catch(e){}var f=b.ownerDocument,h=f.documentElement;if(!d||!c.contains(h,b))return d||{top:0,left:0};b=f.body;f=fa(f);return{top:d.top+(f.pageYOffset||c.support.boxModel&&
|
||||
h.scrollTop||b.scrollTop)-(h.clientTop||b.clientTop||0),left:d.left+(f.pageXOffset||c.support.boxModel&&h.scrollLeft||b.scrollLeft)-(h.clientLeft||b.clientLeft||0)}}:function(a){var b=this[0];if(a)return this.each(function(x){c.offset.setOffset(this,a,x)});if(!b||!b.ownerDocument)return null;if(b===b.ownerDocument.body)return c.offset.bodyOffset(b);c.offset.initialize();var d,e=b.offsetParent,f=b.ownerDocument,h=f.documentElement,l=f.body;d=(f=f.defaultView)?f.getComputedStyle(b,null):b.currentStyle;
|
||||
for(var k=b.offsetTop,o=b.offsetLeft;(b=b.parentNode)&&b!==l&&b!==h;){if(c.offset.supportsFixedPosition&&d.position==="fixed")break;d=f?f.getComputedStyle(b,null):b.currentStyle;k-=b.scrollTop;o-=b.scrollLeft;if(b===e){k+=b.offsetTop;o+=b.offsetLeft;if(c.offset.doesNotAddBorder&&!(c.offset.doesAddBorderForTableAndCells&&xb.test(b.nodeName))){k+=parseFloat(d.borderTopWidth)||0;o+=parseFloat(d.borderLeftWidth)||0}e=b.offsetParent}if(c.offset.subtractsBorderForOverflowNotVisible&&d.overflow!=="visible"){k+=
|
||||
parseFloat(d.borderTopWidth)||0;o+=parseFloat(d.borderLeftWidth)||0}d=d}if(d.position==="relative"||d.position==="static"){k+=l.offsetTop;o+=l.offsetLeft}if(c.offset.supportsFixedPosition&&d.position==="fixed"){k+=Math.max(h.scrollTop,l.scrollTop);o+=Math.max(h.scrollLeft,l.scrollLeft)}return{top:k,left:o}};c.offset={initialize:function(){var a=t.body,b=t.createElement("div"),d,e,f,h=parseFloat(c.css(a,"marginTop"))||0;c.extend(b.style,{position:"absolute",top:0,left:0,margin:0,border:0,width:"1px",
|
||||
height:"1px",visibility:"hidden"});b.innerHTML="<div style='position:absolute;top:0;left:0;margin:0;border:5px solid #000;padding:0;width:1px;height:1px;'><div></div></div><table style='position:absolute;top:0;left:0;margin:0;border:5px solid #000;padding:0;width:1px;height:1px;' cellpadding='0' cellspacing='0'><tr><td></td></tr></table>";a.insertBefore(b,a.firstChild);d=b.firstChild;e=d.firstChild;f=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=e.offsetTop!==5;this.doesAddBorderForTableAndCells=
|
||||
f.offsetTop===5;e.style.position="fixed";e.style.top="20px";this.supportsFixedPosition=e.offsetTop===20||e.offsetTop===15;e.style.position=e.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=e.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==h;a.removeChild(b);c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.css(a,
|
||||
"marginTop"))||0;d+=parseFloat(c.css(a,"marginLeft"))||0}return{top:b,left:d}},setOffset:function(a,b,d){var e=c.css(a,"position");if(e==="static")a.style.position="relative";var f=c(a),h=f.offset(),l=c.css(a,"top"),k=c.css(a,"left"),o=e==="absolute"&&c.inArray("auto",[l,k])>-1;e={};var x={};if(o)x=f.position();l=o?x.top:parseInt(l,10)||0;k=o?x.left:parseInt(k,10)||0;if(c.isFunction(b))b=b.call(a,d,h);if(b.top!=null)e.top=b.top-h.top+l;if(b.left!=null)e.left=b.left-h.left+k;"using"in b?b.using.call(a,
|
||||
e):f.css(e)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),e=Ia.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.css(a,"marginTop"))||0;d.left-=parseFloat(c.css(a,"marginLeft"))||0;e.top+=parseFloat(c.css(b[0],"borderTopWidth"))||0;e.left+=parseFloat(c.css(b[0],"borderLeftWidth"))||0;return{top:d.top-e.top,left:d.left-e.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||t.body;a&&!Ia.test(a.nodeName)&&
|
||||
c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(e){var f=this[0],h;if(!f)return null;if(e!==B)return this.each(function(){if(h=fa(this))h.scrollTo(!a?e:c(h).scrollLeft(),a?e:c(h).scrollTop());else this[d]=e});else return(h=fa(f))?"pageXOffset"in h?h[a?"pageYOffset":"pageXOffset"]:c.support.boxModel&&h.document.documentElement[d]||h.document.body[d]:f[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();
|
||||
c.fn["inner"+b]=function(){return this[0]?parseFloat(c.css(this[0],d,"padding")):null};c.fn["outer"+b]=function(e){return this[0]?parseFloat(c.css(this[0],d,e?"margin":"border")):null};c.fn[d]=function(e){var f=this[0];if(!f)return e==null?null:this;if(c.isFunction(e))return this.each(function(l){var k=c(this);k[d](e.call(this,l,k[d]()))});if(c.isWindow(f))return f.document.compatMode==="CSS1Compat"&&f.document.documentElement["client"+b]||f.document.body["client"+b];else if(f.nodeType===9)return Math.max(f.documentElement["client"+
|
||||
b],f.body["scroll"+b],f.documentElement["scroll"+b],f.body["offset"+b],f.documentElement["offset"+b]);else if(e===B){f=c.css(f,d);var h=parseFloat(f);return c.isNaN(h)?f:h}else return this.css(d,typeof e==="string"?e:e+"px")}})})(window);
|
||||
97
includes/kohana/modules/userguide/media/guide/js/kodoc.js
Normal file
97
includes/kohana/modules/userguide/media/guide/js/kodoc.js
Normal file
@@ -0,0 +1,97 @@
|
||||
$(document).ready(function()
|
||||
{
|
||||
|
||||
// Syntax highlighter
|
||||
|
||||
$('pre:not(.debug) code').each(function()
|
||||
{
|
||||
$(this).addClass('brush: php, class-name: highlighted');
|
||||
});
|
||||
|
||||
SyntaxHighlighter.config.tagName = 'code';
|
||||
// Don't show the toolbar or line-numbers.
|
||||
SyntaxHighlighter.defaults.gutter = false;
|
||||
SyntaxHighlighter.all();
|
||||
|
||||
// Any link that has the current page as its href should be class="current"
|
||||
$('a[href="'+ window.location.pathname +'"]').addClass('current');
|
||||
|
||||
// Breadcrumbs magic
|
||||
$('#kodoc-breadcrumb li.last').each(function()
|
||||
{
|
||||
var $this = $(this);
|
||||
var $topics = $('#kodoc-topics li').has('a.current').slice(0, -1);
|
||||
|
||||
$topics.each(function()
|
||||
{
|
||||
// Create a copy of the menu link
|
||||
var $crumb = $(this).children('a:first, span:not(.toggle):first').clone();
|
||||
|
||||
// Insert the menu link into the breadcrumbs
|
||||
$('<li></li>').html($crumb).insertBefore($this);
|
||||
});
|
||||
});
|
||||
|
||||
// Collapsing menus
|
||||
$('#kodoc-topics li:has(li)').each(function()
|
||||
{
|
||||
var $this = $(this);
|
||||
var toggle = $('<span class="toggle"></span>');
|
||||
var menu = $this.find('>ul,>ol');
|
||||
|
||||
toggle.click(function()
|
||||
{
|
||||
if (menu.is(':visible'))
|
||||
{
|
||||
menu.stop(true, true).slideUp('fast');
|
||||
toggle.html('+');
|
||||
}
|
||||
else
|
||||
{
|
||||
menu.stop(true, true).slideDown('fast');
|
||||
toggle.html('–');
|
||||
}
|
||||
});
|
||||
|
||||
$this.find('>span').click(function()
|
||||
{
|
||||
// Menu without a link
|
||||
toggle.click();
|
||||
});
|
||||
|
||||
if ( ! $this.is(':has(a.current)'))
|
||||
{
|
||||
menu.hide();
|
||||
}
|
||||
|
||||
toggle.html(menu.is(':visible') ? '–' : '+').prependTo($this);
|
||||
});
|
||||
|
||||
// Show source links
|
||||
|
||||
$('#kodoc-main .method-source').each(function()
|
||||
{
|
||||
var self = $(this);
|
||||
var togg = $(' <a class="sourcecode-toggle">[show]</a>').appendTo($('h4', self));
|
||||
var code = self.find('pre').hide();
|
||||
|
||||
togg.toggle(function()
|
||||
{
|
||||
togg.html('[hide]');
|
||||
code.stop(true, true).slideDown();
|
||||
},
|
||||
function()
|
||||
{
|
||||
togg.html('[show]');
|
||||
code.stop(true, true).slideUp();
|
||||
});
|
||||
});
|
||||
|
||||
// "Link to this" link that appears when you hover over a header
|
||||
$('#kodoc-body')
|
||||
.find('h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]')
|
||||
.append(function(){
|
||||
var $this = $(this);
|
||||
return '<a href="#' + $this.attr('id') + '" class="permalink">link to this</a>';
|
||||
});
|
||||
});
|
||||
88
includes/kohana/modules/userguide/media/guide/js/shBrushPhp.js
vendored
Normal file
88
includes/kohana/modules/userguide/media/guide/js/shBrushPhp.js
vendored
Normal file
@@ -0,0 +1,88 @@
|
||||
/**
|
||||
* SyntaxHighlighter
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter
|
||||
*
|
||||
* SyntaxHighlighter is donationware. If you are using it, please donate.
|
||||
* http://alexgorbatchev.com/SyntaxHighlighter/donate.html
|
||||
*
|
||||
* @version
|
||||
* 3.0.83 (July 02 2010)
|
||||
*
|
||||
* @copyright
|
||||
* Copyright (C) 2004-2010 Alex Gorbatchev.
|
||||
*
|
||||
* @license
|
||||
* Dual licensed under the MIT and GPL licenses.
|
||||
*/
|
||||
;(function()
|
||||
{
|
||||
// CommonJS
|
||||
typeof(require) != 'undefined' ? SyntaxHighlighter = require('shCore').SyntaxHighlighter : null;
|
||||
|
||||
function Brush()
|
||||
{
|
||||
var funcs = 'abs acos acosh addcslashes addslashes ' +
|
||||
'array_change_key_case array_chunk array_combine array_count_values array_diff '+
|
||||
'array_diff_assoc array_diff_key array_diff_uassoc array_diff_ukey array_fill '+
|
||||
'array_filter array_flip array_intersect array_intersect_assoc array_intersect_key '+
|
||||
'array_intersect_uassoc array_intersect_ukey array_key_exists array_keys array_map '+
|
||||
'array_merge array_merge_recursive array_multisort array_pad array_pop array_product '+
|
||||
'array_push array_rand array_reduce array_reverse array_search array_shift '+
|
||||
'array_slice array_splice array_sum array_udiff array_udiff_assoc '+
|
||||
'array_udiff_uassoc array_uintersect array_uintersect_assoc '+
|
||||
'array_uintersect_uassoc array_unique array_unshift array_values array_walk '+
|
||||
'array_walk_recursive atan atan2 atanh base64_decode base64_encode base_convert '+
|
||||
'basename bcadd bccomp bcdiv bcmod bcmul bindec bindtextdomain bzclose bzcompress '+
|
||||
'bzdecompress bzerrno bzerror bzerrstr bzflush bzopen bzread bzwrite ceil chdir '+
|
||||
'checkdate checkdnsrr chgrp chmod chop chown chr chroot chunk_split class_exists '+
|
||||
'closedir closelog copy cos cosh count count_chars date decbin dechex decoct '+
|
||||
'deg2rad delete ebcdic2ascii echo empty end ereg ereg_replace eregi eregi_replace error_log '+
|
||||
'error_reporting escapeshellarg escapeshellcmd eval exec exit exp explode extension_loaded '+
|
||||
'feof fflush fgetc fgetcsv fgets fgetss file_exists file_get_contents file_put_contents '+
|
||||
'fileatime filectime filegroup fileinode filemtime fileowner fileperms filesize filetype '+
|
||||
'floatval flock floor flush fmod fnmatch fopen fpassthru fprintf fputcsv fputs fread fscanf '+
|
||||
'fseek fsockopen fstat ftell ftok getallheaders getcwd getdate getenv gethostbyaddr gethostbyname '+
|
||||
'gethostbynamel getimagesize getlastmod getmxrr getmygid getmyinode getmypid getmyuid getopt '+
|
||||
'getprotobyname getprotobynumber getrandmax getrusage getservbyname getservbyport gettext '+
|
||||
'gettimeofday gettype glob gmdate gmmktime ini_alter ini_get ini_get_all ini_restore ini_set '+
|
||||
'interface_exists intval ip2long is_a is_array is_bool is_callable is_dir is_double '+
|
||||
'is_executable is_file is_finite is_float is_infinite is_int is_integer is_link is_long '+
|
||||
'is_nan is_null is_numeric is_object is_readable is_real is_resource is_scalar is_soap_fault '+
|
||||
'is_string is_subclass_of is_uploaded_file is_writable is_writeable mkdir mktime nl2br '+
|
||||
'parse_ini_file parse_str parse_url passthru pathinfo print readlink realpath rewind rewinddir rmdir '+
|
||||
'round str_ireplace str_pad str_repeat str_replace str_rot13 str_shuffle str_split '+
|
||||
'str_word_count strcasecmp strchr strcmp strcoll strcspn strftime strip_tags stripcslashes '+
|
||||
'stripos stripslashes stristr strlen strnatcasecmp strnatcmp strncasecmp strncmp strpbrk '+
|
||||
'strpos strptime strrchr strrev strripos strrpos strspn strstr strtok strtolower strtotime '+
|
||||
'strtoupper strtr strval substr substr_compare';
|
||||
|
||||
var keywords = 'abstract and array as break case catch cfunction class clone const continue declare default die do ' +
|
||||
'else elseif enddeclare endfor endforeach endif endswitch endwhile extends final for foreach ' +
|
||||
'function include include_once global goto if implements interface instanceof namespace new ' +
|
||||
'old_function or private protected public return require require_once static switch ' +
|
||||
'throw try use var while xor ';
|
||||
|
||||
var constants = '__FILE__ __LINE__ __METHOD__ __FUNCTION__ __CLASS__';
|
||||
|
||||
this.regexList = [
|
||||
{ regex: SyntaxHighlighter.regexLib.singleLineCComments, css: 'comments' }, // one line comments
|
||||
{ regex: SyntaxHighlighter.regexLib.multiLineCComments, css: 'comments' }, // multiline comments
|
||||
{ regex: SyntaxHighlighter.regexLib.doubleQuotedString, css: 'string' }, // double quoted strings
|
||||
{ regex: SyntaxHighlighter.regexLib.singleQuotedString, css: 'string' }, // single quoted strings
|
||||
{ regex: /\$\w+/g, css: 'variable' }, // variables
|
||||
{ regex: new RegExp(this.getKeywords(funcs), 'gmi'), css: 'functions' }, // common functions
|
||||
{ regex: new RegExp(this.getKeywords(constants), 'gmi'), css: 'constants' }, // constants
|
||||
{ regex: new RegExp(this.getKeywords(keywords), 'gm'), css: 'keyword' } // keyword
|
||||
];
|
||||
|
||||
this.forHtmlScript(SyntaxHighlighter.regexLib.phpScriptTags);
|
||||
};
|
||||
|
||||
Brush.prototype = new SyntaxHighlighter.Highlighter();
|
||||
Brush.aliases = ['php'];
|
||||
|
||||
SyntaxHighlighter.brushes.Php = Brush;
|
||||
|
||||
// CommonJS
|
||||
typeof(exports) != 'undefined' ? exports.Brush = Brush : null;
|
||||
})();
|
||||
17
includes/kohana/modules/userguide/media/guide/js/shCore.js
vendored
Normal file
17
includes/kohana/modules/userguide/media/guide/js/shCore.js
vendored
Normal file
File diff suppressed because one or more lines are too long
1068
includes/kohana/modules/userguide/media/guide/js/sizzle.js
Normal file
1068
includes/kohana/modules/userguide/media/guide/js/sizzle.js
Normal file
File diff suppressed because it is too large
Load Diff
Binary file not shown.
|
After Width: | Height: | Size: 9.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 8.1 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 8.6 KiB |
14
includes/kohana/modules/userguide/messages/userguide.php
Normal file
14
includes/kohana/modules/userguide/messages/userguide.php
Normal file
@@ -0,0 +1,14 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
return array(
|
||||
'translations' => array(
|
||||
'de-de' => 'Deutsch',
|
||||
'en-us' => 'English',
|
||||
'es-es' => 'Español',
|
||||
'zh-cn' => '简体中文',
|
||||
'ru-ru' => 'Русский',
|
||||
'fr-fr' => 'Français',
|
||||
'he-il' => 'עברית',
|
||||
'nl' => 'Nederlands',
|
||||
),
|
||||
);
|
||||
368
includes/kohana/modules/userguide/tests/KodocTest.php
Normal file
368
includes/kohana/modules/userguide/tests/KodocTest.php
Normal file
@@ -0,0 +1,368 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* @group kohana
|
||||
* @group kohana.userguide
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2012 Kohana Team
|
||||
* @license http://kohanaframework.org/license
|
||||
*/
|
||||
class Kohana_KodocTest extends PHPUnit_Framework_TestCase
|
||||
{
|
||||
public function provider_parse_basic()
|
||||
{
|
||||
return array(
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* Description
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array("<p>Description</p>\n", array()),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* Description spanning
|
||||
* multiple lines
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array("<p>Description spanning\nmultiple lines</p>\n", array()),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* Description including
|
||||
*
|
||||
* a code block
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array("<p>Description including</p>\n\n<pre><code>a code block\n</code></pre>\n", array()),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* Indented
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array("<p>Indented</p>\n", array()),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @tag Content
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('tag' => array('Content'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @tag Multiple
|
||||
* @tag Tags
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('tag' => array('Multiple', 'Tags'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* Description with tag
|
||||
* @tag Content
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
"<p>Description with tag</p>\n",
|
||||
array('tag' => array('Content')),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @trailingspace
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('trailingspace' => array(''))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @tag Content that spans
|
||||
* multiple lines
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array('tag' => array("Content that spans\nmultiple lines")),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @tag Content that spans
|
||||
* multiple lines indented
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array('tag' => array("Content that spans\n multiple lines indented")),
|
||||
),
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @covers Kohana_Kodoc::parse
|
||||
*
|
||||
* @dataProvider provider_parse_basic
|
||||
*
|
||||
* @param string $comment Argument to the method
|
||||
* @param array $expected Expected result
|
||||
*/
|
||||
public function test_parse_basic($comment, $expected)
|
||||
{
|
||||
$this->assertSame($expected, Kodoc::parse($comment));
|
||||
}
|
||||
|
||||
public function provider_parse_tags()
|
||||
{
|
||||
$route_api = Route::get('docs/api');
|
||||
|
||||
return array(
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @access public
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array()),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @copyright Some plain text
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('copyright' => array('Some plain text'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @copyright (c) 2012 Kohana Team
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('copyright' => array('© 2012 Kohana Team'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @license Kohana
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('license' => array('Kohana'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @license http://kohanaframework.org/license
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('license' => array('<a href="http://kohanaframework.org/license">http://kohanaframework.org/license</a>'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @link http://kohanaframework.org
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('link' => array('<a href="http://kohanaframework.org">http://kohanaframework.org</a>'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @link http://kohanaframework.org Description
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array('', array('link' => array('<a href="http://kohanaframework.org">Description</a>'))),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @see MyClass
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'see' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'MyClass'))
|
||||
).'">MyClass</a>',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @see MyClass::method()
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'see' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'MyClass')).'#method'
|
||||
).'">MyClass::method()</a>',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @throws Exception
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'throws' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'Exception'))
|
||||
).'">Exception</a>',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @throws Exception During failure
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'throws' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'Exception'))
|
||||
).'">Exception</a> During failure',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @uses MyClass
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'uses' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'MyClass'))
|
||||
).'">MyClass</a>',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
array(
|
||||
<<<'COMMENT'
|
||||
/**
|
||||
* @uses MyClass::method()
|
||||
*/
|
||||
COMMENT
|
||||
,
|
||||
array(
|
||||
'',
|
||||
array(
|
||||
'uses' => array(
|
||||
'<a href="'.URL::site(
|
||||
$route_api->uri(array('class' => 'MyClass')).'#method'
|
||||
).'">MyClass::method()</a>',
|
||||
),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @covers Kohana_Kodoc::format_tag
|
||||
* @covers Kohana_Kodoc::parse
|
||||
*
|
||||
* @dataProvider provider_parse_tags
|
||||
*
|
||||
* @param string $comment Argument to the method
|
||||
* @param array $expected Expected result
|
||||
*/
|
||||
public function test_parse_tags($comment, $expected)
|
||||
{
|
||||
$this->assertSame($expected, Kodoc::parse($comment));
|
||||
}
|
||||
|
||||
/**
|
||||
* Provides test data for test_transparent_classes
|
||||
* @return array
|
||||
*/
|
||||
public function provider_transparent_classes()
|
||||
{
|
||||
return array(
|
||||
// Kohana_Core is a special case
|
||||
array('Kohana','Kohana_Core',NULL),
|
||||
array('Controller_Template','Kohana_Controller_Template',NULL),
|
||||
array('Controller_Template','Kohana_Controller_Template',
|
||||
array('Kohana_Controller_Template'=>'Kohana_Controller_Template',
|
||||
'Controller_Template'=>'Controller_Template')
|
||||
),
|
||||
array(FALSE,'Kohana_Controller_Template',
|
||||
array('Kohana_Controller_Template'=>'Kohana_Controller_Template')),
|
||||
array(FALSE,'Controller_Template',NULL),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests Kodoc::is_transparent
|
||||
*
|
||||
* Checks that a selection of transparent and non-transparent classes give expected results
|
||||
*
|
||||
* @group kohana.userguide.3529-configurable-transparent-classes
|
||||
* @dataProvider provider_transparent_classes
|
||||
* @param mixed $expected
|
||||
* @param string $class
|
||||
* @param array $classes
|
||||
*/
|
||||
public function test_transparent_classes($expected, $class, $classes)
|
||||
{
|
||||
$result = Kodoc::is_transparent($class, $classes);
|
||||
$this->assertSame($expected,$result);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,45 @@
|
||||
<?php defined('SYSPATH') OR die('Kohana bootstrap needs to be included before tests run');
|
||||
|
||||
/**
|
||||
* Unit tests for internal methods of userguide controller
|
||||
*
|
||||
* @group kohana
|
||||
* @group kohana.userguide
|
||||
* @group kohana.userguide.controller
|
||||
*
|
||||
* @package Kohana/Userguide
|
||||
* @category Tests
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2008-2012 Kohana Team
|
||||
* @license http://kohanaframework.org/license
|
||||
*/
|
||||
class Userguide_ControllerTest extends Unittest_TestCase
|
||||
{
|
||||
|
||||
public function provider_file_finds_markdown_files()
|
||||
{
|
||||
return array(
|
||||
array('userguide/adding', 'guide/userguide/adding.md'),
|
||||
array('userguide/adding.md', 'guide/userguide/adding.md'),
|
||||
array('userguide/adding.markdown', 'guide/userguide/adding.md'),
|
||||
array('userguide/does_not_exist.md', FALSE)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @dataProvider provider_file_finds_markdown_files
|
||||
* @param string $page Page name passed in the URL
|
||||
* @param string $expected_file Expected result from Controller_Userguide::file
|
||||
*/
|
||||
public function test_file_finds_markdown_files($page, $expected_file)
|
||||
{
|
||||
$controller = $this->getMock('Controller_Userguide', array('__construct'), array(), '', FALSE);
|
||||
$path = $controller->file($page);
|
||||
|
||||
// Only verify trailing segments to avoid problems if file overwritten in CFS
|
||||
$expected_len = strlen($expected_file);
|
||||
$file = substr($path, -$expected_len, $expected_len);
|
||||
|
||||
$this->assertEquals($expected_file, $file);
|
||||
}
|
||||
}
|
||||
36
includes/kohana/modules/userguide/vendor/markdown/License.text
vendored
Normal file
36
includes/kohana/modules/userguide/vendor/markdown/License.text
vendored
Normal file
@@ -0,0 +1,36 @@
|
||||
PHP Markdown & Extra
|
||||
Copyright (c) 2004-2008 Michel Fortin
|
||||
<http://www.michelf.com/>
|
||||
All rights reserved.
|
||||
|
||||
Based on Markdown
|
||||
Copyright (c) 2003-2006 John Gruber
|
||||
<http://daringfireball.net/>
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are
|
||||
met:
|
||||
|
||||
* Redistributions of source code must retain the above copyright notice,
|
||||
this list of conditions and the following disclaimer.
|
||||
|
||||
* Redistributions in binary form must reproduce the above copyright
|
||||
notice, this list of conditions and the following disclaimer in the
|
||||
documentation and/or other materials provided with the distribution.
|
||||
|
||||
* Neither the name "Markdown" nor the names of its contributors may
|
||||
be used to endorse or promote products derived from this software
|
||||
without specific prior written permission.
|
||||
|
||||
This software is provided by the copyright holders and contributors "as
|
||||
is" and any express or implied warranties, including, but not limited
|
||||
to, the implied warranties of merchantability and fitness for a
|
||||
particular purpose are disclaimed. In no event shall the copyright owner
|
||||
or contributors be liable for any direct, indirect, incidental, special,
|
||||
exemplary, or consequential damages (including, but not limited to,
|
||||
procurement of substitute goods or services; loss of use, data, or
|
||||
profits; or business interruption) however caused and on any theory of
|
||||
liability, whether in contract, strict liability, or tort (including
|
||||
negligence or otherwise) arising in any way out of the use of this
|
||||
software, even if advised of the possibility of such damage.
|
||||
2909
includes/kohana/modules/userguide/vendor/markdown/markdown.php
vendored
Normal file
2909
includes/kohana/modules/userguide/vendor/markdown/markdown.php
vendored
Normal file
File diff suppressed because it is too large
Load Diff
124
includes/kohana/modules/userguide/views/userguide/api/class.php
Normal file
124
includes/kohana/modules/userguide/views/userguide/api/class.php
Normal file
@@ -0,0 +1,124 @@
|
||||
<h1>
|
||||
<?php echo $doc->modifiers, $doc->class->name ?>
|
||||
<?php foreach ($doc->parents as $parent): ?>
|
||||
<br/><small>extends <?php echo HTML::anchor($route->uri(array('class' => $parent->name)), $parent->name, NULL, NULL, TRUE) ?></small>
|
||||
<?php endforeach; ?>
|
||||
</h1>
|
||||
|
||||
<?php if ($interfaces = $doc->class->getInterfaceNames()): ?>
|
||||
<p class="interfaces"><small>
|
||||
Implements:
|
||||
<?php
|
||||
for ($i = 0, $split = FALSE, $count = count($interfaces); $i < $count; $i++, $split = " | ")
|
||||
{
|
||||
echo $split . HTML::anchor($route->uri(array('class' => $interfaces[$i])), $interfaces[$i], NULL, NULL, TRUE);
|
||||
}
|
||||
?></small>
|
||||
</p>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php if ($child = $doc->is_transparent($doc->class->name)):?>
|
||||
<p class="note">
|
||||
This class is a transparent base class for <?php echo HTML::anchor($route->uri(array('class'=>$child)),$child) ?> and
|
||||
should not be accessed directly.
|
||||
</p>
|
||||
<?php endif;?>
|
||||
|
||||
<?php echo $doc->description() ?>
|
||||
|
||||
<?php if ($doc->tags): ?>
|
||||
<dl class="tags">
|
||||
<?php foreach ($doc->tags() as $name => $set): ?>
|
||||
<dt><?php echo $name ?></dt>
|
||||
<?php foreach ($set as $tag): ?>
|
||||
<dd><?php echo $tag ?></dd>
|
||||
<?php endforeach ?>
|
||||
<?php endforeach ?>
|
||||
</dl>
|
||||
<?php endif; ?>
|
||||
|
||||
<p class="note">
|
||||
<?php if ($path = $doc->class->getFilename()): ?>
|
||||
Class declared in <tt><?php echo Debug::path($path) ?></tt> on line <?php echo $doc->class->getStartLine() ?>.
|
||||
<?php else: ?>
|
||||
Class is not declared in a file, it is probably an internal <?php echo html::anchor('http://php.net/manual/class.'.strtolower($doc->class->name).'.php', 'PHP class') ?>.
|
||||
<?php endif ?>
|
||||
</p>
|
||||
|
||||
<div class="toc">
|
||||
<div class="constants">
|
||||
<h3><?php echo 'Constants'; ?></h3>
|
||||
<ul>
|
||||
<?php if ($doc->constants): ?>
|
||||
<?php foreach ($doc->constants as $name => $value): ?>
|
||||
<li><a href="#constant:<?php echo $name ?>"><?php echo $name ?></a></li>
|
||||
<?php endforeach ?>
|
||||
<?php else: ?>
|
||||
<li><em><?php echo 'None'; ?></em></li>
|
||||
<?php endif ?>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="properties">
|
||||
<h3><?php echo 'Properties'; ?></h3>
|
||||
<ul>
|
||||
<?php if ($properties = $doc->properties()): ?>
|
||||
<?php foreach ($properties as $prop): ?>
|
||||
<li><a href="#property:<?php echo $prop->property->name ?>">$<?php echo $prop->property->name ?></a></li>
|
||||
<?php endforeach ?>
|
||||
<?php else: ?>
|
||||
<li><em><?php echo 'None'; ?></em></li>
|
||||
<?php endif ?>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="methods">
|
||||
<h3><?php echo 'Methods'; ?></h3>
|
||||
<ul>
|
||||
<?php if ($methods = $doc->methods()): ?>
|
||||
<?php foreach ($methods as $method): ?>
|
||||
<li><a href="#<?php echo $method->method->name ?>"><?php echo $method->method->name ?>()</a></li>
|
||||
<?php endforeach ?>
|
||||
<?php else: ?>
|
||||
<li><em><?php echo 'None'; ?></em></li>
|
||||
<?php endif ?>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="clearfix"></div>
|
||||
|
||||
<?php if ($doc->constants): ?>
|
||||
<div class="constants">
|
||||
<h1 id="constants"><?php echo 'Constants'; ?></h1>
|
||||
<dl>
|
||||
<?php foreach ($doc->constants() as $name => $value): ?>
|
||||
<dt><h4 id="constant:<?php echo $name ?>"><?php echo $name ?></h4></dt>
|
||||
<dd><?php echo $value ?></dd>
|
||||
<?php endforeach; ?>
|
||||
</dl>
|
||||
</div>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($properties = $doc->properties()): ?>
|
||||
<h1 id="properties"><?php echo 'Properties'; ?></h1>
|
||||
<div class="properties">
|
||||
<dl>
|
||||
<?php foreach ($properties as $prop): ?>
|
||||
<dt><h4 id="property:<?php echo $prop->property->name ?>"><?php echo $prop->modifiers ?> <code><?php echo $prop->type ?></code> $<?php echo $prop->property->name ?></h4></dt>
|
||||
<dd><?php echo $prop->description ?></dd>
|
||||
<dd><?php echo $prop->value ?></dd>
|
||||
<?php if ($prop->default !== $prop->value): ?>
|
||||
<dd><small><?php echo __('Default value:') ?></small><br/><?php echo $prop->default ?></dd>
|
||||
<?php endif ?>
|
||||
<?php endforeach ?>
|
||||
</dl>
|
||||
</div>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($methods = $doc->methods()): ?>
|
||||
<h1 id="methods"><?php echo 'Methods'; ?></h1>
|
||||
<div class="methods">
|
||||
<?php foreach ($methods as $method): ?>
|
||||
<?php echo View::factory('userguide/api/method')->set('doc', $method)->set('route', $route) ?>
|
||||
<?php endforeach ?>
|
||||
</div>
|
||||
<?php endif ?>
|
||||
@@ -0,0 +1,18 @@
|
||||
|
||||
<h2>Modules</h2>
|
||||
<ol class="menu">
|
||||
<?php foreach ($menu as $package => $categories): ksort($categories); ?>
|
||||
<li><span><strong><?php echo $package ?></strong></span>
|
||||
<ol>
|
||||
<?php foreach ($categories as $category => $classes): sort($classes); ?>
|
||||
<li><?php if ($category !== 'Base'): ?><span><?php echo $category ?></span>
|
||||
<ol><?php endif ?>
|
||||
<?php foreach ($classes as $class): ?>
|
||||
<li><?php echo $class ?></li>
|
||||
<?php endforeach ?>
|
||||
<?php if ($category !== 'Base'): ?></ol><?php endif ?>
|
||||
</li>
|
||||
<?php endforeach ?>
|
||||
</ol>
|
||||
<?php endforeach ?>
|
||||
</ol>
|
||||
@@ -0,0 +1,45 @@
|
||||
<div class="method">
|
||||
|
||||
<?php $declares = $doc->method->getDeclaringClass(); ?>
|
||||
<h3 id="<?php echo $doc->method->name ?>">
|
||||
<?php echo $doc->modifiers, $doc->method->name ?>( <?php echo $doc->params ? $doc->params_short() : '' ?>)
|
||||
<small>(defined in <?php echo html::anchor($route->uri(array('class' => $declares->name)), $declares->name, NULL, NULL, TRUE) ?>)</small>
|
||||
</h3>
|
||||
|
||||
<div class="description">
|
||||
<?php echo $doc->description ?>
|
||||
</div>
|
||||
|
||||
<?php if ($doc->params): ?>
|
||||
<h4>Parameters</h4>
|
||||
<ul>
|
||||
<?php foreach ($doc->params as $param): ?>
|
||||
<li>
|
||||
<code><?php echo ($param->reference?'byref ':'').($param->type?$param->type:'unknown') ?></code>
|
||||
<strong><?php echo '$'.$param->name ?></strong>
|
||||
<?php echo $param->default?'<small> = '.$param->default.'</small>':'<small>required</small>' ?>
|
||||
<?php echo $param->description?' - '.$param->description:'' ?>
|
||||
</li>
|
||||
<?php endforeach; ?>
|
||||
</ul>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($doc->tags) echo View::factory('userguide/api/tags')->set('tags', $doc->tags) ?>
|
||||
|
||||
<?php if ($doc->return): ?>
|
||||
<h4><?php echo 'Return Values'; ?></h4>
|
||||
<ul class="return">
|
||||
<?php foreach ($doc->return as $set): list($type, $text) = $set; ?>
|
||||
<li><code><?php echo HTML::chars($type) ?></code><?php if ($text) echo ' - '.HTML::chars(ucfirst($text)) ?></li>
|
||||
<?php endforeach ?>
|
||||
</ul>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($doc->source): ?>
|
||||
<div class="method-source">
|
||||
<h4><?php echo 'Source Code'; ?></h4>
|
||||
<pre><code><?php echo HTML::chars($doc->source) ?></code></pre>
|
||||
</div>
|
||||
<?php endif ?>
|
||||
|
||||
</div>
|
||||
@@ -0,0 +1,6 @@
|
||||
<h4>Tags</h4>
|
||||
<ul class="tags">
|
||||
<?php foreach ($tags as $name => $set): ?>
|
||||
<li><?php echo ucfirst($name).($set?' - '.implode(', ',$set):''); ?>
|
||||
<?php endforeach ?>
|
||||
</ul>
|
||||
@@ -0,0 +1,69 @@
|
||||
<h1><?php echo 'Available Classes' ?></h1>
|
||||
|
||||
<label>Filter:</label>
|
||||
<input type="text" id="kodoc-api-filter-box" />
|
||||
|
||||
<script type="text/javascript">
|
||||
(function($) {
|
||||
$.fn.extend({
|
||||
api_filter: function(api_container_selector){
|
||||
var $api_container = $(api_container_selector);
|
||||
var $this = this;
|
||||
|
||||
if ($api_container.length) {
|
||||
var $classes = $('.class', $api_container);
|
||||
var $methods = $('.methods li', $classes);
|
||||
var text = $methods.map(function(){ return $(this).text(); });
|
||||
var timeout = null;
|
||||
|
||||
this.keyup(function(){
|
||||
clearTimeout(timeout);
|
||||
timeout = setTimeout(filter_content, 300);
|
||||
});
|
||||
|
||||
filter_content();
|
||||
}
|
||||
|
||||
function filter_content(){
|
||||
var search = $this.val();
|
||||
var search_regex = new RegExp(search,'gi');
|
||||
|
||||
if (search == '') {
|
||||
$methods.show();
|
||||
$classes.show();
|
||||
} else {
|
||||
$classes.hide();
|
||||
$methods.hide();
|
||||
|
||||
text.each(function(i){
|
||||
if (this.match(search_regex)) {
|
||||
$($methods[i]).show().closest('.class').show();
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
return this;
|
||||
}
|
||||
});
|
||||
|
||||
$(document).ready(function(){
|
||||
$('#kodoc-api-filter-box').api_filter('#kodoc-body').focus();
|
||||
});
|
||||
})(jQuery);
|
||||
</script>
|
||||
|
||||
<div class="class-list">
|
||||
|
||||
<?php foreach ($classes as $class => $methods): $link = $route->uri(array('class' => $class)) ?>
|
||||
<div class="class <?php echo Text::alternate('left', 'right') ?>">
|
||||
<h2><?php echo HTML::anchor($link, $class, NULL, NULL, TRUE) ?></h2>
|
||||
<ul class="methods">
|
||||
<?php foreach ($methods as $method): ?>
|
||||
<li><?php echo HTML::anchor("{$link}#{$method}", "{$class}::{$method}", NULL, NULL, TRUE) ?></li>
|
||||
<?php endforeach ?>
|
||||
</ul>
|
||||
</div>
|
||||
<?php endforeach ?>
|
||||
|
||||
</div>
|
||||
@@ -0,0 +1,3 @@
|
||||
<h1>Kodoc - <?php echo 'Error'; ?></h1>
|
||||
|
||||
<p><?php echo $message ?></p>
|
||||
@@ -0,0 +1,6 @@
|
||||
<?php
|
||||
|
||||
// Should trigger an ErrorException with an E_NOTICE level
|
||||
echo $var_does_not_exist;
|
||||
|
||||
?>
|
||||
@@ -0,0 +1,696 @@
|
||||
<style type="text/css">
|
||||
#kohana_error { background: #ddd; font-size: 1em; font-family:sans-serif; text-align: left; color: #111; }
|
||||
#kohana_error h1,
|
||||
#kohana_error h2 { margin: 0; padding: 1em; font-size: 1em; font-weight: normal; background: #911; color: #fff; }
|
||||
#kohana_error h1 a,
|
||||
#kohana_error h2 a { color: #fff; }
|
||||
#kohana_error h2 { background: #222; }
|
||||
#kohana_error h3 { margin: 0; padding: 0.4em 0 0; font-size: 1em; font-weight: normal; }
|
||||
#kohana_error p { margin: 0; padding: 0.2em 0; }
|
||||
#kohana_error a { color: #1b323b; }
|
||||
#kohana_error pre { overflow: auto; white-space: pre-wrap; }
|
||||
#kohana_error table { width: 100%; display: block; margin: 0 0 0.4em; padding: 0; border-collapse: collapse; background: #fff; }
|
||||
#kohana_error table td { border: solid 1px #ddd; text-align: left; vertical-align: top; padding: 0.4em; }
|
||||
#kohana_error div.content { padding: 0.4em 1em 1em; overflow: hidden; }
|
||||
#kohana_error pre.source { margin: 0 0 1em; padding: 0.4em; background: #fff; border: dotted 1px #b7c680; line-height: 1.2em; }
|
||||
#kohana_error pre.source span.line { display: block; }
|
||||
#kohana_error pre.source span.highlight { background: #f0eb96; }
|
||||
#kohana_error pre.source span.line span.number { color: #666; }
|
||||
#kohana_error ol.trace { display: block; margin: 0 0 0 2em; padding: 0; list-style: decimal; }
|
||||
#kohana_error ol.trace li { margin: 0; padding: 0; }
|
||||
</style>
|
||||
<script type="text/javascript">
|
||||
document.write('<style type="text/css"> .collapsed { display: none; } </style>');
|
||||
function koggle(elem)
|
||||
{
|
||||
elem = document.getElementById(elem);
|
||||
|
||||
if (elem.style && elem.style['display'])
|
||||
// Only works with the "style" attr
|
||||
var disp = elem.style['display'];
|
||||
else if (elem.currentStyle)
|
||||
// For MSIE, naturally
|
||||
var disp = elem.currentStyle['display'];
|
||||
else if (window.getComputedStyle)
|
||||
// For most other browsers
|
||||
var disp = document.defaultView.getComputedStyle(elem, null).getPropertyValue('display');
|
||||
|
||||
// Toggle the state of the "display" style
|
||||
elem.style.display = disp == 'block' ? 'none' : 'block';
|
||||
return false;
|
||||
}
|
||||
</script>
|
||||
<div id="kohana_error">
|
||||
<h1><span class="type">Kohana_View_Exception [ 0 ]:</span> <span class="message">The requested view site could not be found</span></h1>
|
||||
<div id="error4ac2453378034" class="content">
|
||||
<p><span class="file">SYSPATH/classes/kohana/view.php [ 215 ]</span></p>
|
||||
<pre class="source"><code><span class="line"><span class="number">210</span> */
|
||||
|
||||
</span><span class="line"><span class="number">211</span> public function set_filename($file)
|
||||
</span><span class="line"><span class="number">212</span> {
|
||||
</span><span class="line"><span class="number">213</span> if (($path = Kohana::find_file('views', $file)) === FALSE)
|
||||
</span><span class="line"><span class="number">214</span> {
|
||||
</span><span class="line highlight"><span class="number">215</span> throw new Kohana_View_Exception('The requested view :file could not be found', array(
|
||||
</span><span class="line"><span class="number">216</span> ':file' => $file,
|
||||
|
||||
</span><span class="line"><span class="number">217</span> ));
|
||||
</span><span class="line"><span class="number">218</span> }
|
||||
</span><span class="line"><span class="number">219</span>
|
||||
</span><span class="line"><span class="number">220</span> // Store the file path locally
|
||||
</span></code></pre> <ol class="trace">
|
||||
<li>
|
||||
<p>
|
||||
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source0" onclick="return koggle('error4ac2453378034source0')">SYSPATH/classes/kohana/view.php [ 115 ]</a>
|
||||
</span>
|
||||
»
|
||||
Kohana_View->set_filename(<a href="#error4ac2453378034args0" onclick="return koggle('error4ac2453378034args0')">arguments</a>)
|
||||
</p>
|
||||
<div id="error4ac2453378034args0" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
|
||||
<tr>
|
||||
<td><code>file</code></td>
|
||||
<td><pre><small>string</small><span>(4)</span> "site"</pre></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<pre id="error4ac2453378034source0" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">110</span> */
|
||||
</span><span class="line"><span class="number">111</span> public function __construct($file = NULL, array $data = NULL)
|
||||
</span><span class="line"><span class="number">112</span> {
|
||||
</span><span class="line"><span class="number">113</span> if ($file !== NULL)
|
||||
</span><span class="line"><span class="number">114</span> {
|
||||
</span><span class="line highlight"><span class="number">115</span> $this->set_filename($file);
|
||||
|
||||
</span><span class="line"><span class="number">116</span> }
|
||||
</span><span class="line"><span class="number">117</span>
|
||||
</span><span class="line"><span class="number">118</span> if ( $data !== NULL)
|
||||
</span><span class="line"><span class="number">119</span> {
|
||||
</span><span class="line"><span class="number">120</span> // Add the values to the current data
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<p>
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source1" onclick="return koggle('error4ac2453378034source1')">SYSPATH/classes/kohana/view.php [ 26 ]</a>
|
||||
</span>
|
||||
»
|
||||
Kohana_View->__construct(<a href="#error4ac2453378034args1" onclick="return koggle('error4ac2453378034args1')">arguments</a>)
|
||||
</p>
|
||||
|
||||
<div id="error4ac2453378034args1" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>file</code></td>
|
||||
<td><pre><small>string</small><span>(4)</span> "site"</pre></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><code>data</code></td>
|
||||
<td><pre><small>NULL</small></pre></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<pre id="error4ac2453378034source1" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">21</span> * @param array array of values
|
||||
|
||||
</span><span class="line"><span class="number">22</span> * @return View
|
||||
</span><span class="line"><span class="number">23</span> */
|
||||
</span><span class="line"><span class="number">24</span> public static function factory($file = NULL, array $data = NULL)
|
||||
</span><span class="line"><span class="number">25</span> {
|
||||
</span><span class="line highlight"><span class="number">26</span> return new View($file, $data);
|
||||
</span><span class="line"><span class="number">27</span> }
|
||||
|
||||
</span><span class="line"><span class="number">28</span>
|
||||
</span><span class="line"><span class="number">29</span> /**
|
||||
</span><span class="line"><span class="number">30</span> * Captures the output that is generated when a view is included.
|
||||
</span><span class="line"><span class="number">31</span> * The view data will be extracted to make local variables. This method
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>
|
||||
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source2" onclick="return koggle('error4ac2453378034source2')">SYSPATH/classes/kohana/controller/template.php [ 32 ]</a>
|
||||
</span>
|
||||
»
|
||||
Kohana_View::factory(<a href="#error4ac2453378034args2" onclick="return koggle('error4ac2453378034args2')">arguments</a>)
|
||||
</p>
|
||||
<div id="error4ac2453378034args2" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
|
||||
<tr>
|
||||
<td><code>file</code></td>
|
||||
<td><pre><small>string</small><span>(4)</span> "site"</pre></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<pre id="error4ac2453378034source2" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">27</span> public function before()
|
||||
</span><span class="line"><span class="number">28</span> {
|
||||
</span><span class="line"><span class="number">29</span> if ($this->auto_render === TRUE)
|
||||
</span><span class="line"><span class="number">30</span> {
|
||||
</span><span class="line"><span class="number">31</span> // Load the template
|
||||
|
||||
</span><span class="line highlight"><span class="number">32</span> $this->template = View::factory($this->template);
|
||||
</span><span class="line"><span class="number">33</span> }
|
||||
</span><span class="line"><span class="number">34</span> }
|
||||
</span><span class="line"><span class="number">35</span>
|
||||
</span><span class="line"><span class="number">36</span> /**
|
||||
</span><span class="line"><span class="number">37</span> * Assigns the template as the request response.
|
||||
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>
|
||||
<span class="file">
|
||||
{PHP internal call}
|
||||
</span>
|
||||
»
|
||||
Kohana_Controller_Template->before()
|
||||
</p>
|
||||
|
||||
</li>
|
||||
<li>
|
||||
<p>
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source4" onclick="return koggle('error4ac2453378034source4')">SYSPATH/classes/kohana/request.php [ 840 ]</a>
|
||||
</span>
|
||||
»
|
||||
ReflectionMethod->invoke(<a href="#error4ac2453378034args4" onclick="return koggle('error4ac2453378034args4')">arguments</a>)
|
||||
</p>
|
||||
|
||||
<div id="error4ac2453378034args4" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>object</code></td>
|
||||
<td><pre><small>object</small> <span>Controller_Hello(3)</span> <code>{
|
||||
<small>public</small> template => <small>string</small><span>(4)</span> "site"
|
||||
<small>public</small> auto_render => <small>bool</small> TRUE
|
||||
<small>public</small> request => <small>object</small> <span>Request(9)</span> <code>{
|
||||
<small>public</small> route => <small>object</small> <span>Route(4)</span> <code>{
|
||||
<small>protected</small> _uri => <small>string</small><span>(32)</span> "(<controller>(/<action>(/<id>)))"
|
||||
<small>protected</small> _regex => <small>array</small><span>(0)</span>
|
||||
<small>protected</small> _defaults => <small>array</small><span>(2)</span> <span>(
|
||||
"controller" => <small>string</small><span>(7)</span> "welcome"
|
||||
"action" => <small>string</small><span>(5)</span> "index"
|
||||
)</span>
|
||||
|
||||
<small>protected</small> _route_regex => <small>string</small><span>(87)</span> "#^(?:(?P<controller>[^/.,;?]++)(?:/(?P<action>[^/.,;?]++)(?:/(?P<id>[^/.,;?]++))?)?)?$#"
|
||||
}</code>
|
||||
<small>public</small> status => <small>integer</small> 500
|
||||
<small>public</small> response => <small>string</small><span>(0)</span> ""
|
||||
<small>public</small> headers => <small>array</small><span>(1)</span> <span>(
|
||||
"Content-Type" => <small>string</small><span>(24)</span> "text/html; charset=utf-8"
|
||||
)</span>
|
||||
|
||||
<small>public</small> directory => <small>string</small><span>(0)</span> ""
|
||||
<small>public</small> controller => <small>string</small><span>(5)</span> "hello"
|
||||
<small>public</small> action => <small>string</small><span>(5)</span> "index"
|
||||
<small>public</small> uri => <small>string</small><span>(5)</span> "hello"
|
||||
<small>protected</small> _params => <small>array</small><span>(0)</span>
|
||||
}</code>
|
||||
|
||||
}</code></pre></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<pre id="error4ac2453378034source4" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">835</span>
|
||||
</span><span class="line"><span class="number">836</span> // Create a new instance of the controller
|
||||
</span><span class="line"><span class="number">837</span> $controller = $class->newInstance($this);
|
||||
|
||||
</span><span class="line"><span class="number">838</span>
|
||||
</span><span class="line"><span class="number">839</span> // Execute the "before action" method
|
||||
</span><span class="line highlight"><span class="number">840</span> $class->getMethod('before')->invoke($controller);
|
||||
</span><span class="line"><span class="number">841</span>
|
||||
</span><span class="line"><span class="number">842</span> // Determine the action to use
|
||||
</span><span class="line"><span class="number">843</span> $action = empty($this->action) ? Route::$default_action : $this->action;
|
||||
|
||||
</span><span class="line"><span class="number">844</span>
|
||||
</span><span class="line"><span class="number">845</span> // Execute the main action with the parameters
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source5" onclick="return koggle('error4ac2453378034source5')">APPPATH/bootstrap.php [ 76 ]</a>
|
||||
|
||||
</span>
|
||||
»
|
||||
Kohana_Request->execute()
|
||||
</p>
|
||||
<pre id="error4ac2453378034source5" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">71</span> /**
|
||||
</span><span class="line"><span class="number">72</span> * Execute the main request. A source of the URI can be passed, eg: $_SERVER['PATH_INFO'].
|
||||
</span><span class="line"><span class="number">73</span> * If no source is specified, the URI will be automatically detected.
|
||||
|
||||
</span><span class="line"><span class="number">74</span> */
|
||||
</span><span class="line"><span class="number">75</span> echo Request::instance()
|
||||
</span><span class="line highlight"><span class="number">76</span> ->execute()
|
||||
</span><span class="line"><span class="number">77</span> ->send_headers()
|
||||
</span><span class="line"><span class="number">78</span> ->response;
|
||||
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>
|
||||
<span class="file">
|
||||
<a href="#error4ac2453378034source6" onclick="return koggle('error4ac2453378034source6')">DOCROOT/index.php [ 106 ]</a>
|
||||
</span>
|
||||
»
|
||||
require(<a href="#error4ac2453378034args6" onclick="return koggle('error4ac2453378034args6')">arguments</a>)
|
||||
</p>
|
||||
|
||||
<div id="error4ac2453378034args6" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>0</code></td>
|
||||
<td><pre><small>string</small><span>(49)</span> "/var/www/kohana/testing/application/bootstrap.php"</pre></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</div>
|
||||
<pre id="error4ac2453378034source6" class="source collapsed"><code><pre class="source"><code><span class="line"><span class="number">101</span> // Load empty core extension
|
||||
</span><span class="line"><span class="number">102</span> require SYSPATH.'classes/kohana'.EXT;
|
||||
</span><span class="line"><span class="number">103</span> }
|
||||
</span><span class="line"><span class="number">104</span>
|
||||
</span><span class="line"><span class="number">105</span> // Bootstrap the application
|
||||
|
||||
</span><span class="line highlight"><span class="number">106</span> require APPPATH.'bootstrap'.EXT;
|
||||
</span></code></pre></code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
</div>
|
||||
<h2><a href="#error4ac2453378034environment" onclick="return koggle('error4ac2453378034environment')">Environment</a></h2>
|
||||
<div id="error4ac2453378034environment" class="content collapsed">
|
||||
<h3><a href="#error4ac2453378034environment_included" onclick="return koggle('error4ac2453378034environment_included')">Included files</a> (31)</h3>
|
||||
|
||||
<div id="error4ac2453378034environment_included" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>DOCROOT/index.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/base.php</code></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/core.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>APPPATH/bootstrap.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/profiler.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/profiler.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SYSPATH/classes/kohana/log.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/config.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/log/file.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/log/writer.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/config/file.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SYSPATH/classes/kohana/config/reader.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>MODPATH/codebench/init.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/route.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/route.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>/var/www/kohana/userguide/init.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SYSPATH/classes/request.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/request.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>APPPATH/classes/controller/hello.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/controller/template.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/controller/template.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SYSPATH/classes/controller.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/controller.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/view.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/view.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/view/exception.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SYSPATH/classes/kohana/exception.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/i18n.php</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/classes/kohana/i18n.php</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SYSPATH/views/kohana/error.php</code></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<h3><a href="#error4ac2453378034environment_loaded" onclick="return koggle('error4ac2453378034environment_loaded')">Loaded extensions</a> (41)</h3>
|
||||
|
||||
<div id="error4ac2453378034environment_loaded" class="collapsed">
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>zip</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>xmlwriter</code></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><code>libxml</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>xml</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>wddx</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>tokenizer</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>sysvshm</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>sysvsem</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>sysvmsg</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>session</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SimpleXML</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>sockets</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>soap</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SPL</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>shmop</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>standard</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>Reflection</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>posix</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>mime_magic</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>mbstring</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>json</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>iconv</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>hash</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>gettext</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>ftp</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>filter</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>exif</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>dom</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>dba</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>date</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>ctype</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>calendar</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>bz2</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>bcmath</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>zlib</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>pcre</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>openssl</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>xmlreader</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>apache2handler</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>curl</code></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>PDO</code></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<h3><a href="#error4ac2453378034environment_server" onclick="return koggle('error4ac2453378034environment_server')">$_SERVER</a></h3>
|
||||
<div id="error4ac2453378034environment_server" class="collapsed">
|
||||
|
||||
<table cellspacing="0">
|
||||
<tr>
|
||||
<td><code>HTTP_HOST</code></td>
|
||||
<td><pre><small>string</small><span>(9)</span> "localhost"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>HTTP_USER_AGENT</code></td>
|
||||
<td><pre><small>string</small><span>(105)</span> "Mozilla/5.0 (X11; U; Linux i686; en-GB; rv:1.9.0.14) Gecko/2009090216 Ubuntu/9.04 (jaunty) Firefox/3.0.14"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>HTTP_ACCEPT</code></td>
|
||||
<td><pre><small>string</small><span>(63)</span> "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>HTTP_ACCEPT_LANGUAGE</code></td>
|
||||
<td><pre><small>string</small><span>(14)</span> "en-gb,en;q=0.5"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>HTTP_ACCEPT_ENCODING</code></td>
|
||||
<td><pre><small>string</small><span>(12)</span> "gzip,deflate"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>HTTP_ACCEPT_CHARSET</code></td>
|
||||
<td><pre><small>string</small><span>(30)</span> "ISO-8859-1,utf-8;q=0.7,*;q=0.7"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>HTTP_KEEP_ALIVE</code></td>
|
||||
<td><pre><small>string</small><span>(3)</span> "300"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>HTTP_CONNECTION</code></td>
|
||||
<td><pre><small>string</small><span>(10)</span> "keep-alive"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>PATH</code></td>
|
||||
<td><pre><small>string</small><span>(28)</span> "/usr/local/bin:/usr/bin:/bin"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SERVER_SIGNATURE</code></td>
|
||||
<td><pre><small>string</small><span>(110)</span> "<address>Apache/2.2.11 (Ubuntu) PHP/5.2.6-3ubuntu4.2 with Suhosin-Patch Server at localhost Port 80</address>
|
||||
"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SERVER_SOFTWARE</code></td>
|
||||
<td><pre><small>string</small><span>(62)</span> "Apache/2.2.11 (Ubuntu) PHP/5.2.6-3ubuntu4.2 with Suhosin-Patch"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SERVER_NAME</code></td>
|
||||
<td><pre><small>string</small><span>(9)</span> "localhost"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SERVER_ADDR</code></td>
|
||||
<td><pre><small>string</small><span>(3)</span> "::1"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SERVER_PORT</code></td>
|
||||
<td><pre><small>string</small><span>(2)</span> "80"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>REMOTE_ADDR</code></td>
|
||||
<td><pre><small>string</small><span>(3)</span> "::1"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>DOCUMENT_ROOT</code></td>
|
||||
<td><pre><small>string</small><span>(8)</span> "/var/www"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SERVER_ADMIN</code></td>
|
||||
<td><pre><small>string</small><span>(19)</span> "webmaster@localhost"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SCRIPT_FILENAME</code></td>
|
||||
<td><pre><small>string</small><span>(33)</span> "/var/www/kohana/testing/index.php"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>REMOTE_PORT</code></td>
|
||||
<td><pre><small>string</small><span>(5)</span> "39409"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>GATEWAY_INTERFACE</code></td>
|
||||
<td><pre><small>string</small><span>(7)</span> "CGI/1.1"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>SERVER_PROTOCOL</code></td>
|
||||
<td><pre><small>string</small><span>(8)</span> "HTTP/1.1"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>REQUEST_METHOD</code></td>
|
||||
<td><pre><small>string</small><span>(3)</span> "GET"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>QUERY_STRING</code></td>
|
||||
<td><pre><small>string</small><span>(0)</span> ""</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>REQUEST_URI</code></td>
|
||||
<td><pre><small>string</small><span>(31)</span> "/kohana/testing/index.php/hello"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>SCRIPT_NAME</code></td>
|
||||
<td><pre><small>string</small><span>(25)</span> "/kohana/testing/index.php"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>PATH_INFO</code></td>
|
||||
<td><pre><small>string</small><span>(6)</span> "/hello"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
|
||||
<td><code>PATH_TRANSLATED</code></td>
|
||||
<td><pre><small>string</small><span>(14)</span> "/var/www/hello"</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>PHP_SELF</code></td>
|
||||
<td><pre><small>string</small><span>(31)</span> "/kohana/testing/index.php/hello"</pre></td>
|
||||
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>REQUEST_TIME</code></td>
|
||||
<td><pre><small>integer</small> 1254245682</pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>argv</code></td>
|
||||
|
||||
<td><pre><small>array</small><span>(0)</span> </pre></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>argc</code></td>
|
||||
<td><pre><small>integer</small> 0</pre></td>
|
||||
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
20
includes/kohana/modules/userguide/views/userguide/index.php
Normal file
20
includes/kohana/modules/userguide/views/userguide/index.php
Normal file
@@ -0,0 +1,20 @@
|
||||
<h1>User Guide</h1>
|
||||
|
||||
<p>The following modules have userguide pages:</p>
|
||||
|
||||
<?php if( ! empty($modules)): ?>
|
||||
|
||||
<?php foreach($modules as $url => $options): ?>
|
||||
|
||||
<p>
|
||||
<strong><?php echo html::anchor(Route::get('docs/guide')->uri(array('module' => $url)), $options['name'], NULL, NULL, TRUE) ?></strong> -
|
||||
<?php echo $options['description'] ?>
|
||||
</p>
|
||||
|
||||
<?php endforeach; ?>
|
||||
|
||||
<?php else: ?>
|
||||
|
||||
<p class="error">I couldn't find any modules with userguide pages.</p>
|
||||
|
||||
<?php endif; ?>
|
||||
17
includes/kohana/modules/userguide/views/userguide/menu.php
Normal file
17
includes/kohana/modules/userguide/views/userguide/menu.php
Normal file
@@ -0,0 +1,17 @@
|
||||
<h2>Modules</h2>
|
||||
|
||||
<?php if( ! empty($modules)): ?>
|
||||
|
||||
<ul>
|
||||
<?php foreach($modules as $url => $options): ?>
|
||||
|
||||
<li><?php echo html::anchor(Route::get('docs/guide')->uri(array('module' => $url)), $options['name'], NULL, NULL, TRUE) ?></li>
|
||||
|
||||
<?php endforeach; ?>
|
||||
</ul>
|
||||
|
||||
<?php else: ?>
|
||||
|
||||
<p class="error">No modules.</p>
|
||||
|
||||
<?php endif; ?>
|
||||
@@ -0,0 +1,10 @@
|
||||
<?php if (is_array($array)): ?>
|
||||
<div class="page-toc">
|
||||
<?php foreach ($array as $item): ?>
|
||||
<?php if ($item['level'] > 1): ?>
|
||||
<?php echo str_repeat(' ', ($item['level'] - 1) * 4) ?>
|
||||
<?php endif ?>
|
||||
<?php echo HTML::anchor('#'.$item['id'],$item['name'], NULL, NULL, TRUE); ?><br />
|
||||
<?php endforeach; ?>
|
||||
</div>
|
||||
<?php endif ?>
|
||||
110
includes/kohana/modules/userguide/views/userguide/template.php
Normal file
110
includes/kohana/modules/userguide/views/userguide/template.php
Normal file
@@ -0,0 +1,110 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
||||
|
||||
<title><?php echo $title ?> | Kohana <?php echo 'User Guide'; ?></title>
|
||||
|
||||
<?php foreach ($styles as $style => $media) echo HTML::style($style, array('media' => $media), NULL, TRUE), "\n" ?>
|
||||
|
||||
<?php foreach ($scripts as $script) echo HTML::script($script, NULL, NULL, TRUE), "\n" ?>
|
||||
|
||||
<!--[if lt IE 9]>
|
||||
<script src="http://ie7-js.googlecode.com/svn/version/2.1(beta4)/IE9.js"></script>
|
||||
<![endif]-->
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="kodoc-header">
|
||||
<div class="container">
|
||||
<a href="http://kohanaframework.org/" id="kodoc-logo">
|
||||
<img src="<?php echo Route::url('docs/media', array('file' => 'img/kohana.png')) ?>" />
|
||||
</a>
|
||||
<div id="kodoc-menu">
|
||||
<ul>
|
||||
<li class="guide first">
|
||||
<a href="<?php echo Route::url('docs/guide') ?>">User Guide</a>
|
||||
</li>
|
||||
<?php if (Kohana::$config->load('userguide.api_browser')): ?>
|
||||
<li class="api">
|
||||
<a href="<?php echo Route::url('docs/api') ?>">API Browser</a>
|
||||
</li>
|
||||
<?php endif ?>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="kodoc-content">
|
||||
<div class="wrapper">
|
||||
<div class="container">
|
||||
<div class="span-22 prefix-1 suffix-1">
|
||||
<ul id="kodoc-breadcrumb">
|
||||
<?php foreach ($breadcrumb as $link => $title): ?>
|
||||
<?php if (is_string($link)): ?>
|
||||
<li><?php echo HTML::anchor($link, $title, NULL, NULL, TRUE) ?></li>
|
||||
<?php else: ?>
|
||||
<li class="last"><?php echo $title ?></li>
|
||||
<?php endif ?>
|
||||
<?php endforeach ?>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="span-6 prefix-1">
|
||||
<div id="kodoc-topics">
|
||||
<?php echo $menu ?>
|
||||
</div>
|
||||
</div>
|
||||
<div id="kodoc-body" class="span-16 suffix-1 last">
|
||||
<?php echo $content ?>
|
||||
|
||||
<?php if ($show_comments): ?>
|
||||
<div id="disqus_thread" class="clear"></div>
|
||||
<script type="text/javascript">
|
||||
var disqus_identifier = '<?php echo HTML::chars(Request::current()->uri()) ?>';
|
||||
(function() {
|
||||
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
|
||||
dsq.src = 'http://kohana.disqus.com/embed.js';
|
||||
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
|
||||
})();
|
||||
</script>
|
||||
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript=kohana">comments powered by Disqus.</a></noscript>
|
||||
<a href="http://disqus.com" class="dsq-brlink">Documentation comments powered by <span class="logo-disqus">Disqus</span></a>
|
||||
<?php endif ?>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="kodoc-footer">
|
||||
<div class="container">
|
||||
<div class="span-12">
|
||||
<?php if (isset($copyright)): ?>
|
||||
<p><?php echo $copyright ?></p>
|
||||
<?php else: ?>
|
||||
|
||||
<?php endif ?>
|
||||
</div>
|
||||
<div class="span-12 last right">
|
||||
<p>Powered by <?php echo HTML::anchor('http://kohanaframework.org/', 'Kohana') ?> v<?php echo Kohana::VERSION ?></p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<?php if (Kohana::$environment === Kohana::PRODUCTION): ?>
|
||||
<script type="text/javascript">
|
||||
//<![CDATA[
|
||||
(function() {
|
||||
var links = document.getElementsByTagName('a');
|
||||
var query = '?';
|
||||
for(var i = 0; i < links.length; i++) {
|
||||
if(links[i].href.indexOf('#disqus_thread') >= 0) {
|
||||
query += 'url' + i + '=' + encodeURIComponent(links[i].href) + '&';
|
||||
}
|
||||
}
|
||||
document.write('<script charset="utf-8" type="text/javascript" src="http://disqus.com/forums/kohana/get_num_replies.js' + query + '"></' + 'script>');
|
||||
})();
|
||||
//]]>
|
||||
</script>
|
||||
<?php endif ?>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user