russian translate

README.md

@@ -1,18 +1,18 @@
 # docs.superpowers-html5.com
 
-This is the repository for the official documentation of Superpowers at [docs.superpowers-html5.com](http://docs.superpowers-html5.com). 
+Это хранилище для официальной документации Superpowers at [docs.superpowers-html5.com](http://docs.superpowers-html5.com). 
 
-(This website will be turned into a Superpowers Web project in the future.)
+(Этот сайт будет превращен в Superpowers Web project в будущем.)
 
-## How to run the website locally
+## Как запустить сайт локально
 
-Make sure you have [Node.js](https://nodejs.org) installed. Clone the repository, open it in a terminal and run:
+Убедитесь, что у вас установлен [Node.js](https://nodejs.org). Клонируйте репозиторий, откройте его в терминале и запустите:
 
     npm install
     npm run build
 
-To start the server, run:
+Чтобы запустить сервер, запустите:
 
     npm start
 
-And go to http://localhost:9051
+И перейдите на http://localhost:9051

package.json

@@ -21,6 +21,7 @@
     "jade": "~1.11.0",
     "marked": "~0.3.5",
     "nib": "~1.1.0",
+    "pug": "^2.0.4",
     "stylus": "~0.53.0"
   }
 }

pages/ru/1_getting-started/10_publishing-your-game.md

@@ -0,0 +1,129 @@
+# Публикация вашей игры
+
+Superpowers поставляется с публикацией в один клик по кнопке `Publish project`, расположенной в верхнем левом углу.
+
+![Кнопка "Publish project"](/images/publishing-your-game/publish-project-button.png)
+
+<div class="note">
+  <p>**Экспорт доступен только из приложения**, не при доступе Superpowers через браузер,
+  потому что браузеры не позволяют веб-приложениям обращаться к файловой системе напрямую из соображений безопасности.
+</div>
+
+## Публикация вашей игры для Интернета
+
+Вы можете загрузить экспортированную папку на любой веб-хостинг или заархивировать ее и загрузить как HTML5 на портал онлайн-игр.
+лайк <a href="http://itch.io/" target="_blank">itch.io</a> или <a href="http://gamejolt.com" target="_blank">Game Jolt</a>.
+
+## Упаковка для desktop
+
+<div class="note">
+  <p>**Дважды проверьте название вашего проекта**, он появится в строке заголовка отдельных сборок вашей игры.
+</div>
+
+<div class="note">
+  <p>Мы надеемся автоматизировать все эти этапы упаковки в будущей версии.
+</div>
+
+Если вы хотите создавать автономные загружаемые версии вашей игры, вы можете использовать Electron.
+Electron - это в основном браузерный движок Chrome, предназначенный для запуска автономных приложений и игр HTML5, а не полноценного веб-браузера.
+
+<div class="action">
+  <p>Загрузите соответствующие сборки <a href="https://github.com/atom/electron/releases" target="_blank">Electron</a>.
+  Мы рекомендуем вам поддерживать Windows как в 64-битной, так и в 32-битной версиях, но, вероятно, вам подойдут только 64-битные версии.
+  для Linux и OS X (Apple несколько лет не поставляла 32-битное оборудование).
+</div>
+
+Electron требует, чтобы вы создали два файла, чтобы запустить вашу игру:
+
+### package.json
+
+```
+{
+  "name": "my-game",
+  "version": "1.0.0",
+  "main": "main.js"
+}
+```
+
+Не забудьте заменить `my-game` с названием вашей игры, используя строчные слова, разделенные тире.
+
+### main.js
+
+```
+"use strict";
+
+const electron = require("electron");
+var mainWindow = null;
+
+electron.app.on("window-all-closed", () => {
+  if (process.platform != "darwin") electron.app.quit();
+});
+
+electron.app.on("ready", () => {
+  mainWindow = new electron.BrowserWindow({
+    width: 1280, height: 720,
+    useContentSize: true,
+    // NOTE: Вы можете включить их, если хотите
+    // resizable: false,
+    // icon: `${__dirname}/icon.png`
+  });
+  mainWindow.setMenuBarVisibility(false);
+  mainWindow.loadURL(`file://${__dirname}/index.html`);
+  mainWindow.on("closed", () => { mainWindow = null; });
+});
+```
+
+### Упаковка для окон (32-bit и 64-bit)
+
+<div class="action">
+  <p>Распакуйте ZIP-архив Electron для каждой архитектуры и переименуйте папки в «my-game-win-ia32» (32-разрядная версия) и «my-game-win-x64» (64-разрядная версия).
+
+  <p>Для обеих этих папок:
+
+  <ul>
+    <li>Удалите `locales`,` pdf.dll` и `version`, они нам не нужны
+    <li>Поместите копию вашей экспортированной папки с игрой в `resources`, переименовав ее в` app`
+    <li>Переименуйте «Electron.exe» в нечто вроде «My Game.exe». Это исполняемые игроки будут нажимать на
+    <li>Создайте `package.json` и` main.js`, как описано выше, в `resources / app`
+  </ul>
+
+  <p>Вот и все, упакуйте все это в ZIP-архив и загрузите.
+</div>
+
+### Упаковка для Linux
+
+<div class="action">
+  <p>Распакуйте ZIP-архив Electron и переименуйте папку в нечто вроде `my-game-linux-x64`.
+
+  <ul>
+    <li>Удалите `locales` и` version`, они нам не нужны
+    <li>Поместите копию вашей экспортированной папки с игрой в `resources`, переименовав ее в` app`
+    <li>Rename `electron` to something like `My Game`. This is the executable players will click on
+    <li>Create `package.json` and `main.js`, as detailed above, in `resources/app`
+  </ul>
+
+  <p>That's it, pack it all up into a ZIP archive and upload.
+</div>
+
+### Packaging for OS X
+
+<div class="action">
+  <p>Unpack the Electron ZIP archive and rename the folder to something like `my-game-osx-x64`.
+
+  <ul>
+    <li>Remove `version`, we don't need it
+    <li>Put a copy of your exported game folder in `Electron.app/Contents/Resources/`, renaming it `app/`
+    <li>Rename `Electron.app` to something like `My Game.app`. This is the executable players will click on
+    <li>Create `package.json` and `main.js`, as detailed above, inside `My Game.app/Contents/Resources/app`
+  </ul>
+
+  <p>That's it, pack it all up into a ZIP archive and upload.
+</div>
+
+## Packaging for mobile
+
+Регулярно экспортируйте и используйте [Intel XDK](https://software.intel.com/en-us/intel-xdk)
+создать приложение для конкретной платформы, которое вы можете отправить в магазин.
+
+На Android кажется, что минимальная версия, необходимая для поддержки WebGL - 4.4.
+Соответственно, вы должны настроить `Projects/Build Settings/Minimum Android Version` на `19` в Intel XDK.

pages/ru/1_getting-started/11_source-control.md

@@ -0,0 +1,20 @@
+# Using source control
+
+Source control lets you create checkpoints in your project, compare old revisions with newer ones and back things up to a remote host like [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/).
+
+Superpowers projects can easily be kept under [source control](https://en.wikipedia.org/wiki/Revision_control). While there is no built-in support at the moment, existing tools like Git and Mercurial work great.
+
+## Delay when making changes
+
+In order to minimize its performance footprint, the Superpowers server doesn't write every change you make to a project to the disk immediately. Saving to disk might be delayed for up to 60 seconds.
+
+When creating a new revision for your project, either wait 60s or stop your server altogether to make sure everything has been flushed out to the disk. (We'll probably have a button to flush changes in the app at some point).
+
+## Что не надо помещать под систему контроля версий
+
+Есть пара папок, которые вы, вероятно, не хотите фиксировать в своем хранилище.:
+
+  * Папка `rooms/` содержит историю вашего недавнего журнала чата
+  * Папка `trashedAssets/` содержит удаленные активы
+
+Вы можете использовать `.gitignore` или файл `.hgignore`.

pages/ru/1_getting-started/1_about-superpowers.md

@@ -0,0 +1,34 @@
+# About Superpowers
+
+Superpowers - это среда разработки HTML5 для создания 2D и 3D игр..  
+Он может быть расширен с помощью плагинов и позволяет вам сотрудничать в режиме реального времени.
+
+[Смотрите вступительное видео на YouTube](https://www.youtube.com/watch?v=T7XoWWvGPd4)
+
+Superpowers был в разработке более года.
+Это уже отличная IDE, но она все еще быстро развивается.
+
+Мы решили сделать это бесплатно и <a href="http://github.com/superpowers" target="_blank">open source</a>.
+Если вам это нравится, вы можете поддержать нашу работу
+в <a href="https://patreon.com/SparklinLabs" target="_blank">patreon.com/SparklinLabs</a>.
+
+<a href="http://superpowers-html5.com/" target="_blank">
+  <img src="http://i.imgur.com/jdtBCpV.png" alt="Superpowers IDE" height="300" /> 
+  <img src="http://i.imgur.com/rDSabRb.gif" alt="Superpowers demo" height="300" />
+</a>
+
+Вы можете [внести свой вклад в эту документацию по GitHub](https://github.com/superpowers/docs.superpowers-html5.com).
+
+## Условные обозначения
+
+В этом руководстве всякий раз, когда вы должны что-то делать, это будет выглядеть так:
+
+<div class="action">
+  <p>Это действие, которое вы должны предпринять.
+</div>
+
+Важные примечания и информация об устранении неполадок будут отображаться в таких полях:
+
+<div class="note">
+  <p>Это может быть важным примечанием, не пропустите!
+</div>

pages/ru/1_getting-started/2_setting-up-superpowers.md

@@ -0,0 +1,65 @@
+# Setting up Superpowers
+
+<div class="action">
+  <p>Загрузите правильный ZIP для вашей платформы с <a href="https://sparklinlabs.itch.io/superpowers" target="_blank">страница загрузки</a>.  
+  Разархивируйте его в удобном месте и дважды щелкните «Superpowers».
+  Приложение запустится.
+</div>
+
+Вы увидите список серверов, и ваш собственный локальный сервер должен запуститься сразу.
+
+<div class="note">
+  <p>**Superpowers использует TCP-порты 4237 (для обслуживания клиента) и 4238 (для обслуживания сборок) ** по умолчанию, поскольку порт 80 требует специальных привилегий в Linux &amp; OS X. Кроме того, такие программы, как Skype, возможно, уже прослушивают его. Вы можете изменить порты, используемые Superpowers, на вкладке настроек сервера приложения.
+
+  <p>Если вы это сделаете, обязательно измените адрес записи «Мой сервер» в списке серверов, чтобы использовать правильный порт.
+</div>
+
+Double-click в "My Server" и откроется вкладка. Вам будет предложено выбрать имя пользователя.
+
+## Где хранятся мои данные?
+
+По умолчанию конфигурация вашего сервера и проекты хранятся в следующих местах, в зависимости от вашей операционной системы:
+
+  * В Windows: `%APPDATA%\Superpowers`
+  * В OS X: `~/Library/Application Support/Superpowers` (Используйте пункт меню «Перейти в папку» в Finder)
+  * В Linux: `~/.local/share/Superpowers`
+
+Чтобы сделать Superpowers автономный (например, если вы хотите носить Superpowers на USB-накопителе), вы можете переместить `config.json` файл и `projects` папка для Superpowers's `app` папку, и он автоматически начнет использовать их. Будьте осторожны при обновлении, вам нужно вручную переместить эти файлы из старой версии в новую.
+
+## Позволить другим присоединиться к вашему серверу
+
+По умолчанию ваш сервер будет принимать соединения только с того компьютера, на котором он работает.
+
+<div class="action">
+  <p>Чтобы открыть свой сервер для других, установите пароль в Настройках и остановите / запустите сервер.
+</div>
+
+<div class="note">
+  <p>**Вам, вероятно, понадобится <a href="https://www.google.com/search?q=setting%20up%20port%20forwarding" target="_blank">настройте свой домашний маршрутизатор</a>** и/или firewall
+  разрешить (или переслать) входящие TCP-соединения на номера портов, которые прослушивает ваш сервер (по умолчанию 4237 и 4238).
+</div>
+
+Когда ваш сервер открыт, <a href="https://www.google.com/search?q=my%20ip" target="_blank">получить ваш публичный IP-адрес</a> и вы можете отправить ссылку на форму `ip:port` людям, с которыми вы хотите работать (e.g.&nbsp;`1.2.3.4:4237`). Они могут либо вставить эту ссылку в адресную строку своего браузера, чтобы присоединиться без установки чего-либо, либо добавить ее в свой список серверов Superpowers из приложения.
+
+<div class="note">
+  <p>**Убедитесь, что вы указали свой публичный IP-адрес** с теми, с кем вы хотите сотрудничать. `127.0.0.1` это специальный адрес, который всегда указывает на компьютер, на котором вы его используете, поэтому другие не смогут подключиться к нему с вашего сервера.
+
+  <p>Самый простой способ получить ваш публичный IP-адрес - это <a href="https://www.google.com/search?q=my%20ip" target="_blank">спросить Google</a>.
+</div>
+
+## Запуск сервера Superpowers из командной строки
+
+Может быть полезно запускать Superpowers на автономном сервере, чтобы вам не приходилось постоянно включать настольный компьютер.
+Это должно работать на любом сервере Linux, включая Raspberry Pi.
+
+  * Установите последнюю версию <a href="https://nodejs.org/" target="_blank">Node.js</a>.
+  * Скачайте [последний выпуск Superpowers Core](https://github.com/superpowers/superpowers-core/releases)  и "распакуйте" его.
+  * Запустите `node server start` в корне.
+
+По умолчанию Superpowers будет хранить файлы конфигурации и проектов в `$XDG_DATA_HOME/Superpowers` (или `~/.local/share/Superpowers` если `$XGD_DATA_HOME` is undefined). Вы можете использовать опцию `--data-path=` чтобы переопределить это поведение.
+
+<div class="note">
+  После первого запуска вашего сервера вам необходимо остановить его (с помощью `Ctrl + C`)
+  и отредактировать сгенерированный файл `config.json`, чтобы установить пароль, затем снова запустите сервер.
+  Вы также можете настроить порты, которые он будет прослушивать.
+</div>

pages/ru/1_getting-started/3_first-project.md

@@ -0,0 +1,14 @@
+# Создание вашего первого проекта
+
+<div class="action">
+  <p>Нажмите на `New Project`, введите имя и описание.  
+  Дважды щелкните по названию вашего проекта, чтобы открыть его.
+</div>
+
+Superpowers поставляется с набором плагинов для импорта спрайтов, 3D-моделей, звуков, создания сцен, написания сценариев и многого другого.
+
+Проект состоит из дерева папок и активов.
+Актив - это общее имя для любой базовой части проекта, такой как спрайт, сцена или скрипт.
+
+Вы можете изменить порядок ресурсов вашего проекта, перетаскивая их.
+Дважды щелкните актив, чтобы открыть его редактор на вкладке, или используйте вместо него значок «Открыть в новом окне».