+ Setup section

Author: RubaXa

README.md

@@ -13,6 +13,35 @@
 ## FileAPI
 A set of javascript tools for working with files.
 
+
+<a name="FileAPI.setup"></a>
+### Setup
+Connecting the library to your project.
+If you need a CORS, then edit the `crossdomain.xml` and put it in the root of remote domain.
+
+```html
+<script>
+window.FileAPI = {
+ debug: false // debug mode, see Console
+, cors: true // if used CORS
+, staticPath: '/js/FileAPI/dist/' // path to '*.swf'
+};
+</script>
+<script src="/js/FileAPI/dist/FileAPI.min.js"></script>
+
+<!-- OR -->
+
+<script>
+window.FileAPI = { /* options */ };
+require(['FileAPI'], function (FileAPI){
+// ...
+});
+</script>
+```
+
+---
+
+
 <a name="FileAPI.getFiles"></a>
 ### getFiles(input`:HTMLInputElement|Event|$.Event`)`:Array`
 Get files from `input` element or `event` object, also support `jQuery`.
@@ -32,6 +61,7 @@ FileAPI.event.on(el, function (evt/**Event*/){
 
 ---
 
+
 <a name="FileAPI.getInfo"></a>
 ### getInfo(file`:Object`, callback`:Function`)`:void`
 Get info of file (see also: FileAPI.addInfoReader).
@@ -988,8 +1018,10 @@ All the other codes - fatal error, user's involvement is recommend.
 
 ---
 
+<a name="buttons.examples"></a>
 ## Buttons examples
 
+<a name="buttons.examples.base"></a>
 ### Base
 Simple input[type="file"]
 
@@ -1001,6 +1033,7 @@ Simple input[type="file"]
 
 ---
 
+<a name="buttons.examples.button"></a>
 ### Button
 Stylized button.
 
@@ -1050,6 +1083,7 @@ Stylized button.
 ---
 
 
+<a name="buttons.examples.link"></a>
 ### Link
 Button like link.
 
@@ -1102,29 +1136,33 @@ Button like link.
 ### 2.0.0
 <ul>
 <li>+ FileAPI.Camera (HTML5 and Flash fallback)</li>
-<li>+ jquery.fileapi.js</li>
+<li>+ jquery.fileapi.js, see <a href="http://rubaxa.github.io/jquery.fileapi/">demo</a></li>
 <li>+ npm support</li>
 <li>+ grunt support</li>
+<li>+ requirejs support</li>
 <li>+ [#80](https://https://github.com/mailru/FileAPI/issues/80): FileAPI.Image.fn.overlay</li>
 	<li>`imageTransform` — now supports: `crop`, `type`, `quality` and `overlay` properties.</li>
 <li>Improved the documentation</li>
 </ul>
 
 
 ### 1.2.5
- * [#86](https://github.com/mailru/FileAPI/issues/86): Smarter upload recovery
- * [#87](https://github.com/mailru/FileAPI/issues/87): Fixed upload files into browsers that do not support FormData
- * Fixed support "accept" attribute for Flash.
- * Fixed detection of HTML5 support for FireFox 3.6
- * + FileAPI.html5 option, default "true"
-
+<ul>
+<li>[#86](https://github.com/mailru/FileAPI/issues/86): Smarter upload recovery</li>
+<li>[#87](https://github.com/mailru/FileAPI/issues/87): Fixed upload files into browsers that do not support FormData</li>
+<li>Fixed support "accept" attribute for Flash.</li>
+<li>Fixed detection of HTML5 support for FireFox 3.6</li>
+<li> + FileAPI.html5 option, default "true"</li>
+</ul>
 
 ### 1.2.4
- * Fixed auto orientation image by EXIF (Flash)
- * Fixed image dimensions after rotate (Flash)
- * [#82](https://github.com/mailru/FileAPI/issues/82): "undefined" data-fields cause exceptions
- * [#83](https://github.com/mailru/FileAPI/issues/83): Allow requests without files
- * [#84](https://github.com/mailru/FileAPI/pull/84): Fixed connection abort when waiting for connection recovery
+<ul>
+<li>Fixed auto orientation image by EXIF (Flash)</li>
+<li>Fixed image dimensions after rotate (Flash)</li>
+<li>[#82](https://github.com/mailru/FileAPI/issues/82): "undefined" data-fields cause exceptions</li>
+<li>[#83](https://github.com/mailru/FileAPI/issues/83): Allow requests without files</li>
+<li>[#84](https://github.com/mailru/FileAPI/pull/84): Fixed connection abort when waiting for connection recovery</li>
+</ul>
 
 
 ### 1.2.3

README.ru.md

@@ -14,6 +14,35 @@
 Набор JavaScript инструментов для работы с файлами.
 
 
+<a name="FileAPI.setup"></a>
+### Setup
+Подключение библиотеки к проекту.
+Если вы собираетесь использовать CORS, то отредактируйте файл `crossdomain.xml` и
+разместите в коре удаленного домена.
+
+```html
+<script>
+window.FileAPI = {
+ debug: false // дебаг режим, смотрите Console
+, cors: true // если используете CORS
+, staticPath: '/js/FileAPI/dist/' // путь к '*.swf'
+};
+</script>
+<script src="/js/FileAPI/dist/FileAPI.min.js"></script>
+
+<!-- ИЛИ -->
+
+<script>
+window.FileAPI = { /* etc. */ };
+require(['FileAPI'], function (FileAPI){
+// ...
+});
+</script>
+```
+
+---
+
+
 <a name="FileAPI.getFiles"></a>
 ### getFiles(input`:HTMLInputElement|Event|$.Event`)`:Array`
 Получить список файлов из `input` элемента, или `event`, также поддерживается `jQuery`.

index.html

@@ -97,13 +97,12 @@ <h4 class="fn" data-anchor="prop">
 <x:v mod="txt.hl" output="text" bind="true">prop.descr[ctx.lang] || prop.descr.en</x:v>
 </div>
 
-<div x:if="prop.code" x:highlight="prop.code.type">
-<pre>
-<code>
-{{prop.code.source[ctx.lang]}}
-</code>
-</pre>
+<div
+x:if="prop.code"
+data-type="{{prop.code.type}}"
+x:highlight="prop.code.source[ctx.lang]">
 </div>
+
 <div x:if="prop.code" style="height: 20px;"></div>
 </div>
 
@@ -179,7 +178,8 @@ <h4 data-anchor="fn" class="fn">
 init: function (el, code){
 var type = $.attr(el, 'data-type');
 el.className += ' language-' + (type == 'js' ? 'javascript' : type);
-el.innerHTML = '<pre><code>'+code+'</code></pre>';
+el.innerHTML = '<pre><code></code></pre>';
+el.firstChild.firstChild.appendChild(document.createTextNode(code));
 hljs.highlightBlock(el);
 },
 update: function (el, code){
@@ -190,7 +190,8 @@ <h4 data-anchor="fn" class="fn">
 
 
 xtpl.mod('txt.hl', function (text){
-returntext ? text.replace(/`([^`]+)`/g, '<span class="code">$1</span>') : '';
+text = text ? text.replace(/`([^`]+)`/g, '<span class="code">$1</span>') : '';
+returntext.replace(/\[([^\]]+)\]\(([^\)]+)\)/g, '<a href="$2">$1</a>');
 });
 
 

statics/docs.json

@@ -25,6 +25,13 @@ body {
 background-image: url('body__top.png');
 }
 
+a {
+color: #ddd;
+}
+a:hover {
+color: #fff;
+}
+
 .logo {
 height: 210px;
 background: url('logo.png') center center no-repeat;