English version

СОДЕРЖАНИЕ ОФОРМЛЕНИЕ ДОКУМЕНТОВ САЕНТО БИБЛИОТЕКИ ПРИМЕР САЕНТО ДОКУМЕНТА ПРИМЕР РАЗМЕТКИ ЧАСТИ САЕНТО ДОКУМЕНТА НАЗВАНИЕ ДОКУМЕНТА СИНТАКСИС РАЗМЕТКИ СПЕЦИАЛЬНЫЕ САЕНТО ТЕГИ СТАНДАРТНЫЕ ВИКИ ТЕГИ ЗАГОЛОВКИ ОФОРМЛЕНИЯ В ТЕКСТЕ СПИСКИ ТАБЛИЦЫ ССЫЛКИ ОБЪЕДИНЕНИЕ ДОКУМЕНТОВ В ГРУППЫ: СЕРИИ БЮЛЛЕТЕНЕЙ, СБОРНИКИ ЛЕКЦИЙ И ПР.

ОФОРМЛЕНИЕ ДОКУМЕНТОВ САЕНТО БИБЛИОТЕКИ

Оформление документов (бюллетений, ИП, лекций и пр.) осуществляется простым синтаксисом, используемым на Википедии, плюс я сделал несколько специальных тегов для оформления шапки документа, раздела "кому", подписи ЛРХ и других специфичных для саенто документа элементов.

Конвертировать любой документ MS Word в MediaWiki разметку можно либо в Libre Office (бесплатный офисный пакет, возможность конвертации есть по умолчанию), либо установив дополнение для MS Office - MS Word Add-in For MediaWiki (после чего в секции экспорта Word появится возможность экспортировать в разметку MediaWiki - вроде бы уже не работает в последних версиях Word).

ПРИМЕР САЕНТО ДОКУМЕНТА

Давайте рассмотрим оформление на примере какого-нибудь короткого выдуманного бюллетеня:

(Разноцветные комментарии описывают элементы документа.)



ПРИМЕР РАЗМЕТКИ

Чтобы получить такой внешний вид, мы должны применить следующую разметку:



Мы видим, что документ имеет определенную структуру и для выделения разных его элементов используется простая и легко читабельная разметка.

ЧАСТИ САЕНТО ДОКУМЕНТА

В структуре стандартного саенто документа выделяются:

  1. Унифицированное название документа, содержащее основные сведения о нем. Оно используется для легкого поиска нужного документа в системе. Названием документа выступает самый первый (самый верхний) из всех содержащихся в документе заголовков.
  2. Шапка документа, включающая все реквизиты и выходные данные документа: место издания, тип издания, дату, есть ли пересмотры, исправления, какой это выпуск, а также различные пояснения, относящиеся ко всему документу, и пр.
  3. Распространение документа, для кого он предназначен.
  4. Название серии или сборника, в который входит документ, с его порядковым номером в этом сборнике, если возможно. Принадлежность к серии или сборнику в системе оформляется в виде ссылки на страницу этой серии или сборника. Это позволяет формировать список сборника автоматом по этим ссылкам.
  5. Основной текст документа - с главным заголовком документа и подзаголовками, текстом, таблицами, рисунками, сносками и пр.
  6. Подпись документа. Может включать помимо подписи ЛРХ, какие-то еще данные - например, "Скомпилировано при поддержке такого-то" и пр.

Рассмотрим структуру названия документа.


НАЗВАНИЕ ДОКУМЕНТА

Первый (самый верхний) заголовок документа воспринимается системой как его название, он будет показываться во всех ссылках на этот документ как название документа.

Оно имеет следующий вид:



''Помимо БОХС, ИП и лекций есть ряд других типов и изданий в саенто. Они обозначаются здесь так:''

Давайте обобщим основную разметку, используемую для выделения частей документа:

СИНТАКСИС РАЗМЕТКИ

СПЕЦИАЛЬНЫЕ САЕНТО ТЕГИ

Я позволил себе ввести в стандартную разметку эти несколько специальных тегов, чтобы выделить часто встречающиеся именно в саенто документах элементы, такие как: привычная нам центрированная шапка документа, выровненное по левому краю распространение документа, сдвинутую вправо подпись ЛРХ и еще некоторые.

БЮЛЛЕТЕНЬ ОХС
Неяркий центрированный текст.
Не выделяется как заголовок в структуре документа.
Используется для оформления в шапке документа.
(Также издан как ИП.)
Наклонный центрированный текст обычного размера.
Не выделяется как заголовок.
Используется для выделения разного рода подзаголовков и пр.
Серия Менеджмента, 12
Наклонный жирный центрированный текст обычного размера. Не выделяется как заголовок.
Используется для выделения серий и жирных подзаголовков.
Размножить
Маленький неяркий текст, выровненный по левому краю - распространение, "кому" документа.
(Обрамляется специфическими апострофами, находящимися на букве Ё в английской раскладке.)
Л.Рон Хаббард
Неяркий текст, имеющий отступ - сдвинутый вправо - подпись.

СТАНДАРТНЫЕ ВИКИ ТЕГИ

ЗАГОЛОВКИ
=====Заголовок 1 уровня=====
Самый крупный жирный центрированный прямой заголовок.
Используется для отображения главного названия БОХСа, ИП и пр.
====Заголовок 2 уровня====
Прямой нежирный центрированный заголовок крупного, но чуть меньшего размера.
Используется для заголовков 2 уровня.
===Заголовок 3 уровня===
Наклонный нежирный центрированный заголовок, еще меньше.
Может использоваться для заголовков 2,3 и т.д. уровней, если того требует оформление.
==Заголовок 4 уровня==
Прямой нежирный заголовок, выровненный по левому краю, с размером текста чуть больше обычного.
Может использоваться для заголовков самого нижнего уровня, которые не должны быть центрированными.
ОФОРМЛЕНИЯ В ТЕКСТЕ
Наклонный
Наклонный шрифт внутри абзаца:
Наклонный
Жирный
Жирный шрифт внутри абзаца:
Жирный
Жирный наклонный
Жирный наклонный шрифт внутри абзаца:
Жирный наклонный
Два перевода строки (Enter, Enter)
Новый абзац.
При одном переводе строки текст все равно отображается на одной строке.
\\

\\ \\ \\
Принудительный перенос строки - 2 слэша со следующим за ними пробелом.
Добавляя несколько раз принудительный перенос строки, можно увеличивать отступ между абзацами, а также переносить строчки в саенто тегах.


На столько раздвинут абзацы 3 переноса строки, как указано слева.
В банке есть локи. *Лок: это бла-бла-бла...
Сноска.

В банке есть локи. *Лок: это бла-бла-бла...

Оформляется заключением данных сноски в двойные круглые скобки.
В том месте, где в текст включена оформленная таким образом сноска, ставится номер сноски, сама информация сноски отображаются в конце документа.
Как в Word, короче.
----
4 тире. Горизонтальная черта.


СПИСКИ
Нумерованный список:
  1. Пункт 1
  2. Пункт 2
  3. Пункт 3
Нумерованный список:
  1. Пункт 1
  2. Пункт 2
  3. Пункт 3
Каждый пункт предваряется решеткой с новой строки, без лишних новых строк между пунктами.
Ненумерованный список:
  • Пункт
  • Пункт
    • Подпункт
    • Подпункт
  • Пункт
Ненумерованный список: (Может быть двухуровневым.)
  • Пункт
  • Пункт
    • Подпункт
    • Подпункт
  • Пункт
Список с подпунктами:
  1. Пункт 1
    1. Подпункт а.
    2. Подпункт b.
  2. Пункт 2
    • Подпункт
    • Подпункт
Двухуровневый список с нумерованными и ненумерованными подпунктами: Список с подпунктами:
  1. Пункт 1
    1. Подпункт а.
    2. Подпункт b.
  2. Пункт 2
    • Подпункт
    • Подпункт
ТАБЛИЦЫ
ТекстТекстТекст
ТекстТекстТекст
____________________
Таблица из 2-х строк и 3-х столбцов.
Простое оформление таблиц.
{
Текст
Текст
Текст
-
Текст
Текст
Текст
Таблица из 2-х строк и 3-х столбцов.
Оформление для сложного содержимого.

Строки таблицы разделяются прямым слэшем с черточкой, а ячейка в строке начинается с новой строки с прямого слэша.
(Подробнее смотрите на сайте Википедия в разделе Синтаксис таблиц.)
ССЫЛКИ
Вставка изображения media/wiki/logo.png, принудительно уменьшенного по ширине до 40% от ширины элемента, в котором находится изображение:

Вместо 40% можно указать ширину в пикселях, например - 300px.
Можно опустить этот параметр, тогда изображение будет занимать 100% отведенного места.
Оформление документов саенто библиотеки
Вставка ссылки на страницу lib-syntax, находящуюся в разделе ru.

lib-syntax

В ссылке надо указывать реальное физическое имя файла страницы (не ее заголовок).
Это имя с полным путем - именно так, как надо указывать в ссылке - отображено в правом верхнем углу каждой страницы.
Отображаться же будет заголовок страницы - в данном случае он "Оформление документов библиотеки".
Это удобно тем, что при изменении заголовков страниц не надо переписывать все ссылки на них.
Оформление документов саенто библиотеки
Вставка ссылки на страницу с названием файла lib-syntax, на раздел с заголовком "Протоколы".

Оформление документов саенто библиотеки

Отображаться в ссылке будет название этого заголовка.

Также вы всегда можете открыть любую страницу на этом сайте в режиме просмотра кода или правки (если у вас есть на это права) и посмотреть, как она отформатирована.


ОБЪЕДИНЕНИЕ ДОКУМЕНТОВ В ГРУППЫ: СЕРИИ БЮЛЛЕТЕНЕЙ, СБОРНИКИ ЛЕКЦИЙ И ПР.

В нашем придуманном бюллетене на месте серии вы видите ссылку на страницу серии "Админ Одитора":

Серия Админ одитора

Это сделано специально. Группировка сделана таким образом, что на странице серии или сборника будут отображаться все документы, которые ссылаются на эту страницу.

Таким образом, чтобы ваш документ отображался на странице какой-то Серии или сборника лекций - входил в нее, просто поставьте в документе ссылку на страницу этой серии.

Оформление документов саенто библиотеки