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