Поиск по сайту:

tldr Преобразует справочные страницы в краткие пояснения на простом английском языке


Пользователи командной строки знают, как читать руководство: введите «man», а затем название команды — вы увидите подробное объяснение. Эти руководства полезны, но многословны, в них используются сотни слов для объяснения каждой детали команды.

Это нормально, когда вы хотите знать все, но чаще всего вы ищете одно конкретное использование. Вместо этого проект tldr содержит краткие пояснения и позволяет найти любое приложение, набрав «tldr» и имя команды. Он идеально подходит, когда вам нужно быстро освежить свои знания, и поддерживается в системах Linux и Mac.

Использование tldr для быстрого поиска того, что делает команда

Допустим, вы забыли тонкости использования cd, команды для смены папок. Вы можете ввести man cd, но результаты не будут простыми.

Если у вас установлен tldr, вместо этого введите tldr cd. Вы увидите только самые важные моменты.

Легко представить, что это пригодится. Вы забыли, как обновлять пакеты в Ubuntu? Просто введите tldr apt-get.

Или, может быть, вы не совсем помните, как размонтировать диски с помощью diskutil в macOS:

Вы поняли идею: это быстрый способ посмотреть, что делает практически любая команда. Я не смог найти много распространенных команд, которые не поддерживались, но если вы все же загляните на страницу вкладов, чтобы узнать, как отправлять свои собственные резюме.

Установка tldr на macOS и Ubuntu

Установить tldr на macOS легко с помощью Homebrew, менеджера пакетов для macOS. Установите Homebrew, затем используйте команду brew install tldr, и все готово. Вы можете начать использовать tldr прямо сейчас!

У меня было немного больше проблем с Ubuntu, потому что на момент написания этой статьи tldr не предлагался ни в одном репозитории. Но нетрудно заставить это работать с небольшой работой.

Сначала установите NodeJS и диспетчер пакетов Node (nps):

sudo apt install nodejs npm

Затем используйте npm для установки tldr:

sudo npm install -g tldr

Теперь вы должны иметь возможность использовать tldr, но у меня были проблемы с Ubuntu 16.04: я видел ошибку о том, что «нет такого файла или каталога» как node. Решение состояло в том, чтобы создать символическую ссылку:

sudo ln -s /usr/bin/nodejs /usr/bin/node

Сделайте это, и tldr должен быть запущен и работать в Ubuntu. Как всегда, эти шаги могут различаться в зависимости от того, какой дистрибутив Linux вы используете.

…или просто используйте веб-версию

Использование tldr из командной строки имеет смысл, потому что это место, где вы вводите свои команды. Но это не обязательно: на tldr.ostera.io есть отличная веб-версия, и стоит добавить в закладки, если не получается установить вышеуказанные версии.

Там даже есть ссылка на редактирование, на случай, если вы увидите ошибку. Наслаждаться!