LOGIN-45d1: Streamlined login process in Installation mode. Also conv…

…erted some docs to MarkDown
supernova-ws · Jul 27, 2020 · cc0c702 · cc0c702
1 parent 61fa624
commit cc0c702
Show file tree

Hide file tree

Showing 11 changed files with 386 additions and 311 deletions.
diff --git a/README → README.MD b/README → README.MD
@@ -1,11 +1,9 @@
-We Want YOU!
-~~~~~~~~~~~~
+# We Want YOU!
 SuperNova need YOU! We need maintainers  for  localizations.  Any  language  is
 fine! Currently we need maintainer for English locale to check and  fix  it  as
 base for other non-Russian speaker users!
 
-Project "SuperNova.WS"
-~~~~~~~~~~~~~~~~~~~~~~
+# Project "SuperNova.WS"
 "SuperNova.WS" (shortly SN) is  a  massive  multiplayer  online  browser  space
 strategy game (like oGame). SN is a very heavily modified XNova RageRepack v226
 
@@ -22,8 +20,7 @@ If you want to sell such product - contact me
 Currently SN supports Russian and English languages
 
 
-Disclaimer
-==========
+## Disclaimer
 WARNING! Project status is "Alpha"! It means  that  any  update  can  seriously
 change any aspect of gameplay!  Also  it  means  that  there  may  be  lack  of
 documentation, no user-friendly installer. Also it means  that  any  user  that
@@ -39,46 +36,35 @@ ENCOUNTER SUCH DIFFERENCE! Some notes about SN future development can  be  read
 in /docs/todo.txt (Russian)
 
 
-Web-resources
-=============
+## Web-resources
 
-Main Hub For Your SuperNova Experience
---------------------------------------
-Russian Version
-  http://supernova.ws/index.htm
-English Version
-  http://supernova.ws/index-en.htm
+### Main Hub For Your SuperNova Experience
+Russian Version http://supernova.ws/index.htm
 
-GitHub
-------
+English Version http://supernova.ws/index-en.htm
+
+### GitHub
 You encouraged to use GitHub as main source for SN releases and builds
 
-SN on GitHub:
-  http://github.com/supernova-ws/SuperNova
+SN on GitHub: http://github.com/supernova-ws/SuperNova
 
-GIT-repository:
-  git://github.com/supernova-ws/SuperNova.git
+GIT-repository: git://github.com/supernova-ws/SuperNova.git
 
-GIT-repository through HTTP:
-  https://github.com/supernova-ws/SuperNova#
+GIT-repository through HTTP: https://github.com/supernova-ws/SuperNova#
 
-Latest stable release:
-  https://github.com/supernova-ws/SuperNova/zipball/master
+Latest stable release: https://github.com/supernova-ws/SuperNova/zipball/master
 
-Latest night build (stability is not guaranted!):
-  https://github.com/supernova-ws/SuperNova/zipball/trunk
+Latest night build (stability is not guaranted!): https://github.com/supernova-ws/SuperNova/zipball/trunk
 
-SVN-interface (SVN-interface on GitHub works is very unstable):
-  http://svn.github.com/supernova-ws/SuperNova.git
+SVN-interface (SVN-interface on GitHub works very unstable): http://svn.github.com/supernova-ws/SuperNova.git
 
 There are 3 branches on GitHub repository
-"master" contains last stable version.
-"trunk" contains most recent and feature-rich code. Here can be some minor bugs
-"test"  contains  developer  snapshot.   It   can   be   partially   or   fully
+- "master" contains last stable version.
+- "trunk" contains most recent and feature-rich code. Here can be some minor bugs
+- "test"  contains  developer  snapshot.   It   can   be   partially   or   fully
 non-functional.  Hovewer  here  you  can  see  currently  developing  features.
 
-SourceForge
------------
+### SourceForge
 GIT-repository on SourceForge:
   git://supernova-ws.git.sourceforge.net/gitroot/supernova-ws/supernova-ws
 
@@ -91,13 +77,11 @@ DIFFs
 Patches (archive of differences between indicated versions)
   http://sourceforge.net/projects/supernova-ws/files/patches/
 
-Support
--------
+### Support
 Forum (Russian and English):
   http://forum.supernova.ws/viewforum.php?f=73
 
-Live Demo Universes
--------------------
+### Live Demo Universes
 SuperNova (x1):
   http://supernova.ws
 
@@ -107,42 +91,42 @@ oGame (x2):
 Beta (x50):
   http://beta.supernova.ws
 
-Documentation
-=============
-All documentation located in folder "docs".
+## Documentation
+All documentation located in folder `/docs`.
 
 License (English):
-  /docs/license.txt
+  `/docs/license.txt`
 
 Project documentation (Russian):
-  /docs/readme.txt
+  `/docs/readme.txt`
 
 User-level changelog (Russian):
-  /docs/changelog.txt
+  `/docs/changelog.txt`
 
 Installation instructions (Russian):
-  /docs/install.txt
+  `/docs/install.md`
+
 Installation instructions (English, google-translated):
-  /docs/install-en.txt
+  `/docs/install-en.md`
 
 
 Documentation for developers & administrators (Russian):
-  /docs/html/developer.html
+  `/docs/html/developer.html`
 
 Changelog for developers & administrators (Russian):
-  /docs/changelog_dev.txt
+  `/docs/changelog_dev.txt`
 
 Plans for further development (Russian):
-  /docs/todo.txt
+  `/docs/todo.txt`
 
 Coding Gudelines for developers (English):
-  /docs/html/coding-guidelines.html
+  `/docs/html/coding-guidelines.html`
 
 Bellitrized game background (Russian):
-  /docs/SuperNova - All you didn't want to know but forced to.docx
+  `/docs/SuperNova - All you didn't want to know but forced to.docx`
+
 
+# Copyright notice
+СуперНова copyright (c) 2009-2020 Gorlum для http://supernova.ws
 
-Copyright notice
-================
-СуперНова copyright (c) 2009-2013 Gorlum для http://supernova.ws
-Project "SuperNova.WS" copyright (c) 2009-2013 by Gorlum for http://supernova.ws
+Project "SuperNova.WS" copyright (c) 2009-2020 by Gorlum for http://supernova.ws
diff --git a/docs/changelog.txt b/docs/changelog.txt
@@ -11,6 +11,9 @@
 
 Project "SuperNova.WS" Release 45 "11 years anniversary"
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+[!] Установка/обновление
+    Улучшен процесс установки/обновления
+    Расширен раздел, посвященный проблемам с установкой или обновлением в файлах /docs/install.md и /docs/install-en.md
 [!] Чат
     Полностью новый чат
     Встроенная система команд с поддержкой алиасов команд
@@ -50,6 +53,12 @@ Project "SuperNova.WS" Release 45 "11 years anniversary"
     Новая система рабочих процессов Worker
     Новая система задач и блокировок (Task/Lock). Пока используется только для обсчёта летящих флотов
     Добавлена поддержка формата изображений WebP
+[!] Документация
+    Инструкция по установке/обновлению переделана в формат MarkDown:
+        - /README -> /README.MD
+        - /docs/install.txt -> /docs/install.md
+        - /docs/install-en.txt -> /docs/install-en.md
+
 
 [+] Альянсы/Поиск
     В результаты поиска Альянсов и в "Рекомендуемые Альянсы" (см. ниже) добавлены две колонки:

diff --git a/docs/changelog_dev.txt b/docs/changelog_dev.txt
@@ -164,8 +164,6 @@ AccessorsV2
     - htmlentities($text, ENT_COMPAT, 'UTF-8');
     - Заменить nl2br хелпером ?
 
-Переделать README в markdown
-
 Мигрировать опции
     $options = sys_user_options_pack($user);
 
@@ -2080,6 +2078,18 @@ https://stackoverflow.com/questions/1019867/is-there-a-way-to-use-shell-exec-wit
 #ctv
 
 
+2020-07-27 12:12:06 45d1
+[!] Документация
+    Переделана в формат MarkDown:
+        - /README -> /README.MD
+        - /docs/install.txt -> /docs/install.md
+        - /docs/install-en.txt -> /docs/install-en.md
+
+[!] Установка/обновление
+    Улучшен процесс установки/обновления
+    Расширен раздел, посвященный проблемам с установкой или обновлением в файлах /docs/install.md и /docs/install-en.md
+
+
 2020-07-27 10:08:44 45d0
 [!] Project "SuperNova.WS" Release 45 "11 years anniversary"
     Project "SuperNova.WS" Release 45 "11 years anniversary"
@@ -12494,7 +12504,7 @@ get_unit_param()
     транспортов на одну строку вниз
 [%] Локализация/EN: Исправлены очепятки
 
-[@] Документация: readme преобразован в UTF8
+[@] Документация: README преобразован в UTF8
 [@] Добавлена компенсация  работы  механизма  Magic  Quotes.  Подробнее  -  см.
     /docs/install.txt, подраздел "Magic Quotes"
 

diff --git a/docs/html/changelog.html b/docs/html/changelog.html
@@ -32,6 +32,9 @@ <h1>
 
 Project "SuperNova.WS" Release 45 "11 years anniversary"
 ~~
+[!] Установка/обновление
+    Улучшен процесс установки/обновления
+    Расширен раздел, посвященный проблемам с установкой или обновлением в файлах /docs/install.md и /docs/install-en.md
 [!] Чат
     Полностью новый чат
     Встроенная система команд с поддержкой алиасов команд
@@ -71,6 +74,12 @@ <h1>
     Новая система рабочих процессов Worker
     Новая система задач и блокировок (Task/Lock). Пока используется только для обсчёта летящих флотов
     Добавлена поддержка формата изображений WebP
+[!] Документация
+    Инструкция по установке/обновлению переделана в формат MarkDown:
+        - /README -> /README.MD
+        - /docs/install.txt -> /docs/install.md
+        - /docs/install-en.txt -> /docs/install-en.md
+
 
 [+] Альянсы/Поиск
     В результаты поиска Альянсов и в "Рекомендуемые Альянсы" (см. ниже) добавлены две колонки:

diff --git a/docs/html/readme.html b/docs/html/readme.html
@@ -237,8 +237,8 @@ <h2 class="heading">Установка</h2>
                             версии PHP, или используйте предыдущую версию СН.
                             Описание бага: <a href="https://bugs.php.net/bug.php?id=50394">https://bugs.php.net/bug.php?id=50394</a>
                             Подробные инструкции по установке содержатся в файлах:
-                            /docs/install.txt
-                            /docs/install-en.txt
+                            /docs/install.md
+                            /docs/install-en.md
                         </p>
                     </div>
                 </li>
@@ -344,10 +344,10 @@ <h2 class="heading">Документация</h2>
                             /docs/changelog_dev.txt
                         </p>
                         <p>Инструкции по установке (на русском):
-                            /docs/install.txt
+                            /docs/install.md
                         </p>
                         <p>Инструкции по установке (английский, google-translated):
-                            /docs/install-en.txt
+                            /docs/install-en.md
                         </p>
                         <p>Документация для администраторов и разработчиков (на русском):
                             /docs/html/developer.html
@@ -1094,7 +1094,7 @@ <h4>Опыт, уровни и навыки Капитана</h4>
                                             Повышение в уровне дает возможность улучшать умения Капитанов.
                                             Умения Капитана включают бонусы к щитам, броне и атаке
                                             Каждый  уровень  умений   дает   1%   к   базовому   значению       соответствующей
-                                            характеристики кораблей во флоте, которым управляет Капитан 
+                                            характеристики кораблей во флоте, которым управляет Капитан
                                             Уровни Капитана вкладываются в умения один раз и  навсегда  -   поэтому  заранее
                                             тщательно планируйте развитие своего Капитана
                                         </li>
@@ -1469,7 +1469,7 @@ <h4>Боевой отчёт</h4>
                                             <li>5. Общие потери в пересчете на ресурсы. Включает стоимость боевых  единиц  на
                                                                                         момент боя, вывоз с планеты и ресурсы, потерянные из-за уменьшения трюмов</li>
                                            <li> 6. Общие потери в ресурсах в пересчете на металл по курсу  Черного  Рынка  на
-                                                                                       момент проведения боя. Писькомерка для сравнения 
+                                                                                       момент проведения боя. Писькомерка для сравнения
                                                                                        "Лог раундов" показывает результаты расчета каждого раунда для всех флотов</li>
                                             </ul>
                                            <ul>
@@ -1482,7 +1482,7 @@ <h4>Боевой отчёт</h4>
                                            <li> 3. Цветовое кодирование информации о подразделениях:
                                                                                        Зеленый означает, что вся атака в раунде поглощена щитами
                                                                                        Желтый - часть атаки пробила щиты ("пробой") и нанесла урон по  броне,  но
-                                                                                       при этом ни одна боевая единица не уничтожена 
+                                                                                       при этом ни одна боевая единица не уничтожена
                                                                                        Оранжевый - один или более боевых единиц уничтожено
                                                                                        Красный - все оставшиеся боевые единицы уничтожены в этом раунде
                                                                                        Число в скобках в столбце потерь - количество боевых единиц,  взорвавшихся
@@ -2119,7 +2119,7 @@ <h4>Почему все работает именно так?</h4>
                                                                                        в статистике.</p>
                                                 </li>
                                             </ul>
-                                            
+
                                         </li>
                                         <li>
                                             <ul>
@@ -2130,7 +2130,7 @@ <h4>Расчет по минимальному размеру Альянса</h4
                                             Значение бонуса вычисляется  по формуле:
                                             Бонус = round(
                                             &lt;уровень&gt;
-                                            * 
+                                            *
                                             &lt;участники&gt;
                                             / sqr(
                                             &lt;минимальный размер&gt;
@@ -2176,11 +2176,11 @@ <h4>Расчет по очкам Альянса</h4>
                                             Значение бонуса вычисляется по формуле:
                                             Бонус = round(
                                             &lt;уровень&gt;
-                                            * 
+                                            *
                                             &lt;очки&gt;
-                                            / 
+                                            /
                                             &lt;количество игроков&gt;
-                                            / 
+                                            /
                                             &lt;делитель&gt;
                                             ),
                                             где
@@ -2761,7 +2761,7 @@ <h4>Именование систем и галактик</h4>
                                     базовую стоимость в 1.000 ТМ, однако решил уплатить 2.500 ТМ
                                     Теперь цена переименования системы для следующего игрока составит
                                     &lt;Текущая цена имени&gt;
-                                    + 
+                                    +
                                     &lt;Базовая цена&gt;
                                     = 2.500 + 1.000 = 3.500 ТМ
                                     Таким  образом  более  высокая  цена  именования  галактики   или   системы   в
@@ -3575,7 +3575,7 @@ <h2 class="heading">Прочее</h2>
                         Все это позволило заметно сократить размеры кода в памяти сервера
                         [@] Модули: Загрузчики модулей теперь располагаются в каталоге /modules, а не в
                         /modules/_functions
-                        [@] Документация: readme преобразован в UTF8
+                        [@] Документация: README преобразован в UTF8
                         [@] Добавлена компенсация  работы  механизма  Magic  Quotes.  Подробнее  -  см.
                         "/docs/install.txt", подраздел "Magic Quotes"
                         [@] Юниты