はじめに 文章を書くときに、注意して半角文字の両端に半角空白を空けるという手動 lint をよくやっています。 また、日本語の表現や句読点、typo などに注意を払うことも必要です。 そこで、機械的に検出できた方が内容を書くことに集中できるので文章の lint ができる textlint というツールを使っていきます。 同様の検査ツールとして RedPen が存在します。 以下の記事に RedPen と textlint それぞれの立場から文章における問題とその解決についてまとまっているので参考になります。 文書執筆の指南書で解説されている問題点を RedPen で発見する - Qiita 文書執筆の指南書で解説されている問題点を textlint で発見する - Qiita 今回は、リポジトリ内で管理する Markdown ファイルに対して、Visual Studio Code(VS C
実践ソフトウェアエンジニアリング（第9版）は、合計12名という監訳、翻訳者で活動しておりました。この人数である程度、用語や表現を統一する必要がありました。この複数名で作業を進めるにあたっての翻訳環境なり事前準備した内容を軽く紹介してみます。 ただ、最後にも触れますが、準備したとはいえ大変だったことは言っておきます。 （忘れてたのであとから追記）あ、こちらの記事も「実践ソフトウェアエンジニアリング第9版 Advent Calendar 2021」の対象です。 以前の記事で触れてますが、翻訳プロジェクト自体を一度凍結したという状況があり、その後2020年12月にプロジェクト再立ち上げをしております。 この翻訳プロジェクト再立ち上げへ向けた準備段階で、複数名で翻訳できる環境を用意し、自分の翻訳を先行して40-50ページ程度進めてみる。そうして運用できることを自己チェックし、その気づきをフィードバ
例のごとく「実践ソフトウェアエンジニアリング第9版 Advent Calendar 2021」の対象です。今回は「用語」のおはなし。 実践ソフトウェアエンジニアリング（第9版）は、ソフトウェアエンジニアリングの体系に対する教科書みたいなものです。そうすると、一種の「用語集」としての意味ももつことになると認識してます。 そのため、できる限り用語はぶれずに、適切な用語を選定しておきたいとは考えておりました。今回はこの用語統一への取り組みと、実際の活動で発生した困りごとを紹介しておきます。 まー、「ここまでやってはいます」という「言い訳」みたいなものです。 用語統一へやったこと 用語統一への活動結果は「訳者まえがき」にも載ってますが、実活動の状況なりを書いておきます。まず意識的にやっていたのは、「技術用語」の統一の活動でした。具体的には次のようなものです。 textlint/textlint-r
「Pythonクローリング&スクレイピング」という書籍を執筆しました。執筆にあたって色々なツール・サービスのお世話になったので、記録を残しておきます。 大まかな流れは、以前の記事に書いたとおりです。ツールの選定は2015年1月頃（textlintとprhは2016年1月頃）に行ったので、現在では状況が変わっているものもあるかもしれません。ご了承ください。 目次 目次 Re:VIEW 採用理由 良いところ 振り返って 作ったものとか textlint 採用理由 良いところ 振り返って 作ったものとか prh 採用理由 良いところ 振り返って goemon 採用理由 良いところ 振り返って GitHub 採用理由 良いところ 振り返って CircleCI 採用理由 良いところ 振り返って まとめ Re:VIEW 原稿の形式は著者の自由とのことでしたので、Re:VIEWで書きました。 Re:VI
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
