Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions ru/news/_posts/2025-12-23-new-look-for-ruby-documentation.md
Original file line number Diff line number Diff line change
@@ -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/
Loading