~funderscoreblog cgit wikiget in touch

Вимикання дії AttachFile

Дія AttachFile дозволяє додавати до сторінки декілька файлів.

Оскільки при неправильному застосуванні відвантаження файлів може спричинити DoS-атаки (відмову обслуговування), адміністратор має можливість для вимикання дії AttachFile. Подробиці дивіться на сторінці Налаштовування МоінМоін.

Створення вкладень

Для вкладання файлу можна або додати до сторінки посилання на вкладення (нижче описано як це робити), або натисніть на посиланні Вкладення знизу сторінки. У першому випадку, після збереження сторінки ви побачите посилання Відвантажити нове вкладення. Натиснувши на ньому ви перейдете до сторінки відвантаження, так само як і при безпосередньому натисканні на посиланні Вкладення.

Форма відвантаження складається з двох полів. Окрім поля імені файлу ще є необов'язкове поле (Перейменувати на ), якщо треба призначити файлу іншу назву ніж він має у вашому комп'ютері.

Існуючі вкладення можна переглядати, завантажувати чи видаляти, залежно від конфігурації вікі та прав доступу користувача. Наприклад, вкладення не може видалити користувач, який не має права delete на цій сторінці.

Будь-яке відвантаження чи видалення файлів впливає на ОстанніЗміни і тому потраплятиме до огляду. На відміну від редагування сторінок, для вкладень не ведеться історія, тож зберігайте локальну копію файлів для відновлення після вандалізму.

Вивід інформації про вкладення

Є два макроси, які виводять інформацію про вкладення на сторінках. Макрос <<AttachInfo>> виводить коротке речення про будь-які вкладення:

There are 10 attachment(s) stored for this page.

Макрос <<AttachList>> виводить список вкладених у сторінку файлів:

  • [get | view] (2018-09-09 17:46:35, 7.4 KB) [[attachment:move_example1.png]]
  • [get | view] (2018-09-09 17:46:35, 4.8 KB) [[attachment:move_example2.png]]
  • [get | view] (2018-09-09 17:46:35, 3.7 KB) [[attachment:unzip1.png]]
  • [get | view] (2018-09-09 17:46:35, 6.6 KB) [[attachment:unzip2.png]]
  • [get | view] (2018-09-09 17:46:35, 3.1 KB) [[attachment:unzip3a.png]]
  • [get | view] (2018-09-09 17:46:35, 13.4 KB) [[attachment:unzip3b.png]]
  • [get | view] (2018-09-09 17:46:35, 5.5 KB) [[attachment:unzip5.png]]
  • [get | view] (2018-09-09 17:46:35, 4.0 KB) [[attachment:unzip6.png]]
  • [get | view] (2018-09-09 17:46:35, 5.3 KB) [[attachment:unzip6b.png]]
  • [get | view] (2018-09-09 17:46:35, 3.2 KB) [[attachment:unzip7.png]]
 All files | Selected Files: delete move to page copy to page

Він має два необов'язкові параметри:

Посилання на вкладення

Щоб зробити на сторінці посилання на вкладення, вкажіть attachment:назвафайлу.ext або [[attachment:файл з пробілами.txt]].

Не використовуйте URL посилання [взяти], яке можна побачити на сторінці відвантаження вкладень, оскільки ці посилання можуть змінитися при зміні налаштувань вікі. Щоб додати посилання на вкладення з інших сторінок вкажіть attachment:ВікіНазва/назвафайлу.ext.

attachment: (або при використанні синтаксису у квадратних дужках) буде завжди вказувати на ціль.

Вбудовування вкладень

Якщо треба вбудувати файл, використовуйте синтаксис {{attachment:image.png}}. При вбудовуванні деякі типи файлів можуть бути особливо оформлені (наприклад, виділені кольором), залежно від підтримки моін файлів цього типу mime.

Редагування векторної графіки

Посилання, що виглядають як drawing:назвамалюнку дозволяють інтерактивне редагування діаграм у вбудованому аплеті Java. Аплет збереже три вкладення, "назвамалюнку.draw", "назвамалюнку.png" та "назвамалюнку.map". Після першого збереження малюнку, створене зображення PNG відображається у посиланні типу drawing:. MAP використовується для активації посилань на частинах зображення. Тобто, для редагування потрібно увімкнути підтримку Java, а відображення результатів роботи можливе у будь-якому веб-переглядачі.

Для редагування малюнку після першого збереження, натисніть на Вкладення та скористайтесь посиланням [виправити], що відображається замість [переглянути] для вкладення типу .draw. Також для переходу у режим редагування можна клацнути на невидимій рамці розміром 5 точок навколо зображення. При збереженні зображення відображається запис на сторінці ОстанніЗміни.

Докладну інформацію щодо роботи аплету можна знайти на сторінці Plugins/TWikiDrawPlugin.

Встановлення пакетів

Дивіться ДовідкаВстановленняПакетів.

Розпаковування файлів

Щоб отримати доступ до властивості розпаковування файлів на сторінці слід вказати наступні права:

наприклад

#acl ПевнийКористувач:admin,read,write,delete All:read

Ми реалізувати певний захист сервера від некоректного використання цієї функції. Zip-файл запакований у Zip-файлі відкидається без розпаковування. При визначенні параметру конфігурації unzip_attachments_space, можна встановити обмеження у байтах на розпаковування файлів. Якщо у каталозі вже є файли, їх розмір віднімається від цього числа. Розмір одного файлу у архіві, який буде розпаковуватися можна обмежити параметром конфігурації unzip_single_file_size. У unzip_attachments_count можна обмежити кількість файлів, які розпаковуються з zip-файлу.

Правила розпаковування реалізовані таким самим чином як і відвантаження файлу. Не припускається перезаписувати файл шляхом розпаковування його з архіву.

При розпаковуванні zip-файлу розпаковуються файли лише з першого рівняю Файли у каталогах ігноруються.

Коректний zip-файл можна створити наступним чином:

zip приклад.zip *.jpg

Розпаковування zip-файлу

Після відвантаження zip-файлу, ви побачите посилання unzip.

Немає прав для розпаковування

Якщо бракує пав для розпаковування, ви побачите лише звичайне діалогове вікно.

Не вистачає вільного місці

Якщо файли, що розпаковуються перевищують обмеження на розмір вкладень, ви побачите попередження.

Успішне розпаковування

unzip3a.png
unzip3b.png

Розпаковані файли можуть бути надто великими

Якщо розмір файлу у архіві перевищує визначений у параметрі unzip_single_file_size файл не розпаковується.

zip-файли у zip-файлі ігноруються

Якщо zip-файли включені до zip-архіву, вони пропускаються при розпаковуванні. Звичайні файли будуть розпаковані.

Тож відомий 42.zip не впливає на систему.

переміщення файлу

Дія "перемістити" для посилання відображається для кожного вкладеного файлу, якщо ви маєте на право "delete" на сторінці з вкладенням.

move_example1.png

Просто натисніть на "перемістити", відкриється наступне діалогове вікно:

move_example2.png

Тепер можна або просто перейменувати файл (він залишається вкладеним у цю сторінку) або перемістити файл на іншу сторінку (та потім перейменувати його, за потреби). Вам потрібно право "write" на цільовій сторінці (також цільова сторінка вже має існувати).