https://twitter.com/iwashi86/status/1576502850909540352
執筆・編集のためのGit（GitHub）ワークフローを考えてみた
まとまった量の文章を執筆・編集するのにバージョン管理システムを使うことは、少なくとも技術文書においては特別なことではなくなりました。 原稿が汎用のテキストファイルの場合には、バージョン管理システムとして、GitやMercurialなどのソフトウェア開発用のツールを使いたいことが多いと思います。 実際、GitHubやGitBucketを利用して技術書やドキュメントの原稿を共同執筆するという話はとてもよく聞きます（知っている世間が狭いだけかもしれないけど）。 とはいえ文章の執筆・編集という作業には、プログラムのソースコードを開発する作業とは違う側面もいっぱいあります。 そのため、ツールとしてはソフトウェア開発用のバージョン管理システムを利用する場合であっても、そのワークフローについては、執筆・編集ならではの工夫が多少は必要なのかなと考えています。 もちろん、同じソフトウェア開発でもプロジェクト
textlintで日本語の文章をチェックする
textlintはMarkdownなどテキスト向けのLintツールで、テキスト版ESLintみたいな感じのツールです。 JavaScriptでルールを書けるテキスト/Markdownの校正ツール textlint を作った | Web Scratch 最近azu/JavaScript-Plugin-Architectureという小さな書籍を書いていて、色々簡単に使えるような仕組みを追加しています。 この記事では簡単なtextlintの導入方法について紹介します。 公式サイトには一部ルールを含むオンラインデモが公開されています。 textlint · The pluggable linting tool for text and markdown ドットインストールにてNode.jsのインストール、textlintの利用方法、エディタとの連携などのチュートリアルが公開されています。Node.
これはストーリーをつくるのが苦手な人のために書いた文章です
生まれてはじめて書く人のための、小学生向け小説執筆マニュアル（手順書） 読書猿Classic: between / beyond readers はオールインワンの総論だったので、各論をもう少し詳しく説明しろ、という話がありました。 今回は、小説だけでなくマンガでも映画でも共通するストーリーをつくることに焦点をあわせて、なるべくわかりやすく説明してみます。 ストーリーは最低３つのパートからできている 当たり前のことからはじめましょう。 世界最初の創作論（『詩学』）を書いたアリストテレスは、ストーリーは〈はじめ〉〈なか〉〈おわり〉の３つでできているといいました。 というのも、ストーリーは、 ・始まったら必ず終わらなくてはならない→〈はじめ〉から〈おわり〉へ ・しかしいくらか続かなくてはならない→ある程度の長さがある＝〈なか〉が必要 からです。 ストーリーには変化（落差）が必要 ストーリーには
技術的な文章を書くための1歩、2歩、3歩 - Qiita
ちょっと書きたくなったので書くんじゃーい！ この文章を読み終わった時、読者がそれなりわかめ品質な文章を出力できるようになり、どこかに寄稿した時に全面リテイクを食らったりしないようになることを目指します。 mhidaka が 0歩目を書いてくれました！ 背景 筆者は普通のエンジニアです。その辺の開発とかしてる会社に勤めています。技術系の原稿も書きます。 原稿書きでご飯食べてるわけではありません(晩ご飯が豪華になることは稀にあります)。 今まで有能なレビューワー(muなんとかさんとか)編集さんとか(某社の安藤さんとか)とかとかに鍛えていただきました。 この場を借りてお礼を述べておきたいと思います。ありがとうございます。 なお、この文章は2013年10月時点での筆者(わかめ)のやり方です。 将来的にはより良いやり方を見つけるでしょうし、これとは全く違う書き方で上手にやっている人もいると思います。
技術的な文章を書くための第0歩 ～読者に伝わる書き方～ - Qiita
はじめまして。ひつじです。 TechBoosterというウェブサイトでAndroidなどの記事をかいてます。Qiitaには初めて投稿します。 vvakameさんの技術的な文章を書くための1歩、2歩、3歩 を見る人の補助的な気持ちで0歩目を紹介します。 記事の構成方法については、vvakameさんの記事で触れられてることもあり、あまり触れません。 読みやすい文章のための心得をまとめました。 0歩というぐらいなので普段から気を付けている（そして完璧には、こなせていない）内容をまとめています。ただ内容については私自身が気を付けていることですので、もっと皆さんにあった良い方法があるかもしれません。参考になれば幸いです。 文章を書くのに大切なことって？ 言いたいことを1つに絞る １つの文章にたくさんの主張を入れると読む人は混乱してしまいます。ですので、なるべく1つのコンテキスト（章、節、項で主張の大
英語で数学を (Mathematics in English)
書く 数学的な記述は，概ね， 定義で始まり，定理を目指し，その間を証明という論理的な推論でつなぐ， という流れになっています．したがって，専門用語を除いて，使われる語句にも 一定の傾向があり，それらを知れば，数学的内容を英語で伝えるのは それほど困難ではないと思われます．ここでは，主に Donald E. Knuth の未完の大作 The Art of Computer Programming Volume 1 Fundamental Algorithms Second Edition ( Addison-Wesley, 1973) †1 の Chapter 1 Basic Concepts の 1.2. Mathematical Preliminaries †2 から「決まり文句」や「つなぎ言葉」中心に数学的と思われる表現を 抜き出してみました． もとより個人的な見解ですので，興味ござい
Twitterでも本の記録を 自分のスタイルで始める「読書ノート」の書き方 - はてなニュース
本を読んだ感想や読み終わった日付など、自分の読書の記録を残す「読書ノート」、あなたはつけていますか？今日は「書いてみたいけどどうやって始めたらいいか分からない」「今の書き方をもっと工夫してみたい」という人のために、「読書ノートの書き方」を学べるエントリーを集めました。 ■みんなは読書ノートに何を書いてる？ 読書ノートの書き方は、読む本のジャンルやその人のスタイルなどによって様々です。既に実践している人はどんなことを書いているのでしょうか？ ▽ おまえら読書ノート取ってる？:【2ｃｈ】ニュース速報アワーズ 上記のエントリーでは、2ちゃんねるの読書ノートについてのスレッドに寄せられたアイデアがまとめられています。ノートには、「書名・著者・読書開始日・読了日」といった基本情報に加えて、「感想」「要約」「評価」などを書いている人が多い様子。中には「感想などはあえて書かない」「コメントはたまに一行く
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
本の書き出し
文章の書き方以前！文章力の基本意識向上１０か条