Merge branch 'master' of git://github.com/kohana/userguide

dyron · dyron · commit 107aea118f6b · 2010-10-15T22:31:43.000+02:00
diff --git a/guide/about.install.md b/guide/about.install.md
@@ -32,6 +32,8 @@ There are a few things you'll want to do with your application before moving int
 3. Turn on APC or some kind of opcode caching. 
    This is the single easiest performance boost you can make to PHP itself. The more complex your application, the bigger the benefit of using opcode caching.
 
+[!!] Note: The default bootstrap will set Kohana::$environment = $_ENV['KOHANA_ENV'] if set. Docs on how to supply this variable are available in your web server's documentation (e.g. [Apache](http://httpd.apache.org/docs/1.3/mod/mod_env.html#setenv), [Lighttpd](http://redmine.lighttpd.net/wiki/1/Docs:ModSetEnv#Options), [Nginx](http://wiki.nginx.org/NginxHttpFcgiModule#fastcgi_param)). This is considered better practice than many alternative methods to set Kohana::$enviroment.
+
 		/**
 		 * Set the environment string by the domain (defaults to Kohana::DEVELOPMENT).
 		 */
diff --git a/guide/nl/about.conventions.md b/guide/nl/about.conventions.md
@@ -42,19 +42,13 @@ Kohana gebruikt underscore namen, geen camelCase.
 
 	<?php
 
-	// Library, gebruikt _Core achtervoegsel
-	class Beer_Core {
+	// Controller class, gebruikt Controller_ voorvoegsel
+	class Controller_Apple extends Controller {
 
-	// Library extension, gebruikt geen achtervoegsel
-	class Beer extends Beer_Core
+	// Model class, gebruikt Model_ voorvoegsel
+	class Model_Cheese extends Model {
 
-	// Controller class, gebruikt _Controller achtervoegsel
-	class Apple_Controller extends Controller {
-
-	// Model class, gebruikt _Model achtervoegsel
-	class Cheese_Model extends Model {
-
-	// Helper class
+	// Regular class
 	class peanut {
 
 Wanneer je een instantie aanmaakt van een class, gebruik dan haakjes als je niets meegeeft aan de constructor:
diff --git a/guide/nl/about.install.md b/guide/nl/about.install.md
@@ -31,6 +31,8 @@ Er zijn enkele dingen dat je best doet met je applicatie vooraleer je deze in pr
    Zie onderstaand voorbeeld van Shadowhand's [wingsc.com broncode](http://github.com/shadowhand/wingsc).
 3. Zet APC of een andere soort opcode caching aan. Dit is het enige en eenvoudigste manier om de performantie te verbeteren dat je kunt doen in PHP zelf. Hoe complexer je applicatie, hoe groter het voordeel van opcode caching.
 
+[!!] Opmerking: De standaard bootstrap zal Kohana::$environment = $_ENV['KOHANA_ENV'] instellen indien ingesteld. Documentatie hoe je deze variable moet invullen kan je vinden in je webservers documentatie (e.g. [Apache](http://httpd.apache.org/docs/1.3/mod/mod_env.html#setenv), [Lighttpd](http://redmine.lighttpd.net/wiki/1/Docs:ModSetEnv#Options), [Nginx](http://wiki.nginx.org/NginxHttpFcgiModule#fastcgi_param))). Deze manier wordt als beste beschouwd in vergelijking met de alternatieve manieren om Kohana::$environment in te stellen.
+
 		/**
 		 * Stel de omgeving in aan de hand van het domein (standaard Kohana::DEVELOPMENT).
 		 */
diff --git a/guide/nl/about.kohana.md b/guide/nl/about.kohana.md
@@ -10,6 +10,6 @@ Alles kan worden uitgebreid door het unieke design van het [filesystem](about.fi
 
 Om je te helpen je applicatie te beveiligen zijn er tools voor [XSS te verwijderen](security.xss), [input validatie](security.validation), [gesigneerde cookies](security.cookies), [formulieren](security.forms) en [HTML](security.html) generators toegevoegd aan het systeem. De [database](security.database) layer voorkomt [SQL injectie](http://wikipedia.org/wiki/SQL_Injection). En natuurlijk, alle officiële code is met zorg geschreven en herbekeken inzake veiligheid.
 
-## Deze documentatie trekt nergens op!
+## Vul mee deze documentatie aan
 
-We zijn keihard en volop bezig om je van een complete documentatie te voorzien. Indien je problemen ondervindt bij het zoeken van een antwoord, bekijk dan de [onofficiële wiki (en)](http://kerkness.ca/wiki/doku.php). Als je iets wilt toevoegen of wijzigen in de documentatie, gelieve dan [de gebruiksaanwijzing te forken](http://github.com/kohana/userguide), uw veranderingen te maken, en een pull request zenden. Als je nog geen ervaring hebt met git kan je altijd een [feature request](http://dev.kohanaframework.org/projects/kohana3/issues) aanmaken (vereist registratie).
+We zijn keihard en volop bezig om je van een complete documentatie te voorzien. Om deze documentatie te helpen verbeteren, gelieve dan de userguide te [forken](http://github.com/kohana/userguide), uw aanpassingen te doen en een pull request te sturen. Als je nog geen ervaring hebt met git kan je altijd een [feature request](http://dev.kohanaframework.org/projects/kohana3/issues) aanmaken (vereist registratie).
diff --git a/guide/nl/security.validation.md b/guide/nl/security.validation.md
@@ -102,11 +102,13 @@ Merk op dat alle array parameters steeds moeten "verpakt" worden door een array!
 
 Je kan eigen regels toevoegen met behulp van een [PHP callback](http://php.net/manual/language.pseudo-types.php#language.types.callback]:
 
-    $post->rule('username', array($model, 'unique_username'));
+    $post->rule('username', 'User_Model::unique_username');
 
-De methode `$model->unique_username()` zal ongeveer gedefinieerd worden als:
+[!!] Momenteel (v3.0.7) is het niet mogelijk om een object te gebruiken als rule, enkel statische methodes en functies.
 
-    public function unique_username($username)
+De methode `User_Model::unique_username()` zal ongeveer gedefinieerd worden als:
+
+    public static function unique_username($username)
     {
         // Controleer of de username al bestaat in de database
         return ! DB::select(array(DB::expr('COUNT(username)'), 'total'))
diff --git a/guide/nl/tutorials.orm.md b/guide/nl/tutorials.orm.md
@@ -70,7 +70,7 @@ ORM ondersteunt de meeste krachtige [Database] methoden voor het doorzoeken van
 
 	// Dit zal alle gebruikers nemen met de naam Bob
 	$users = ORM::factory('user')
-		...
+		->where('name', '=', 'Bob')
 		->find_all();
 
 Wanneer je een lijst van modellen ontvangt met behulp van [ORM::find_all], kan je deze doorlopen zoals je doet met database resultaten:
@@ -83,7 +83,7 @@ Wanneer je een lijst van modellen ontvangt met behulp van [ORM::find_all], kan j
 Een zeer handige functie van ORM is de [ORM::as_array] methode die het record zal teruggeven als een array. Indien je dit gebruikt met [ORM::find_all], zal een array van alle records worden teruggegeven. Een goed voorbeeld van wanneer dit nuttig is, is voor select in het HTML formulier:
 
 	// Toon een dropdown/select met daarin alle gebruikersnamen (id als value van de options)
-	form::select('user', ORM::factory('user')->find_all()->as_array('id', 'username') ...
+	echo Form::select('user', ORM::factory('user')->find_all()->as_array('id', 'username'));
 
 ### Het aantal records tellen
 
@@ -119,11 +119,11 @@ Voor het opslaan van gegevens/properties die niet bestaan in de tabel van het mo
 	class Model_User extends ORM
 	{
 		...
-		protected $_ignored_columns = array('field1', 'field2', ...)
+		protected $_ignored_columns = array('field1', 'field2', …);
 		...
 	}
 
-Meerdere key => value paren kunnen worden ingesteld door gebruik te maken van de [ORM::values] methode
+Meerdere key => value paren kunnen worden ingesteld door gebruik te maken van de [ORM::values] methode.
 
 	$user->values(array('username' => 'Joe', 'password' => 'bob'));
 
@@ -156,19 +156,19 @@ Je kan meerdere records tegelijk veranderen met de [ORM::save_all] methode:
 
 De `_updated_column` en `_created_column` members staan ter beschikking om automatisch aangepast te worden wanneer een model wordt gecreëerd of aangepast. Ze worden standaard niet gebruikt. Om ze te gebruiken:
 
-	// date_created is de kolom die wordt gebruikt om de aanmaak datum op te slaan. Gebruik TRUE om een timestamp op te slaan
-	protected $_created_column = array('date_created' => TRUE);
+	// date_created is de kolom die wordt gebruikt om de aanmaak datum op te slaan. Gebruik format => TRUE om een timestamp op te slaan
+	protected $_created_column = array('date_created', 'format' => TRUE);
 
 	// date_modified is de kolom die wordt gebruikt om de datum op te slaan wanneer het item is aangepast. In dit geval wordt een string gebruikt om een date() formaat te specificeren
-	protected $_updated_column = array('date_modified' => 'm/d/Y');
+	protected $_updated_column = array('date_modified', 'format' => 'm/d/Y');
 
 ### Verwijderen van records
 
 Records worden verwijderd met [ORM::delete] en [ORM::delete_all]. Deze methoden werken op dezelfde manier als het opslaan van records zoals hierboven beschreven, met de uitzondering dat [ORM::delete] nog een optionele parameter heeft, het `id` van het record om te verwijderen. Anders wordt het huidig ingeladen record verwijderd.
 
 ### Relaties
 
-ORM ondersteunt zeer goed relateies. Ruby heeft een goede tutorial omtrent relaties op [http://api.rubyonrails.org/classes/ActiveRecord/Associations/ClassMethods.html](http://api.rubyonrails.org/classes/ActiveRecord/Associations/ClassMethods.html)
+ORM ondersteunt zeer goed relateies. Ruby heeft een [goede tutorial omtrent relaties](http://api.rubyonrails.org/classes/ActiveRecord/Associations/ClassMethods.html).
 
 #### Belongs-To en Has-Many
 
diff --git a/guide/nl/using.sessions.md b/guide/nl/using.sessions.md
@@ -78,7 +78,7 @@ Het verwijderen van sessie- of cookie-gegevens wordt gedaan met behulp van de `d
 
 Zowel cookies als sessies hebben verschillende configuratie-instellingen die van invloed zijn hoe gegevens worden opgeslagen. Controleer altijd deze instellingen voordat u uw applicatie live zet, omdat veel van die instellingen een rechtstreeks effect zal hebben op de veiligheid van uw applicatie.
 
-## Cookie Instellingen
+## Cookie Instellingen {#cookie-settings}
 
 Al de cookie instellingen worden verandert met behulp van statische properties. Je kan deze instellingen veranderen in `bootstrap.php` of door een [class extension](using.autoloading#class-extension) te gebruiken.
 
diff --git a/guide/tutorials.orm.md b/guide/tutorials.orm.md
@@ -72,7 +72,7 @@ ORM supports most of the [Database] methods for powerful searching of your model
 	$users = ORM::factory('user')
 		->where('name', '=', 'Bob')
 		->find_all();
-	
+
 When you are retrieving a list of models using [ORM::find_all], you can iterate through them as you do with database results:
 
 	foreach ($users as $user)
@@ -104,10 +104,10 @@ If you wish to count the total number of users for a given query, while only ret
 
 ### Accessing Model Properties
 
-All model properties are accessible using the `__get` and `__set` magic methods. 
+All model properties are accessible using the `__get` and `__set` magic methods.
 
 	$user = ORM::factory('user', 5);
-	
+
 	// Output user name
 	echo $user->name;
 
@@ -157,10 +157,10 @@ You can update multiple records by using the [ORM::save_all] method:
 The `_updated_column` and `_created_column` members are provided to automatically be updated when a model is updated and created. These are not used by default. To use them:
 
 	// date_created is the column used for storing the creation date. Use format => TRUE to store a timestamp.
-	protected $_created_column = array('date_created', 'format' => TRUE);
+	protected $_created_column = array('column' => 'date_created', 'format' => TRUE);
 
 	// date_modified is the column used for storing the modified date. In this case, a string specifying a date() format is used.
-	protected $_updated_column = array('date_modified', 'format' => 'm/d/Y');
+	protected $_updated_column = array('column' => 'date_modified', 'format' => 'm/d/Y');
 
 ### Deleting Records
 
@@ -195,7 +195,7 @@ To access a school's students, you would use:
 By default, ORM will look for a `school_id` model in the student table. This can be overriden by using the `foreign_key` attribute:
 
 	protected $_belongs_to = array('school' => array('foreign_key' => 'schoolID'));
-	
+
 The foreign key should be overridden in both the student and school models.
 
 #### Has-One
@@ -239,7 +239,7 @@ To access the related objects, use:
 	$class->students->find_all();
 
 ### Validation
-	
+
 ORM is integrated tightly with the [Validate] library. The ORM provides the following members for validation:
 
 * _rules
@@ -248,7 +248,7 @@ ORM is integrated tightly with the [Validate] library. The ORM provides the foll
 * _labels
 
 #### `_rules`
-	
+
 	protected $_rules = array
 	(
 		'username' => array('not_empty' => array()),
@@ -258,7 +258,7 @@ ORM is integrated tightly with the [Validate] library. The ORM provides the foll
 `username` will be checked to make sure it's not empty. `email` will be checked to also ensure it is a valid email address. The empty arrays passed as values can be used to provide optional additional parameters to these validate method calls.
 
 #### `_callbacks`
-	
+
 	protected $_callbacks = array
 	(
 		'username' => array('username_unique'),
@@ -281,7 +281,7 @@ ORM is integrated tightly with the [Validate] library. The ORM provides the foll
 	);
 
 `TRUE` indicates that the `trim` filter is to be used on all fields. `username` will be filtered through `stripslashes` before it is validated. The empty arrays passed as values can be used to provide additional parameters to these filter method calls.
-	
+
 #### Checking if the Object is Valid
 
 Use [ORM::check] to see if the object is currently valid.
diff --git a/guide/using.messages.md b/guide/using.messages.md
@@ -1,6 +1,6 @@
 # Message Basics
 
-Kohana messages are human friendly strings represented by a shorter word or phrase, called a "key". Messages are accessed using the [Kohana::message] method, which an return either an entire group of messages, or a single message.
+Kohana messages are human friendly strings represented by a shorter word or phrase, called a "key". Messages are accessed using the [Kohana::message] method, which returns either an entire group of messages, or a single message.
 
 As an example, when a user is not logged in and attempts to access a page that requires authentication, an error such as "You must be logged in to access this page" might be displayed. This message could be stored in the `auth` file with a `must_login` key:
 
diff --git a/media/css/kodoc.css b/media/css/kodoc.css
@@ -1,9 +1,9 @@
 html { margin: 0; }
 body { margin: 0 }
 body.he { direction: rtl }
-pre { background: #efefef; padding: 0.4em; border: dotted 1px #ddd; overflow: auto; }
+pre { background: #eee; padding: 0.5em 0.6em 0.4em; overflow: auto; }
 table th { color: #444; background: #eee; }
-table td { background: #f4f4f4; }
+table td { background: #fafafa; }
 	table tr.alt td { background: #fff; }
 
 .container .toggle { font-size: 0.7em; float: right; padding: 0 1em; cursor: pointer; color: #777; text-decoration: none; }
@@ -31,10 +31,9 @@ table td { background: #f4f4f4; }
 
 #footer { margin-top: 1em; padding: 1em 0; color: #666; }
 	#footer p { font-size: 0.8em; text-transform: uppercase; }
-#content h1 { margin-top: 0; }
-#content h1,
-#content h2,
-#content h3 { margin-left: -20px; padding: 0.4em 20px; padding-right: 0; background: #eee; }
+#content h1 { font-size: 3em; letter-spacing: -0.02em; }
+#content h2 { margin-top: 1.5em; margin-left: -20px; padding: 0.6em 20px 0.5em 20px; background: #e5e5e5; font-size: 2em; letter-spacing: -0.01em; text-shadow: 0 -1px 0 #fff; }
+#content h3 { border-bottom: 2px solid #eee; font-size: 1.6em; }
 #content h1 small,
 #content h2 small,
 #content h3 small,
@@ -57,7 +56,7 @@ table td { background: #f4f4f4; }
 #content div.constants { margin-bottom: 1em; }
 	#content div.method h3 .param { font-weight: normal; cursor: help; border-bottom:1px dashed #666;}
 	#content div.method h3 abbr.param { text-transform: none; font-size: 1em; }
-#content p.note { display: block; padding: 0.4em 0.6em; padding-left: 3em; background: #efefef url(../img/note.png) 1em 0.6em no-repeat; color: #444; border: solid 1px #eee; }
+#content p.note { display: block; padding: 0.4em 0.6em; padding-left: 3em; background: url(../img/note.png) 1em 0.6em no-repeat; border: 1px solid #e5e5e5; font-family: Georgia, serif; font-size: 1.05em; font-style: italic; color: #555; }
 #content dl.tags { overflow: auto; background: #eee; padding: 1em; border: solid 6px #ddd; }
 	#content dl.tags dt { margin: 0 0 0.4em; clear: both; float: left; width: 25%; }
 	#content dl.tags dd { margin: 0; padding: 0; clear: right; float: right; }
