Docusaurus の逆襲

Docusaurus の逆襲

    ›

    • 01 - Docusaurus が攻めてきた!
    • 02 - インストールはできるけど
    • 03 - Slash の謎
    • 04 - docs の書式と website
    • 05 - 決戦! "index.js"
    • 06 - 刮目せよ! 〜"index.js" を読む〜
    • 07 - sidebars.json
    • 08 - siteConfig.js
    • 09 - もう読める
    • 10 - 再構築

    10 - 再構築

    あとコマンド 1 つで Docusaurus の文書を公開できる。けれど,翌日になっても ThinkPad の置いてある机に向かおうとは思わなかった。

    まっさらな空間にこれだけ形の整ったページを作るのだから,どうしても手間はかかる。でも,手作り感があって,自分の実力も上がっているように思えて,それを私は楽しんでいたのに,ただラクかどうかだけで判断されるなんてどうしても我慢できなかった。

    慣れない練習をしている自分が先輩にばかにされたようで,私は悲しかった。しかもそれをしてきたのが,ほかでもない EeePC であったことに。

    私はその日,真っ赤になった目を EeePC に見られないよう,机に顔を向けないようにして一日を過ごした。


    次の日の夜。へとへとになって帰ってくると,そのまま布団に倒れこんだ。真っ暗な部屋に,EeePC の画面と ThinkPad のスタンバイランプだけがともっている。

    … EeePC の画面?

    そういえば,液晶パネルを交換したのだった。電源をつけても黒い画面に慣れていたので忘れていた。電圧の変化か,何かのタイミングで画面がともったのだろう。私は顔をそらしたまま,スイッチに指をのばす。

    「私をシャットダウンする前に,話を聞いてくれないか」

    待ち構えていたかのように EeePC が話しかけてくる。私は無言のままスイッチを押そうとする。

    「頼む。一度でいい。この URL にアクセスしてほしい。そうしたら,私を廃棄するなり,好きにしてもらって構わない」

    「それ,新手のフィッシング詐欺?Linux でもウイルスに感染するんだね」私は吐き捨てるように言う。「私は正気だ。youtube がウイルスサイトだとでも思うのか?」

    「youtube?」私はそこでようやく画面を見る。そうして EeePC に言われるまま, EXWM から起動したブラウザに URL を打ち込んだ。


    「あ」

    まるで溜まっていた水が抜けるように,私の目を涙がつたう。昔の思い出がよみがえってくる。知人さえいない場所や,言葉さえ通じない土地。一人になるたび,私はさびしくて眠れなかった。そんな私は,EeePC の小さな画面に何度もなぐさめられたのだ。いまこの画面にうつっているのは,その頃に見たミュージックビデオのひとつだった。

    ビブラフォンの優しい音色がひきたてる印象的なバイオリンの響き。そして心まで洗われるような澄んだ歌声に,私の胸まで満たされていくようだった。

    「こんなもの聴かせて,自分がやったこと帳消しにするつもり…?」「そんな気はない。私は取るに足らない好奇心で君の心を深く傷つけた。どうすれば許してもらえるかもわからない。謝って許してもらえるとも思っていない。これからは私ができるあらゆることをして,君への罪をつぐなっていきたい。ただ,その前にまず謝らせてほしい。本当に,すまなかった」

    私はそれを聞いて大きくため息をついた。EeePC は皮肉屋だ。ここで許せば,いずれすぐ元の調子を取り戻すだろう。けれども,許さなくとも,私の態度からいずれ本心を見抜く。それでも私が EeePC に愛想をつかさないのは,どんなときでも必ず助けてくれるからだ。まるで,飼い主と深い絆で結ばれた愛犬のように。

    「君を許すわけじゃないけど,あと少しなのに終わらせないのは私もイヤだから,最後まで説明してあげるよ」

    そうして私は ThinkPad のディスプレイを持ち上げた。

    いきなりデプロイ

    「ここまで来たらあとはコマンド 1 個で読めるようになるんだけど」「おお」

    「その前に, SSH の公開鍵を作成して GitHub に登録 していない人は絶対してください」

    「…君,それ 前にも言った な」「絶対してください」

    「その説明はここではしないんだな」「絶対してください」


    「あ,編集したファイルがどんな風に見えるかは 2 話 で説明した yarn start を使ってね」「うむ」「 SSH の公開鍵を作成して GitHub に登録 が済んで,必要な文書をプッシュし終えたら,ターミナルで website フォルダに移動して次のコマンドを打ちます」

    GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true yarn run publish-gh-pages
    


    「 <GIT_USER> のところはアカウント名ね。 < > は入れないくていいよ。あ,あと npm 使ってる人は yarn のところが npm になります。少し待つと, Website is live at: って感じで URL が表示されるはずだから,それがサイトの URL です。以上。おわり」

    「GitHub Pages の設定は要らないのか?」「Docusaurus は自動でやってくれるみたい」「ほう。便利だな」「うん。最初は index.js とかの設定はがんばらないといけないけど,一旦作ればあとは楽。そこが Easy to Maintain なのかも」

    「ところで,どうしてタイトルが『 Docusaurus の逆襲』なんだ?」

    「試行錯誤しながら 『 Spacemacs のささやき』 を Docusaurus で書いたとき,そのやり方を忘れないうちにまとめなきゃいけないと思ったから。撃退したはずなのにまた帰ってきたから逆襲」「初めて読んだ人は Docusaurus のすごさをアピールするような作品だと勘違いしないか?」

    「え,すごいじゃん」「どこが?」

    「だって Javascript を一行も書いたことない私でも作れたんだもん」



    -- 了 --

    ← 09 - もう読める
    (c) 2018 jamcha (jamcha.aa@gmail.com).
    cc by-sa