PDA

Просмотр полной версии : [Info] Описание Pro-Pawn Wiki



Daniel_Cortez
23.07.2018, 17:32
Pro-Pawn Wiki (http://wiki.pro-pawn.ru) - проект по составлению альтернативной русскоязычной документации к моду San Andreas Multiplayer (SA-MP), развивающийся под эгидой Pro-Pawn.ru.
Основным отличием данного wiki-проекта от официального является подход к написанию статей:

Документация составляется с "инсайдерской" точки зрения.
По возможности описывается каждый баг и каждая особенность работы той или иной функции SA-MP и Pawn. Для получения информации используется декомпиляция и дизассемблирование исполняемых файлов мода, а также изучение исходных кодов открытых частей сервера (например, интерпретатора и модулей расширения AMX из Pawn 3.0).

Баги не выдаются за "фичи".
Перед публикацией примечаний о багах в функциях Pawn и SA-MP в сомнительных случаях реализация функций изучается посредством декомпиляции, дизассемблирования или анализа доступных исходных кодов, чтобы отличить баги от запланированного поведения.

Отсутствие цензуры.
Данный wiki-проект не связан c разработчиками SA-MP и не контролируется ими, а потому на нём нет правила (как явного, так и негласного) говорить о них и обо всём проекте SA-MP только в позитивном ключе. Например, если в SA-MP Team зачем-то сделали две функции AddStaticVehicle() и AddStaticVehicleEx(), это сделали не из-за "недосмотра", а из-за незнания разработчиками языка Pawn (можно было сделать всего одну функцию AddStaticVehicle() и добавить в неё необязательный аргумент respawn_delay = 120).

Регистрация в данном wiki-проекте производится по приглашениям. Вы можете оставить заявку в специальной теме (http://pro-pawn.ru/showthread.php?16327-%D0%97%D0%B0%D1%8F%D0%B2%D0%BA%D0%B8-%D0%BD%D0%B0-%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8E), в случае её одобрения мы отправим на Ваш e-mail инвайт, по которому вы сможете пройти регистрацию.

VVWVV
23.07.2018, 20:35
В примерах явно не хватает результата. Кстати, если уж на то пошло, то мне кажется, что пора делать онлайн парсер для pawn.

ORLADOK
17.08.2018, 16:48
По-моему у кого-то была уже идея (из программы: "Идея: Pr0c, Osetin") делать подобные статьи, как страницы книжки.
Что случилось с "Учебником Pro-Pawn.ru"?

Не имею право судить, но разве не стоит добавлять в статьи наименование заголовочной библиотеки описываемой функции? Или я просто не доглядел (минуту-три посидел-потыркал) =)

Daniel_Cortez
17.08.2018, 17:11
Кстати, если уж на то пошло, то мне кажется, что пора делать онлайн парсер для pawn.
В чате это обсуждалось, и, по-моему, уже не раз, причём каждый раз обсуждение заходило в тупик. Если есть желание потратить кучу времени на написание с нуля парсера на PHP или арендовать за свои деньги сервер для запуска на нём компилятора - всегда пожалуйста. =)


Что случилось с "Учебником Pro-Pawn.ru"?
Возможно, позже попробую выложить на Wiki обновлённые уроки из учебника.


Не имею право судить, но разве не стоит добавлять в статьи наименование заголовочной библиотеки описываемой функции?
Едва ли это важная информация, когда в SA-MP все стандартные инклуды включаются одной строкой "#include <a_samp>".

ORLADOK
17.08.2018, 17:28
Едва ли это важная информация, когда в SA-MP все стандартные инклуды включаются одной строкой "#include <a_samp>".

То есть это будет включено при описаниях функций других библиотек, например, sscanf? [Кстати, было бы интересно увидеть объем информации по нему (вы же будете выкладывать своими словами, судя по статье?)]

Mopok
26.01.2019, 04:59
Круто, надеюсь развитие продолжается, ибо вики нужна часто и альтернативная версия от про- павн лишней не была бы, тем более с вашей инфой, тем более некоторые вещи мне уже пригодились )

Daniel_Cortez
29.01.2019, 06:04
Круто, надеюсь развитие продолжается, ибо вики нужна часто и альтернативная версия от про- павн лишней не была бы, тем более с вашей инфой, тем более некоторые вещи мне уже пригодились )
Спасибо. Wiki время от времени пополняется статьями, последние изменения можно найти здесь (http://wiki.pro-pawn.ru/index.php?title=%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%A1%D0%B2%D0%B5%D0%B6%D0%B8%D0%B5_%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8&days=14&from=).