Touhou Patch Center:Servers/ru-prereform

Зеркала
Чтобы гарантировать доступность нашихъ переводовъ, ​данные​ ​патча​ ​используемые​ Touhou Community Reliant Automatic Patcher отзеркалены на нѣсколькихъ серверахъ.

Основной серверъ srv.thpatch.net является наиболѣе актуальнымъ рессурсомъ и напрямую получаетъ переводы послѣ того, какъ ​они​ были сдѣланы на вики. ​Остальныя​ зеркала получаютъ оттуда послѣднее состояніе каждую минуту.

Какъ и содержимое вики, переводы и изображенія на этомъ серверѣ лицензированы.

Сосѣди
Этотъ списокъ содержитъ ссылки на ​сторонніе​ ​репозиторіи​ ​патчей​, не находящихся подъ нашимъ контролемъ. При указаніи на, инструментъ конфигураціи также предложитъ выбрать ​патчи​ и этихъ ​репозиторіевъ​.

Если вы хотите, чтобы вашъ ​репозиторій​ былъ включенъ въ этотъ списокъ, отправьте письмо по адресу [mailto:submissions@thpatch.net submissions@thpatch.net], указавъ публичный путь къ вашему ​репозиторію​ (это значеніе "servers" въ repo.js). Если вы используете Git для управленія вашимъ серверомъ, вы также можете запросить его автоматическое зеркальное отображеніе на mirrors.thpatch.net. Это настоятельно рекомендуется для того, чтобы ваши ​патчи​ оставались доступными на случай, если исходный ​хостъ​ выйдетъ изъ строя.

Созданіе собственнаго сервера ​патчей​
Начиная со сборки 2014-01-26, thcrap включаетъ скриптъ Python для помощи въ созданіи собственнаго само-​обновляющегося​ сервера для ​патча​, на которомъ вы можете опубликовать свои ​патчи​, имѣя полный контроль надъ ними. Хотя это можетъ звучать довольно сложнымъ, но на самомъ дѣлѣ это не такъ ужъ и трудно - мы спеціально разработали систему такимъ образомъ, чтобы не требовалось никакого спеціальнаго ​серверного​ программнаго обезпеченія.

Для этого вамъ даже не надо платить за ​вебъ​-пространство; ​есть​ рядъ безплатныхъ облачныхъ хранилищъ, ​которыя​ такъ же хорошо работаютъ. Ниже вы можете найти руководства о томъ, какъ настроить вашъ собственный ​репозиторій​ на одномъ изъ нихъ. ​Всѣ​ ​эти​ руководства написаны только для Windows, но если вы используете другую операціонную систему, у васъ не должно возникнуть проблемъ съ ихъ адаптаціей. ☺

Обзоръ
Чтобы объяснить термины:


 * Во-первыхъ, у насъ ​есть​ ​патчи​. Это просто не​упорядоченные​ наборы файловъ, ​которые​ замѣняютъ ​​опредѣленные ​исходные​ ​данные​ игры. Одинъ ​патчъ​ можетъ замѣнить ​данные​ для неограниченнаго количества игръ.
 * ​Патчи​ сгруппированы въ ​репозиторіи​. Это, въ свою очередь, коллекціи всѣхъ разныхъ ​патчей​, предлагаемыхъ и контролируемыхъ однимъ человѣкомъ или сообществомъ.

Вы начинаете съ созданія ​репозиторія​, затѣмъ съ одного или нѣсколькихъ ​патчей​, ​которые​ вы обычно публикуете на серверѣ.

Локальная настройка
Во-первыхъ, вамъ нужно придумать глобально уникальный, короткій идентификаторъ для вашего ​репозиторія​. Это можетъ быть просто ваше имя или имя вашего сообщества. Въ этомъ руководствѣ мы назовемъ его RepoDir.

Также вамъ понадобится сдѣлать слѣдующее:

(Это языкъ программированія, на которомъ написанъ скриптъ сборки ​репозиторія​.) Это будетъ вашъ локальный путь ​репозиторія​, гдѣ будетъ происходить вся ваша разработка ​патча​.
 * 1) Загрузить и установить Python.svg Python 3, если у васъ его еще нѣтъ. Обязательно запишите путь, по которому онъ устанавливается.
 * 1) Создать новую папку, названную RepoDir въ вашей папкѣ thcrap.
 * 1) Внутри RepoDir создайте новую папку для каждаго вашего ​патча​, назвавъ его соотвѣтствующимъ короткимъ ID. Мы используемъ PatchDir какъ примѣръ.

Настройка ​патча​
Для каждаго ​патча​, создайте файлъ, названный patch.js</tt> въ RepoDir\PatchDir</tt>. Это обязательно, иначе скриптъ сборки не будетъ распознавать ​патчъ​.

​Всѣ​ файлы съ расширеніемъ JS являются форматомъ файла JSON. Вы можете провѣрить ихъ синтаксисъ, используя такіе сайты, какъ JSONLint.

Зависимости
​Онѣ​ устанавливаются съ помощью массива dependencies</tt> въ patch.js</tt> и гарантируютъ, что инструментъ конфигураціи автоматически задѣйствуетъ ​всѣ​ ​нужныя​ функціи вашего ​патча​.

Утвержденія о зависимостяхъ имѣютъ форму id_репозиторія/id_патча</tt>. id_репозиторія</tt> не является обязательной вещью - его отсутствіе разрѣшитъ данный ​патчъ​ сначала въ вашемъ ​репозиторіи​, а затѣмъ глобально во всѣхъ ​репозиторіяхъ​, обнаруженнымъ пользователемъ. Будьте осторожны, это можетъ имѣть не​предвидѣнныя​ послѣдствія при использованіи съ ​патчемъ​, который не въ вашемъ ​репозиторіи​.

Вотъ ​нѣкоторые​ изъ сѣтевыхъ ​патчей​, ​которые​ вы можете захотѣть связать:
 * nmlgc/base_tsa</tt>: Базовая техническая поддержка для Touhou игръ на Windows. Если вашъ ​патчъ​ нацѣленъ на какую-либо изъ этихъ игръ, обязательно включите его какимъ-либо образомъ! Иначе, инструментъ конфигураціи можетъ не втянуть его, и въ результатѣ конфигураціи могутъ не сработать!
 * nmlgc/script_latin</tt>: Содержитъ шрифтъ съ достаточнымъ охватомъ Unicode для текстовъ на латиницѣ, греческомъ и кириллицѣ, ​нѣкоторыя​ настройки могутъ сдѣлать такъ, чтобы онъ настолько хорошо выглядѣлъ, насколько возможно для каждой игры, а также для латинизаціи Хепбернъ для общихъ терминовъ и изображеній.
 * nmlgc/western_name_order</tt>: Именно то, что написано - западный порядокъ написанія именъ враговъ во время битвъ съ боссами.
 * thpatch/lang_en</tt>: Не только даетъ вамъ актуальный англійскій переводъ, но и гарантируетъ, что будутъ присутствовать ​всѣ​ другіе зависимости для ​патча​ для перевода (напримѣръ, ​всѣ​ три ​патча​, упомянутыхъ выше), когда вы будете выбирать вашъ ​патчъ​ въ инструментѣ конфигураціи.

Примѣры
Базовая конфигурація ​патча​ для перевода, использующая скриптъ на латинскомъ алфавитѣ, отличный отъ англійскаго:

Включаетъ всё вышеперечисленное (а можетъ даже больше въ будущемъ) плюсъ переводъ на англійскій:

Шрифты
Если вашъ ​патчъ​ включаетъ въ себя ​пользовательскіе​ шрифты, зарегистрируйте ихъ съ помощью объекта fonts</tt>. Это просто списокъ съ каждымъ именемъ файла шрифта, ​которые​ должны загрузиться передъ запускомъ ​запатченной​ игры:

(thcrap не смотритъ на фактическое значеніе ключа, въ этомъ примѣрѣ true)

Хорошо, и какъ мнѣ сдѣлать X?
Что же, thcrap можетъ сдѣлать многое. ☺ Пока мы не опишемъ всё, лучше всего посмотрѣть, какъ наши ​патчи​ дѣлаютъ то, что вы собираетесь сдѣлать. Если у васъ всё еще остались вопросы, просто посѣтите нашъ IRC ​чатъ​, спросите насъ, и мы будемъ рады вамъ помочь.

Настройка сервера
Оставшаяся часть этого руководства отличается въ зависимости отъ ​вебъ​-пространства или провайдера сервера, который вы используете.

Использованіе GitHub.png GitHub
Это рекомендуемый варіантъ. Это сохранитъ вашъ ​репозиторій​ подъ системой контроля версій и, такимъ образомъ, будетъ хранить всю исторію вашихъ ​патчей​, которую затѣмъ можно будетъ просмотрѣть на сайтѣ GitHub. Мы также думаемъ о добавленіи прямой поддержки Git въ обновитель thcrap въ будущемъ, что сдѣлаетъ настройку даже легче.

Если вы уже знакомы съ Git: Просто запускайте repo_update.py</tt> каждый разъ передъ отдачей. Если же вы не знакомы, то вотъ какъ настроить его на Windows:

Если ваша локальная папка ​репозиторія​ имѣетъ такое же имя, какъ у того, который въ GitHub, это не сработаетъ. Въ этомъ случаѣ просто переименуйте вашу локальную папку, а затѣмъ перемѣстите ​ея​ содержимое въ новую созданную папку послѣ завершенія процесса клонированія.
 * 1) Убѣдитесь, что у васъ послѣдняя 2014-05-08 или болѣе поздняя версія thcrap. Эта сборка вводитъ ​нѣкоторыя​ ​важныя​ измѣненія въ скриптъ ​репозиторія​, который дѣлаетъ поддержку GitHub возможной. Также убѣдитесь, что это thcrap.zip и его содержимое находится въ той же папкѣ, что и ваши ​патчи​. Иначе вы получите ошибку объ томъ, что repo_update отсутствуетъ.
 * 2) Зарегистрируйте новый безплатный аккаунтъ на GitHub, если у васъ его еще нѣтъ.
 * 3) На вашей панели инструментовъ создайте новый ​репозиторій​ съ настройками по умолчанію. Его имя необязательно должно соотвѣтствовать съ именемъ, который вы выбрали для RepoDir</tt> въ вашей локальной настройкѣ.  GitHub Tutorial 02 - Dashboard.png  GitHub Tutorial 03 - New repo.png
 * 4) Загрузите и установите кліентъ для Windows и войдите въ вашъ аккаунтъ GitHub.
 * 5) Въ меню "Options" установите въ default storage directory вашу папку thcrap и укажите свое имя и адресъ электронной почты въ раздѣлѣ configure git.  GitHub Tutorial 05 - Login.png
 * 6) ​Клонируйте​ ​репозиторій​, который вы создали на GitHub въ вашу папку thcrap.
 * 1) Въ новой клонированной папкѣ создайте файлъ съ именемъ Update.bat</tt>, который вы будете использовать для запуска скрипта обновленія thcrap:
 * Затѣмъ запустите Update.bat</tt> и установите ​основные​ параметры вашего ​репозиторія​. ID ​репозиторія​ долженъ быть такимъ же, какъ имя его папки, а общедоступная ссылка для GitHub - это:
 *  https://raw.githubusercontent.com/ имя-пользователя-GitHub/имя-​репозиторія​-GitHub/master/</tt>
 * GitHub Tutorial 07 - repo_update.png

Это всё, что касается базовой настройки. Послѣ того, какъ вы внесете нѣсколько измѣненій въ ваши ​патчи​, вы ихъ публикуете такимъ образомъ: Обязательно сдѣлайте это сразу послѣ запуска скрипта обновленія! Если вы запустите thcrap съ ​патчемъ​, который вы редактируете передъ отдачей, обновитель перезапишетъ ваши измѣненія послѣднимъ состояніемъ на серверѣ!''' СЪ 2017-02-05, ​автоматическія​ обновленія автоматически отключатся, если ​патчъ​ находится внутри ​репозиторія​ git.
 * 1) Запустите <tt>Update.bat</tt>.
 * 2) Откройте кліентъ GitHub и перейдите въ вашъ ​репозиторій​ ​патча​. Это должно дать вамъ ​всѣ​ измѣненія съ послѣдней отдачи, а также возможность создать новую.
 * 1) Подтвердите измѣненія, ​которыя​ вы собираетесь отдать. Если всё въ порядкѣ, каждый файлъ, который вы измѣнили, теперь долженъ имѣть другую контрольную сумму въ <tt>files.js</tt> файлъ затронутыхъ обновленій:  GitHub Tutorial 08 - Commit.png
 * 2) Потомъ просто нажмите commit to master, а затѣмъ publish, и ваши измѣненія вступятъ въ силу.

Сдѣлать вашъ ​репозиторій​ извѣстнымъ
Для того, чтобы вашъ ​патчъ​ былъ виденъ и могъ использоваться другими во всёмъ ​мірѣ​, обычно существуетъ три способа:
 * Послѣ того, какъ вашъ ​репозиторій​ былъ загруженъ, ​любой​ другой можетъ обнаружить его, запустивъ <tt>thcrap_configure</tt> съ вашей ссылкой въ качествѣ командной строки.
 * Если у васъ ​есть​ собственный сайтъ, ​блогъ​ и т.д., вы можете загрузить пользовательскую версію архива thcrap, содержащій файлъ <tt>repo.js</tt> внутри вашего локальной папки ​репозиторія​. Хотя обычно это не рекомендуется.
 * Однако, лучшій методъ - это связаться съ нами въ https://thpatch.net/w/logos/discord.png Discord и сообщить намъ вашу ссылку на ​репозиторій​, чтобы онъ былъ внесенъ въ списокъ сѣти     какъ одинъ изъ нашихъ сосѣдей.