From 8ca1aec0a3cd1a614d0907ba851a8ae32c08a720 Mon Sep 17 00:00:00 2001 From: ablzh <123565843+ablzh@users.noreply.github.com> Date: Wed, 24 Dec 2025 15:12:38 +0800 Subject: [PATCH] Translate A New Look for Ruby's Documentation (ru) --- ...5-12-23-new-look-for-ruby-documentation.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 ru/news/_posts/2025-12-23-new-look-for-ruby-documentation.md diff --git a/ru/news/_posts/2025-12-23-new-look-for-ruby-documentation.md b/ru/news/_posts/2025-12-23-new-look-for-ruby-documentation.md new file mode 100644 index 0000000000..ffae4bba8e --- /dev/null +++ b/ru/news/_posts/2025-12-23-new-look-for-ruby-documentation.md @@ -0,0 +1,34 @@ +--- +layout: news_post +title: "Новый облик документации Ruby" +author: "Stan Lo" +translator: "ablzh" +date: 2025-12-23 00:00:00 +0000 +lang: ru +--- + +Вслед за [редизайном ruby-lang.org](https://www.ruby-lang.org/ru/news/2025/12/22/redesign-site-identity/), у нас есть еще новости в честь 30-летия Ruby: [docs.ruby-lang.org][ruby-doc] получил полностью новый облик с Aliki — новым стандартным шаблоном [RDoc](https://github.com/ruby/rdoc). + +## Свежий взгляд на документацию Ruby + +Писать на Ruby всегда было удовольствием, и теперь чтение документации Ruby может соответствовать этому опыту. Aliki привносит современный и чистый дизайн на [docs.ruby-lang.org][ruby-doc] и в любой гем, который генерирует документацию с помощью RDoc версии 7.0 и выше. + +## Ключевые особенности + +- **Улучшенный поиск**: ранжирование с учетом регистра, нечеткий поиск и поддержка поиска констант. +- **Темная тема**: учитывает настройки вашей ОС с возможностью ручного переключения. +- **Трехколоночный макет**: левая боковая панель для навигации, центральная часть для контента и правая боковая панель для оглавления. +- **Улучшения блоков кода**: кнопки копирования в блоках кода и подсветка синтаксиса C. +- **Настраиваемый футер**: авторы гемов могут добавлять ссылки на свой репозиторий, трекер задач и другие ресурсы. + +## Для авторов гемов + +Если вы генерируете документацию с помощью RDoc 7.0+, ваши пользователи автоматически увидят Aliki. Вы можете настроить ссылки в футере или вернуться к теме Darkfish в вашем файле `.rdoc_options`. + +## Попробуйте сами + +Посмотрите на новый дизайн в действии на [docs.ruby-lang.org][ruby-doc]. + +Если вы обнаружите ошибки или у вас появятся предложения, пожалуйста, [откройте issue](https://github.com/ruby/rdoc/issues) на GitHub. + +[ruby-doc]: https://docs.ruby-lang.org/en/master/