Skip to content

feat(dncl): 書き出しを標準の形にする #1754

Open
1 of 1 issue completed
Open

Description

@smalruby3-editor-bot

やること

書き出し(ブロック・Ruby → 日本語)を 標準の形 に切り替える。読み込みは標準の形と DNCL 風の形の両方を受け付けたまま。

  • 字下げ + 行末の :。を実行する で閉じない
  • and / or / not、そうでなくもし、表示する(a, b)、余り %
  • 入力: そのまま使うときは 【外部からの入力】、整数にするときは 【整数を入力】
  • 関数 名前(引数):、値 を返す

受け入れ条件

  • 3 章の表の「書く」列どおりに出る。往復(日本語 → ブロック → 日本語)で同じテキストに戻る
  • 既存の DNCL 風のテキストを貼っても動く

設計: docs/dncl/design.md(PR #1751)の 2 章・3 章。方針: docs/dncl/policy.md。EPIC #1731

Activity

  1. smalruby3-editor-bot commented on Nov 16, 2026

    @smalruby3-editor-bot
    Author

    進め方(AI)

    この Issue の範囲を、次の 3 つに分けました。

    1. 書き出しの土台とよく使う文(PR feat(dncl): 書き出しを標準の形にする(字下げと :、and / or / not) #2036): Ruby → 日本語を標準の形で書く。字下げ(1 段 = 空白 4 つ)と行末の :、繰り返す:、and / or / not、%、関数 名前(引数):、値 を返す。読み込みも、標準の形の 関数 …: / を返す / % を読めるようにした。表示する(a, b) と入力の書き分けは、いまの書き出しのままで設計の形だった(表のテストで固定)。
    2. 補完とブロックのエラー文(feat(dncl): 補完とブロックのエラー文を標準の形にする #2035): スニペットと「「を実行する」で閉じてください」の文を標準の形にそろえる。
    3. 生成AI に相談・教材・docs は docs(dncl): 生成AI・教材・docs を標準の形にする #1760 のまま。

    変えないこと

    • DNCL 風の形の読み込みは残す(を実行する で閉じる形・かつ / または / でない・返す x)。DNCL 風の形の書き出しも rubyToDncl(ruby, { form: FORMS.DNCL }) で残し、これまでのテストはそれで確かめる。
    • 作品はブロックで保存されるので、書き出しの形を変えても作品は壊れない。表のテストで、標準の形から戻した Ruby がブロックに変換できることも確かめた。

    字下げだけでは閉じる位置が分からないとき

    DNCL 風の終端の行(を実行する など)を残す。中身の無いブロック、end # c のように終わりにコメントがあるとき、ブロックの直後がコメントの行のとき。読み込みは両方の形を受け付けるので動く。

    #1699 / #1706 / #1740

    書き出しはまだ 1 行ずつの置きかえで、形だけを変えた。これらは直していない。書き出しを構文木で作り直すとき(#1826 の流れ)にまとめて直すのがよいと考えている。

    人間に決めてほしいこと

    1. 上の「閉じる位置が分からないとき」に DNCL 風の終端の行を残す、でよいか。
    2. Ruby の until 条件 を not 条件 の間繰り返す: にした(例題に「〜になるまで」の前判定が無いため)。これでよいか。
  2. smalruby3-editor-bot commented on Nov 18, 2026

    @smalruby3-editor-bot
    Author

    topic/japanese-mode-1731 での確認(7882526268・J0〜J6 のあと)

    一部直った(ほぼ済み)。残りは人間の判断 2 つだけ。

    PR #2036 / #2041 に加えて、topic では書き出しが構文木から作られる(J4)。rubyToDncl で確かめた結果:

    • if @a > 1 && @b / elsif / else → もし a > 1 and b ならば: / そうでなくもし a == 0 ならば: / そうでなければ:(字下げ 4 つ、を実行する なし)
    • puts(@a % 2) → 表示する(a % 2)、puts(@a, @b) → 表示する(a, b)
    • def foo(x) / return x → 関数 foo(x): / x を返す
    • ask("") + @a = answer → a = 【外部からの入力】、@n = answer.to_i → n = 【整数を入力】
    • until @a > 3 → not a > 3 の間繰り返す:
    • どれも日本語 → Ruby で同じ Ruby に戻り、ブロックに変換できる(targetCodeToBlocks でエラー 0)。DNCL 風の形の読み込みも残っている。

    この Issue で残っているのは、PR #2036 の「人間に決めてほしいこと」の 2 つ。topic でもいまの決め方のまま:

    1. 中身の無いブロック(if @a > 1 / end → もし a > 1 ならば: / を実行する)、end # c(→ を実行する # c)、ブロックの直後のコメントの行で、DNCL 風の終端の行を残す。
    2. until を not 条件 の間繰り返す: にする。

    この 2 つでよければ、develop へ入るときに閉じてよい。生成AI・教材・docs は #1760 に残っている。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions