Страницы TLDR
 | |
 Скриншот CLI- клиента для tldr-pages | |
| Оригинальный автор(ы) | Ромен Прието |
|---|---|
| Первоначальный выпуск | 8 декабря 2013 г. [1] ( 2013-12-08 ) |
| Репозиторий | github.com/tldr-pages/tldr |
| Написано в | Уценка |
| Платформа | Мультиплатформенность |
| Доступно в | Немецкий , испанский , фарси , французский , индонезийский , итальянский , японский , корейский , малаялам , голландский , норвежский , португальский , русский , шведский , словенский , хинди , тамильский , тайский , турецкий , китайский , украинский , арабский , бенгальский , боснийский , каталонский , персидский |
| Тип | Документация по программному обеспечению |
| Лицензия | Лицензия CC BY-SA 4.0 MIT |
| Веб-сайт | tldr.sh |
TLDR Pages (стилизовано как tldr-pages ) — это бесплатный и открытый проект совместной документации программного обеспечения , который стремится стать более простым и доступным дополнением к традиционным man pages . Это коллекция поддерживаемых сообществом страниц справки, которые охватывают утилиты командной строки и другие компьютерные программы. Страницу можно вызвать, введя tldr команду . [2] [3] Название происходит от слова TL;DR , которое является аббревиатурой от «слишком длинный; не читал», имея в виду man pages , которые, по словам нескольких пользователей, слишком длинные. [4]
По состоянию на август 2024 года его репозиторий на GitHub имеет более 50 000 звезд и 4 100 форков. [5]
История
Ромен Прието начал проект, сделав первый коммит на популярном сайте хостинга кода и контроля версий GitHub 8 декабря 2013 года в 19:56:16 по часовому поясу своего персонального компьютера . [1]
Сначала в проект вносило свой вклад лишь несколько человек. К концу 2015 года, с помощью неизвестных китайских изданий, продвигающих его, проект стал стремительно набирать популярность на GitHub , оставив позади популярное программное обеспечение и языки программирования, такие как Swift . [6] 25 декабря 2015 года проект оказался на 3-м месте в тренде. [7] К 27 декабря 2015 года репозиторий достиг 2700+ звезд, набрав примерно 700 из них всего за неделю. [8] На следующий день проект попал на первую страницу Hacker News . [9] После публикации количество звезд, полученных проектом, достигло 3700+, а сам проект в течение дня занял первое место по ежедневной популярности. [10] [11] Проект пережил еще один скачок в конце 2017 года и позже сохранял стабильный рост популярности по сей день. [12]
Форматирование
По умолчанию для форматирования страниц tldr используется Markdown — популярный язык разметки, используемый во многих других проектах свободного программного обеспечения и документации. [13]
Хотя проект имеет собственное пользовательское {{token_syntax}}расширение, он придерживается спецификации CommonMark . Фактически спецификации проекта требуют, чтобы клиенты были полностью совместимы с CommonMark .
Использование команды
Получите типичные примеры использования команды:
команда tldr Чтобы увидеть, что можно сделать, вот довольно хорошая команда:
вкратце вкратцеПоказать страницу tar TLDR для Linux:
tldr -p линукс tarПолучить справку по подкоманде Git:
tldr git-checkoutОбновление локальных страниц (если клиент поддерживает кэширование):
tldr -uАвторство
Страницы TLDR можно писать в любом текстовом редакторе, поддерживающем форматирование CommonMark . [13]
Чтобы внести свой вклад в репозиторий tldr-pages на GitHub, вам необходимо подписать Лицензионное соглашение участника и следовать рекомендациям проекта, которые, как утверждается, представляют собой не строгие правила, а вспомогательную информацию для сохранения простоты страниц.
Лицензирование
Страницы лицензированы в соответствии с лицензией Creative Commons Attribution 4.0 International , в то время как содержимое каталога scripts/лицензировано в соответствии с лицензией MIT . Любые вклады в проект регулируются лицензионным соглашением участника .
Смотрите также
.svg/1280px-Free_and_open-source_software_logo_(2009).svg.png){kind=logo}
Ссылки
- ^ ab коммит 11264d9b19000734a2d35ecbdbdebc0b0b45aed9
- ^ "Страницы TLDR: упрощенные и поддерживаемые сообществом страницы руководства". Новости Laravel .
- ^ «TLDR — простые для понимания страницы руководства для каждого пользователя Linux». www.tecmint.com . 16 января 2019 г.
- ^ "Страницы TLDR: Упрощенные страницы руководства, поддерживаемые сообществом". 22 января 2020 г.
- ^ /web/20210301121724/https://github.com/tldr-pages/tldr
- ^ "tldr-pages/tldr - Gitter". gitter.im .
- ^ "Monosnap". monosnap.com .
- ^ "tldr-pages/tldr - Gitter". gitter.im .
- ^ "Страницы TLDR | Hacker News". news.ycombinator.com .
- ^ "tldr-pages/tldr - Gitter". gitter.im .
- ^ @asyncadventures (28 декабря 2015 г.). «Иногда небольшой сторонний проект полезен другим людям и становится трендом :) Спасибо всем, кто внес вклад в TLDR!» ( Твит ) – через Twitter .
- ^ "Star history". star-history.t9t.io . Архивировано из оригинала 18 февраля 2021 г. . Получено 13 января 2022 г. .
- ^ ab "tldr-pages/tldr". Гитхаб . 23 ноября 2021 г.
Внешние ссылки
- Официальный сайт
- Репозиторий
- PDF-документация
