Редактирование: Модуль:Отексте/doc

Реализует функциональность шаблона {{Tl|Отексте}} средствами Lua. Парсит в словниках шаблоны семейства {{Tl|Статья в словнике}}. Может подгружать на страницу секции из ПИ «Страница».

== Используемые модули данных ==
* [[Модуль:Отексте/строки]]
* [[Модуль:Отексте/transl-lang]] — реализация шаблона {{T|Transl-lang}}
* [[Модуль:Источники по теме]] — генерация ссылок на словари и братские проекты
** [[MediaWiki:Encyclopedias settings.json]] — настройки энциклопедий, [[MediaWiki:Wikiprojects settings.json]] — настройки проектов
* Модули шаблонов словников ([https://ru.wikisource.org/wiki/Служебная:Указатель_по_началу_названия?prefix=Отексте/&namespace=828 полный список]):
** Используются: [[Модуль:Отексте/БСЭ1|БСЭ1]], [[Модуль:Отексте/БЭАН|БЭАН]], [[Модуль:Отексте/БЭЮ|БЭЮ]], [[Модуль:Отексте/ВЭ|ВЭ]], [[Модуль:Отексте/ГСС|ГСС]], [[Модуль:Отексте/ЕЭБЕ|ЕЭБЕ]], [[Модуль:Отексте/МСР|МСР]], [[Модуль:Отексте/МСЭ|МСЭ]], [[Модуль:Отексте/МЭСБЕ|МЭСБЕ]], [[Модуль:Отексте/НСТ|НСТ]], [[Модуль:Отексте/НЭС|НЭС]], [[Модуль:Отексте/ПБЭ|ПБЭ]], [[Модуль:Отексте/РБС|РБС]], [[Модуль:Отексте/РСКД|РСКД]], [[Модуль:Отексте/РЭСБ|РЭСБ]], [[Модуль:Отексте/САР1|САР1]], [[Модуль:Отексте/САР2|САР2]], [[Модуль:Отексте/ТСД1|ТСД1]], [[Модуль:Отексте/ТСД2|ТСД2]], [[Модуль:Отексте/ТСД3|ТСД3]], [[Модуль:Отексте/ТЭ1|ТЭ1]], [[Модуль:Отексте/ЭЛ|ЭЛ]], [[Модуль:Отексте/ЭСБЕ|ЭСБЕ]], [[Модуль:Отексте/ЭСГ|ЭСГ]]
** Не используются: [[Модуль:Отексте/ТСД|ТСД]] (пример сложной навигации по трем корпусам статей)
** … шаблоны [[Служебная:PrefixIndex/Модуль:Отексте/|других словарей]] — в процессе
* Модули расширений:
** [[Модуль:Отексте/Документ]], [[Модуль:Отексте/ТолстойПСС|ТолстойПСС]], [[Модуль:Отексте/СочиненияПлатона|СочиненияПлатона]], [[Модуль:Отексте/Синодальный перевод]]

== [[Шаблон:Статья в словнике]] ==
; Параметры шаблона
* 1-й и 2-й — названия страниц в двух орфографиях,
* 3-й параметр (а также 5-й и 7-й, если есть) — номера страниц/столбцов в печатном издании (''hard''), 4-й (также 6-й и 8-й) — номера страниц в скане (''soft''). Несколько пар этих параметров используются для сборки статьи из нескольких источников (см., например [[ЭСБЕ/Россия]] — единственный пока пример, где используются 7-й и 8-й параметры). Оба параметра (hard и soft) — составные, т. е. могут состоять из нескольких значений через слэш «/»: для hard — <code>страницы/пагинация/том</code> (пагинация — для случаев, когда том имеет несколько пагинаций, пока не используется); для soft — значения <code>from/to/exclude</code> для передачи в <code><nowiki><pages></nowiki></code>. <br>Если параметр soft пустой или отсутствует, но в подмодуле имеется параметр <code>offsets</code> для данного тома — номера soft вычисляются на основе соответствующих номеров hard.

== Переменные модуля ==

=== Пагинация ===
Номера страниц вычисляются по формуле: <code>((hard + correction) / factor) + offset (с округлением вверх)</code>.

; Параметры
* <code>hard</code> — номера страниц/столбцов в печатном издании
* <code>offset</code> — смещение номеров страниц/столбцов книги относительно индексных страниц скана
* <code>soft</code> — номера страниц в скане, = hard + correction
* <code>factor</code> — для страниц скана, на которые приходится больше одного номера пагинации (колонки, сканы в разворот и т. п.). Например, при 2 номерах на страницу во всех томах: <code>p.factor</code> = 2
* <code>correction</code> — корректирующий сдвиг для factor. Если номера идут не в порядке 1-2,3-4,5-6… (здесь достаточно factor), а 1,2-3,4-5… — тогда используется <code>correction = 1</code>

Пример: для номеров 625 и 626 при correction=1, factor=2 и offset=17 получаем страницы 330 и 331; а при correction=0 (это значение по умолчанию) оба раза будет 330.

== Модули-расширения ==
Модуль должен называться как подмодуль этого модуля, например [[Модуль:Отексте/Документ]]. И возвращать 3 значения (<code>return params, categories, beforetext</code>). Где первое — таблица параметров в формате <code>data.p</code> главного модуля, второе — таблица с категориями, третье — текст перед шаблоном-шапкой.

Для подключения в шаблоне (в данном примере в Шаблон:Документ) название модуля задаётся в переменной <code>ext</code>:
<syntaxhighlight lang="">{{#invoke:Отексте|textinfo|ext=Документ}}</syntaxhighlight>
;Алгоритм
Запускается Модуль:Отексте. По полученному из шаблона названию вызывается модуль расширения (<code>extpath</code>), которому передается таблица с параметрами шаблона. Он их обрабатывает (в том числе все нестандартные параметры), и возвращает таблицу со стандартным набором данных для сборки Отексте. Далее главный модуль выполняется как обычно, только с другим набором данных.

== Отслеживание ошибок ==
* [[:Категория:Страница в оглавлении не найдена]] (оглавление — это словник)
* [[:Категория:Оглавление не найдено]]

<noinclude>[[Категория:Модули:Документация]]</noinclude>
<includeonly>[[Категория:РуСказки:Модули]]</includeonly>