JSO x
- 2nd Lieutenant -
 | | 1402 |
Doom Rate: 2.27
Posts quality: +786 |
 Отправлено: 08.02.26 13:53:46 | |
|
Доброго времени суток!
ZScript — не самый элементарный язык, и большинство хороших руководств, документаций и статей по нему есть только на английском языке. Существующие русскоязычные ресурсы либо покрывают какую-то небольшую часть, либо, к сожалению, остались доступны только в архивах.
Устойчивый спрос на ZScript в русскоязычной среде есть, и это положение дел необходимо исправлять. Потому — объявляю анонс первой публичной версии наиболее полного руководства по ZScript на русском языке!
Сайт руководства:
https://zscript-rus-manual.readthedocs.io/latest/
Там же "Быстрый старт" и страница оглавления.
Репозиторий проекта:
https://github.com/LLDM-Doom-Modding/zscript_rus_manual
Что ещё важно, данное руководство никуда не денется, даже если куда-то денутся все авторы — работу на данный момент обеспечивают два известных хостинга.
Внимание! Проект на данный момент находится в глубокой разработке, поэтому часть статей или разделов пока что отсутствует, в остальных же могут попадаться ошибки.
Просьба относиться с пониманием и по возможности о них сообщать или сразу исправлять. Конструктивная критика приветствуется, а отзывы и помощь дают огромный приток мотивации.
В руководство включается:
- Непосредственно раздел руководства — глава "Первый мод";
- Документация с дружелюбными примерами использования (главы от 3 до 6), а также полноценные примеры готового кода в отдельном разделе;
- Ссылки на ресурсы, где могут помочь разобраться с ZScript;
- Советы и решения, полученные из опыта (встречаются повсеместно и иногда в отдельных статьях);
- Как на самом деле работает движок — разбор внутренней работы движков семейства *ZDoom и языка ZScript;
- Списки частых ошибок, списки действительно неординарных багов, список ошибок компилятора — и, конечно, как их всех отслеживать и решать.
На данный момент написаны не все статьи — к примеру, глава 2 "Первый мод" включает в себя 7-8 статей, но готовы из них пока только 3.5. Прогресс можно отслеживать в репозитории проекта и в канале "#zscript-rus-manual-commits" Discord-сервера Russian Doom Discord Community. Пока что основная ветка разработки также находится на RDDC, в форум-канале "#Русскоязычный мануал по ZScript. Канал разработки". Новости в первую очередь будут публиковаться там и в этой теме на iddqd.ru.
Связаться с авторами можно:
- На большинстве серверов общей направленности в списке всех отечественных Doom-Discord-серверов;
- Здесь, в личных сообщениях iddqd.ru;
- В issues на GitHubl
- Где-нибудь ещё, где будет удобно общаться и где переписка не потеряется.
* * *
Ищем авторов и редакторов!
За всё время, считая только текстовые файлы статей размером более 1 Кб, было написано 396 Кб текста. За последние три ударные недели перед выпуском первой версии добавлено 112 Кб, или 957 строк/абзацев (подсчёт ведётся по символу новой строки), с учётом заменённых абзацев 1467. Если эти три недели смотреть по всем попарным изменения между соседними коммитами, заменено 1049 строк/абзацев, добавлено — 4328.
Конечно, это уже далеко не капля в море, но проект всё ещё не завершён, и в свободном темпе будет готов хорошо если через десяток лет.
Из истории, из результатов коммерческих компаний и мира Open Source известно, что совместная работа позволяет совершать то, что невозможно одному человеку. Потому, если Вы видите неточности или видите, что можно улучшить абзац — просьба сообщать, корректура тоже отнимает много времени. Если Вы знаете ту или иную тему из мира ZScript, призываю присоединяться к разработке — лучше написать и потом совместно исправить, чем не написать вовсе! Сокращение времени основного цикла разработки до полугода (получается, в двадцать раз) — это уже огромный успех, и он вполне реалистичен.
Вся цепочка поставок настроена, при отправке изменений в репозиторий они появляются и на сайте. В минимальной комплектации достаточно будет блокнота Windows и произвольного канала связи со мной или другим разработчиком, некоторые другие варианты описаны здесь. При необходимости со своей стороны могу провести краткий экскурс в работу с git/репозиторием, про текстовый язык разметки Markdown, или даже про локальное развёртывание сервера MkDocs для необязательного предпросмотра результата.
* * *
Успехов в изучении ZScript! |
|
|
Правила 
Поиск
