JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
vanilla ckeditor-3.6.3
[ckeditor.git] / _samples / ui_languages.html
index b95c5f6..9fe56ef 100644 (file)
@@ -1,28 +1,52 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
 <!--\r
-Copyright (c) 2003-2009, CKSource - Frederico Knabben. All rights reserved.\r
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.\r
 For licensing, see LICENSE.html or http://ckeditor.com/license\r
 -->\r
 <html xmlns="http://www.w3.org/1999/xhtml">\r
 <head>\r
-       <title>Sample - CKEditor</title>\r
-       <meta content="text/html; charset=utf-8" http-equiv="content-type"/>\r
+       <title>User Interface Globalization &mdash; CKEditor Sample</title>\r
+       <meta content="text/html; charset=utf-8" http-equiv="content-type" />\r
        <script type="text/javascript" src="../ckeditor.js"></script>\r
+       <script type="text/javascript" src="../lang/_languages.js"></script>\r
        <script src="sample.js" type="text/javascript"></script>\r
-       <link href="sample.css" rel="stylesheet" type="text/css"/>\r
-       <script id="headscript" type="text/javascript">\r
-       //<![CDATA[\r
-\r
-       document.write( '<script type="text/javascript" src="../' +\r
-               'lang/_languages.js"><\/script>' );\r
-\r
-       //]]>\r
-       </script>\r
+       <link href="sample.css" rel="stylesheet" type="text/css" />\r
 </head>\r
 <body>\r
-       <h1>\r
-               CKEditor Sample\r
+       <h1 class="samples">\r
+               CKEditor Sample &mdash; User Interface Languages\r
        </h1>\r
+       <div class="description">\r
+       <p>\r
+               This sample shows how to automatically replace <code>&lt;textarea&gt;</code> elements\r
+               with a CKEditor instance with an option to change the language of its user interface.\r
+       </p>\r
+       <p>\r
+               It pulls the language list from CKEditor <code>_languages.js</code> file that contains the list of supported languages and creates\r
+               a drop-down list that lets the user change the UI language.\r
+       </p>\r
+       <p>\r
+       By default, CKEditor automatically localizes the editor to the language of the user.\r
+       The UI language can be controlled with two configuration options:\r
+       <a class="samples" href="http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.config.html#.language">\r
+       <code>language</code></a> and <a class="samples" href="http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.config.html#.defaultLanguage">\r
+       <code>defaultLanguage</code></a>. The <code>defaultLanguage</code> setting specifies the\r
+       default CKEditor language to be used when a localization suitable for user's settings is not available.\r
+       </p>\r
+       <p>\r
+       To specify the user interface language that will be used no matter what language is\r
+       specified in user's browser or operating system, set the <code>language</code> property:\r
+       </p>\r
+       <pre class="samples">CKEDITOR.replace( '<em>textarea_id</em>',\r
+       {\r
+               // Load the German interface.\r
+               <strong>language: 'de'</strong>\r
+       });</pre>\r
+       <p>\r
+               Note that <code><em>textarea_id</em></code> in the code above is the <code>id</code> attribute of\r
+               the <code>&lt;textarea&gt;</code> element to be replaced.\r
+       </p>\r
+       </div>\r
        <!-- This <div> holds alert messages to be display in the sample page. -->\r
        <div id="alerts">\r
                <noscript>\r
@@ -33,82 +57,77 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
                        </p>\r
                </noscript>\r
        </div>\r
-       <!-- This <fieldset> holds the HTML that you will usually find in your\r
-            pages. -->\r
        <form action="sample_posteddata.php" method="post">\r
-                       <p>\r
-                               <label for="editor1">\r
-                                       Available languages (<span id="count"> </span>\r
-                                       languages!):</label><br/>\r
-                               <select disabled="disabled" id="languages" onchange="createEditor( this.value );">\r
-                                       <script type="text/javascript">\r
-                                       //<![CDATA[\r
-\r
-                                               // Get the language list from the _languages.js file.\r
-                                               for ( var i = 0 ; i < window.CKEDITOR_LANGS.length ; i++ )\r
-                                               {\r
-                                                       document.write(\r
-                                                               '<option value="' + window.CKEDITOR_LANGS[i].code + '">' +\r
-                                                                       window.CKEDITOR_LANGS[i].name +\r
-                                                               '</option>' );\r
-                                               }\r
+               <p>\r
+                       Available languages (<span id="count"> </span> languages!):<br />\r
+                       <script type="text/javascript">\r
+                       //<![CDATA[\r
+                               document.write( '<select disabled="disabled" id="languages" onchange="createEditor( this.value );">' );\r
+                               // Get the language list from the _languages.js file.\r
+                               for ( var i = 0 ; i < window.CKEDITOR_LANGS.length ; i++ )\r
+                               {\r
+                                       document.write(\r
+                                               '<option value="' + window.CKEDITOR_LANGS[i].code + '">' +\r
+                                                       window.CKEDITOR_LANGS[i].name +\r
+                                               '</option>' );\r
+                               }\r
+                               document.write( '</select>' );\r
+                       //]]>\r
+                       </script>\r
+                       <br />\r
+                       <span style="color: #888888">(You may see strange characters if your system does not\r
+                               support the selected language)</span>\r
+               </p>\r
+               <p>\r
+                       <textarea cols="80" id="editor1" name="editor1" rows="10">&lt;p&gt;This is some &lt;strong&gt;sample text&lt;/strong&gt;. You are using &lt;a href="http://ckeditor.com/"&gt;CKEditor&lt;/a&gt;.&lt;/p&gt;</textarea>\r
+                       <script type="text/javascript">\r
+                       //<![CDATA[\r
 \r
-                                       //]]>\r
-                                       </script>\r
-                               </select>\r
-                               <br/>\r
-                               <span style="color: #888888">(You may see strange characters if your system doesn't\r
-                                       support the selected language)</span>\r
-                       </p>\r
-                       <p>\r
-                               <textarea cols="80" id="editor1" name="editor1" rows="10">&lt;p&gt;This is some &lt;strong&gt;sample text&lt;/strong&gt;. You are using &lt;a href="http://www.fckeditor.net/"&gt;CKEditor&lt;/a&gt;.&lt;/p&gt;</textarea>\r
-                               <script type="text/javascript">\r
-                               //<![CDATA[\r
+                               // Set the number of languages.\r
+                               document.getElementById( 'count' ).innerHTML = window.CKEDITOR_LANGS.length;\r
 \r
-                                       // Set the number of languages.\r
-                                       document.getElementById( 'count' ).innerHTML = window.CKEDITOR_LANGS.length;\r
+                               var editor;\r
 \r
-                                       var editor;\r
+                               function createEditor( languageCode )\r
+                               {\r
+                                       if ( editor )\r
+                                               editor.destroy();\r
 \r
-                                       function createEditor( languageCode )\r
-                                       {\r
-                                               if ( editor )\r
-                                                       editor.destroy();\r
+                                       // Replace the <textarea id="editor"> with an CKEditor\r
+                                       // instance, using default configurations.\r
+                                       editor = CKEDITOR.replace( 'editor1',\r
+                                               {\r
+                                                       language : languageCode,\r
 \r
-                                               // Replace the <textarea id="editor"> with an CKEditor\r
-                                               // instance, using default configurations.\r
-                                               editor = CKEDITOR.replace( 'editor1',\r
+                                                       on :\r
                                                        {\r
-                                                               language : languageCode,\r
-\r
-                                                               on :\r
+                                                               instanceReady : function()\r
                                                                {\r
-                                                                       instanceReady : function()\r
-                                                                       {\r
-                                                                               // Wait for the editor to be ready to set\r
-                                                                               // the language combo.\r
-                                                                               var languages = document.getElementById( 'languages' );\r
-                                                                               languages.value = this.langCode;\r
-                                                                               languages.disabled = false;\r
-                                                                       }\r
+                                                                       // Wait for the editor to be ready to set\r
+                                                                       // the language combo.\r
+                                                                       var languages = document.getElementById( 'languages' );\r
+                                                                       languages.value = this.langCode;\r
+                                                                       languages.disabled = false;\r
                                                                }\r
-                                                       } );\r
-                                       }\r
+                                                       }\r
+                                               } );\r
+                               }\r
 \r
-                                       // At page startup, load the default language:\r
-                                       createEditor( '' );\r
+                               // At page startup, load the default language:\r
+                               createEditor( '' );\r
 \r
-                               //]]>\r
-                               </script>\r
-                       </p>\r
-               </form>\r
+                       //]]>\r
+                       </script>\r
+               </p>\r
+       </form>\r
        <div id="footer">\r
-               <hr/>\r
+               <hr />\r
                <p>\r
-                       CKEditor - The text editor for Internet - <a href="http://ckeditor.com/" shape="rect">http://ckeditor.com</a>\r
+                       CKEditor - The text editor for the Internet - <a class="samples" href="http://ckeditor.com/">http://ckeditor.com</a>\r
                </p>\r
                <p id="copy">\r
-                       Copyright © 2003-2009, <a href="http://cksource.com/" shape="rect">CKSource</a> - Frederico Knabben. All rights reserved.\r
+                       Copyright &copy; 2003-2012, <a class="samples" href="http://cksource.com/">CKSource</a> - Frederico\r
+                       Knabben. All rights reserved.\r
                </p>\r
        </div>\r
 </body>\r