AsciiDoc と PlantUML と mermaid.js で素敵なテキストベース仕様書ライフ
以前からテキストベースで仕様書(PDF)などを管理したいと思っていたのですが、ようやくその環境が整い、一度実際に運用してみてかなりいい感じだったので紹介したいと思います。 基本テキストは AsciiDoc で記述する UML は PlantUML で記述する フローチャートとかは必要に応じて mermaid.js も使う つまり基本テキストで表現・管理できるものはテキストで書く 成果物は PDF形式。目次(Table of Contents) はつける。 動作確認環境 macOS Sierra 10.12.3 ruby 2.3.1 Asciidoctor 1.5.5 Asciidoctor PDF 1.5.0.alpha.14 Asciidoctor Diagram 1.5.4 mermaid 7.0.0 AsciiDoc とは AsciiDoc Home Page 軽量マークアップ言語の
日米仏の思考表現スタイルを比較する - ベネッセ教育総合研究所
これには歴史的・文化的な背景があります。日本でも公立学校が設立された明治期には、むしろアメリカ以上に「型」から学ぶ形式模倣主義の作文教育が主流でした。ところが、大正期に子ども中心主義の新教育運動が世界的に広がると、明治の形式模倣主義への反省から、型を壊して子どもらしい文章表現を重視する「綴り方」が在野の文学者から提唱されました。綴り方は単に「書く技術」ではありません。子どもが体験や考えをありのままに書くことを通じて「人格修養」することを主な目的としていました。このアプローチが現場の教師に圧倒的な支持を得て、「生活綴り方」から戦時中の「国民学校の綴り方」へ、そして戦後も「学校作文」としてその精神は脈々と受け継がれ、現在に至っています。 ところが皮肉なことに、型を壊したと思いきや、結果として「子どもが見たまま、感じたままを綴る学校作文」という唯一の型を作り上げてしまいました。体験したことを素直
佐々木高政「英文構成法」の結びにある名文 - はてな読み
（佐々木高政「英文構成法」、結びより） 「はるけくも来つるものかな」である。これでもう諸君は英作文の第一歩を立派に卒業したと言って差し支えない。ここまでまじめに練習を積んで来られた方は、「やさしく、素直な、しかも英語の調子に乗った英文」を書くコツを少しは会得されたはずである。この態度は最後まで持ちつづけていただきたい。日本人の悪い癖で抽象的なむずかしい言葉を使うほうが「偉そうに」見えるため、当人にもハッキリしない、読む者にはサッパリわからない文章が盛んにあちこちで書かれるが、この癖を英語に持込まれたのではやりきれない。それを読まされる不幸な教師は厭世観をいだくに至るであろう。戒むべきは独りよがりの「独創」である。外国語でものを書く時の「独創」ほど剣呑なものはない。英語には一語一句の末に至るまでその用い方には何かしら「きまり」がある。それを辞書などで確かめる労をうるさがって、ものは試しとばか
「おもしろい書評」を書くために必要な7つの知識
書評は当ブログのメインのコンテンツとなっています。毎日ブログを更新する（平日のみ）と決めている私にとって、書評は計算できるコンテンツです。一冊読めれば、確実に一記事を更新できるからです。 書評にはコツがあります。私が書く書評が面白いかの判断は皆さんに任せるとして、もし当ブログのような書評を書きたい方は、これからご紹介するポイントを抑えておけば、誰でも書評が書けるはずです。 Tagged! / laszlo-photo 1.「自分が主役」を強く意識する 本のあらすじを順番に書いて、その都度「私もそう思いました」「共感しました」のような平凡なコメントを付けていく書評が多いです。このパターンの書評は「本」の内容が主役になってしまい、凡庸な文章になりがちです。絶対にこういう書評は書かないことです。 個性というのは、ある種の「無理」や「歪み」だと思います。無理や歪みが一切ない整然たるものというのは、
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
