Talk:Ru/api/kernel: Difference between revisions
mNo edit summary |
mNo edit summary |
||
Line 9: | Line 9: | ||
Хм, шаблон. Интересная идея. Можно попробовать сделать либо полный шаблон, навроде такого: | Хм, шаблон. Интересная идея. Можно попробовать сделать либо полный шаблон, навроде такого: | ||
---- | ---- | ||
'''Системная функция | '''Системная функция name''' - about | ||
==Параметры== | |||
* eax = eax | * eax = eax | ||
==Возвращаемое значение== | ==Возвращаемое значение== | ||
return | return | ||
==Замечания== | ==Замечания== | ||
notes | notes | ||
---- | ---- | ||
Такой вот скрипт, проверяющий, что поле eax, например, не пустое: | |||
<nowiki> | |||
* {{#if: {{eax}} | |||
| eax = {{eax}} | |||
}} | |||
</nowiki> | |||
Тогда обращаться к шаблону надо будет примерно так: | Тогда обращаться к шаблону надо будет примерно так: |
Revision as of 07:00, 27 March 2010
Огромная статья. Может, лучше разбить на отдельные статьи?
Разбить API на 70 статей? Да, было бы здорово. Короткие темы логично было бы дополнять примерами кода и описаниями соответствующих оберток системных вызовов.
В качестве примера: Ru/api/SysFn07. Может, еще какой-нибудь шаблон для удобства добавить? --Art zh 01:15, 27 March 2010 (EET)
Хм, шаблон. Интересная идея. Можно попробовать сделать либо полный шаблон, навроде такого:
Системная функция name - about
==Параметры== * eax = eax
==Возвращаемое значение== return
==Замечания== notes
Такой вот скрипт, проверяющий, что поле eax, например, не пустое:
* {{#if: {{eax}} | eax = {{eax}} }}
Тогда обращаться к шаблону надо будет примерно так:
{{SysFn|name=7|eax=7 - номер функции|ebx=указатель на изображение в формате BBGGRRBBGGRR|ecx=[размер по оси x]*65536 + [размер по оси y]|edx = [координата по оси x]*65536 + [координата по оси y]|return=функция не возвращает значения|notes= Координаты изображения - это координаты верхнего левого угла изображения относительно окна.<br /> Размер изображения в байтах = ''3 * Xsize * Ysize''. <br /> Соответствующий системный вызов: '''??''' <br />}}
Насколько рационально делать такой шаблон - не знаю. Ведь для каждой функции могут быть детали... Просто прийти к какому-нибудь стандарту по оформлению статей - как с приложениями определились более-менее.
Мне кажется, что правильнее начинать статью не с дублирования её заголовка как подраздела, а сразу с пояснения сути функции. Вроде бы так принято в вики.
Плюс... И/или добавить шаблон для отображения в нижней части страницы - как с приложениями. Если таковой востребован, могу наваять :)--SoUrcerer 08:52, 27 March 2010 (EET)