Новий вигляд документації Ruby

Опублікував Stan Lo 23-12-2025
Переклав: Andrii Furmanets

Слідом за ре-дизайном ruby-lang.org, ми маємо більше новин, щоб відсвяткувати 30-річчя Ruby: docs.ruby-lang.org має повністю новий вигляд завдяки Aliki — новій темі за замовчуванням для RDoc.

Свіжий погляд на документацію Ruby

Ruby завжди було приємно писати, і тепер читання документації Ruby може відповідати цьому досвіду. Aliki привносить сучасний, чистий дизайн на docs.ruby-lang.org та будь-який гем, що генерує документацію за допомогою RDoc v7.0+.

Ключові особливості

• Покращений пошук: Ранжування з урахуванням регістру, нечіткий пошук (fuzzy matching) та підтримка пошуку констант
• Темний режим: Поважає налаштування вашої ОС з можливістю ручного перемикання
• Макет з трьома колонками: Ліва бічна панель для навігації, центр для контенту, права бічна панель для змісту
• Покращення блоків коду: Кнопки копіювання на блоках коду та підсвічування синтаксису C
• Налаштовуваний футер: Підтримувачі гемів можуть додавати посилання на свій репозиторій, трекер проблем та інші ресурси

Для авторів Gem

Якщо ви генеруєте документацію за допомогою RDoc 7.0+, ваші користувачі автоматично побачать Aliki. Ви можете налаштувати посилання у футері або переключитися назад на тему Darkfish у вашому файлі .rdoc_options.

Спробуйте

Подивіться на новий вигляд у дії на docs.ruby-lang.org.

Якщо ви знайдете проблеми або маєте пропозиції, будь ласка, відкрийте проблему на GitHub.