Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

タグ

writingに関するimai78のブックマーク (10)

  • 先輩ライターに訊く、技術文書執筆のアレコレ一覧

    CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

    先輩ライターに訊く、技術文書執筆のアレコレ一覧
    imai78
    imai78 2011/10/21
    今まで聞いたことのない世界だな。
  • 文章を書くノウハウを伝授

    ITエンジニアにとって文書作成技術は欠かせません。日常のメールのやりとりにはじまり、要件定義書、機能仕様書、企画の提案書など、上司やチーム、顧客などに対して、文章でコミュニケーションをとる機会がとても多いからです。 連載『悪文と良文から学ぶロジカル・ライティング』では、論理的にわかりやすい文章を書くノウハウを伝授しています。ITエンジニアが日常的に用いるであろう文章を例に使い、どこが悪くてどう直せばいいのかといったポイントをわかりやすく解説しています。実践すれば、誰でもすぐにわかりやすい文書が書けるようになるはずです。 オリエンテーション ITエンジニアにとって「書く技術」とは? 文書の全体構成を組み立てられるようにする 内容を大きく分けて項目を立てる 適切な順番で項目を並べる 話の階層をそろえる 文章表現の基ルールをマスターする 主語と述語を対応させる 修飾語と被修飾語をはっきりさせる

    文章を書くノウハウを伝授
  • HTMLで雑誌の原稿を書くためのツール - 西尾泰和のはてなダイアリー

    こんなの作った モチベーション テキスト形式での納品を求められるけども、もうちょっとメタデータの乗せやすいフォーマットで書きたいなぁ、ついでに言えば自分が今どれくらい書けているかのイメージを掴む上でも、人に渡してレビューしてもらうにしても、編集しているものが手軽に見やすい形にできるといいなぁ。プログラムで扱うのが楽なフォーマットがいいなぁ。ってそれHTMLでいいんじゃない? 過去の実装 Jythonを執筆するときは「求められているテキストフォーマットに最低限のメタデータを載せられるようにした独自フォーマット」からHTMLと納品用テキストに変換していたが、メタデータの載せにくさと自分の書いている原稿のプレビューのたびに変換スクリプトを走らせるののめんどくさにこのアプローチはダメだと思った。 現在の仕様 1行23文字、1ページ42行、1ページ2カラム構成の紙面を想定。 JSとCSSで真面目に

    HTMLで雑誌の原稿を書くためのツール - 西尾泰和のはてなダイアリー
  • 優れた文章を書くための11の賢いヒント » SEO Japan

    無料で資料をダウンロード SEOサービスのご案内 専門のコンサルタントが貴社サイトのご要望・課題整理から施策の立案を行い、検索エンジンからの流入数向上を支援いたします。 無料ダウンロードする >> 米国でNo.1人気のライティングに関するブログ「コピーブロガー」から優れた文章を書くための11のヒントを。英語ならではのアドバイスもありますが、大半は日語にも通じるかと。 — SEO Japan あなたは難しい言葉を使う時、自分が賢くなったような気になるだろうか? Applied Cognitive Psychologyに発表された研究によると、その答えはNOだ。 実際、複雑な文章はあなたを狭量な人間のようにさせてしまう。こんな研究タイトルはどうだろう:Consequences of erudite vernacular utilized irrespective of necessity:

    優れた文章を書くための11の賢いヒント » SEO Japan
  • エンジニアのための文章の書き方入門 – 秋元

    なるほど。と思ったのでメモがてら和訳。 How to make engineers write concisely with sentences? By combining journalism with the technical report format. In a newspaper article, the paragraphs are ordered by importance, so that the reader can stop reading the article at whatever point they lose interest, knowing that the part they have read was more important than the part left unread. エンジニアに簡潔な文章を書かせるには? ジャーナリズムと技術レポー

  • 長文を整理して書くのに適したテキストエディタ·WriteOnly MOONGIFT

    WriteOnlyはWindows/Mac OSX/Linux向けのオープンソース・ソフトウェア。個人的にあまり長文を書くのは得意ではない。上から下まで全てをつなげて書くよりも、章や項目毎にファイルを分けて書く方が分かりやすい。個々の項目についてだけ集中できるからだ。 章立てで書くのが好きな方向け そのような書き方が好きな方はアウトライナー系のテキストエディタが向いているだろう。二段階に分けて文章を書く、そんな書き方に適しているのがWriteOnlyだ。 WriteOnlyは2ペインに分かれており、右側に題目、左側に実際の文を記述する。左右の入れ替えは自由に行える。そして題目のところで名称を登録していき、個々の内容は文欄に入力していくのだ。特にフォーマット変更などはないので、文字を書くことだけに集中できる。 配置を変更した例 作成した文章はOpenDocumentでエクスポート可能だ。

    長文を整理して書くのに適したテキストエディタ·WriteOnly MOONGIFT
  • 文章力のシンプルな鍛え方 | シゴタノ!

    By: Guudmorning! – CC BY 2.0 「どうすれば文章力をあげることができますか?」 と、私が誰かに尋ねられたとしたら次の二点をあげます。 読むように書く事 書くように読む事 すでに文章を書いている方には当たり前のことかもしれません。しかし、この基的なことについて触れられているのをあまり見かけないので、今回はこの二つについて考えてみたいと思います。 読むように書く 多勝一氏の『日語の作文技術』というの中では、文章の書き方として「ダメな」例が二つ挙げられています。 話すように書く 見たとおりに書く アドバイスとして「話すようにかけばいいよ」とか「見たとおりに書けばいいよ」と言われれば、書き手としては楽な気持ちになれるでしょう。それらは日常的に行っていることなので、あたりまえにできると感じます。 しかしながら、実際このアドバイス通りにやって文章を書く事ができるか、と

    文章力のシンプルな鍛え方 | シゴタノ!
  • 読みやすい文章の極意は「修飾語」にあり

    「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 第5回「ドキュメントの質を確実に上げる6つの文章作法」に続き、顧客に伝わる文章を記述するためのポイントを紹介します。今回は、修辞句や用語など、「より具体的な表現方法」について説明します。なお、前回同様に、まず「分かりにくい例文」を取り上げてどこが分かりにくいのかを解説し、その後に分かりやすい文章へと修正していきます。 「修飾語を適切に使う」ことが、読みやすい文章を作るコツ 分かりやすい文章を書きたいなら、「修飾語」に着目しましょう。修飾語を使うときは、以下のような点に注意します。 長い修飾語は前に、短い修飾語は後に置く 文章を書く際は、句や文節を使った長い修飾語を前に、

    読みやすい文章の極意は「修飾語」にあり
  • 物書きのための集中できるテキストエディタ·Ommwriter MOONGIFT

    OmmwriterはMac OSX向けのフリーウェア。コンピュータ上には様々な動画や写真、音楽ゲーム等の様々なコンテンツが存在し、さらにネットワークを使えば無限とも言えるコンテンツに出会うことが出来る。このような状況では集中して仕事をするのはとても大変だ。 シンプルなエディタ 集中して物書きに励みたいと思うなら試してみたいのがOmmwriterだ。同種のソフトウェアにWriteRoomが知られているが、WriteRoomが真っ黒なのに対して、こちらは雪景色の白っぽい画面なのが特徴になっている。メニューも表示されず、ただ白いウィンドウにテキストボックスが表示されるのみで、とてもシンプルだ。 さらに音楽が流れるようになっていて、その音楽を聴いているとまた集中力が高められる。機能は右側にボタンで並んでいるが(書いている時は消える)、テキストサイズの変更や音楽の変更、背景の変更など簡単なものだけ

    物書きのための集中できるテキストエディタ·Ommwriter MOONGIFT
  • まとめ:文章を磨きあげるテクニックとチェックのハック12選 : ライフハッカー[日本版], 仕事も生活も上手くこなすライフハック情報満載のブログ・メディア

    たとえどんな秀逸なアイディアが自分の中にあったとしても、それを的確に伝える文章力がないと実現は難しいーーそんなふうに考えたことはありませんか? 昨日行われたライフハッカーのイベント後の雑談で、出演して頂いたパネリストの御一人である杉山竜太郎(株式会社LoiLo/ 取締役)さんは、お子さんの教育について"フリーな方針だよ(笑)"と前置きしつつも、「書くこと」だけはきっちり教えてあげたいと仰っていました。考えてみれば、別に小説家を志すわけでなくとも、メールやら企画書やら、ビジネスにおいて「書く」局面は、今も昔も満載。その傾向はむしろ拍車がかかりそうですから、もっとも有効な"子育てハック"といえるかもしれません。 文章には好みもありますし、文体は人それぞれのパーソナリティーなだけに、よくある文章講座的なものには疑問符をつけたくなります。特に日語は、その是非はともかく、けっして断定せず、結論を先

    まとめ:文章を磨きあげるテクニックとチェックのハック12選 : ライフハッカー[日本版], 仕事も生活も上手くこなすライフハック情報満載のブログ・メディア
  • 1