# Страницы и узлы ## Деление и названия ### Форма следует за весом, а вес меняется Узел — для того, что несёт утверждение и довод в его пользу, пункт списка — для того, что несёт одну строку, ячейка — для того, что несёт слово. Таблица нужна, чтобы сравнивать данные по строкам, поэтому набору сущностей место в узлах, а не в её строках. Вес меняется, когда тема растёт и сжимается, поэтому эти границы переходят в обе стороны: пункт, разросшийся до абзацев, становится узлом, список, переросший название над собой, становится разделами, а несколько узлов, в каждом из которых по одному предложению, становятся одним списком. Утверждение, спрятанное внутри текста, не имеет адреса и никогда не попадает в оглавление. Оно прячется в вводных словах жирным, в пункте списка длиной в несколько абзацев, в строке таблицы-каталога или во втором утверждении того же блока; заголовок `##`, набранный в тексте, — то же самое. Прячется оно и в сплошном тексте, вовсе без разметки: страница с правильно названными разделами и без единого дочернего узла под ними содержит каждое своё утверждение внутри текста, и читатель, пробегающий её оглавление, не узнаёт ни одного из них. Обратная ошибка — заголовок над одним предложением, который тратит строку оглавления и экран пустого места на то, что сказал бы пункт списка. Обе ошибки видны снаружи. На хорошо устроенной странице у каждого утверждения текста есть своя строка в оглавлении. А текст, который при закрытом заголовке читается как сноска к нему, — это пункт списка. ### Заголовок несёт ровно то, что содержит текст На уровне h2 заголовок называет раздел — именным словосочетанием в несколько слов: верхний уровень читают как оглавление, и предложение там соперничает с заголовком самой страницы. Глубже заголовок формулирует утверждение, а текст его доказывает; именно это позволяет читателю взять утверждение из оглавления и открывать текст только ради довода. Узел, объединяющий дочерние, называет раздел на любой глубине. Форму утверждениям задают разделы. Без них страница — ряд утверждений на уровне h2, какой остаётся после письма за один проход, и чтобы хоть что-то найти, её приходится читать целиком. ### Что заслуживает страницы Тема — это страница, когда читатель пришёл бы на неё напрямую, и блок, когда вне своего родителя она ничего не значит. Та же проверка делит разросшуюся тему: после пары десятков строк оглавления или нескольких экранов текста страницу листают, а не читают, и её колонка содержания перестаёт быть картой, поэтому раздел, который можно открыть без подготовки, — это отдельная страница, а разделы, понятные только по порядку, остаются короткими. ### Страница на примере Одни заголовки — именно так читатель встречает страницу: ``` Визовые правила Кому нужна виза Гражданам ЕС не нужна Транзитная пересадка считается въездом Подача заявления Анкету подают только онлайн Сбор оплачивают в консульстве ``` Два заголовка h2 называют разделы. Четыре утверждения под ними — то, что содержит страница, поэтому читатель берёт утверждение из оглавления и открывает текст только ради довода. Под третьим заголовком текст доказывает его и не повторяет ничего из сказанного заголовком: > Иммиграционная служба считает пересадку в транзитной зоне въездом, поэтому пассажиру, который пересаживается на другой рейс, нужна та же виза, что и тому, кто выходит из аэропорта. Авиакомпания проверяет это при регистрации — там отсутствие визы обычно и обнаруживается. ## Навигация Навигация по страницам показывает меньше, чем содержит дерево: она открывается свёрнутой до верхнего уровня; на внутренней странице раскрыт только путь до корня; на телефоне она скрыта за кнопкой меню. Поэтому ссылка в тексте на страницу двумя уровнями ниже не копирует навигацию: для большинства читателей это единственный видимый путь туда. Ссылке всё равно место там, где текст называет тему, а до глубоко вложенной страницы всё равно добираются через её предков; но само дерево не выведет такую страницу к читателю, который их не открывал. ### Страница с дочерними предлагает их, а не перечисляет Главная страница и каждая страница с дочерними страницами начинаются с того, что стоит прочитать ниже, и ссылаются на несколько страниц, ради которых приходят читатели, даже глубоких: это избранные ссылки, а не копия дерева, которое у читателя и так рядом с текстом. Полный список дочерних уместен, только когда читателю нужно выбрать из всех, как со способами установки. У такой страницы есть собственные разделы, а не один вводный абзац: без них у неё нет колонки содержания и она выглядит незаконченной. ## Что уже хранит движок ### Пересказ того, что хранит движок, устаревает У каждого узла есть своя история, свой `updated_at`, место в колонке содержания и список узлов, которые на него ссылаются. Текст, повторяющий что-либо из этого, устаревает, как только кто-то правит страницу или её структуру, не обновив это предложение, и тогда он сообщает неверное. Поэтому в добротном тексте этого нет: ни блока, описывающего собственное устаревание, — история хранит то, что он заменил; ни отметки «проверено в апреле» — она устаревает сама и ничего надёжного не говорит о том, актуально ли содержание; ни перечня разделов ниже — их перечисляет колонка содержания; ни строки «назад к X» внизу — обратные ссылки уже есть на странице. Решает то, откуда предложение берёт свою истинность. Из дерева этой страницы — и оно уходит, потому что читатель видит это дерево, а оно меняется, не спрашивая предложение. Из предмета — и оно остаётся, даже если его число сегодня совпадает с деревом: год основания — это содержание, дата проверки — метаданные, а три закона робототехники остаются тремя, что бы ни делала эта вики. ### Как ссылка доходит до узла Короткая ссылка, `page:N` или `block:N`, указывает на узел, а не на слова его заголовка. Ссылка на блок называет утверждение, ссылка на страницу — тему. Она не пересекает границу вики: другую вики открывают по её адресу, и такая ссылка ведёт себя как внешняя, потому что ссылка, пересекающая границу, вела бы в вики, которые читатель не может открыть. --- ## Links here - [Навыки Wikilayer](page:68329) --- [All pages](https://wikilayer.org/smee-again/wikilayer-howto/ru/index.md)