Различия
Различия между двумя ревизиями данной страницы
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
ru:wiki:syntax [2019/03/09 01:07] Rainbow Spike Удаление лишних пробелов |
ru:wiki:syntax [2020/03/31 18:41] (текущий) Rainbow Spike |
||
---|---|---|---|
Строка 3: | Строка 3: | ||
===== Общие сведения ===== | ===== Общие сведения ===== | ||
- | ==== Файловая система ==== | + | {{page>1namespaces&noheader}} |
- | + | ||
- | В DokuWiki тексты статей хранятся в обычной файловой системе, соответственно, их можно группировать в папки и подпапки. Это позволяет спокойно создавать одноимённые страницы и папки на каких угодно уровнях. Например ''/a/bb/**ccc**'' и ''/a/**ccc**'' (одноимённые страницы разных уровней отмечены звёздочками): | + | |
- | <file> | + | |
- | корень | + | |
- | ├── папка «a» | + | |
- | ... ├── папка «bb» | + | |
- | │ ├── *страница «ccc» | + | |
- | │ | + | |
- | ├── *страница «ccc» | + | |
- | </file> | + | |
- | Второй пример, ''/a/**bb**/ccc'' и ''/a/**bb**'' (одноимённые папка и страница одного уровня отмечены звёздочками): | + | |
- | <file> | + | |
- | корень | + | |
- | ├── папка «a» | + | |
- | ... ├── *папка «bb» | + | |
- | │ ├── страница «ccc» | + | |
- | │ | + | |
- | ├── *страница «bb» | + | |
- | </file> | + | |
- | [[/start?do=index|Посмотреть всю структуру сайта]]. Единственное отличие - помимо __разделителя папок__ слэш «''/''» можно использовать двоеточие «'':''», и даже вперемешку; они равнозначны по смыслу. | + | |
- | + | ||
- | ==== Адресация ==== | + | |
- | + | ||
- | Начальный слеш в адресе означает, что он полный, указывает путь от самой корневой папки сайта. Это полезно, когда нужно сослаться на страницу в другом разделе или возникает "проблема одноимённости". Полный адрес текущей страницы всегда отображается в нижнем левом углу сайта (через родное "двоеточие" и без «корня»). | + | |
- | + | ||
- | **Эта страница имеет полный путь «от корня» ''/wiki/1namespaces'', главная справки - ''/wiki/index'', главная страница сайта - ''/start''** | + | |
- | + | ||
- | В случае соседнего расположения ссылку можно укоротить до текущего уровня. | + | |
- | + | ||
- | **Эта страница адресуется ''1namespaces'', а главная страница справки - ''index''** | + | |
- | + | ||
- | Можно использовать //относительную// адресацию (родительская папка обозначается как ''../'', её родительская - как ''../../'' и т.д., текущая папка - ''./'') | + | |
- | + | ||
- | **Главная страница сайта //относительно этой страницы// адресуется ''../start'', а главная страница справки - ''./index''** | + | |
- | + | ||
- | ==== Ограничения имён ==== | + | |
- | + | ||
- | Имена страниц автоматически преобразуются в нижний регистр, кириллица переводится в длинные URL-коды, поэтому кириллические имена длиннее 15 знаков нежелательны, хотя в целом хорошо поддерживаются. Допустимыми для имени символами являются буквы, цифры, а ещё точка «''.''», дефис «''-''» и подчёркивание «''_''», в который будут преобразованы все остальные спецсимволы. Если последние три поставлены в начале или конце имени, они будут убраны, если их несколько подряд - сведены к одному. Слэш «''/''» и двоеточие «'':''» зарезервированы, как разделители папок. | + | |
===== Работа со страницами ===== | ===== Работа со страницами ===== | ||
- | Вы можете редактировать страницы этого сайта, а также создавать новые. На практически каждой странице есть кнопки "Править страницу", которые позволят вам это сделать | + | {{page>2pages&noheader}} |
- | + | ||
- | ==== Создание страниц и папок ==== | + | |
- | + | ||
- | Видео про создание страницы (на дизайн-шаблоне default, однако принцип тот же)\\ {{youtube>vpQzfFyWq4Y}}\\ | + | |
- | В любой вики всегда используется правило: **"сначала ссылка, затем страница"**\\ | + | |
- | Для создания новой страницы (например, странички catalog) при редактировании родительской страницы __впишите ссылку__ на catalog в нужное место ([[5links|читать про синтаксис ссылок]]), **сохраните изменения**. Если только что созданная ссылка зеленого цвета - значит, такой адрес в разделе <fc #009000>уже занят</fc> и ссылку надо изменить - показателем <fc #F03000>несуществующей</fc> страницы является красный цвет. Перейдите по красной ссылке и появится сообщение о несуществующей странице, а на кнопках вместо "Править страницу" будет надпись "Создать страницу". Нажмите, __внесите содержимое__ новой страницы **и сохраните ее**\\ | + | |
- | Аналогично, для создания новой папки, например, folder, впишите ссылку на её начальную страницу (обычно она называется index, соответственно, в ссылке пишем folder/index)\\ | + | |
- | Впрочем, можно прямо вписать в адресную строку браузера будущий адрес страницы и тогда тоже последует запрос на её создание, но без ссылок с других страниц она останется изолированной\\ | + | |
- | **Автошаблон**: специальная страница, содержащая переменные, подставляемые при создании новой страницы в папке, на которую действует автошаблон, таким образом (если картинки уже загружены или прописан внешний путь на них) заполнение новых стрипов чаще всего сводится к нажатию "Редактировать", "Сохранить", следующий номер в навигаторе\\ | + | |
- | **Добавленный функционал {saveandedit}**: галочка "Продолжить редактирование после сохранения" - редактор не закроется после сохранения страницы | + | |
- | + | ||
- | ==== Удаление и восстановление страниц ==== | + | |
- | + | ||
- | Вам надо открыть страницу для редактирования, удалить всё её содержимое и сохранить изменения. Если у вас есть права на удаление, то страница удалится сразу, если таких прав нет, то она останется пустой. Для привлечения внимания администратора поставьте смайл *DELETEME* кодом %%*DELETEME*%%. Пустые папки исчезают автоматически\\ | + | |
- | Для восстановления страницы зайдите на ее прежний адрес, нажмите в меню слева "Историю страницы", выберите из списка предыдущих версий нужную, откройте ее и нажмите кнопку "Править страницу", а затем "Сохранить" | + | |
- | + | ||
- | ==== Права групп пользователей ==== | + | |
- | + | ||
- | В Докувики используется ACL (Access Control List, списки доступа) - простая, но надёжная система управления доступом пользователей и их групп к страницам и папкам. Доступы: | + | |
- | * нет прав 0 | + | |
- | * чтение 1 | + | |
- | * правка 2 | + | |
- | * создание 4 | + | |
- | * аплоад файлов 8 | + | |
- | * удаление 16 | + | |
- | Ныне существующие группы: | + | |
- | * @ALL - все незарегистрированные посетители | + | |
- | * @user - все зарегистрированные посетители ((хотя при регистрации требуется e-mail, подтверждение выслано не будет, отключено для поощрения ленивых пользователей :) )) | + | |
- | * @user18 - зарегистрированные пользователи подтвердившие свой возраст, правильно введя [[https://comicslate.org/lib/plugins/asd/index.php|капчу]]. Количество попыток не ограничено :) | + | |
- | * @helper - модераторский статус, выданный наиболее активным переводчикам | + | |
- | * @admin - этим статусом обладает автор этих строк :) | + | |
- | В **открытом режиме** вики группа ALL имеет права 8 на всё, кроме некоторых технических страниц и комиксов, огороженных по просьбе автора. В случае атак на сайт есть три способа защиты: для @ALL вводится уровень 1 (**режим read-only**), пополняется антиспам-фильтр wordblock (поддерживаются маски, поэтому в принципе не сработают извращения с падежами и транслитерацией; в последнее время также введена защита от zаlgo-знаков), бан по IP. | + | |
- | + | ||
- | Текущие полномочия пользователя на правку страницы определяются наличием надписи "Редактировать страницу" на соответствующей кнопке. Если кнопка позволяет только просматривать исходный код - значит редактирование с данными правами недоступно. Как минимум, вы должны нажать кнопку "Вход" в левой части сайта и указать свои **логин и пароль** всякий раз, когда хотите начать что-то изменять на таких страницах. Возможны и более сложные конфигурации групп и доступов, например, для перевода отдельного комикса ограниченной группой | + | |
- | + | ||
- | Декларация о добросовестности. Администратор и назначенные им модераторы обязуются не использовать личную информацию пользователей им во вред. Переводы, предоставленные пользователями, регулируются лицензией CC BY-NC-SA. | + | |
===== Основы форматирования текста ===== | ===== Основы форматирования текста ===== | ||
- | DokuWiki поддерживает простой язык форматирования, который сохраняет данные насколько возможно читабельными. В чём-то он отличается от применяемого в Википедии и прочих вики, в чём-то совпадает, будьте внимательны. Далее вы узнаете об элементах форматирования, которые пригодятся при редактировании страниц; некоторые из них легко доступны в виде __пиктограмм__ в панели инструментов, появляющейся при редактировании страницы\\ Возможности синтаксиса показаны в форме действующих примеров и приведённого под ними их же оформления. Вы можете нажать кнопку [//Посмотреть исходный код//] внизу этой страницы (и на других страницах справки тоже), чтобы просмотреть ее форматирование, а для опытов предусмотрена специальная [[/ru:playground:index]] | + | {{page>3syntax&noheader}} |
- | + | ||
- | ==== Примитивы синтаксиса ==== | + | |
- | + | ||
- | DokuWiki поддерживает %%**%%**жирный**%%**%%, %%//%%//курсивный//%%//%%, %%__%% __подчеркнутый__ %%__%%((Пробелы сделаны специально чтобы показать подчерки, не делайте так в текстах)) и %%''%%''моноширинный''%%''%% текст | + | |
- | + | ||
- | Конечно, можно %%**__//''%% **__//''объединять''//__** %%''//__**%%((Пробелы сделаны специально чтобы показать подчерки, не делайте так в текстах)) элементы %%<del>%%<del>оформления</del>%%</del>%% синтаксиса | + | |
- | + | ||
- | Они доступны в виде __пиктограмм__ {{wiki:pg:bold.png?nolink}} {{wiki:pg:italic.png?nolink}} {{wiki:pg:underline.png?nolink}} {{wiki:pg:mono.png?nolink}} {{wiki:pg:strike.png?nolink}} на панели инструментов | + | |
- | + | ||
- | C помощью плагина [[doku>plugin:bbcode|bbcode]] поддерживается более знакомый синтаксис, хотя он (пока) недоступен через пиктограммы: %%[b]%%[b]жирный[/b]%%[/b]%%, %%[i]%%[i]курсивный[/i]%%[/i]%%, %%[u]%%[u]подчеркнутый[/u]%%[/u]%% и %%[m]%%[m]моноширинный[/m]%%[/m]%% текст | + | |
- | + | ||
- | Вот пример %%[b][u][i][m]%%[b][u][i][m]объединённого[/m][/i][/u][/b]%%[/m][/i][/u][/b]%% [[wp>BBCode]] %%[s]%%[s]оформления[/s]%%[/s]%% синтаксиса | + | |
- | + | ||
- | ==== Уровни ==== | + | |
- | + | ||
- | Вот текст в %%<sub>%%<sub>нижнем</sub>%%</sub>%% и %%<sup>%%<sup>верхнем</sup>%%</sup>%% индексе | + | |
- | + | ||
- | ==== Абзацы ==== | + | |
- | + | ||
- | Абзацы отбиваются через пустую строку((Двумя Enter'ами)) | + | |
- | + | ||
- | Другой абзац | + | |
- | + | ||
- | Абзацы отбиваются через пустую строку | + | |
- | + | ||
- | Другой абзац | + | |
- | + | ||
- | + | ||
- | ==== Переносы строк ==== | + | |
- | + | ||
- | Если нужно вставить разрыв строки без создания нового абзаца, достаточно поставить 2 **обратные** косые черты и пробел. Второй способ: 2 **обратные** косые черты и перенос строки Enter'ом. Администратор нередко обрабатывает тексты переводов массово и сводит второй способ к первому, поэтому первый способ несколько предпочтительнее. | + | |
- | + | ||
- | Вот текст, который заканчивается разрывом строки\\ Обратите внимание на то, | + | |
- | что две обратные косые черты должны быть в конце строки\\ | + | |
- | или отделяться от последующего текста\\ пробелом. Иначе \\ничего не получится. | + | |
- | + | ||
- | Вот текст, который заканчивается разрывом строки\\ Обратите внимание на то, | + | |
- | что две обратные косые черты должны быть в конце строки\\ | + | |
- | или отделяться от последующего текста\\ пробелом. Иначе \\ничего не получится. | + | |
- | + | ||
- | Разрыв строки в переводах следует использовать только в случае необходимости - если сам автор комикса структурировал фразу или если фраза в наклейке требует особого закрепления. | + | |
- | <note important>Не путайте вышеописанное с такими же парными **прямыми** косыми чертами для отображения %%//%%//курсивного//%%//%% текста. Курсив наклонён в ту же сторону, что и надписи на ваших клавишах, а перенос находится выше "энтера", рядом с "бэкспейсом" [←]</note> | + | |
===== Изображения и другие файлы ===== | ===== Изображения и другие файлы ===== | ||
- | (tab)С внешними файлами всё просто - указываем их путь в двойных фигурных скобках: | + | {{page>4files&noheader}} |
- | {{http://php.net/images/php.gif}} | + | |
- | {{http://php.net/images/php.gif}} | + | |
- | + | ||
- | (tab)Внутренние файлы предварительно требуется загрузить в вики. Ничто не вечно в интернете, вполне может сломаться любой внешний хостинг. Также функционал спецплагина, упомянутого ниже, с внешними файлами работает недостаточно правильно <note tip>Структура медиа-папок сайта, хранящихся отдельно от папок со статьями, может быть сходной с ними. Это сильно упрощает адресацию файлов в статьях</note> | + | |
- | + | ||
- | ==== Загрузка файлов ==== | + | |
- | + | ||
- | (tab)Для загрузки файла нужно: | + | |
- | * зайти на страницу, где он будет размещаться (это желательно, если вы ещё не разбираетесь в структуре медиа-папок сайта) | + | |
- | * нажать кнопку "Править страницу"; откроется редактор страницы | + | |
- | * в редакторе щёлкнуть пиктограмму {{.:pg:image.png?nolink}}; в отдельном окне откроется медиа-менеджер (ваш браузер должен разрешать всплывающие окна) | + | |
- | * нажать кнопку "Выбрать файлы" и выбрать файл на вашем компьютере | + | |
- | {{ media1.png }} | + | |
- | * в следующем поле, которое добавится после выбора файла, можно задать внутрисайтовое имя файла, к которому теперь будут обращаться на сайте | + | |
- | * если нужно создать медиа-подпапку - добавить её имя перед именем файла, отделив двоеточием | + | |
- | * если нужно иное начальное расположение файла - слева есть дерево медиа-папок; либо просто указать полный путь, с двоеточием в начале | + | |
- | {{ media2.png }} | + | |
- | * нажать кнопку "Загрузить" и тем закачать файл на сайт | + | |
- | + | ||
- | ==== Применение внутренних файлов ==== | + | |
- | + | ||
- | (tab)Если вы на память знаете расположение требуемого файла (или в редактор вставляется полуготовый шаблон статьи, как, например, в личных страницах в папке user) - используйте такой синтаксис: | + | |
- | {{wiki:dokuwiki-128.png}} | + | |
- | {{wiki:dokuwiki-128.png}} | + | |
- | + | ||
- | (tab)В случае, если медиа-папка файла совпадает с папкой статьи (в данном случае wiki), её упоминание можно просто опустить, вместе с разделяющим двоеточием: | + | |
- | {{dokuwiki-128.png}} | + | |
- | + | ||
- | (tab)И наоборот, для указания полного пути нужно начальное двоеточие; этот функционал полезен в случае коллизий с одинаковыми именами файлов в медиа-папке и медиа-подпапке: | + | |
- | {{:wiki:dokuwiki-128.png}} | + | |
- | + | ||
- | ==== Выбор файлов в менеджере ==== | + | |
- | + | ||
- | (tab)Тот же менеджер файлов из пиктограммы {{.:pg:image.png?nolink}}: | + | |
- | * при необходимости - перейти в нужную медиа-папку в дереве медиа-папок слева | + | |
- | * выбрать файл из списка щелчком по нему или его названию | + | |
- | * если это картинка (c расширениями ''gif'', ''jpg'', ''jpeg'' или ''png'') - появится окошко с настройками ссылки, после того нажать внизу окошка кнопку "Вставить" и менеджер закроется, а ссылка будет вставлена в редакторе по месту расположения курсора {{ media3.png }} | + | |
- | <note tip>Обычно подобный сервис совершенно не нужен - удаляйте лишние детали синтаксиса</note> | + | |
- | * если это не картинка - ссылка отправится сразу в редактор (пример презентации {{/wiki/sample_present.ppt}}) и будет снабжена файл-иконкой | + | |
- | <note warning>Некоторые расширения файлов вовсе не допускаются к загрузке (обратитесь к [[user>Robot Spike]] за разъяснениями)</note> | + | |
- | + | ||
- | (tab)Обратите внимание на правые пиктограммы в строках списка: первая позволяет посмотреть метатеги и сам файл в оригинальном виде, третья - удалить этот файл, если у вас достаточно прав в данной папке, вторая - "Управление медиафайлами" {{.:pg:mediamanager.png?nolink}} - включает расширенную, встроенную в страницу сайта версию медиа-менеджера. Её преимущества - возможность поиска, сортировки, просмотра истории версий файлов | + | |
- | {{ media4.png }} | + | |
- | + | ||
- | ==== Названия и подписи ==== | + | |
- | + | ||
- | (tab)При необходимости дописываем через знак %%|%% название, которое будет видно при наведении мыши на картинку: | + | |
- | {{/wiki/dokuwiki-128.png|Логотип}} | + | |
- | {{/wiki/dokuwiki-128.png|Логотип}} | + | |
- | + | ||
- | (tab)UPD. Специальным плагином добавлена возможность обозначить файл подписью, знакомой по Википедии. Для этого нужно взять весь синтаксис в квадратные одинарные скобки: | + | |
- | [{{/wiki/dokuwiki-128.png|Логотип}}] | + | |
- | [{{/wiki/dokuwiki-128.png|Логотип}}] | + | |
- | + | ||
- | ==== Масштабирование ==== | + | |
- | + | ||
- | (tab)Масштабирование по заданной ширине: | + | |
- | {{/wiki/dokuwiki-128.png?50}} | + | |
- | {{/wiki/dokuwiki-128.png?50|Логотип}} | + | |
- | [{{/wiki/dokuwiki-128.png?50|Логотип}}] | + | |
- | {{/wiki/dokuwiki-128.png?50}} | + | |
- | {{/wiki/dokuwiki-128.png?50|Логотип}} | + | |
- | [{{/wiki/dokuwiki-128.png?50|Логотип}}] | + | |
- | + | ||
- | <note important>Обратите внимание, что файл с подписью переносится сам, кроме того, у него имеется иконка для просмотра в оригинальном масштабе</note> | + | |
- | + | ||
- | (tab)Масштабирование по ширине и высоте с помощью латинской буквы "икс"; если пропорции заданной ширины и высоты не совпадают с изображением, оно будет обрезано перед масштабированием: | + | |
- | {{/wiki/dokuwiki-128.png?200x50}} | + | |
- | {{/wiki/dokuwiki-128.png?200x50|Логотип}} | + | |
- | [{{/wiki/dokuwiki-128.png?200x50|Логотип}}] | + | |
- | {{/wiki/dokuwiki-128.png?200x50}} | + | |
- | {{/wiki/dokuwiki-128.png?200x50|Логотип}} | + | |
- | [{{/wiki/dokuwiki-128.png?200x50|Логотип}}] | + | |
- | + | ||
- | ==== Выравнивание ==== | + | |
- | + | ||
- | (tab)Оставляя пробелы вокруг ссылки, можно осуществлять выравнивание изображений: | + | |
- | {{ /wiki/dokuwiki-128.png}} | + | |
- | {{/wiki/dokuwiki-128.png }} | + | |
- | {{ /wiki/dokuwiki-128.png }} | + | |
- | {{ /wiki/dokuwiki-128.png}} | + | |
- | {{/wiki/dokuwiki-128.png }} | + | |
- | {{ /wiki/dokuwiki-128.png }} | + | |
- | + | ||
- | <note tip>В случае выравнивания "боковое-боковое-центральное" картинки прекрасно выстраиваются в одну строку. Впрочем, можно не применять выравнивания вовсе</note> | + | |
- | + | ||
- | (tab)Масштабирование в таком случае жёстко прикрепляется к расширению файла; ниже некорректный пробел, обозначенный подчёркиванием, игнорируется, в итоге третья картинка считает себя выровненной вправо: | + | |
- | {{ /wiki/dokuwiki-128.png?200x50 }} | + | |
- | {{ /wiki/dokuwiki-128.png_?200x50 }} = {{ /wiki/dokuwiki-128.png?200x50 }} | + | |
- | {{ /wiki/dokuwiki-128.png_?200x50}} = {{ /wiki/dokuwiki-128.png?200x50}} | + | |
- | {{ /wiki/dokuwiki-128.png?200x50 }} | + | |
- | {{ /wiki/dokuwiki-128.png ?200x50 }} | + | |
- | {{ /wiki/dokuwiki-128.png ?200x50}} | + | |
- | <brr> | + | |
- | (tab)Поскольку надписи могут заканчиваться пробелом по недосмотру составителя, этот пробел считается частью надписи и не может быть управляющим в выравнивании; здесь ситуация с третьей картинкой аналогичная: | + | |
- | {{ /wiki/dokuwiki-128.png |Логотип1}} | + | |
- | {{ /wiki/dokuwiki-128.png |Логотип2_}} = {{ /wiki/dokuwiki-128.png |Логотип1}} | + | |
- | {{ /wiki/dokuwiki-128.png|Логотип3_}} = {{ /wiki/dokuwiki-128.png|Логотип3}} | + | |
- | {{ /wiki/dokuwiki-128.png |Логотип1}} | + | |
- | {{ /wiki/dokuwiki-128.png |Логотип2 }} | + | |
- | {{ /wiki/dokuwiki-128.png|Логотип3 }} | + | |
- | <brr> | + | |
- | (tab)Поведение плагина подписей идентично: | + | |
- | [{{ /wiki/dokuwiki-128.png |Логотип1}}] | + | |
- | [{{ /wiki/dokuwiki-128.png |Логотип2_}}] = [{{ /wiki/dokuwiki-128.png |Логотип1}}] | + | |
- | [{{ /wiki/dokuwiki-128.png|Логотип3_}}] = [{{ /wiki/dokuwiki-128.png|Логотип3}}] | + | |
- | [{{ /wiki/dokuwiki-128.png |Логотип1}}] | + | |
- | [{{ /wiki/dokuwiki-128.png |Логотип2 }}] | + | |
- | [{{ /wiki/dokuwiki-128.png|Логотип3 }}] | + | |
- | <brr> | + | |
- | + | ||
- | ==== Комплексный пример ==== | + | |
- | + | ||
- | (tab)Масштабированное изображение с выравниванием и подписями: | + | |
- | {{ /wiki/dokuwiki-128.png?200x50 |Логотип}} | + | |
- | [{{ /wiki/dokuwiki-128.png?200x50 |Логотип}}] | + | |
- | {{ /wiki/dokuwiki-128.png?200x50 |Логотип}} | + | |
- | [{{ /wiki/dokuwiki-128.png?200x50 |Логотип}}] | + | |
===== Оформление ссылок ===== | ===== Оформление ссылок ===== | ||
- | DokuWiki поддерживает разные способы создания ссылок, в том числе с помощью __пиктограмм__ панели инструментов | + | {{page>5links&noheader}} |
- | + | ||
- | ==== Внешние ссылки ==== | + | |
- | + | ||
- | Внешние ссылки создаются автоматически: http://www.google.com или просто www.google.com, также можно дать ссылкам название: [[http://www.google.com|Эта ссылка ведет на Google]] | + | |
- | + | ||
- | Внешние ссылки создаются автоматически: http://www.google.com или просто www.google.com, | + | |
- | также можно дать ссылкам название: [[http://www.google.com|Эта ссылка ведет на Google]] | + | |
- | + | ||
- | Как видно, при дополнительном оформлении внешних ссылок требуются двойные квадратные скобки (кстати, их автоматически подставляет __пиктограмма__ {{wiki:pg:linkextern.png?nolink}}). Однако, есть и особые внешние ссылки: | + | |
- | + | ||
- | Адреса электронной почты оформляются вот так: <[email protected]> | + | |
- | + | ||
- | Адреса электронной почты оформляются вот так: <[email protected]> | + | |
- | + | ||
- | Они закодированы для защиты от спамерских коллекторов. | + | |
- | + | ||
- | ==== Внутренние ссылки ==== | + | |
- | + | ||
- | Внутренние ссылки всегда окружаются двойными квадратными скобками. Если на странице %%[[2pages]]%% имеется свой элемент заголовка, он отображается вместо ее адреса: [[2pages]]. Вместо заголовка можно снабдить ссылку подходящим по контексту [[2pages|названием]] | + | |
- | + | ||
- | Внутренние ссылки окружаются двойными квадратными скобками. Если на странице [[2pages]] | + | |
- | имеется свой элемент заголовка, он отображается вместо ее адреса: [[2pages]]. Вместо | + | |
- | заголовка можно снабдить ссылку подходящим по контексту [[2pages|названием]] | + | |
- | + | ||
- | В кириллических адресах каждая буква кириллицы заменяется трехсимвольными URL-кодами, так что при превышении лимита на длину пути файла на сервере это приведет к нарушению отображения адреса. Однако раскладка, используемая для адреса страницы, не так уж и важна, если вместо него все равно будет показываться ее заголовок или, тем более, контекстное название. Кроме этого, адреса страниц в DokuWiki автоматически переводятся в нижний регистр, специальные символы не разрешаются | + | |
- | + | ||
- | С помощью __пиктограммы__ {{wiki:pg:link.png?nolink}} можно сконструировать внутренний адрес, пройдя последовательно по всем подпапкам вики до нужной страницы | + | |
- | + | ||
- | ==== "Якоря" ==== | + | |
- | + | ||
- | Возможно указать в ссылке привязку к конкретному пункту страницы. Для этого нужно оформить ссылку как %%[[адрес#раздел]]%%, как это принято в HTML | + | |
- | + | ||
- | Это ссылка на [[5links#Interwiki|следующий раздел]] | + | |
- | + | ||
- | Это ссылка на [[5links#Interwiki|следующий раздел]] | + | |
- | + | ||
- | <note important>Когда меняется заголовок раздела, внутренние ссылки на него перестают работать, поэтому по возможности следует избегать привязки ссылок к разделам страницы</note><note info>По умолчанию в DokuWiki для автоматического создания ссылок не используется [[wp>CamelCase]], но эту функцию может включить администратор и тогда текст "DokuWiki" будет виден как цветная ссылка</note> | + | |
- | + | ||
- | ==== Interwiki ==== | + | |
- | + | ||
- | DokuWiki поддерживает [[doku>wiki:interwiki|interwiki]]-ссылки, короткие ссылки на другие Wiki. Например, вот ссылка на страницу англоязычной Википедии о Wiki: [[wp>Wiki]]. | + | |
- | + | ||
- | DokuWiki поддерживает [[doku>wiki:interwiki|interwiki]]-ссылки, короткие ссылки на другие Wiki. | + | |
- | Например, вот ссылка на страницу англоязычной Википедии о Wiki: [[wp>Wiki]]. | + | |
- | + | ||
- | Список поддерживаемых, а также их замены: | + | |
- | | wp | http://en.wikipedia.org/wiki/{NAME} | | + | |
- | | wr | http://ru.wikipedia.org/wiki/{NAME} | | + | |
- | | lm | http://lurkmore.to/{NAME} | | + | |
- | | wfr | http://ru.wikifur.com/wiki/{NAME} | | + | |
- | | doku | http://www.dokuwiki.org/ | | + | |
- | | go | http://www.google.com/search?q={URL}&btnI=lucky | | + | |
- | | xmpp | xmpp:{NAME} | | + | |
- | | skype | skype:{NAME} | | + | |
- | + | ||
- | ==== Изображения-ссылки ==== | + | |
- | + | ||
- | Любое изображение может выступать в качестве ссылки на внутреннюю или внешнюю страницу с помощью совмещения синтаксиса изображения (в том числе изменение размера, выравнивание и прочее) и синтаксиса ссылки, как это сделано ниже: | + | |
- | + | ||
- | [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] | + | |
- | + | ||
- | [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] | + | |
- | + | ||
- | Форматирование картинок - это единственная синтаксическая конструкция, которую можно использовать в наименовании ссылки | + | |
===== Оформление таблиц ===== | ===== Оформление таблиц ===== | ||
- | В DokuWiki довольно просто создавать таблицы | + | {{page>6tables&noheader}} |
- | + | ||
- | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
- | | Стр. 2 Стб. 1 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | | Стр. 3 Стб. 1 | **Объединение столбцов** || | + | |
- | | Стр. 4 Стб. 1 | Стр. 4 Стб. 2 | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | Символом ''|'' начинаются и заканчиваются обычные строки (им же отделяются столбцы), символом ''^'' (циркумфлекс) - заголовки | + | |
- | + | ||
- | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
- | | Стр. 2 Стб. 1 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | | Стр. 3 Стб. 1 | **Объединение столбцов** || | + | |
- | | Стр. 4 Стб. 1 | Стр. 4 Стб. 2 | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | Можно **объединить ячейки горизонтально**, если в самой левой оставить содержимое, а справа сдвинуть вместе разделители, и так по количеству объединяемых ячеек. Следите за количеством ячеек! | + | |
- | + | ||
- | Возможно также создавать **построчные и угловые заголовки**: | + | |
- | + | ||
- | | ^ Заголовок 1 ^ Заголовок 2 ^ | + | |
- | ^ Заголовок 3 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | ^ Заголовок 4 | Стр. 3 Стб. 2 | Стр. 3 Стб. 3 | | + | |
- | ^ Заголовок 5 | Стр. 4 Стб. 2 | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | Как видно, разделитель перед клеткой определяет ее форматирование | + | |
- | + | ||
- | | ^ Заголовок 1 ^ Заголовок 2 ^ | + | |
- | ^ Заголовок 3 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | ^ Заголовок 4 | Стр. 3 Стб. 2 | Стр. 3 Стб. 3 | | + | |
- | ^ Заголовок 5 | Стр. 4 Стб. 2 | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | Можно **объединить ячейки вертикально**, если в самой верхней оставить содержимое, а клетки ниже заполнить знаками '':::'', и так по количеству объединяемых ячеек | + | |
- | + | ||
- | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
- | | Стр. 2 Стб. 1 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | | Стр. 3 Стб. 1 | **Объединение строк** | Стр. 3 Стб. 3 | | + | |
- | | Стр. 4 Стб. 1 | ::: | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
- | | Стр. 2 Стб. 1 | Стр. 2 Стб. 2 | Стр. 2 Стб. 3 | | + | |
- | | Стр. 3 Стб. 1 | **Объединение строк** | Стр. 3 Стб. 3 | | + | |
- | | Стр. 4 Стб. 1 | ::: | Стр. 4 Стб. 3 | | + | |
- | + | ||
- | Вы можете определить **выравнивание** текста внутри ячеек. Для этого нужно добавить не менее двух пробелов с противоположной стороны ячейки: при пробелах слева текст выравнивается по правому краю и наоборот. Если два и более пробелов отделяют текст от обоих разделителей, текст центрируется | + | |
- | + | ||
- | ^ Таблица с выравниванием ||^ | + | |
- | | справа| в центре |слева | | + | |
- | |слева | справа| в центре | | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | ^ Таблица с выравниванием ||^ | + | |
- | | справа| в центре |слева | | + | |
- | |слева | справа| в центре | | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | Вертикальное выравнивание не поддерживается | + | |
- | + | ||
- | Регулирование ширины ячеек - см. [[10plug-ins#Tablewidth]] | + | |
- | + | ||
- | Вставка спойлеров в таблицы - см. [[:playground:place01]] | + | |
===== Структурирование текста ===== | ===== Структурирование текста ===== | ||
- | ==== Заголовки ==== | + | {{page>7hierarchy&noheader}} |
- | + | ||
- | Для структурирования текста на странице можно использовать заголовки пяти уровней вложенности. Заголовок 1-го уровня использован в названии "Структурирование текста", заголовок 2-го уровня это "Заголовки", а ниже представлены остальные уровни: | + | |
- | + | ||
- | === Заголовок 3-го уровня === | + | |
- | == Заголовок 4-го уровня == | + | |
- | = Заголовок 5-го уровня = | + | |
- | + | ||
- | === Заголовок 3-го уровня === | + | |
- | == Заголовок 4-го уровня == | + | |
- | = Заголовок 5-го уровня = | + | |
- | + | ||
- | Пиктограмма {{wiki:pg:h.png?nolink}} является гнездовой и открывает подпанель с пиктограммами всех пяти типов заголовков {{wiki:pg:h1.png?nolink}} {{wiki:pg:h2.png?nolink}} {{wiki:pg:h3.png?nolink}} {{wiki:pg:h4.png?nolink}} {{wiki:pg:h5.png?nolink}} | + | |
- | + | ||
- | <del>Если использовать более трех заголовков, в правом верхнем углу страницы автоматически создается список содержимого страницы, способный сворачиваться/разворачиваться по кнопкам +/-. Чтобы отключить эту функцию, например, когда текст страницы умещается в один экран, нужно включить в текст страницы неотображаемую строку ''%%~~NOTOC~~%%''. Здесь содержание не отключено специально</del> | + | |
- | <fc #FF0000>В настоящее время содержание в вики отключено совсем</fc> | + | |
- | + | ||
- | ==== Списки ==== | + | |
- | + | ||
- | Dokuwiki поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела, следом астериск ''*'' для ненумерованного списка или тире ''-'' для нумерованного и еще один пробел. | + | |
- | + | ||
- | * Первый элемент списка | + | |
- | * Второй элемент списка | + | |
- | * Можно делать вложенные списки | + | |
- | * Еще один элемент списка | + | |
- | + | ||
- | - Тот же список, только нумерованный | + | |
- | - Еще один элемент | + | |
- | - Отступим и сделаем вложенный | + | |
- | - Вот и все | + | |
- | + | ||
- | <code> | + | |
- | * Первый элемент списка | + | |
- | * Второй элемент списка | + | |
- | * Можно делать вложенные списки | + | |
- | * Еще один элемент списка | + | |
- | + | ||
- | - Тот же список, только нумерованный | + | |
- | - Еще один элемент | + | |
- | - Отступим и сделаем вложенный | + | |
- | - Вот и все | + | |
- | </code> | + | |
- | + | ||
- | Для списков предназначены соответствующие __пиктограммы__ {{wiki:pg:ul.png?nolink}} и {{wiki:pg:ol.png?nolink}} | + | |
- | + | ||
- | Еще можно почитать [[doku>faq:lists|FAQ]] на официальном сайте Докувики | + | |
- | + | ||
- | ==== Разделитель ==== | + | |
- | + | ||
- | С помощью четырех и более дефисов можно сделать горизонтальную разделительную линию: | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | <code> | + | |
- | ---- | + | |
- | </code> | + | |
- | + | ||
- | Разделитель доступен на панели инструментов в виде __пиктограммы__ {{wiki:pg:hr.png?nolink}}, также доступен тег %%<hr>%% | + | |
- | + | ||
- | ==== Цитаты ==== | + | |
- | + | ||
- | В некоторых случаях требуется оформить текст таким образом, чтобы показать, что это ответ на вопрос или комментарий. В таких случаях используется следующий метод: | + | |
- | + | ||
- | Да будет так | + | |
- | + | ||
- | > Нет, не так | + | |
- | + | ||
- | >> Я сказал так, значит так | + | |
- | + | ||
- | > Именно так? | + | |
- | + | ||
- | >> Да! | + | |
- | + | ||
- | >>> Ну раз так, пусть будет так! | + | |
- | + | ||
- | Да будет так | + | |
- | > Нет, не так | + | |
- | >> Я сказал так, значит так | + | |
- | > Именно так? | + | |
- | >> Да! | + | |
- | >>> Ну раз так, пусть будет так! | + | |
- | + | ||
- | ==== Сноски ==== | + | |
- | + | ||
- | Сноска может быть добавлена с помощью двойных круглых скобок ((Это сноска)) | + | |
- | + | ||
- | Сноски могут быть добавлены с помощью двойных круглых скобок ((Это сноска)) | + | |
- | + | ||
- | Наведя на сноску мышку, можно просмотреть ее; щелкнув по ней, можно перейти к их списку внизу страницы; щелкнув по ней в списке, можно перейти к месту ее расположения в тексте. Список сносок сквозной и не зависит от секционного разделения страницы, однако сноски с одинаковым содержимым группируются | + | |
===== Символы ===== | ===== Символы ===== | ||
- | DokuWiki может конвертировать некоторые предопределенные символы или строки в картинки или иной текст или HTML | + | {{page>8symbols&noheader}} |
- | + | ||
- | Первое обычно используется для смайликов, второе - для типографики | + | |
- | + | ||
- | ==== Смайлики ==== | + | |
- | + | ||
- | DokuWiki конвертирует часто используемые смайлики в их графические варианты. Вот смайлики, которые есть в DokuWiki: | + | |
- | <spoiler|Список смайлов> | + | |
- | * 8-) %%8-)%% | + | |
- | * 8-O %%8-O%% | + | |
- | * :-( %%:-(%% | + | |
- | * :-) %%:-)%% | + | |
- | * =) %%=)%% | + | |
- | * :-/ %%:-/%% | + | |
- | * :-\ %%:-\%% | + | |
- | * :-? %%:-?%% | + | |
- | * :-D %%:-D%% | + | |
- | * :-P %%:-P%% | + | |
- | * :-O %%:-O%% | + | |
- | * :-X %%:-X%% | + | |
- | * :-| %%:-|%% | + | |
- | * ;-) %%;-)%% | + | |
- | * ^_^ %%^_^%% | + | |
- | * :?: %%:?:%% | + | |
- | * :!: %%:!:%% | + | |
- | * LOL %%LOL%% | + | |
- | * FIXME %%FIXME %% | + | |
- | * DELETEME %%DELETEME%% | + | |
- | </spoiler> | + | |
- | <spoiler|Список MLP-смайлов> | + | |
- | * *ТС* %%*ТС*%% %%*TS*%% | + | |
- | * *РР* %%*РР*%% %%*RR*%% | + | |
- | * *ФШ* %%*ФШ*%% %%*FS*%% | + | |
- | * *РД* %%*РД*%% %%*RD*%% | + | |
- | * *ЭД* %%*ЭД*%% %%*AJ*%% | + | |
- | * *ПП* %%*ПП*%% %%*PP*%% | + | |
- | * *ПЛ* %%*ПЛ*%% %%*PL*%% | + | |
- | * *БМ* %%*БМ*%% %%*BM*%% | + | |
- | * *TGPT* %%*TGPT*%% | + | |
- | * *ЭБ* %%*ЭБ*%% %%*AB*%% | + | |
- | * *СБ* %%*СБ*%% %%*SB*%% | + | |
- | * *СЛ* %%*СЛ*%% %%*SL*%% | + | |
- | </spoiler> | + | |
- | + | ||
- | У смайликов есть своя гнездовая __пиктограмма__ {{wiki:pg:smiley.png?nolink}} | + | |
- | + | ||
- | ==== Типографика ==== | + | |
- | + | ||
- | DokuWiki может преобразовывать некоторые текстовые символы в их корректные типографские эквиваленты. По умолчанию распознаются такие элементы: | + | |
- | + | ||
- | ... (pipe) --. -- -. ['] ' ’ (nbsp) (tab) 640x480 | + | |
- | <hr> | + | |
- | + | ||
- | "He thought 'It's a man's world'..." | + | |
- | + | ||
- | Три точки заменяются на троеточие (оригинальная типографика Докувики, остальное неспецифично для комиксов), пайп (вертикальная черта), тире и перенос, тире, перенос, ударение, два вида редких апострофов (заменяются на общеизвестный), неломаемый пробел, табуляция из трёх неломаемых пробелов, автораспознавание иксов между чисел. | + | |
- | + | ||
- | <code> | + | |
- | ... (pipe) --. -- -. ['] ' ’ (nbsp) (tab) 640x480 | + | |
- | <hr> | + | |
- | + | ||
- | "He thought 'It's a man's world'..." | + | |
- | </code> | + | |
- | + | ||
- | Гнездовая __пиктограмма__ {{wiki:pg:chars.png?nolink}} содержит больше знаков | + | |
===== Особые случаи ===== | ===== Особые случаи ===== | ||
- | ==== Подпись ==== | + | {{page>9special&noheader}} |
- | + | ||
- | Зарегистрированный участник вики может при необходимости оставить свою подпись, используя __пиктограмму__ {{wiki:pg:sig.png?nolink}} на панели инструментов. По умолчанию она уже включает в себя скобки | + | |
- | + | ||
- | ==== Необрабатываемый текст ==== | + | |
- | + | ||
- | Необрабатываемый текст можно добавить в документ либо отделив его по крайней мере двумя пробелами от начала строки (как в случае с почти всеми примерами Справки), либо с использованием тэгов ''%%<code>%%'' ''%%</code>%%'' или ''%%<file>%%'' ''%%</file>%%'' | + | |
- | + | ||
- | Это текст с двумя пробелами в начале строки | + | |
- | + | ||
- | <code> | + | |
- | В этой строке сохранены все ← 17 пробелов | + | |
- | </code> | + | |
- | + | ||
- | <file> | + | |
- | Применение тэга <file> указывает на то, что вы приводите содержание файла | + | |
- | </file> | + | |
- | + | ||
- | Вот как это выглядит при правке: | + | |
- | + | ||
- | Это текст с двумя пробелами в начале строки | + | |
- | + | ||
- | <code> | + | |
- | В этой строке сохранены все ← 17 пробелов | + | |
- | </code> | + | |
- | + | ||
- | <file> | + | |
- | Применение тэга <file> указывает на то, что вы приводите содержание файла | + | |
- | </file> | + | |
- | + | ||
- | ==== Необрабатываемый текст-2 ==== | + | |
- | + | ||
- | Чтобы заставить парсер игнорировать участки текста (то есть не форматировать их), используйте тэги ''%%<nowiki>%%'' ''%%</nowiki>%%'' или два знака "процент" - ''<nowiki>%%</nowiki>'' | + | |
- | + | ||
- | <nowiki> | + | |
- | В этой строке содержатся URL http://www.splitbrain.org и **форматирование**. | + | |
- | А ещё перенесена строка, должная показываться целой. Но ничего не происходит | + | |
- | </nowiki> | + | |
- | То же верно для %%//__этого__ текста// со смайлом ;-)%%. | + | |
- | + | ||
- | <nowiki> | + | |
- | В этой строке содержатся URL http://www.splitbrain.org и **форматирование**. | + | |
- | А ещё перенесена строка, должная показываться целой. Но ничего не происходит | + | |
- | </nowiki> | + | |
- | То же верно для %%//__этого__ текста// со смайлом ;-)%%. | + | |
- | + | ||
- | Вы можете просмотреть код этой страницы, чтобы лучше понять эффект тегов | + | |
- | + | ||
- | ==== RSS/ATOM Feed Aggregation ==== | + | |
- | + | ||
- | Докувики может собирать данные из внешних источников XML-новостей (RSS). Для распознавания используется [[http://simplepie.org/|SimplePie]], понимаемые им форматы понимаемы и Докувики. Можно расширить распознавание добавлением параметров через пробел: | + | |
- | + | ||
- | ^ Параметр ^ Описание ^ | + | |
- | | любое число | Максимальное число строк списка, по умолчанию 8 | | + | |
- | | reverse | Показывать строки в обратном порядке | | + | |
- | | author | Показывать имя автора | | + | |
- | | date | Показывать дату | | + | |
- | | description | Показывать описание. Если [[doku>config:htmlok|HTML]] отключен, все теги обрезаются | | + | |
- | | //число//[dhm] | Период обновления, d = дни, h = часы, m = минуты, по умолчанию 4h, минимально 10m | | + | |
- | + | ||
- | Докувики старается брать кэшированную страницу; очевидно, это неприемлемо при наличии в ней динамического текста. Более короткий период обновления поможет избежать излишнего устаревания данных. | + | |
- | + | ||
- | **Пример:** | + | |
- | + | ||
- | {{rss>http://slashdot.org/index.rss 5 author date 1h }} | + | |
- | + | ||
- | {{rss>http://slashdot.org/index.rss 5 author date 1h }} | + | |
- | + | ||
- | ==== Контрольные макросы ==== | + | |
- | + | ||
- | Этот синтаксис определяет, как будет отображаться страница без определённых составляющих. По умолчанию доступны: | + | |
- | + | ||
- | ^ Макрос ^ Описание | | + | |
- | | %%~~NOCACHE~~%% | Cтраница отображается напрямую, без кэширования. Иногда может быть полезно принудительно перерисовывать страницу с обновляемым содержимым | | + | |
- | | %%~~NOTOC~~%% | Cтраница отображается без таблицы содержания. Полезно для личных страниц, например | | + | |
===== Плагины ===== | ===== Плагины ===== | ||
- | ==== AIMG ==== | + | {{page>10plug-ins&noheader}} |
- | + | ||
- | Адаптация популярной утилиты Fotonotes для примечаний, оставляемых поверх изображения. Сильно модифицированная версия с [[https://comicslate.org|Комикслейта]] для создания табличек, рецептов и карт. Синтаксис: | + | |
- | {{aimg>путь к картинке}} | + | |
- | @вниз от верхнего левого угла изображения,то же вправо,ширина наклейки,"низота" наклейки | + | |
- | первая наклейка будет под всеми, что накладываются на неё | + | |
- | ~ | + | |
- | @8,8,32,32 | + | |
- | фона нет. можно вставить картинку или другую страницу | + | |
- | ~ | + | |
- | @8,8,32,32,-40 | + | |
- | эта наклейка повёрнута на угол в 360-40 = 320 градусов | + | |
- | ~ | + | |
- | @8,8,32,32 | + | |
- | последняя наклейка будет наложена поверх всех предыдущих | + | |
- | ~ | + | |
- | {{<aimg}} | + | |
- | + | ||
- | ==== BBCode ==== | + | |
- | + | ||
- | Популярный способ разметки BBCode: | + | |
- | * примитивы %%[b]%%[b]жирный[/b]%%[/b]%%, %%[i]%%[i]курсивный[/i]%%[/i]%%, %%[u]%%[u]подчеркнутый[/u]%%[/u]%%, %%[m]%%[m]моноширинный[/m]%%[/m]%%, %%[s]%%[s]зачёркнутый[/s]%%[/s]%% | + | |
- | * ссылки %%[url=wiki:index]Пояснение[/url], [url=http://2ip.ru]Пояснение[/url]%%. Вставленную img не понимает | + | |
- | * картинки %%[img=wiki:pg:image.png]Пояснение[/img]%%, внешние ссылки аналогичны. Вставленную url не понимает | + | |
- | * емайлы %%[email]емайл[/email]%% | + | |
- | * список %%[list][*]строка 1[*]строка 2[*]строка 3[/list]%%, %%[list=1][*]строка 1[*]строка 2[*]строка 3[/list]%%, атрибуты: 1, a, A, i или I | + | |
- | * размер %%[size=70%]текст[/size]%% в любых CSS-единицах (см. список в [[#FontSize]]) и простых числах 1-6 | + | |
- | * цвет %%[color=red]красный[/color]%% в любых CSS-единицах (см. список в [[#FontColor]]) | + | |
- | * листинг %%[code]<?php echo $text;[/code]%% | + | |
- | * цитата %%[quote="Esther"]DokuWiki замечательна![/quote]%%. Поддерживает в себе теги url, size и color | + | |
- | + | ||
- | ==== CNAV ==== | + | |
- | + | ||
- | Навигатор со стрелками с [[https://comicslate.org|Комикслейта]], здесь используется в блоке новостей. Стандартный синтаксис %%{cnav}%% листает по 4-значным цифрам, синтаксисом вида %%{cnav-3}%% поддерживаются 3-6-значные номера. Можно указать конкретные пути вперёд-назад %%{017<cnav>show}%% | + | |
- | + | ||
- | ==== Discussion ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/comment.png}} для управления обсуждениями. %%~~DISCUSSION:open~~%% вставляет обсуждение, %%~~DISCUSSION:closed~~%% запрещает комментирование, %%~~DISCUSSION:off~~%% закрывает обсуждение. Администратор может приоритетно запретить обсуждение на конкретной странице, вследствие чего поставленный на страницу разрешительный тег после сохранения будет исчезать | + | |
- | + | ||
- | В обсуждениях могут принимать участие все посетители сайта. Если вы работаете на сайте под своим логином и паролем, то вы сможете вносить изменения в свои сообщения. Вы можете создавать на страницах обсуждения и в стиле форума. Используйте для этого команду: | + | |
- | + | ||
- | {{threads>папка}} | + | |
- | + | ||
- | ==== ExtTab ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/table.png}} для вставки таблицы с [[https://www.mediawiki.org/wiki/Help:Tables/ru|Медиавики-синтаксисом]] | + | |
- | + | ||
- | Отключено | + | |
- | + | ||
- | ==== FontColor ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/color_picker.png}} для вставки цветного текста с синтаксисом %%<fс номер></fc>%%. Поддерживаются единицы CSS: | + | |
- | * шестизначные #[00-FF][00-FF][00-FF] (по умолчанию) | + | |
- | * трёхзначные #[0-F][0-F][0-F] | + | |
- | * ИменаЦветов (SVG-формат) | + | |
- | * именацветов (HTML-формат: white, black, blue и пр.) | + | |
- | * RGB([0-255],[0-255],[0-255]) | + | |
- | * RGBА([0-255],[0-255],[0-255],[0-1]) | + | |
- | * HSL([0-255],[0-100%],[0-100%]) | + | |
- | * HSLA([0-255],[0-100%],[0-100%],[0-1]) | + | |
- | + | ||
- | ==== FontFamily ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/font_picker.png}} для вставки разных шрифтов: <ff Arial>Arial</ff>, <ff BrushScriptMS>Brush Script MS</ff>, <ff Georgia>Georgia</ff>, <ff Impact>Impact</ff>, <ff TimesNewRoman>Times New Roman</ff>, <ff TrebuchetMS>Trebuchet MS</ff>, <ff Verdana>Verdana</ff>, <ff Webdings>Webdings</ff> | + | |
- | + | ||
- | Шрифт [mine]Minecraft[/] для оформления табличек использует иной способ отображения | + | |
- | + | ||
- | Шрифт [mine]Minecraft[/] для оформления табличек использует иной способ отображения | + | |
- | + | ||
- | ==== FontSize ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/size_picker.png}} для вставки крупного/мелкого текста с синтаксисом %%<fs размер></fs>%%. Поддерживаются единицы CSS: | + | |
- | * типографские: px, em, ex, % | + | |
- | * имперские и метрические: in = 6pc = 72pt = 2.54cm = 25.4mm | + | |
- | * ключевые слова: xx-small, x-small, small, medium, large, x-large, xx-large, smaller, larger (по умолчанию) | + | |
- | + | ||
- | ==== HtmlComment ==== | + | |
- | + | ||
- | HTML-комментарии для редакторов статьи можно оставлять в обычном теге <!-- вот тут --> | + | |
- | + | ||
- | HTML-комментарии для редакторов статьи можно оставлять в обычном теге <!-- вот тут --> | + | |
- | + | ||
- | ==== ImageBox ==== | + | |
- | + | ||
- | Красивое оформление для картинок, с кнопкой масштабирования и местом для подписи. Достаточно окружить синтаксис изображения квадратными скобками %%[{{картинка.жпг}}]%%. Не понимает HTTPS-протокол, желательно [[4files|загружать изображения в вики]] | + | |
- | + | ||
- | ==== Include ==== | + | |
- | + | ||
- | Вставка на страницу содержимого других страниц, их секций или целых папок с помощью следующего синтаксиса: | + | |
- | + | ||
- | {{page>папка:имя}} (страница) | + | |
- | {{page>папка:имя#секция}} (секция страницы) | + | |
- | {{page>папка}} (папка) | + | |
- | + | ||
- | ==== Interwiki ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/interwiki.gif}} для вставки [[https://www.dokuwiki.org/ru%3Ainterwiki|интервики-ссылок]]. Например, вместо [[https://ru.wikipedia.org/wiki/Minecraft|Minecraft]] можно поставить [[wr>Minecraft]] | + | |
- | + | ||
- | Например, вместо [[https://ru.wikipedia.org/wiki/Minecraft|Minecraft]] можно поставить [[wr>Minecraft]] | + | |
- | + | ||
- | ==== Macros ==== | + | |
- | + | ||
- | FIXME | + | |
- | + | ||
- | Позволяет использовать макросы с аргументами для повторяющихся объектов (заголовки, ссылки, оформление и т.д.). Макрос является локальным для страницы, глобальные макросы задаются на отдельной специальной странице. Макрос работает на низком уровне, поэтому в него могут быть включены многие управляющие конструкции. Например, данная справка не выводится корректно (примеры кода не экранируются). Прочтите справку в режиме редактирования. Оригинал: https://www.dokuwiki.org/plugin:macros?&#syntax_and_usage | + | |
- | + | ||
- | == Экранирующие символы == | + | |
- | + | ||
- | Символ, стоящий после апострофа ` , будет выведен как обычный символ. Таким образом можно выводить символы, которые могут интерпретироваться как управляющие: | + | |
- | + | ||
- | `{`{ literal braces `}`} | + | |
- | + | ||
- | Чтобы выввести апостроф, напишите его два раза: | + | |
- | + | ||
- | `` | + | |
- | + | ||
- | == Макросы == | + | |
- | + | ||
- | Определение макроса: | + | |
- | + | ||
- | {{$name=definition$}} | + | |
- | + | ||
- | где //name// - идентификатор макроса and //definition// - выводимый макросом текст. Определение может содержать подстановочные аргументы //@0//, //@1//, ... //@9//, до десяти аргументов. | + | |
- | + | ||
- | Вызов макроса: | + | |
- | + | ||
- | $name (без аргументов - эквивалентно пустым аргументам) | + | |
- | $name[] (с пустым списком аргументов) | + | |
- | $name[arg] (с одним аргументом) | + | |
- | $name[arg1|arg2] (с двумя аргументами, и т.д.) | + | |
- | + | ||
- | Пример: | + | |
- | + | ||
- | {{$format=**@0** @1 //@2//$}} | + | |
- | $format[bold|and|italics] | + | |
- | + | ||
- | Выводит текст: **bold** and //italics// | + | |
- | + | ||
- | == Условия == | + | |
- | + | ||
- | Плагин обрабатывает два типа условных выражений: | + | |
- | + | ||
- | $??[cond|T|F] | + | |
- | + | ||
- | выдаёт ''T'' если ''cond'' - не пустая строка, в противном случае выдаёт ''F'': | + | |
- | + | ||
- | $?[a|b] (сокращённый вызов $??[a|a|b]) | + | |
- | + | ||
- | выдаёт ''a'' если ''a'' - не пустая строка, иначе выдаёт ''b'' | + | |
- | + | ||
- | ==== MultiPoll ==== | + | |
- | + | ||
- | Плагин для создания развёрнутых опросов: | + | |
- | <multipoll [hideresults] [hideifvoted] [showresultsto]=user,@grp,... | [id]> | + | |
- | [вопрос 1] | + | |
- | * [ответ] | + | |
- | * [ответ] | + | |
- | * ... | + | |
- | [вопрос 2] | + | |
- | * [ответ] | + | |
- | * [ответ] | + | |
- | [многовариантный вопрос] | + | |
- | + [ответ] | + | |
- | + [ответ] | + | |
- | + [ответ] | + | |
- | + ... | + | |
- | </multipoll> | + | |
- | + | ||
- | ==== Note ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/note_picker.png}} для вставки заметок. Примеры, как это может выглядеть: | + | |
- | + | ||
- | <note>Простая заметка. Поместите здесь текст, на который вы хотите обратить внимание</note> | + | |
- | <note>Простая заметка. Поместите здесь текст, на который вы хотите обратить внимание</note> | + | |
- | + | ||
- | <note tip>Полезный совет, новая идея. Поместите здесь текст, который должен помочь читателям</note> | + | |
- | <note tip>Полезный совет, новая идея. Поместите здесь текст, который должен помочь читателям</note> | + | |
- | + | ||
- | <note important>Внимание! Есть некоторые проблемы, которые требуют специального решения</note> | + | |
- | <note important>Внимание! Есть некоторые проблемы, которые требуют специального решения</note> | + | |
- | + | ||
- | <note warning>Опасность! Не делайте того, о чем написано в этой заметке!</note> | + | |
- | <note warning>Опасность! Не делайте того, о чем написано в этой заметке!</note> | + | |
- | + | ||
- | ==== Pageredirect ==== | + | |
- | + | ||
- | FIXME | + | |
- | + | ||
- | Есть пиктограмма. | + | |
- | + | ||
- | Иногда нужно, чтобы ссылка на одну страницу автоматически перенаправлялась на другую. Например, страница переместилась на другое место или вы решили объединить две страницы в одну. Перенаправление поможет вам сохранить работоспособность ссылок в пределах всего сайта. | + | |
- | + | ||
- | Для перенаправления на странице, на которую вы ссылаетесь, поместите следующую команду: | + | |
- | + | ||
- | ~~REDIRECT>страница_которую_надо_показать~~ | + | |
- | + | ||
- | Например, откройте страницу [[.:page1]], вас автоматически перенаправят на страницу [[.:page2]]. Вернувшись в браузере на один клик назад (обычно Alt + ←), вы все-таки окажетесь на странице page1 и сможете [[.:2pages|посмотреть ее исходный код]] | + | |
- | + | ||
- | ==== Spoiler ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/spoiler.png}} для сжатия секции текста под кликабельную кнопку с синтаксисом %%<spoiler|Титул>Содержимое</spoiler>%%. Титул необязателен | + | |
- | + | ||
- | ==== TableWidth ==== | + | |
- | + | ||
- | Можно явно указывать ширину столбцов таблицы в любых CSS-единицах (см. список в [[#FontSize]]). Нужно учесть, что длинные слова не переносятся и могут искажать таблицу, поэтому между слогов вставляем дефис и точку %%-.%% (тег мягкого переноса). Синтаксис: | + | |
- | + | ||
- | |< 70% 50px - 5em 10em 10% >| | + | |
- | ^ A ^ B ^ C ^ D ^ E ^ | + | |
- | | 1 | 2 | 3 | 4 | 5 | | + | |
- | + | ||
- | |< 70% 50px - 5em 10em 10% >| | + | |
- | ^ A ^ B ^ C ^ D ^ E ^ | + | |
- | | 1 | 2 | 3 | 4 | 5 | | + | |
- | + | ||
- | Первая цифра - ширина всей таблицы (70% от ширины текстового поля вики), остальные относятся к столбцам. Не регулируемые столбцы оформляются через дефис и забирают остаток ширины; дефис в конце списка можно не указывать. Если нерегулируемых столбцов несколько, они делят свободную ширину пропорционально содержимому. В следующем примере остаток в 72% делится вторым и третьим столбцами в соотношении 1 к 2: | + | |
- | + | ||
- | |< 70% 28% >| | + | |
- | ^ 28% ^ 72% |^ | + | |
- | | Заданная ширина |1111111111|11111111111111111111| | + | |
- | + | ||
- | |< 70% 28% >| | + | |
- | ^ 28% ^ 72% |^ | + | |
- | | Заданная ширина |1111111111|11111111111111111111| | + | |
- | + | ||
- | ==== Тag ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/tag.png}} для вставки меток с синтаксисом %%{{tag>метка}}%%. Метки разделяются пробелом, внутри них в качестве раздела слов используется подчерк _ %%{{tag>метка_1 метка_2 метка_3}}%%. Длинные фразы можно взять в кавычки %%{{tag>"Ключевая фраза"}}%% | + | |
- | + | ||
- | === Cloud === | + | |
- | + | ||
- | Ассоциированный плагин для оформления облака тегов синтаксисом %%~~TAGCLOUD~~%% (по умолчанию показывается до 50 самых популярных тегов во всех разделах). Можно указать папку и управлять этим числом в пределах от 1 до 999: 20 самых популярных тегов в комиксах по "Королю Льву" - %%~~TAGCLOUD:20>tlk~~%% | + | |
- | + | ||
- | ~~TAGCLOUD:20>tlk~~ | + | |
- | + | ||
- | ==== tCycle ==== | + | |
- | + | ||
- | Оболочка для джаваскриптовой библиотеки tCycle. Пиктограмма {{./pg/chart_bar.png}} для анимирования набора картинок. Синтаксис: | + | |
- | <tcycle data-speed=500 data-fx=fade data-timeout=4000> | + | |
- | {{картинка1.жпг|подпись}} | + | |
- | {{картинка2.жпг|подпись}} | + | |
- | ...и так далее | + | |
- | </tcycle> | + | |
- | Параметры опциональны, speed и timeout измеряются в миллисекундах, fx может принимать значение scroll. Если их не указывать, то величины будут взяты такими же, как в примере | + | |
- | + | ||
- | ==== VShare ==== | + | |
- | + | ||
- | Пиктограмма {{./pg/vshare.png}} для вставки видеороликов из различных видеохостингов: vimeo, ustream, youtube, viddler, slideshare, dailymotion, bambuser, metacafe, bliptv, break, msoffice, 5min, clipfish, gtrailers, myspacetv, rcmovie, scivee, twitchtv, veoh. Достаточно дать ей ссылку, а она оформит её в виде %%{{сервис>номер}}%% | + | |
===== Стилевые и прочие теги ===== | ===== Стилевые и прочие теги ===== | ||
- | Добавление нижеуказанных значков в квадратных скобках меняет стиль последующего текста. Остальные варианты реализуются пиктограммами цвета, размера и шрифта. За новыми стилями обращаться к админу в Чате | + | {{page>11styles&noheader}} |
- | + | ||
- | |< 800px >| | + | |
- | | **# новая типографика** |||| | + | |
- | |%%(pipe)%%|%%|%% вертикальная черта|%%\"%%|%%"%% машинописные кавычки| | + | |
- | |%%--%%|%%–%% два дефиса = тире|%%-.%%|%%­%% мягкий перенос| | + | |
- | |%%[-.]%%|%%[-.]%%Автоматические переносы|%%<hr>%%|%%<hr />%% отчерк (почти аналог четырёх дефисов)| | + | |
- | |%%<hrr>%%|%%<hr style="clear:both" />%% абсолютный отчерк|%%<brr>%%|%%<br style="clear:both" />%% абсолютный перенос| | + | |
- | |%%(nbsp)%%|%% %% неразрывный пробел|%%(tab)%%|%%   %% табуляция| | + | |
- | |%%[back]%%|./index Возврат в текущий индекс|%%[up]%%|../index Возврат в родительский индекс| | + | |
- | |%%[']%%|%%́%% приставно[']е ударе[']ние|%%[>]%%| %%[>]%%Равнение на правый край| | + | |
- | |%%[<]%%|%%[<]%%Равнение на левый край |%%[|]%%| %%[|]%%Равнение по центру | | + | |
- | | Равнения в таблицах формируются проще - дважды пробелом с нужных сторон |||| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **# normal** |||| | + | |
- | |%%[mirx]%%|[mirx]Зеркально по X|%%[miry]%%|[miry]Зеркально по Y| | + | |
- | |%%[ax][!1.5]%%|[ax][!1.5]AxolOTL Comic 1.5em|%%[df][!1.2]%%|[df][!1.2]Dat Fest Comic 1.2em| | + | |
- | |%%[ft][!2.0]%%|[ft][!2.0]dspfetcher 2.0em|%%[sc][!1.2]%%|[sc][!1.2]Stripped Clone 1.2em| | + | |
- | |%%[lc][!1.2]%%|[lc][!1.2]Lisichka Comic 1.2em|%%[cl][!1.2]%%|[cl][!1.2]Clawrite 1.2em| | + | |
- | |%%[im][!1.2]%%|[im][!1.2]Impact 1.2em|%%[!1.2]%%|[!1.2]Trebuchet MS 1.2em (стандартный)| | + | |
- | | Диапазон размеров от 0.6 до 6.0 (0.6em - 6.0em) |||| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **# freefall** |||| | + | |
- | |%%[flo]%%|[flo]Dat Fest Comic 1.3em Флоренс Амброуз|%%[sam]%%|[sam]Dat Fest Comic 1.3em Сэм Старфолл| | + | |
- | |%%[hlx]%%|[hlx]Dat Fest Comic 1.3em Хеликс|%%[saw]%%|[saw]Dat Fest Comic 1.3em Пилозуб Риверграйндер| | + | |
- | |%%[qwe]%%|[qwe]Dat Fest Comic 1.3em Кверти|%%[dvo]%%|[dvo]Dat Fest Comic 1.3em Дворак| | + | |
- | |%%[edge]%%|[edge]Dat Fest Comic 1.3em Эдж|%%[blunt]%%|[blunt]Dat Fest Comic 1.3em Железяка| | + | |
- | |%%[max]%%|[max]Dat Fest Comic 1.3em Макс Пост|%%[rai]%%|[rai]Dat Fest Comic 1.3em Мистер Райберт| | + | |
- | |%%[kor]%%|[kor]Dat Fest Comic 1.3em мистер Корнада|%%[mad]%%|[mad]Dat Fest Comic 1.3em Винстон Турмад| | + | |
- | |%%[mayor]%%|[mayor]Dat Fest Comic 1.3em Мэр|%%[mhlp]%%|[mhlp]Dat Fest Comic 1.3em Помощник мэра| | + | |
- | |%%[nio]%%|[nio]Dat Fest Comic 1.3em Найоми|%%[pol]%%|[pol]Dat Fest Comic 1.3em Полицейские| | + | |
- | |%%[mst]%%\\ %%[mst1]%%|[mst]Dat Fest Comic 1.3em Полярники базы|%%[bow]%%|[bow]Dat Fest Comic 1.3em Др. Боуман| | + | |
- | |%%[com]%%|[com]Dat Fest Comic 1.3em Командующий базы|%%[ish]%%|[ish]Dat Fest Comic 1.3em Мистер Ишигуро| | + | |
- | |%%[oth]%%|[oth]Dat Fest Comic 1.3em Остальные| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **# commander kitty** |||| | + | |
- | |%%[kit]%%|[kit]Dat Fest Comic 1.2em Китти|%%[mou]%%|[mou]Impact 1.2em Мышь| | + | |
- | |%%[mtt]%%|[mtt]Dat Fest Comic 1.2em Миттенс|%%[nnw]%%|[nnw]Dat Fest Comic 1.2em Нин-Ва| | + | |
- | |%%[znt]%%|[znt]Dat Fest Comic 1.2em Зенит|%%[ck-]%%|[ck-]Dat Fest Comic 1.2em Остальные| | + | |
- | \\ | + | |
- | | **# lions** || | + | |
- | |%%[rel]%%|[rel]Dat Fest Comic 1.7em| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **# ponies** |||| | + | |
- | |%%[mol]%%|[mol]Stripped Clone 1.2em Молестия||| | + | |
- | |%%[tsp]%%|[tsp]Stripped Clone 1em Твайлайт Спаркл|%%[rrp]%%|[rrp]Stripped Clone 1em Рэрити| | + | |
- | |%%[rdp]%%|[rdp]Stripped Clone 1em Рэйнбоу Дэш|%%[fsp]%%|[fsp]Stripped Clone 1em Флаттершай| | + | |
- | |%%[ppp]%%|[ppp]Stripped Clone 1em Пинки Пай|%%[ajp]%%|[ajp]Stripped Clone 1em Эплджек| | + | |
- | |%%[sdr]%%|[sdr]Stripped Clone 1em дракон Спайк|%%[bmp]%%|[bmp]Stripped Clone 1em Биг Макинтош| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **# ozy & millie** |||| | + | |
- | |%%[ozy]%%|[ozy]Dat Fest Comic 1em Ози|%%[ozy1]%%|[ozy1]Dat Fest Comic 1.2em Ози| | + | |
- | |%%[mil]%%|[mil]Dat Fest Comic 1em Милли|%%[mil1]%%|[mil1]Dat Fest Comic 1.2em Милли| | + | |
- | | | |%%[lle]%%|[lle]Impact 1.2em Ллевеллин| | + | |
- | |%%[otr]%%|[otr]Dat Fest Comic 1em Остальные|%%[otr1]%%|[otr1]Dat Fest Comic 1.2em Остальные| | + | |
- | | В процессе переезда на более крупные |||| | + | |
- | \\ | + | |
- | | **# bunny** || | + | |
- | |%%[bun]%%|[bun]Dat Fest Comic 1.5em| | + | |
- | \\ | + | |
- | | **# ichabod** || | + | |
- | |%%[ich]%%|[ich]AxolOTL Comic 1.7em Ихавод| | + | |
- | |%%[ich-]%%|[ich-]AxolOTL Comic 1.7em остальные| | + | |
- | \\ | + | |
- | | **# weegie** || | + | |
- | |%%[wee]%%|[wee]Impact 4.5em полужирный| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | |%%[/]%%|Конец действия последнего наложенного стиля, %%[!1.3]%%[!1.3]без этого знака происходит %%[!1.3]%%[!1.3]умножение размеров[/]%%[/]%% текста[/]%%[/]%%. Он не требуется в конце наклеек и ячеек таблиц - современные браузеры прощают это| | + | |
- | \\ | + | |
- | |< 800px >| | + | |
- | | **Метки состояния** |||| | + | |
- | |%%@approved@%%|@approved@|%%@approveds@%%|@approveds@| | + | |
- | |%%@c-on@%%|@c-on@|%%@p-on@%%|@p-on@| | + | |
- | |:::|:::|%%@p-on+@%%|@p-on+@| | + | |
- | |%%@c-off@%%|@c-off@|%%@p-off@%%|@p-off@| | + | |
- | |%%@c-end@%%|@c-end@|%%@p-end@%%|@p-end@| | + | |
===== Работа с наклейками ===== | ===== Работа с наклейками ===== | ||
- | <note>Рекомендация для пользователей Оперы (и м.б. других браузеров с подобной функцией) – уберите приведение ширины страницы к 100% ширины экрана, это влияет на реальное положение наклеек</note> | + | {{page>12balloons&noheader}} |
- | + | ||
- | Если вы попали на данную страницу через [[./index|Справочную]], то, вероятно, ещё ни разу не редактировали страницы. В обычном редакторе после загрузки страницы до конца появляется дополнительная фиолетовая кнопка CoTAN. Это название означает "Comic Translator by Applicated Notes" или "переводчик комиксов накладываемыми наклейками". Это удобный дополнительный редактор для разметки наклеек с помощью мыши, так как стандартный подход предполагает простановку координат только вручную | + | |
- | + | ||
- | === Общий вид === | + | |
- | + | ||
- | @ко,орд,ина,ты | + | |
- | # | + | |
- | ~ | + | |
- | @ко,орд,ина,ты | + | |
- | Здесь текст перевода. Это текстовая наклейка,\\ а выше – [[#маски|маскирующая]], и в ней указан белый фон | + | |
- | ~ | + | |
- | + | ||
- | Между собой наклейки одинакового типа придерживаются приоритетности описания – которая ниже описана, та и будет налегать поверх. Расположение маскирующих наклеек всегда подлежащее текстовым, независимо от порядка описания. Однако эстетичнее придерживаться координатной связности – маска, расположенный на ней текст, на новом месте следующая маска, расположенный на ней текст... Такой способ легче сопровождается между разными языками перевода. Это можно поправить вручную после разметки | + | |
- | + | ||
- | === Интерфейс === | + | |
- | + | ||
- | CoTAN-редактор имеет 4 режима работы: | + | |
- | * "Оригинал" – для обзора исходной картинки | + | |
- | * Прячет все наработки | + | |
- | * "Маски" – для перекрывания оригинального текста на картинке цветом фона | + | |
- | * Они содержат только [[#маски|код цвета фона]], иной текст, поставленный в них, обращает их в текстовые | + | |
- | * <fc #FF0000>Собственный функционал цветовыбирателя пока не реализован</fc> | + | |
- | * Но можно получить цвет с картинки с помощью браузерного плагина-пипетки или даже инструментом, встроенным в браузерную консоль | + | |
- | * "Тексты" – для перевода | + | |
- | * О стилизации текстов можно прочитать на [[./11styles|предыдущей странице]] Справочной | + | |
- | * При редактировании все наклейки на время делаются прозрачными, чтобы видеть оригинальный текст | + | |
- | * "Осмотр" – для обзора результатов работы | + | |
- | Сохранение правок в CoTAN-редакторе не означает последующего автосохранения и в базовом редакторе! Вдруг в базовом редакторе надо что-то ещё подправить? | + | |
- | + | ||
- | === Обзорные видео === | + | |
- | + | ||
- | Для перевода свежего выпуска\\ | + | |
- | {{youtube>Kb1CWfnKQlo?medium}} | + | |
- | + | ||
- | Для переделки из старого редактора AIMG | + | |
- | {{youtube>glYz4eY9IzE?medium}} | + | |
- | + | ||
- | === AIMG для ленивых === | + | |
- | + | ||
- | При нежелании заниматься фонами, можно проставить более примитивную AIMG-разметку. Старый редактор одновременно с новым работать не может, так что метод получения разметки через CoTAN-редактор несколько неординарный: | + | |
- | * Открыть CoTAN-редактор, фиолетовая кнопка | + | |
- | * [[#маски|Маски]] размечать бесполезно, их в отдельности в AIMG не существует, а текстовые можно назвать маско+текстовыми | + | |
- | * Выбрать [[#интерфейс|режим "Тексты"]] | + | |
- | * Разметить наклейки не с отступами, описанными в вышеуказанных видео, а с охватом баллона целиком | + | |
- | * Сохранить правки, вернуться в базовый редактор | + | |
- | * Поменять вручную открывающий **__и закрывающий__** теги cotan на aimg | + | |
- | * Нижеописанные [[#повороты]] и [[#скругления]] также работают и в AIMG | + | |
- | * Не забыть сохранить правки в базовом редакторе! | + | |
- | + | ||
- | === Координаты наклеек === | + | |
- | + | ||
- | Система координат здесь отличается от привычной со школы [[wr>Прямоугольная система координат|декартовой]] тем, что высота (Y) обёрнута вниз, то есть началом отсчёта является левый верхний угол картинки и отсчёт в пикселях идёт всегда вправо и вниз. В дальнейших примерах используем образец **__@37,25,419,112__**. Это полезно знать для ручного исправления неточно поставленной наклейки. Первая и вторая цифры отвечают за расположение наклейки на картинке и могут выходить за её края, вечноположительные третья и четвёртая отвечают за размеры наклейки. Заметьте, с отношениями "верх-низ" связаны первая и четвёртая цифры, а с отношениями право-лево – вторая и третья. Координаты понимают операции сложения и вычитания (но только один раз) – это также удобно для отладки неточностей | + | |
- | + | ||
- | Поиграем с высотой... | + | |
- | * @37,25,419,112**__+10__** – наклейка расширилась вниз на 10 пикселей | + | |
- | * @37**__-10__**,25,419,112**__+10__** – вверх на 10 пикселей | + | |
- | * @37**__-10__**,25,419,112**__+20__** – и вверх, и вниз | + | |
- | + | ||
- | ...и шириной | + | |
- | * @37,25,419**__+10__**,112 – вправо на 10 пикселей | + | |
- | * @37,25**__-10__**,419**__+10__**,112 – влево на 10 пикселей | + | |
- | * @37,25**__-10__**,419**__+20__**,112 – и влево, и вправо | + | |
- | + | ||
- | === Повороты === | + | |
- | + | ||
- | Для наклона добавим через запятую угол наклона в градусах | + | |
- | * @37,25,419,112**__,90__** – и наклейка встанет вправо на бок | + | |
- | * @37,25,419,112**__,-90__** – или то же влево | + | |
- | * @37,25,419,112**__,-270__** – и снова вправо, так как -270 угловых градусов = +90 | + | |
- | Обычно повороты применимы для текстовых наклеек (и AIMG'овских маско+текстовых), но бывают случаи надобности и для маскирующих | + | |
- | + | ||
- | === Маски === | + | |
- | + | ||
- | Посмотрим на вторую строку наклейки: | + | |
- | + | ||
- | @37,25,419,112 | + | |
- | # | + | |
- | ~ | + | |
- | + | ||
- | Знак # с начала строки обозначает отношение этой наклейки к маскирующим наклейкам. Соответственно, начинаться непосредственно с этого символа содержимое текстовой наклейки не может – можно использовать стандартные <nowiki>%%вики-методы%%</nowiki> экранирования или просто начальный пробел. После знака # может идти 3 или 6 символов, соответствующих трёх- либо шестисимвольному RGB-коду цвета фона, вне зависимости от РЕГИСТРА знаков. Белый фон наиболее часто встречающийся и для него сделано упрощение – равнозначны не только #fff и #ffffff, но и простой #, как в примере выше | + | |
- | + | ||
- | Такая гибкость настройки в сочетании с управлением цветом перевода позволяет сделать, например, на чёрном фоне (#000) серый текст (смотреть пиктограм-группу {{/wiki/pg/color_picker.png}}): | + | |
- | + | ||
- | @37,25,419,112 | + | |
- | #000 | + | |
- | ~ | + | |
- | @37,25,419,112 | + | |
- | <fc #808080>Серый текст</fc> | + | |
- | ~ | + | |
- | + | ||
- | === Скругления === | + | |
- | + | ||
- | По умолчанию [[#маски|маскирующие]] и AIMG'овские маско+текстовые наклейки имеют скругление уголков в 10% ширины и высоты всей наклейки, и его можно настроить ещё одной группой координат, отделённых от основы точкой с запятой. Простое число приравнивается к числу пикселей (20 = 20px). Поддерживаются все единицы CSS (кроме ключевых слов small, large и т.п.) – px, ex, абсолютные 1in = 6pc = 72pt = 2.54cm = 25.4mm, em и %. Конкретно для скруглений рекомендуются последние два из-за автомасштабирования при изменениях основных координат наклеек | + | |
- | * @37,25,419,112 – автоскругление всех углов на 10%, сокращаем: | + | |
- | * @37,25,419,112**__;10%,10%,10%,10%__** – ровно то же самое | + | |
- | + | ||
- | Настройка возможна как персонально для каждого уголка по схеме ↖,↗,↘,↙ ... | + | |
- | * @37,25,419,112**__;4em,3em,2em,1em__** – скругления уменьшаются по часовой стрелке | + | |
- | * @37,25,419,112**__;3em,4em,1em,2em__** – против часовой стрелки | + | |
- | + | ||
- | ...так и с разной степенью группировки. Если значение не указано, оно равно значению левее | + | |
- | * @37,25,419,112**__;4em,4em,4em,4em__** – скругление на 4em по всем углах, сокращаем: | + | |
- | * @37,25,419,112**__;4em,,,__** – ровно то же самое | + | |
- | * @37,25,419,112**__;4em,4em,2em,2em__** – попарно, снизу скруглено чуть слабее – в комиксах такая форма часто случается | + | |
- | * @37,25,419,112**__;4em,,2em,__** – ровно то же самое, последнюю запятую тоже можно опустить | + | |
- | + | ||
- | * @37,25,419,112**__;,,,__** – если всё пусто, то берётся умолчание 10% – надо ли говорить о ненужности запятых и точки с запятой? | + | |
- | * @37,25,419,112**__;,,2em,__** – образец для домашнего задания. Ответ заретуширован: <fc #FFFFFF>10%,10%,2em,2em</fc> | + | |
- | * @37,25,419,112**__;0__** – жёсткий прямоугольник | + | |
- | + | ||
- | И наконец эллиптические углы форматируются так: | + | |
- | * @37,25,419,112**__;2em 4em,1em 3em,2em 5em,1em 4em__** – 4 разных эллиптических угла | + | |
- | * @37,25,419,112**__;2em 4em,2em 4em,2em 4em,2em 4em__** – передача значений также касается и таких углов: | + | |
- | * @37,25,419,112**__;2em 4em,,,__** – ровно то же самое | + | |
===== Горячие клавиши ===== | ===== Горячие клавиши ===== | ||
- | [back] | + | {{page>accesskey&noheader}} |
- | + | ||
- | Помимо банальной мышки доступны ещё три способа перемещения по сайту: | + | |
- | * с помощью браузерных клавиш "[[#accesskey]]" | + | |
- | * [[#контрол-навигация]] как у [[http://artlebedev.ru|Артемия Лебедева]] | + | |
- | * и [[#юзерскрипт]]-автолистатель для особо ленивых :) | + | |
- | + | ||
- | ==== Accesskey ==== | + | |
- | + | ||
- | И сначала следует узнать, какие функциональные клавиши ваш браузер требует зажимать перед применяемой буквой: | + | |
- | + | ||
- | |< 33% - 150px 150px 150px >| | + | |
- | ^ ^ Windows ^ Linux ^ Mac ^ | + | |
- | ^ {{/wiki/browsers/sf.png?32&nolink}}\\ Safari | ''Alt'' + accesskey | - | ''Ctrl'' + ''⌥ Opt'' + accesskey | | + | |
- | ^ {{/wiki/browsers/ff.png?32&nolink}}\\ Firefox | ''Shift'' + ''Alt'' + accesskey || ::: | | + | |
- | ^ {{/wiki/browsers/ch.png?32&nolink}}\\ Chrome | ''Alt'' + accesskey || ::: | | + | |
- | ^ {{/wiki/browsers/op.png?32&nolink}}\\ Opera 15+ | ''Alt'' + accesskey || ''⌥ Opt'' + accesskey | | + | |
- | ^ {{/wiki/browsers/op.png?32&nolink}}\\ Opera 12- | ''Shift'' + ''Esc'' + accesskey ||| | + | |
- | ^ {{/wiki/browsers/ie.png?32&nolink}}\\ IE | ''Alt'' + accesskey | - | ? | | + | |
- | + | ||
- | А теперь буквы: | + | |
- | * Везде | + | |
- | * Поле поиска - F (от слова find) | + | |
- | * Правка - E (edit) | + | |
- | * В комиксе | + | |
- | * Назад - P (previous) | + | |
- | * Вперёд - N (next) | + | |
- | * В индекс - X | + | |
- | * Поле номера - Z | + | |
- | * Галочка "Показать перевод" - T (translation) | + | |
- | * В редакторе | + | |
- | * Сохранение - S (save) | + | |
- | * Просмотр - P (preview) | + | |
- | * Отмена правки/Показать страницу - W | + | |
- | * {{/wiki/pg/bold.png?nolink}} - B (bold, жирный) | + | |
- | * {{/wiki/pg/italic.png?nolink}} - I (italic, курсив) | + | |
- | * {{/wiki/pg/underline.png?nolink}} - U (underline, подчерк) | + | |
- | * {{/wiki/pg/mono.png?nolink}} - M (monotype, моноширинный) | + | |
- | * {{/wiki/pg/strike.png?nolink}} - D (delete, зачёркнутый) | + | |
- | * {{/wiki/pg/h1.png?nolink}} - 1 (размеры заголовков) | + | |
- | * {{/wiki/pg/h2.png?nolink}} - 2 | + | |
- | * {{/wiki/pg/h3.png?nolink}} - 3 | + | |
- | * {{/wiki/pg/h4.png?nolink}} - 4 | + | |
- | * {{/wiki/pg/h5.png?nolink}} - 5 | + | |
- | * {{/wiki/pg/link.png?nolink}} - L (link, ссылка) | + | |
- | * {{/wiki/pg/ol.png?nolink}} - - (номерной список) | + | |
- | * {{/wiki/pg/ul.png?nolink}} - . (неномерной список) | + | |
- | * {{/wiki/pg/sig.png?nolink}} - Y (подпись) | + | |
- | * Котан-редактор - C | + | |
- | * В котан-редакторе | + | |
- | * Применить - G | + | |
- | * Отменить - X | + | |
- | + | ||
- | ==== Контрол-навигация ==== | + | |
- | + | ||
- | * В комиксе | + | |
- | * Назад - [Ctrl] + [←] | + | |
- | * Вперёд - [Ctrl] + [→] | + | |
- | * В индекс - [Ctrl] + [↑] | + | |
- | + | ||
- | ==== Юзерскрипт ==== | + | |
- | + | ||
- | - Нужно браузерное расширение Tampermonkey ([[https://addons.mozilla.org/ru/firefox/addon/tampermonkey|Firefox]], [[https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=ru|Chrome, Opera 15+, Яндекс.Браузер и т.п.]]) | + | |
- | - {{/wiki/us/autolister.user.js|Юзер-скрипт с таймером}} - при клике на ссылку расширение предложит окно с автоустановкой скрипта | + | |
===== Рейтинги ===== | ===== Рейтинги ===== | ||
- | Все комиксы должны быть отмечены звёздами, **вращение** которых отмечает ещё выпускающиеся комиксы, а **цвет** обозначает охват переводом, независимо от его качества. Зачёта достойна хотя бы черновая разметка наклеек по синтаксису AIMG (прямоугольные скругленные наклейки с фоном) c переведёнными текстами в них. Переводом для рейтинга не признаются: | + | {{page>ratings&noheader}} |
- | * размещённый на странице скрипт с речью персонажей, неважно, на языке оригинала или уже переведённый, | + | |
- | * первичная разметка с замазанным оригинальным текстом | + | |
- | * отфотошопленные абы как изображения | + | |
- | + | ||
- | **Обозначения звёзд** | + | |
- | ^ Переведено в комиксе ^ Комикс закончен ^ Комикс выходит ^ | + | |
- | ^ < 25% | *PUST* | @PUST@ | | + | |
- | ^ 25% - 50% | *BRNZ* | @BRNZ@ | | + | |
- | ^ 50% - 95% | *SILV* | @SILV@ | | + | |
- | ^ > 95% | *GOLD* | @GOLD@ | | + | |
- | + | ||
- | При этом уже достигнутый ранг не снижается ситуативно, например, выходящий комикс с полностью переведёнными 15 выпусками нет смысла ронять в "серебро" при выходе нового выпуска. однако если перевод будет заброшен надолго, то при периодической проверке рейтингов проводится коррекция. | + | |
- | + | ||
- | Состояние перевода следует отмечать цветом Заметки: | + | |
- | <note tip>Перевод активен</note> | + | |
- | <note important>Завис</note> | + | |
- | <note warning>Всё совсем плохо</note> | + |