タグ

ブックマーク / blog.h2o-space.com (2)

  • H2O Blog. • 分かりやすい文章を書くために工夫していること

    Editors’ & Writers’ Advent Calendar 2013 - Adventar の18日目です。 私は、『WordPressをちゃんと使うための教科書』や『よくわかるPHPの教科書』、『よくわかるJavaScriptの教科書』など、初心者さん向けの入門書などを執筆しています。 今日はそんな入門書を書いた経験から、「分かりやすい文章を書くために工夫していること」をいくつか紹介してみたいと思います。 解説をとばす 技術系の記事の場合、どうしても「例外」があったり、ケースによって必要なことが異なることがあります。これらを一文の中で説明しようとすると、どんどん結論が先延ばしされて、全体的に難解な文章になっていってしまいます。 そこで、文章ではそのような例外などをどんどんとばして簡潔に説明し、代わりにコラムなどを使って、一つずつ紹介をします。 例) 6-23の手順に従って、デ

    idejunp
    idejunp 2013/12/18
  • WordPressは CMSにあらず? - H2O Blog.

    今や、CMSといえばこれ、という位スタンダードな存在になっている「WordPress」。 しかし、実際に使い始めた方の感想を聞くと「MTの方がテンプレートタグなどが素直で良い」「PHPが生々しすぎて扱いにくい」「何かにつけて functions.phpを触らないといけない」「プラグイン入れすぎだし、不安定」などなど、酷評も多々聞きます。 私の場合、かなり初期の頃から WordPressラブの状態です。しかし、それは決して WordPressが「CMSとして」優れているからという訳ではなく、むしろ今のように人気が出るのは変な気もしています。 私は、WordPressは CMSというよりも「アプリケーションプラットフォーム」という位置付けかなと思います。もし、コンテンツを管理するためにCMSを使いたいという用途ならば、おそらく他の CMS製品の方が優れたものが多いでしょう。 WordPress

    idejunp
    idejunp 2013/04/05
  • 1