Слышали ли вы когда-нибудь фразу: «Открой man-страницу и разберись сам»? Если вы когда-либо сталкивались с командной строкой на компьютере — ну хоть мельком, — скорее всего, да. Для многих пользователей Linux или macOS это классика жанра. Но вот парадокс: большинство этих самых man-страниц написаны, кажется, для людей, у которых дома стоит памятник Unix и портрет Денниса Ритчи на стене. Остальным же, ну… мягко говоря, не всегда просто.
А теперь представьте, что кто-то взял и написал человеческим языком короткие инструкции для всех этих команд. Без лишней теории, без «загонов» про стандарты, просто — вот команда, вот пример, вот что она делает. Не сказка, а реальность. Это и есть TLDR Pages. Нет, серьёзно, именно так они называются.
Почему так?
TLDR — это, если по-русски, «слишком длинно, не стал читать». В интернете эту аббревиатуру используют, когда лень вчитываться в километры текста и хочется суть за минуту. Вот и создатели проекта TLDR Pages решили: а почему бы не сделать такие же короткие, удобные шпаргалки по командам терминала? Для всех. Особенно для тех, кто не живёт с ноутбуком в серверной.
Проект родился в 2013 году — да, ему уже больше десяти лет, не какой-то вчерашний стартап. И за это время набрал кучу сторонников. Знаешь, сколько людей поставили звезду этому репозиторию на GitHub? Больше 56 000. Для справки: если бы это был канал на YouTube, то он бы уверенно вошёл в топы технических блогов.
Как это выглядит на практике
Допустим, ты решил почистить диск на своём компьютере и вспомнил про команду rm. Все знают — она удаляет файлы, но только попробуй ошибиться в синтаксисе… Файл не вернуть, с system32 шутки плохи. Заходишь в man — и там тебе сразу же пятьдесят строчек про какие-то ключи, POSIX-совместимость, указание путей… Не хочется.
А теперь открываешь TLDR-страницу и видишь:
rm
Удаляет файлы или папки.
rm file.txt # удалить файл
rm -r папка/ # удалить папку и всё внутри
rm -f file # удалить без подтверждения
Вот оно, чудо. Всё ясно, наглядно, без лишних нервов. Можно копировать, можно читать по диагонали — всё равно поймёшь, что происходит.
Ещё одна фишка: эти справочники пишутся коллективно. Любой человек — да-да, даже ты — может добавить или поправить пример. Так что всё всегда актуально, ошибок почти не бывает. Если что-то не работает — наверняка уже кто-то это заметил и внёс правку.
Почему TLDR Pages вообще нужны, если есть man-страницы?
Ну, тут есть один нюанс. Man-страницы — это, конечно, здорово. Без них Linux вообще бы не взлетел. Но у них стиль такой… как бы сказать… бездушный, официальный. Иногда даже пугает.
TLDR Pages не заменяют официальную документацию. Это не подробный мануал, а именно «шпаргалка». Если нужен полный расклад по каждому ключу и случаю — да, открывай man. Но если нужно быстро вспомнить, как отправить архив по SSH или подсчитать количество строк в файле, вот тут TLDR спасает.
Да, это не для фанатов глубины. Скорее для тех, кто хочет работать быстро. Особенно если ты не пишешь скрипты сутками, а просто время от времени забегаешь в терминал что-то проверить или исправить. Или, может быть, хочешь выучить что-то новое, но не планируешь уходить с головой в командную строку.
Как использовать TLDR Pages
Тут всё довольно просто, и, если честно, даже приятно. Открываешь сайт tldr.sh — и сразу ищешь нужную команду. Пример: захотел узнать про tar (тот самый, который архивы собирает) — вводишь название, и тебе показывают короткое описание плюс несколько рабочих примеров.
Есть ещё вариант: можно установить специальное приложение или плагин для терминала. Это, кстати, особенно удобно, если ты часто работаешь в командной строке. Ставится оно элементарно, по сути, одна команда — и всё работает. И, что приятно, работает быстро. Вот здесь, кстати, есть нюанс: иногда в зависимости от операционной системы бывают заморочки с установкой — ну, как всегда, то пакет не тот, то версия не совпала. Обычно решается гуглением в стиле «tldr install ubuntu» — и почти всегда находится готовый ответ.
Некоторые даже ставят специальные расширения для любимого редактора — тот же VS Code, например, поддерживает TLDR Pages из коробки через плагины. Это прямо лайфхак, особенно если часто забываешь синтаксис редких команд.
Про коллективный характер проекта
Вот тут, на мой взгляд, самая большая фишка. TLDR Pages не делают какие-то отдельные «гуру», оторванные от реальности. Всё, что появляется в этих шпаргалках, — результат работы огромного сообщества. Обычные люди со всего мира добавляют примеры, предлагают улучшения, следят за актуальностью.
Это значит, что проект не зарастает пылью. Вчера появилась новая команда — сегодня уже есть пример, как её правильно использовать. Исправили ошибку или добавили новую фичу в программу — через пару дней, а то и часов, обновляется TLDR-страница. Тут даже встречаются советы для редких или экспериментальных команд, которые в официальной документации появятся, может быть, через год.
Для кого всё это вообще?
На самом деле, проект TLDR Pages рассчитан почти на всех, кто хоть как-то сталкивается с командной строкой. Это могут быть и студенты, и сисадмины, и просто любопытные пользователи. Многие разработчики признаются, что пользуются TLDR чаще, чем man. Потому что быстро, удобно, не напрягает.
Но если ты работаешь за компьютером давно и привык, что любые вопросы решаются через меню и кнопки, не спеши закрывать вкладку. Даже для «непрограммистов» TLDR может стать палочкой-выручалочкой. Нужно срочно вспомнить, как поменять права на папку? Или как отправить файл по сети? Открыл — посмотрел — сделал.
Иногда, кстати, встречаю скепсис: мол, зачем это всё, ведь есть Google. Но попробуй-ка найти лаконичный, рабочий пример команды, чтобы сразу скопировать в терминал — не всегда просто. TLDR Pages эту задачу решают в разы лучше. Особенно когда интернет под рукой, а времени в обрез.
Почему у TLDR Pages столько звёзд на GitHub?
Возможно, тут секрет прост. Во-первых, проект реально облегчает жизнь, особенно новичкам. Во-вторых, его поддерживает огромное сообщество — более 1 500 участников регулярно вносят свой вклад. В-третьих, всё абсолютно бесплатно и с открытым исходным кодом. Нет рекламы, нет скрытых функций — бери и пользуйся.
Справедливости ради, у TLDR Pages бывают свои минусы. Иногда в примерах не хватает нюансов, или какой-то экзотической команды ещё нет в базе. Но благодаря открытому формату, такие вопросы решаются быстро. Добавил пример сам — помог и себе, и другим.
Интересно, что сама идея TLDR оказалась заразительной. Сейчас появляются «шпаргалки» в таком формате и для других областей: Python, Git, SQL, даже для повседневных задач, вроде горячих клавиш в Windows или настройки роутера. Люди хотят простых объяснений, без бюрократии. Это нормально.
А если вы вдруг решите присоединиться
Да, участвовать в развитии проекта может любой желающий. Не нужен глубокий опыт или крутые знания — иногда достаточно просто добавить пример, который когда-то помог вам самим. Все материалы проходят проверку — так что ошибки ловят быстро, никто не отругает.
Для этого достаточно зайти на страницу проекта на GitHub и посмотреть инструкции. Вся процедура описана очень понятно: как создать новую страницу, как исправить опечатку или предложить свой пример.
Если никогда не работали с GitHub — ну, тут придётся освоить пару новых слов, но сама процедура гораздо проще, чем кажется. Плюс, есть масса подсказок и руководств (в том числе на русском).
Чуть в сторону: почему всё это важно
Понимаешь, в цифровом мире знание командной строки — это что-то вроде второй грамотности. Даже если не используешь её каждый день, иногда без неё никак. А когда рядом есть простой, понятный справочник — не страшно ошибиться, не надо бояться попробовать новое.
К тому же, проекты вроде TLDR Pages воспитывают здоровое сообщество. Тут нет «токсичности», типичной для некоторых форумов, никто не стыдит за «глупые вопросы». Наоборот, каждый новичок может быть уверен — ему помогут и объяснят.
Что дальше?
Вполне возможно, что через пару лет TLDR Pages вырастет во что-то ещё более масштабное. Может быть, появятся интерактивные справочники или голосовые помощники, которые сразу подсказывают команду под задачу. А может быть, и так уже хорошо. Знаешь, иногда хочется, чтобы простые вещи оставались простыми.
Один вопрос остаётся открытым: насколько долго такие проекты смогут держаться на чистом энтузиазме? Но если судить по нынешней популярности — 56 000 звёзд это не шутка — похоже, у TLDR Pages всё впереди.
—
Если интересно покопаться глубже: https://github.com/tldr-pages/tldr