English

СОДЕРЖАНИЕ СОЗДАНИЕ НОВОГО ДОКУМЕНТА СТРУКТУРА БИБЛИОТЕКИ НАЗВАНИЯ ДОКУМЕНТОВ ШАГИ СОЗДАНИЯ ДОКУМЕНТА ДЕТАЛЬНАЯ СТРУКТУРА НАЗВАНИЯ СТРАНИЦЫ

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

И СТРУКТУРА РАЗМЕЩЕНИЯ ДОКУМЕНТОВ В ПАПКАХ

Если вы захотите создать в библиотеке новый саенто документ (страницу), первым делом вам надо будет сделать две вещи:

  1. Дать ему название и
  2. Разместить его в определенном разделе библиотеки (пространстве имен).

СТРУКТУРА БИБЛИОТЕКИ

Структура разделов библиотеки на данный момент имеет следующий вид:

  1. ru: (раздел для русских документов, в его корне лежат общие для русского раздела страницы - со списками русских документов: по годам, по сериям, по сборникам лекций и пр.)
    1. hcob: - раздел для технических выпусков: БОХСов и пр.
    2. not-hcob: - подраздел для технических изданий, которые не являются БОХСами, например, для Технических Писем Правления и пр.
    3. hcopl: - раздел для административных выпусков: ИП ОХС и пр.
    4. lectures: - раздел для лекций
    5. books: - раздел для книг ЛРХ
    6. books-fiction: - раздел для художественных книг ЛРХ
  2. en: - раздел для документов на английском языке, которых пока нет.

Т.е. полный путь до раздела русских БОХСов будет таким - ru:hcob:

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

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

Таким образом, при создании нового документа надо дать ему 2 названия:

Вот пример английского имени страницы с разделами, в которых она находится:

ru/hcob/b710916iipa72__vedenie_protokolov__seriya_admin_oditora-11

Оно очень похоже на основной заголовок документа на русском, который мы рассматривали на странице lib-syntax, кроме даты, которая здесь идет в формате ГГММДД, пригодном для сортировки, а в русском заголовке лучше ее указывать в более удобочитаемом виде - ДДММГГ.

ШАГИ СОЗДАНИЯ ДОКУМЕНТА

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

1. Наберите в строке поиска на английском языке название документа, который вы хотите создать - в полном виде с путем папок, где вы его хотите создать (как в примере выше), если вы наберете название без папок, то страница создастся в корне библиотеки.

2. Нажмите "Найти". Вы сможете создать страницу только после того, как система убедится, что документа с таким названием еще не существует.

3. После того, как такой документ не будет найден, нажмите "Создать страницу" в меню справа. Создастся страница точно с тем названием и в той папке, которые вы ввели в строку поиска ранее. Название страницы с полным путем папок можно всегда увидеть в правом верхнем углу страницы.

4. Наберите вверху тела страницы первый заголовок, который будет отображаться как название этого документа. Например:

====Л171152 Процессинг создания (Конгресс "Власть теты 52", 7)====

5. Вставьте дальше текст документа в форматировании, как описано на странице lib-syntax.

ДЕТАЛЬНАЯ СТРУКТУРА НАЗВАНИЯ СТРАНИЦЫ

Разберем английское название страницы поподробнее.

Вот пара примеров таких полных названий с указанием пути разделов, в которых они находятся:

ru/hcob/b710916iipa72__vedenie_protokolov__seriya_admin_oditora-11_2
ru/lecture/l521117-protsesing-sozdania-vlast-teti-7

1. Названия файлов в ДокуВики могут содержать только маленькие буквы английского алфавита и цифры, пробелы не разрешены (можно заменять их знаком подчеркивания или дефисом, более двух дефисов к сожалению запрещены, два и более подчеркиваний - можно). Использование заглавных букв не рекомендуется, т.к. конфликтует с плагином индексации и приводит к появлению дубликатов документов в поиске.

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

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

2. В начале названия идут разделенные двоеточием разделы и подразделы, в которых находится документ, например, ru/hcob: - это папка для русских БОХСов.

3. Само название предваряется буквой, обозначающей тип документа (B - БОХС, I - ИП, L - лекция, K - книга, и пр.), датой в формате ГГММДД, номером выпуска (ii - выпуск II), номером пересмотра (pa) и годом пересмотра (72).

А также может включать в конце названия - Серию (seriya_admin_oditora), номер в серии (-11), и порядковый номер перевода (_2).

Кроме типа документа и даты, которые используются в системе для вывода и сортировки документов, все остальные атрибуты названия, в принципе, не существенны в названии файла - они более важны в русском заголовке.