ruby-list

Download

ruby-list@ml.ruby-lang.org

July 2026

1 participants
2 discussions

[ruby-list:51038] [ANN] bitclust-core / bitclust-dev / refe2 1.6.0リリース
by Kazuhiro NISHIYAMA 29 Jul '26

29 Jul '26

西山和広です。るりま(Ruby の日本語リファレンスマニュアル)のツールである bitclust と refe の gem 1.6.0 をリリースしました。先週お知らせした「ドキュメントソースの Markdown 移行」後、初の gem リリースです。主な変更点: - ドキュメントソースの Markdown ツリー(doctree の manual/)にネイティブ対応しました(パース・描画・リンク検証) - `bitclust setup` が Markdown ツリーから DB を構築するようになりました。旧設定からの移行は `bitclust setup --purge` で作り直してください - refe で module function の表示・検索が Ruby 4.0 以降の `?.` 表記(例: `Kernel?.open`)に対応しました - メソッド単位の追加/削除バージョン表示、`[表示名](m:...)` 形式のラベル付き参照などの記法拡張が入っています docs.ruby-lang.org/ja/ のドキュメントは gem リリースに先行して更新済みのため、今回の更新は主に refe コマンドや bitclust をローカルで使っている方向けです。詳細な変更点は GitHub のリリースノートをご覧ください: https://github.com/rurema/bitclust/releases/tag/v1.6.0 (この文面は Claude Code で下書きしています) -- |ZnZ(ゼットエヌゼット) |西山和広(Kazuhiro NISHIYAMA)

1 0

[ruby-list:51037] るりま(Ruby リファレンスマニュアル)のソースを Markdownに移行しました
by Kazuhiro NISHIYAMA 23 Jul '26

23 Jul '26

るりま(Ruby の日本語リファレンスマニュアル)の開発に参加している西山和広です。 2026年7月に、るりまのドキュメントソースを従来の RD ベースの独自記法 (RRD)から GitHub Flavored Markdown ベースの記法へ移行しましたのでお知らせします。本番切替は完了しており、現在の https://docs.ruby-lang.org/ja/ は Markdown ソースからビルドした HTML を配信しています。読む側に大きな変化はありません(URL・ページ構成は従来どおりです)。変わったのは書く側で、主な変更点は次のとおりです。 * ドキュメントの編集場所が rurema/doctree リポジトリの manual/ 配下の .md ファイルに変わりました。各ページ下部の編集リンクから該当ファイルに直接飛べます。 https://github.com/rurema/doctree * 旧 refm/ ツリーは凍結中です。編集しても公開サイトには反映されませんのでご注意ください(移行期間の後に削除予定)。 * バージョン分岐(#@since / #@until)の仕組みは従来どおりです。 * あわせて検索ページを静的検索に置き換え、Ruby 1.8.7〜2.7.0 の旧バージョンも検索対象に復活しました。 https://docs.ruby-lang.org/ja/search/ * 読む側の改善として、Ruby 3.2 以降の各バージョンのページでは、コード例をブラウザ内でそのまま実行できる RUN ボタンが使えるようになりました(ruby.wasm によるクライアントサイド実行です)。ほかにも、メソッド見出しへの対応バージョンのバッジ表示(「Ruby 3.2 から」など)、ページタイトルへの別名 (collect と map など)の併記、defined? などの言語キーワードでの検索対応、といった改善が入っています。 * Ruby 4.0 以降のページでは、モジュール関数の表記が従来の Math.#atan2 形式から、RBS の def self?.bar 記法に似せた Math?.atan2 形式に変わりました(3.4 以前のページは従来どおりです。検索はどちらの表記でもヒットします)。 * あわせて、2014 年から溜まっていた doctree の open issue 181 件を全件棚卸しし、説明の誤りを現在の Ruby で実測しながらまとめて修正しました。残っているのは方針検討中の数件のみです。移行の経緯や記法の詳細は、以下にまとめてあります。 * 紹介記事(ブログ): https://blog.n-z.jp/blog/2026-07-23-rurema-to-markdown * 記法仕様: https://github.com/rurema/bitclust/blob/master/doc/markdown-samples/MARKUP_… * 移行の背景・FAQ: https://github.com/rurema/bitclust/blob/master/doc/markdown-announcement.md * 貢献の手引き: https://github.com/rurema/doctree/blob/master/CONTRIBUTING.md Markdown になったことで、ドキュメント修正の敷居はだいぶ下がったと思います。誤字の修正から新しいメソッドの説明の追加まで、PR をお待ちしています。 -- |ZnZ(ゼットエヌゼット) |西山和広(Kazuhiro NISHIYAMA)

1 0