セクションのパーマネントURLに日本語を含まないようにする

[azu]

GitBookの機能でセクションのタイトルに 内部リンクを指定できる。

## タイトル {#header}

をつけると url#header の内部リンクでアクセスできるようになる。

ウェブ版はリンクを自由に貼れる書籍にしたいため、細かくリンクを貼れる仕組みをととのえる

Tasks

• textlintルール fix: ヘッダのIDをチェックするtextlintルールの追加 #418
• リンクを貼る

[azu]

基本的に各 # タイトル {#title} を付けていくだけなので、完全に人力作戦になる。
手伝ってくれる人も募集していいます。
基本的には、セクションのタイトルの英語を #link にする感じ

例えば、

## 配列は特別なオブジェクト

https://asciidwango.github.io/js-primer/basic/array/#%E9%85%8D%E5%88%97%E3%81%AF%E7%89%B9%E5%88%A5%E3%81%AA%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88

は

## 配列は特別なオブジェクト {#array-is-special-object}

https://asciidwango.github.io/js-primer/basic/array/#array-is-special-object

にしていきたい。

[azu]

#360 DocSearch連携をマージした。
検索から直接セクションのパーマネントにジャンプできるようになった

[nissy-dev]

@azu
#361 を見た感じあまり進んでいないみたいなので、こちらの作業をお手伝いしたいです 🙋

セクションのタイトルの英語は、どこかに記載されているのでしょうか? それとも、自分で訳をあてる感じになるのでしょうか?

[azu]

@nd-02110114 そうですね。訳語はその場で考えて適当に当てていることが多いですね。。
まあページ内リンクは最悪名前が変わっても問題ない(リンク切れにはならない)ので、ある程度適当で大丈夫です。

基本的には、名詞、固有名詞、動詞、and, or, ofぐらいだと思います。
(完全に訳さなくてもユニークになっていれば問題ないので、ざっくりとした単語を当てはめることが多いです)

固有名詞は大部分は仕様書の単語を元にしていて、一部( #231 )だけ例外的に仕様的じゃない単語を使っています。
仕様書の単語とMDNの単語は大体一致していると思うので、基本的にはMDNの単語を参考にするのが手っ取り早いと思います。

(多分ですが) 既存のセクションタイトルの単語に s は付けてない気はします。

[nissy-dev]

@azu
ご返答ありがとうございます。数日中に作業して、PRを出してみます。

[azu]

@nd-02110114 ありがとうございます。
コンフリクトを避けるために章(ファイル単位)毎ぐらいのPRだといいかもしれませんね。

[nissy-dev]

とりあえず、第一部までは #412 で終了しました！

[yumetodo]

通知が大爆発しているから何事かと思ったらこれか。びっくり。

[azu]

@nd-02110114 ありがとうございます！
ひとまず一通りみました。
#397
#399
#400
#403
#410

[nissy-dev]

@azu
ご確認ありがとうございました！
2部については、今週にまた少しずつやって行きたいと考えています。

[azu]

#418 で自動チェックするルールを追加したので、これからはヘッダを追加する際にIDを書いていく形になると思います。

@nd-02110114 @yumetodo ご協力ありがとうございました。