====== Изображения и другие файлы ====== (tab)С внешними файлами всё просто - указываем их путь в двойных фигурных скобках: {{http://php.net/images/php.gif}} {{http://php.net/images/php.gif}} (tab)Внутренние файлы предварительно требуется загрузить в вики. Ничто не вечно в интернете, вполне может сломаться любой внешний хостинг. Также функционал спецплагина, упомянутого ниже, с внешними файлами работает недостаточно правильно Структура медиа-папок сайта, хранящихся отдельно от папок со статьями, может быть сходной с ними. Это сильно упрощает адресацию файлов в статьях ===== Загрузка файлов ===== (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 }} Обычно подобный сервис совершенно не нужен - удаляйте лишние детали синтаксиса * если это не картинка - ссылка отправится сразу в редактор (пример презентации {{sample_present.ppt}}) и будет снабжена файл-иконкой Некоторые расширения файлов вовсе не допускаются к загрузке (обратитесь к [[user>Робот]] за разъяснениями) (tab)Обратите внимание на правые пиктограммы в строках списка: первая позволяет посмотреть метатеги и сам файл в оригинальном виде, третья - удалить этот файл, если у вас достаточно прав в данной папке, вторая - "Управление медиафайлами" {{.:pg:mediamanager.png?nolink}} - включает расширенную, встроенную в страницу сайта версию медиа-менеджера. Её преимущества - возможность поиска, сортировки, просмотра истории версий файлов {{ media4.png }} ===== Названия и подписи ===== (tab)При необходимости дописываем через знак %%|%% название, которое будет видно при наведении мыши на картинку: {{dokuwiki-128.png|Логотип}} {{dokuwiki-128.png|Логотип}} (tab)UPD. Специальным плагином добавлена возможность обозначить файл подписью, знакомой по Википедии. Для этого нужно взять весь синтаксис в квадратные одинарные скобки: [{{dokuwiki-128.png|Логотип}}] [{{dokuwiki-128.png|Логотип}}] ===== Масштабирование ===== (tab)Масштабирование по заданной ширине: {{dokuwiki-128.png?50}} {{dokuwiki-128.png?50|Логотип}} [{{dokuwiki-128.png?50|Логотип}}] {{dokuwiki-128.png?50}} {{dokuwiki-128.png?50|Логотип}} [{{dokuwiki-128.png?50|Логотип}}] Обратите внимание, что файл с подписью переносится сам, кроме того, у него имеется иконка для просмотра в оригинальном масштабе (tab)Масштабирование по ширине и высоте с помощью латинской буквы "икс"; если пропорции заданной ширины и высоты не совпадают с изображением, оно будет обрезано перед масштабированием: {{dokuwiki-128.png?200x50}} {{dokuwiki-128.png?200x50|Логотип}} [{{dokuwiki-128.png?200x50|Логотип}}] {{dokuwiki-128.png?200x50}} {{dokuwiki-128.png?200x50|Логотип}} [{{dokuwiki-128.png?200x50|Логотип}}] ===== Выравнивание ===== (tab)Оставляя пробелы вокруг ссылки, можно осуществлять выравнивание изображений: {{ dokuwiki-128.png}} {{dokuwiki-128.png }} {{ dokuwiki-128.png }} {{ dokuwiki-128.png}} {{dokuwiki-128.png }} {{ dokuwiki-128.png }} В случае выравнивания "боковое-боковое-центральное" картинки прекрасно выстраиваются в одну строку. Впрочем, можно не применять выравнивания вовсе (tab)Масштабирование в таком случае жёстко прикрепляется к расширению файла; ниже некорректный пробел, обозначенный подчёркиванием, игнорируется, в итоге третья картинка считает себя выровненной вправо: {{ dokuwiki-128.png?200x50 }} {{ dokuwiki-128.png_?200x50 }} = {{ dokuwiki-128.png?200x50 }} {{ dokuwiki-128.png_?200x50}} = {{ dokuwiki-128.png?200x50}} {{ dokuwiki-128.png?200x50 }} {{ dokuwiki-128.png ?200x50 }} {{ dokuwiki-128.png ?200x50}} (tab)Поскольку надписи могут заканчиваться пробелом по недосмотру составителя, этот пробел считается частью надписи и не может быть управляющим в выравнивании; здесь ситуация с третьей картинкой аналогичная: {{ dokuwiki-128.png |Логотип1}} {{ dokuwiki-128.png |Логотип2_}} = {{ dokuwiki-128.png |Логотип1}} {{ dokuwiki-128.png|Логотип3_}} = {{ dokuwiki-128.png|Логотип3}} {{ dokuwiki-128.png |Логотип1}} {{ dokuwiki-128.png |Логотип2 }} {{ dokuwiki-128.png|Логотип3 }} (tab)Поведение плагина подписей идентично: [{{ dokuwiki-128.png |Логотип1}}] [{{ dokuwiki-128.png |Логотип2_}}] = [{{ dokuwiki-128.png |Логотип1}}] [{{ dokuwiki-128.png|Логотип3_}}] = [{{ dokuwiki-128.png|Логотип3}}] [{{ dokuwiki-128.png |Логотип1}}] [{{ dokuwiki-128.png |Логотип2 }}] [{{ dokuwiki-128.png|Логотип3 }}] ===== Комплексный пример ===== (tab)Масштабированное изображение с выравниванием и подписями: {{ dokuwiki-128.png?200x50 |Логотип}} [{{ dokuwiki-128.png?200x50 |Логотип}}] {{ dokuwiki-128.png?200x50 |Логотип}} [{{ dokuwiki-128.png?200x50 |Логотип}}] [[3syntax|Назад]] : [[5links|Далее]]