ブロックコードとコメントアウト

[KeenS]

ブロックコードをコメントアウトするのがどうもgitbookと相性良くないようです。今のところブロックコードはコメントアウトせず削除することで対応しています。

幸い、コード中に出てくるコメントの分量はそこまで多くないので大丈夫ですが、いずれは対応を考える必要があります。

[Nnwww]

ではPRを投げる側でコードブロックを削除しておいた方が良いですか?

[KeenS]

はい。おねがいします。他に良い方法(コメント部分だけ抽出してコメントアウトしておくとか)があるならその方がいいのですがとりあえずは削除ということでお願いします。

[yohhoy]

ブロックコードのコメントアウトとは、具体的にどのような記述でしょうか？下記のようなもの？

<!-- Is this `block code`? -->

[KeenS]

それは問題ないです。バッククォートを3つ使った別行立ての方です。

<!-- ```
   this is the block code
  ``` -->

[KeenS]

#28 にてそれっぽい解決策発見。

# // let x = "foo" // this is a commet
let x = "foo" // これはコメントです。

のようにするとHTMLの表示上は原文は見えない。

@Nnwww @yohhoy @tatsuya6502 @ykomatsu @dalance
この方式でどうでしょうか。

[ykomatsu]

「Documentation as tests」で使われている方法ですね。
いいと思います。

[Nnwww]

良いと思います。

[tatsuya6502]

#13 (comment)

# // let x = "foo" // this is a commet
let x = "foo" // これはコメントです。

この方式でどうでしょうか

試してみました。

• rustbook で生成した HTML → 英文が表示されない
• play.rust-lang.org のコードエディタ → 英文も和文もコードコメントとして表示される

いいですね。この方法に賛成します。

[KeenS]

ありがとうございます。既存のものの変換とCONTRIBUTINGの変更しますね。