Принципи іменування файлів

У цьому матеріалі ми поговоримо про те, як організувати найменування файлів в проєкті.

Може здатися, що організація файлів — це справа смаку. Але насправді, тут потрібна система. В першу чергу, це корисно для вас: з часом у вас накопичаться сотні й тисячі файлів, і без осмисленого підходу до найменування орієнтуватися в них буде просто неможливо. Крім того, працювати ви будете, швидше за все, в команді. І корисно буде зробити так, щоб у ваших файлах могли розібратися не тільки ви, але й ваші колеги.

Основні принципи

При найменуванні файлів слід використовувати певні принципи. Давайте спочатку перерахуємо їх всі, а потім зануримося в деталі:

У назвах файлів потрібно використовувати виключно латинські літери.
Назви файлів повинні бути осмисленими та відповідати проєкту.
Якщо назва складається з декількох слів, відокремлюйте їх один від одного.
Але при цьому пам'ятайте, що в назвах файлів не можна використовувати пробіли.
Бажано, щоб назви були лаконічними.
Називати файли найкраще англійськими словами.

Тепер про все це докладніше.

Латинські букви в назві

У назві файлів використовуйте тільки латинські букви. Може здатися, що називати файли українською зручніше та зрозуміліше, але це може викликати технічні проблеми: After Effects не сприймає кирилицю. Якщо у вас хоча б один файл названий кирилицею, під час автозбереження After Effects може підвиснути.

Крім букв, можна також використовувати цифри та деякі інші символи — про це поговоримо нижче.

Неправильно

М'ячик.aep
банер1.png
інструкція.mp4

Правильно

ball.aep
banner1.png
instruction.mp4

Осмислені назви

Намагайтеся завжди давати файлам такі назви, щоб ви потім могли зрозуміти, що це таке. Уявіть собі, що вам доведеться на місяць-другий переключитися на інші завдання, а потім знову повернутися до проєкту. Або що до вашої команди приєднається нова людина. Якщо назви файлів осмислені, це заощадить купу часу на занурення в роботу.

Неправильно

1.aep
untitled-copy1.png
new.mp4

Правильно

ball.aep
logo.png
instruction.mp4

Відокремлення слів в назві

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

розділяти слова дефісами,
починати кожне слово з великої літери.

Дефіси між словами (kebab-case)

Цей принцип ще називають kebab-case — на честь східного блюда люля-кебаб, в якому всі інгредієнти нанизують на паличку. Назви, що складені за цим принципом, трохи схожі на люля-кебаб:

first-visit-page.html

Кожне слово з великої літери (CamelCase)

Альтернативний принцип називається CamelCase, тобто «ВерблюжийРегістр». Верблюжим він називається тому, що дві великі літери в слові трохи схожі на верблюжі горби:

FirstPage.html

На практиці застосовуються обидва підходи, але для курсу ми пропонуємо використовувати саме kebab-case. Просто для дотримання порядку.

Неправильно

verticallogo.png
jumpingball.aep
howtoinstall.mp4

Правильно

vertical-logo.png
jumping-ball.aep
how-to-install.mp4

Без пробілів

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

Неправильно

vertical logo.png
jumping ball.aep
how to install.mp4

Правильно

vertical-logo.png
jumping-ball.aep
how-to-install.mp4

Лаконічність

Намагаючись давати файлам зрозуміліші назви, легко перегнути палицю. Занадто довгі та докладні назви теж незручні: їх довго читати, і до того ж іноді інтерфейси їх обрізають, так що ви бачите тільки початок. Намагайтеся вмістити назву в 15-20 символів.

Неправильно

vertical-logo-on-the-black-background.png
first-project-for-the-ALV-company.aep
ball-jumping-along-the-street.mp4

Правильно

vertical-logo-black.png
ALV-1.aep
jumping-ball.mp4

Назви англійською мовою

Англійська мова є стандартом в програмуванні, тому його заведено використовувати і для назв файлів. Крім того, англійська мова лаконічніша і слова в ній зазвичай коротші, ніж в українській. Тож, це допоможе вам дотримуватися й попереднього правила.

Неправильно