Patarakin: /* Часть 3. Создайте страницу демонстрации */

2026-04-13T13:58:28Z

Часть 3. Создайте страницу демонстрации

← Предыдущая версия		Версия от 16:58, 13 апреля 2026
Строка 176:		Строка 176:

	После создания вашего remix-модуля создайте отдельную страницу демонстрации, в категории [[:Категория:Работы МФ-221]] например:		После создания вашего remix-модуля создайте отдельную страницу демонстрации, в категории [[:Категория:Работы МФ-221]] например:
			; Придумать название!!!

	На этой странице нужно показать:		На этой странице нужно показать:

Patarakin: /* Часть 3. Создайте страницу демонстрации */

2026-04-13T13:55:08Z

Часть 3. Создайте страницу демонстрации

← Предыдущая версия		Версия от 16:55, 13 апреля 2026
Строка 175:		Строка 175:
	== Часть 3. Создайте страницу демонстрации ==		== Часть 3. Создайте страницу демонстрации ==

	После создания вашего remix-модуля создайте отдельную страницу демонстрации, ~~например:~~		После создания вашего remix-модуля создайте отдельную страницу демонстрации, в категории [[:Категория:Работы МФ-221]] например:
	* [[~~Программирование/Иванов/AggregatorDemo~~]]
	* [[Программирование/Петрова/AggregatorDemo]]

	На этой странице нужно показать:		На этой странице нужно показать:

	# название вашего модуля;		# название вашего модуля;
	# список новых режимов;		# список новых режимов;

Patarakin: /* PlantUML-схема задания */

2026-04-13T13:51:36Z

PlantUML-схема задания

← Предыдущая версия		Версия от 16:51, 13 апреля 2026
Строка 292:		Строка 292:
	== PlantUML-схема задания ==		== PlantUML-схема задания ==

	<~~syntaxhighlight lang="plantuml"~~>		<uml>
	@startuml		@startuml
	title Задание Aggregator		title Задание Aggregator
Строка 307:		Строка 307:
	Remix --> Demo : показать примеры		Remix --> Demo : показать примеры
	@enduml		@enduml
	</~~syntaxhighlight~~>		</uml>

	== Что сдавать ==		== Что сдавать ==

Patarakin: /* = Пример 2. Подсчёт длины страницы */

2026-04-13T08:18:07Z

= Пример 2. Подсчёт длины страницы

← Предыдущая версия		Версия от 11:18, 13 апреля 2026
Строка 49:		Строка 49:
	{{#invoke:Aggregator\|main\|mode=args\|a=Lua\|b=SMW\|c=NetLogo}}		{{#invoke:Aggregator\|main\|mode=args\|a=Lua\|b=SMW\|c=NetLogo}}

	=== Пример 2. Подсчёт длины страницы ==		=== Пример 2. Подсчёт длины страницы ===

	Вызов:		Вызов:

Patarakin: Новая страница: «* Программирование (syllabus) 2026 = Программирование/Задание:Aggregator = ; Это учебное задание посвящено работе с Lua-модулем Module:Aggregator в среде MediaWiki + Scribunto. == Идея задания == Используем готовый модуль Module:Aggregator как '''базовый объект для remix'''. Сначала мы вы...»

2026-04-13T08:17:47Z

Новая страница: «* Программирование (syllabus) 2026 = Программирование/Задание:Aggregator = ; Это учебное задание посвящено работе с Lua-модулем Module:Aggregator в среде MediaWiki + Scribunto. == Идея задания == Используем готовый модуль Module:Aggregator как '''базовый объект для remix'''. Сначала мы вы...»

Новая страница

* [[Программирование (syllabus) 2026]]

= Программирование/Задание:Aggregator =

; Это учебное задание посвящено работе с Lua-модулем [[Module:Aggregator]] в среде [[MediaWiki]] + [[Scribunto]].

== Идея задания ==
Используем готовый модуль [[Module:Aggregator]] как '''базовый объект для remix'''.
Сначала мы вызываем готовые функции модуля на wiki-странице.
Затем каждый студент создаёт '''свой собственный remix-модуль''', добавляя новые режимы анализа.

Идея задания состоит в том, что '''страница wiki становится данными''', а Lua-модуль становится инструментом их анализа и представления. На сайте уже существует модуль: [[Module:Aggregator]]. Этот [[модуль]] умеет работать в нескольких режимах:

{| class="wikitable"
! Режим
! Что делает
|-
| <code>args</code>
| считает количество переданных аргументов
|-
| <code>chars</code>
| считает длину исходного вики-текста страницы
|-
| <code>words</code>
| считает количество слов в исходном вики-тексте страницы
|-
| <code>links</code>
| считает количество wiki-ссылок вида <code><nowiki>[[...]]</nowiki></code>
|-
| <code>headings</code>
| считает количество заголовков вида <code>== ... ==</code>
|}

== Часть 1. Попробуйте готовый модуль ==

Сначала попробуйте использовать уже готовый модуль [[Module:Aggregator]].

=== Пример 1. Подсчёт аргументов ===

Вызов:

<syntaxhighlight lang="wikitext">
{{#invoke:Aggregator|main|mode=args|a=Lua|b=SMW|c=NetLogo}}
</syntaxhighlight>

Результат:

{{#invoke:Aggregator|main|mode=args|a=Lua|b=SMW|c=NetLogo}}

=== Пример 2. Подсчёт длины страницы ==

Вызов:

<syntaxhighlight lang="wikitext">
{{#invoke:Aggregator|main|mode=chars|title=Lua}}
</syntaxhighlight>

Результат:

{{#invoke:Aggregator|main|mode=chars|title=Lua}}

=== Пример 3. Подсчёт слов на странице ===

Вызов:

<syntaxhighlight lang="wikitext">
{{#invoke:Aggregator|main|mode=words|title=Lua}}
</syntaxhighlight>

Результат:

{{#invoke:Aggregator|main|mode=words|title=Lua}}

=== Пример 4. Подсчёт wiki-ссылок ===

Вызов:

<syntaxhighlight lang="wikitext">
{{#invoke:Aggregator|main|mode=links|title=Lua}}
</syntaxhighlight>

Результат:

{{#invoke:Aggregator|main|mode=links|title=Lua/Tutorial}}

=== Пример 5. Подсчёт заголовков ===

Вызов:

<syntaxhighlight lang="wikitext">
{{#invoke:Aggregator|main|mode=headings|title=Lua}}
</syntaxhighlight>

Результат:

{{#invoke:Aggregator|main|mode=headings|title=Lua}}

== Что важно понять ==

Модуль [[Module:Aggregator]] анализирует '''исходный wiki-текст''' страницы.
Это значит, что он работает с текстом разметки, шаблонами, ссылками и заголовками как с данными.

Поэтому один и тот же вопрос можно понимать по-разному:
{| class="wikitable"
! Вопрос
! Что фактически считает модуль
|-
| Сколько слов на странице?
| Сколько слов в исходном wiki-тексте
|-
| Сколько символов на странице?
| Длину строки исходного текста
|-
| Сколько ссылок на странице?
| Количество конструкций <code><nowiki>[[...]]</nowiki></code>
|-
| Сколько заголовков на странице?
| Количество строк или фрагментов вида <code>== ... ==</code>
|}

== Часть 2. Создайте свой remix ==
Задача — не просто использовать готовый модуль, а сделать '''собственный [[remix]]'''.

Создайте личный модуль, например:

* <code>Module:Student/Smirnov/Aggregator</code>
** предпочтителен вариант с подстраницами, потому что он лучше организует пространство имён.

== Что нужно сделать в remix ==

В вашем remix-модуле должно быть:

# не меньше '''2 новых режимов''' по сравнению с исходным [[Module:Aggregator]];
# страница документации <code>/doc</code>;
# страница демонстрации, на которой показаны примеры вызова вашего модуля;
# короткое объяснение, что именно делает ваш remix.

== Возможные направления remix ==

{| class="wikitable"
! Новый режим
! Идея
! Что анализировать
|-
| <code>templates</code>
| считать шаблоны
| количество конструкций <code><nowiki>{{...}}</nowiki></code>
|-
| <code>categories</code>
| считать категории
| количество вхождений <code><nowiki>[[Категория:...]]</nowiki></code>
|-
| <code>externallinks</code>
| считать внешние ссылки
| ссылки вида <code>http://</code> и <code>https://</code>
|-
| <code>files</code>
| считать файлы
| вхождения <code><nowiki>[[Файл:...]]</nowiki></code>
|-
| <code>sentences</code>
| считать предложения
| количество предложений в тексте
|-
| <code>paragraphs</code>
| считать абзацы
| количество текстовых блоков
|-
| <code>tables</code>
| считать таблицы
| количество wiki-таблиц
|}

== Часть 3. Создайте страницу демонстрации ==

После создания вашего remix-модуля создайте отдельную страницу демонстрации, например:
* [[Программирование/Иванов/AggregatorDemo]]
* [[Программирование/Петрова/AggregatorDemo]]

На этой странице нужно показать:

# название вашего модуля;
# список новых режимов;
# не меньше '''3 примеров вызова''';
# краткое объяснение результатов.

== Рекомендуемая структура demo-страницы ==

<syntaxhighlight lang="wikitext">
= AggregatorDemo =

== Мой модуль ==
[[Module:Student/Иванов/Aggregator]]

== Новые режимы ==
* templates
* categories

== Примеры ==
{{#invoke:Student/Иванов/Aggregator|main|mode=templates|title=Lua/Tutorial}}

{{#invoke:Student/Иванов/Aggregator|main|mode=categories|title=Lua/Tutorial}}

== Комментарий ==
Мой remix считает шаблоны и категории в исходном wiki-тексте страницы.
</syntaxhighlight>

== Часть 4. Документация ==

У вашего модуля должна быть страница документации:

* <code>Module:Student/Иванов/Aggregator/doc</code>

На странице <code>/doc</code> должно быть:

{| class="wikitable"
! Что должно быть
! Обязательно?
|-
| краткое описание модуля
| да
|-
| список режимов
| да
|-
| примеры вызова
| да
|-
| описание новых режимов
| да
|-
| указание автора remix
| да
|}

== Минимальные требования ==

{| class="wikitable"
! Требование
! Минимум
|-
| Личный remix-модуль
| 1
|-
| Новые режимы
| 2
|-
| Примеры вызова на demo-странице
| 3
|-
| Страница /doc
| 1
|-
| Рабочий вызов без ошибок
| обязательно
|}

== Критерии оценки ==

{| class="wikitable"
! Критерий
! Что оценивается
|-
| Работоспособность
| модуль запускается без Lua error
|-
| Понятность кода
| читаемые имена функций и режимов
|-
| Качество remix
| есть собственные новые режимы, а не только переименование
|-
| Документация
| есть /doc и примеры вызова
|-
| Демонстрация
| есть отдельная страница с результатами
|-
| Интерпретация
| студент понимает, что именно считает модуль
|}

== Вопросы для размышления ==

После выполнения задания ответьте письменно на 3 вопроса:

# Чем отличается '''исходный wiki-текст''' страницы от её визуального отображения?
# Что именно считает ваш модуль?
# Что в вашем remix является '''новой функцией''', а что — только изменением оформления?

== PlantUML-схема задания ==

<syntaxhighlight lang="plantuml">
@startuml
title Задание Aggregator

rectangle "Module:Aggregator" as Base
rectangle "Module:Student/StudentName/Aggregator" as Remix
rectangle "Module:Student/StudentName/Aggregator/doc" as Doc
rectangle "Программирование/StudentName/AggregatorDemo" as Demo
rectangle "Программирование/Задание:Aggregator" as Task

Task --> Base : изучить и вызвать
Base --> Remix : remix
Remix --> Doc : документировать
Remix --> Demo : показать примеры
@enduml
</syntaxhighlight>

== Что сдавать ==

Итогом задания являются 3 объекта:

# ваш личный remix-модуль;
# страница документации <code>/doc</code>;
# страница демонстрации с примерами вызова.

== Формула задания ==

'''Use → Understand → Remix → Document → Demonstrate'''

== Дополнительная идея ==
Если базовый remix выполнен успешно, можно сделать второй уровень и
превратить агрегатор из простого счётчика в модуль, который не только считает, но и строит таблицу с результатами анализа нескольких страниц.

Например:
* сравнить 3 страницы по числу слов;
* сравнить 3 страницы по числу ссылок;
* сравнить 3 страницы по числу заголовков.

Программирование (syllabus) 2026/Task/Aggregator - История изменений

Patarakin: /* Часть 3. Создайте страницу демонстрации */

Patarakin: /* Часть 3. Создайте страницу демонстрации */

Patarakin: /* PlantUML-схема задания */

Patarakin: /* = Пример 2. Подсчёт длины страницы */