mac

Wrote a feedforce engineer's blog

Nov 5, 2015 • 2 min read

すんごい久しぶりに会社の技術ブログを執筆しました！

SELinuxでlogrotateが失敗した話

うんこみたいな個人ブログばっかし書いてるので、会社ブログはちゃんと書こうと思ってがんばったので参考書籍とか、どんなこと考えて書いたか、メモしておく！

参考書籍

結城浩さんの数学文章作法基礎編を手元に置きながら書きました。小さくて厚みも無い本だけど全部実践するのは不可能なので主に最初の方の章だけ実践しました。

本自体読みやすいし持ち運びしやすいし、これだけあればいいやってなる。多分今後も何か書くときはこの本見ながら書くと思います。

本に書いてあることを意識して考えながら書いた。

本文にある3つの項目を穴埋め。

ここは自分に当てはめて考えました。読者＝ちょっと前の自分として考えました。

いろいろ記事とか漁ってみたのですがけっこう記事によって内容が違ったりしていてどうもよくわからない…公式のドキュメントも難しい…。

いろいろ設計や概念や用語が出てくるけど「結局それってどういうことなの？」がなかなか入ってこなくて苦労しました。

なのでその「結局どういうことなの？」が読んだ人にわかるように頑張りましたが…難しかった！うまくいったかは正直自信ない！

然し→しかしと書いたほうが読みやすい。抽象的な話→具体的な話、概念→実際の設定、みたいに順序を整理して書く。

のようなわかりやすい書き方とか上から下にちゃんと文章が読めるように意識しました。

という感じで本の2章までくらいの事を考えて書きました。なかなか難しい。

会社の技術ブログはミドルマンで作られていて、マークダウンが使えます。それもあってエディタはMacDownを使いました。

MacDownはMouの後継として作られたマークダウンエディタで、Mouに比べ開発も活発です。Mouと違ってシンタックスハイライトが使えるのがマジやべえ。おすすめ。

html、pdfにエクスポートもできます！MouみたいにTumblr等に直接投稿するような機能はまだないみたいです。

あと会社技術ブログはGithubにPR出してマージされたら公開されるフローになっているのですが、タイポとかおかしな言い回しとかみんなに指摘してもらえるのでマジ助かる。

そんな感じで、これからもアウトプット増やしていきたいなと思うのでした。