新入生向けの資料

はじめに 文章を書くときに、注意して半角文字の両端に半角空白を空けるという手動 lint をよくやっています。 また、日本語の表現や句読点、typo などに注意を払うことも必要です。 そこで、機械的に検出できた方が内容を書くことに集中できるので文章の lint ができる textlint というツールを使っていきます。 同様の検査ツールとして RedPen が存在します。 以下の記事に RedPen と textlint それぞれの立場から文章における問題とその解決についてまとまっているので参考になります。 文書執筆の指南書で解説されている問題点を RedPen で発見する - Qiita 文書執筆の指南書で解説されている問題点を textlint で発見する - Qiita 今回は、リポジトリ内で管理する Markdown ファイルに対して、Visual Studio Code(VS C

漢字で書ける語句をひらがなで書くことを「ひらく」、その逆に、ひらがなの語句を漢字で書くことを「とじる」（＝ひらかない）、これらを総称して「（漢字の）閉じ開き」といいます。 この「閉じ開き」は、テキストの読みやすさ、伝わりやすさ、さらに、誤読を避ける気づかいなどに直結します。デザイン制作物だけでなく、メールやSNSなど、文字ベースでのコミュニケーションが多く行われている現在では、ビジネススキルのひとつです。 ライティングや文字校正では、よくひらがなを【ひらく】漢字を【閉じる】と表現しますが、僕は小学生の頃両さんに教えてもらいました😎 ちなみに1988年発売の51巻です。 相変わらずこち亀の守備範囲は広すぎる🥺#ブログ書け#ブログ初心者 pic.twitter.com/vZirFnQOCy — おかぺー🙋🏻‍♀️オカンのIT力向上 (@DemoOkan) May 2, 2021 ルー

2019年3月26日に社内で実施した文章力をアップするための勉強会の資料です。プロのライターのようなハイクオリティな文章ではなく、ビジネスパーソンが仕事をする上で最低限機能する上での「上手な文章」を、とても簡単な3つに絞って話をしています。実際の勉強会ではワークもしてもらいました。皆さんもこれを読んで、…

注意：アカデミックヤクザとはフィクションであり，実在の人物・団体とは一切関係ありません． この記事はeeic （東京大学工学部電気電子・電子情報工学科） Advent Calendar 2017 - Qiitaの22日目の記事として書かれたものです． はじめに 私はこれまでLaTeXを使って論文執筆をしてきました． その際に何度も調べてしまうこと・後輩に何度も繰り返し教えていることをまとめておくことで，誰かの役に立てればと思いこの記事を書いています． 執筆する論文の内容には触れず，あくまでも最低限ちゃんとした文章っぽく見せるため体裁をどう整えるかに主眼を置いています． これさえ守っておけば，パイセンや先生に論文添削を頼むときに小言を言われる可能性が低くなるのではないでしょうか．（多分． 責任はとれない．） また，これからLaTeXで論文執筆したいけど，環境構築とかめんどくさい・・・という人

2016-06-30開催のssmjpでの発表資料です。 詳細: https://www.opslab.jp/publish/20160630-ssmjp.html (運用設計ラボ合同会社 波田野裕一)

今日は、Webライティングにもメールにも役立つはずの、「わかりやすく、読みやすい」文章を作るための日本語を解説したマニュアルを紹介します。これは、すべての社会人が読むとその日からトクする情報です。 いわゆる「お役所言葉」改善の手引 by 佐賀県「いわゆる『お役所言葉』改善の手引」という、佐賀県が2004年に公開した文書があります。文書名だけ見ると「なんだ、また意味のない無駄なやつか」と思うかもしれませんが、これが非常に役に立つ内容だったのです。 佐賀県：いわゆる「お役所ことば」改善の手引きの策定 なにが役に立つって、本当に「わかりやすい、読みやすい、伝わる」文章を書くための基本をシンプルかつ明確に、具体的な例を示しながら解説してくれているのです。 内容はこんな感じです。 できるだけ具体的な表現を的確で簡潔な文章を、まずは結論から行政で多用される慣用語の見直しをカタカナ語（外来語）は普及して

こう言い換えろ→論文に死んでも書いてはいけない言葉３０ 読書猿Classic: between / beyond readers を書いたとき、「あとは穴埋めしたら論文を出力してるものが作れないか」みたいな話があったので、作ってみた。 何であれ、文章を書く骨法は、書きたいことではなく、書くべきことを（そしてそれだけを）書くことである。 問題は何を書くべきかであるが、幸いにして、論文については後述するようにほとんど決まっている。 結論から言えば、以下の表を埋めていくだけで、論文の骨組みができあがる。 必要な項目は揃い、しかるべき順序で並ぶ。 論文穴埋めシート こんな簡単な穴埋め表がこれまであまり取り上げられなかったのは、わざわざ作るまでもないことも勿論あるが、その他にも次のような理由がある。 つまり、こうした穴埋め表が、 あなたは論文が書けないのではない。 研究ができないのだ。 という目の当

「書くことはあとからでも教えられるが、好きになることは教えられない」 とても久々にライティングの本を読みました。手に取ったのは『新しい文章力の教室　苦手を得意に変えるナタリー式トレーニング』。著者はナタリー運営のナターシャ取締役の唐木元さん。コミックナタリーやおやつナタリー（現在は終了）、ナタリーストアなどを編集長として立ち上げ、現在はメディア全体のプロデュースを担当されています。 「書くことはあとからでも教えられるが、好きになることは教えられない」というナタリーの採用ポリシーがあることから、ライティングや記者経験のない人も多くいるのだとか。そういった新人に向けて唐木さんは「唐木ゼミ」という社内での新人向けトレーニングを繰り返してきました。 書けない理由は、「遅い」「まとまらない」「伝わらない」のどれか、もしくはそのすべて、と説く本書を読むことで「書く前の準備」の大切さを改めて実感すること

これは、小論文を書くのが苦手な人のために書いた文章です。 文章の言い回しや磨き方※よりも、そもそも何を書いたらいいか、どう考えたら書くものを思いつけるのか、について分かるように書きました。 小論文がどういうものであり、何を書くことを要求しているかが分かれば、少なくとも「何を書いたらいいか」分からず困ることがなくなると思います。 「何を書いたらいいか」をどうやって思いつくか、必要な材料をどうやってアタマから引き出すかについても説明しました。 文章を書くこと自体が苦手という人は、末尾にリンクを置いた参考記事が参考になるかもしれません。 ※論文らしい文章の書き方については、以下の記事を参考にしてください。 論文はどんな日本語で書かれているか？アタマとシッポでおさえる論文らしい文の書き方 卒論に今から使える論文表現例文集（日本語版） 時間がない人のための要約 ◯自分語り系の小論文 （「私の仕事観」

（例文／コーパス） ◯KOTONOHA「現代日本語書き言葉均衡コーパス」 少納言 www.kotonoha.gr.jp/shonagon/search_form 現代の日本語の書き言葉の全体像を把握できるように集められた約１億語収録の『現代日本語書き言葉均衡コーパス』をジャンルを指定したり、前後にくる言葉を指定した上で検索できる。用例を探したいときはまずここを当たる。 ◯コーパス検索ツールNINJAL-LWP for BCCWJ (NLB) nlb.ninjal.ac.jp/ 『現代日本語書き言葉均衡コーパス』を検索するために、国語研とLago言語研究所が共同開発したオンライン検索システム。上の少納言との違いは、名詞や動詞などの内容語の共起関係や文法的振る舞いを網羅的に表示できるところ。 たとえば「タバコ」を検索すると、用例が「タバコ＋助詞＋動詞」や「動詞＋タバコ」＋「タバコ＋助詞＋形容詞

今日は文章を書くことを、作業面から助ける提案を。 知っている／やっている人には当たり前すぎる話だが、知ると知らないとでは執筆中の効率の面でも精神衛生の面でも大違いなので書く。 コメントとは何か？ プログラミング言語を用いてコンピュータに何か有用な作業をさせるための指示を書き上げることをプログラミングといい、書かれた指示のかたまりをソースコードという。 ソースコードには、コンピュータが処理を行うときには〈ないもの〉扱いされる（つまり処理されることなく飛ばされる）が、覚え書きとしてコメント（comment）があちこちに挿入されることが多い。 たとえばC++やJavaでは// 以降がコメントと見なされ、PerlやPythonでは、# 以降がコメントと見なされる。 またHTML、Wikiでは、で括られた部分がコメントと見なされ、C、C++、Java、JavaScript、CSSでは、/* と */

なんとなく昔片隅にいたあの技術系コミュニティのことを思い出してみようかなと。 マニュアルに書いてあることや検索してわかることは質問しちゃいけない 技術系コミュニティでは質問がよく飛ぶ。ただしたいていの質問はとっくに解決済みなのであって、そこに辿りつけないのはマニュアルやドキュメントや検索が足りないからである。質問の前にはちゃんとそうしたものに目を通さないといけない。そうしないと同じ質問がたくさん並ぶことになってしまう。 ドキュメント化はよいこと 前項に関連して、すべての質問を生まれる前に消し去ることが目指すべき善なので、ドキュメントを書くことはたいへん良いこと。そのためにどんな環境でも読める HTML を学ぶべき。 挨拶やお礼は重要ではない 大量の情報を見る人間にとって挨拶やお礼など儀礼的な意味しかないものを何度も見るのはあまりうれしいことではない。 お礼を書くくらいなら教わったことを実行

元々、書き言葉は、それぞれの用途や目的ごとに決まった定型（フォーマット）に基づいて書かれるのが普通であった。 例外は、近代以降、西洋世界から広がった〈小説〉という新しい言語芸術と、大正期以来、日本の初等教育で続けられる〈自由作文〉ぐらいである。 日本に生を受け、小説しか読まず、作文教育しか受けていない人が、「書き方がわからない」としても不思議なことではない。 現状確認を繰り返すだけでは仕方がないから、「ならばどうすればいいか」に進もう。 書き言葉が定型に基づくものであるなら、その定型を学べばいい。もっと言えば、マネすればいい。 これについては、すでに多くのフォーマットやテンプレートが提案されている。 このブログでも 文章の型稽古→穴埋めすれば誰でも書ける魔法の文章テンプレート 読書猿Classic: between / beyond readers という記事を書いたことがある。 そこで今

どのようにすればよいか？（how to do）は、どんな場合に何をすべきか（what to do）に還元される。 論文の書き方を説明するのに、〈論文には何が書いてあるべきなのか（構成要素は何か？〉〈なぜそれらの構成要素は必要なのか？〉を解説して、答えにかえよう。 論文構成の標準的な型式（Style）を、その構成要素Introduction（序論）, Methods（方法）, Results（結果） And Discussion（考察）の頭文字を構成順に並べてIMRAD（いむらっど/ˈɪmræd/）と呼ぶ。 頭文字は構成を記憶するには便利だが、なぜそれらの構成要素が必要なのか理由を納得した方が身につくだろう。 以下に、論文の構成要素について、その論理構造を説明し、それぞれで何を書くのか簡単な例をいくつか挙げる。 Introduction（序論） 背景と必要性Backgroud and Nec