はじめに
本稿は、"ワタクシ的"書き方の規約/Tips集です。
以下の6つのシーンに焦点を置いています。
⑴ Qiita
⑵ 論文/レポート
⑶ ビジネスライティング
⑷ ブログ/エッセイ
⑸ トークスクリプト/説明
⑹ English
番外編
⑺ そもそも考える技術
※各Tipは、「 ❶Tipsのテーマタイトル ❷参考にしたサイトURL ❸Tipsポイント 」 の順に記載しています。
※Tipsのタイトルは、指示レベルで命名します。 ex) 〇〇の時は、××××する。
※逐次更新します。
【 ⑴ Qiita writing Tips 】
絵文字
下記の文字列を " : " (コロン)で囲む
pencel2 →
取り消し線 (二つの波線"~~"で囲む)
ex) 打ち消し線を入れたいテキスト
・[WebFX「EMOJI CHEAT SHEET」WebFX (WebFX is a full-service digital marketing agency)]
(https://www.webfx.com/tools/emoji-cheat-sheet/)
・Qiita 投稿「Markdown記法 チートシート」 Qiita Team 執筆
文字色 (fontタグでcolor指定して囲む)
< font color="Red">< /font >
ex) 赤色の文字テキスト
折りたたみ 折りたたみテキスト
"詳細をみる"
ここクリック
すると中のデータが出てくる
【copy】
QiitaでGoogleアナリティクスを利用する手順
Qiita Markdown 書き方 まとめ
コードの挿入
function hello(){
return "hello world!";
}
【 ⑵ 論文/レポートの書き方 】
規約
参考文献表の作り方/参考文献・資料の示し方
(http://www.nagasaki-gaigo.ac.jp/toguchi/composition/ref.pdf)
① ネットに掲載された論文・記事・データ・資料は、明記する。
執筆者名(示されていない場合は省略)、論文・記事・データ・資料の題名、掲載機関名/掲載サイト名、アドレスなどを明記する。
② 題名・見出しのなかに「 」が使われている場合は『 』に変える。
③ 並べる順序をルール化する。
1.執筆者が示されている論文・記事(執筆者名を基準に「あいうえお」順)を最初にまとめ、
2.次に無署名記事を(たとえば年代順:古いものから順に)、
3.最後に政府・省庁・研究機関などのホームページに掲載されているデータ・資料をあげる。
❶執筆者名 ❷「論文・記事・データ・資料の題名」
❸掲載機関名/掲載サイト名 ❹掲載日時 ❺url
例) 執筆者名「論文・記事・データ・資料の題名」、掲載機関名/掲載サイト名、掲載日時。url
戸舘圭之「ABC マート摘発が示す過重労働根絶の難しさ 『残業代ゼロ法案』の議論も見落とすな」、東洋経済オンライン、2015 年 >07月 08 日。
http://toyokeizai.net/articles/-/76124
広岡延隆「ABC マート役員を書類送検した『かとく』の正体 残業代を払っていても“アウト”になる企業が続出か」、日経ビジネス >ONLINE、2015 年 7 月 8 日。
http://business.nikkeibp.co.jp/atcl/opinion/15/221102/070700018/
「雇用の分野における男女の均等な機会及び待遇の確保等に関する法律」、e-Gov(電子政府の総合窓口 イーガブ、総務省)。
http://law.e-gov.go.jp/htmldata/S47/S47HO113.html
「年齢(5 歳階級)、男女別人口(平成 23 年 11 月確定値、平成 24 年 4 月概算値)」、総務省統計局ホームページ。
http://www.e-stat.go.jp/SG1/estat/List.do?lid=000001088251
文学系卒業論文 制作の注意点
レポート・論文の書き方
レポート・論文の書き方 ― 日本語でしっかりした文章を書くために
Tips
【 ⑶ ビジネスライティング 】
【 ⑷ ブログ/エッセイ 】
【 ⑸ トークスクリプト 】
頭がいい人は「分かりやすい説明」をする時、何を考えているのか
「頭がいい人は、相手に説明をする目的と、相手にどこまで理解させる必要があるかを見極めることが上手い」
・難しいテーマには、「構造が複雑なので難しい」ものと、「理解しなくてはいけない情報量が純粋に多いので難しい」ものの、大きく二種類がある
・前者を整理して「分かりやすく」説明することは可能だが、後者を「簡単に」説明することは基本的に出来ない
・ただし、情報を簡略化したり、たとえ話を使ったりで「分かった気になってもらう」ことは出来る
・そして、それで十分目的は達成できることの方が多い。「きちんと」分かってもらう必要がない場合はそれで十分だし、えらい人たちはそれを承知の上で納得している
・重要なのは、相手に「どのレベルまで分かってもらう必要があるのか?」という見極め
・「分かりやすい説明」と「本来必要な情報を省いた説明」は違うものであって、ごっちゃにしてはいけない
・後者で「必要なところまで理解した」気になってしまうと困る
難しいことを簡単に説明する指針。"Lie(s)-to-children"
【 ⑹ English 】
【 ⑺ そもそも考える技術 】
~参考文献~
~ビジネスライティング~
誰がどう見てもそうとしか受け取れない文書術(公開版)
ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい
~論文~
~レポート・論文の書き方~
(http://www.nagasaki-gaigo.ac.jp/toguchi/composition/index.htm)
・[今井 勉「文学系卒業論文 制作の注意点」今井勉のホームページ(東北大学フランス語学フランス文学研究室教授・今井勉教授のホームページ)]
(http://www2.sal.tohoku.ac.jp/~tsutomu/documents/noticessotsuron.pdf)