Maintainer Month: オープンソースをメンテナンスするコツ
週に一度まとめて更新のようなパターンだと、体調が悪いときなどにその週はスキップされ、また次の週も更新しようとして偶然タイミングが合わなかった場合などに、1ヶ月更新が止まるみたいな状態は起きやすいです。 1ヶ月更新を止めてしまうと、そこで更新する習慣が失われて、この書籍でいう逆戻りが起きるのかなと思っています。 そのため、JSer.infoではタスクを細分化して進められる時にやっていけるような形を作っています。 ライブラリのメンテナンスのリズムをツール化する JavaScript周りは顕著ですが、ライブラリが細かく分かれていることが多いため、リポジトリの数も多いです。 そのため、リポジトリのCI設定や依存ライブラリのアップデートなどをメンテナンスするだけで無限の時間がかかります。 このメンテナンス作業を手動で毎回やるととても疲れるので、自分の場合はツール化していることが多いです。 作ったり、
ミーティングログ/議事録の取り方についてのメモ
この記事はミーティングログの取り方についてのメモです。 以前書いた勉強会でのメモの取り方と似た話です。 勉強会でのメモの取り方について | Web Scratch 自分は書きながら話を聞くのが習慣化しているので、こんな感じでミーティングログ(ミーティングノート)を書いていますという話です。 この記事はメモ書きなのであんまり読みやすくないです。 このログの取り方は正確さログや整形されたログを取る方法ではありません。 2種類のミーティングログ 自分の場合は主に2種類のミーティングログを取ることが多いです。 ミーティングの内容によってどちらで取るのかを使い分けています。 リアルタイムモード 対面、リモートでのミーティング 回想モード ブレスト系のミーティング(JavaScript Primerの出版に関するミーティングなど) この記事ではこの２つのミーティングログの取り方について書いていきます。
JavaScript ASTを使ったツール(自作、ESLint、Babel、jscodeshift)を実装する話
JavaScript ASTを使ったツール(自作、ESLint、Babel、jscodeshift)を実装する話 Dive into ASTというJavaScriptのASTを使ったツールの作り方を見ていく話を書きました。 自作の正規表現、ASTチェックツール、ESLint、Babel、jscodeshiftでそれぞれ動くツールを実装してるので、リポジトリにまとめてあります。 スライドではCode Surferを使ってASTや書き方をインタラクティブに解説しています。 スライド: Dive into AST リポジトリ: azu/dive-into-ast: JavaScriptを中心にしたAST(Abstract Syntax Tree)を使ったツールの作り方についての資料です！ 自作ASTツール、ESLint、Babel、jscodeshift それぞれでASTを使ったツールをどう実装
JXAをTypeScriptでコード補完して書く環境やNode.jsから実行する環境を作った
JXA(JavaScript for Automation)を書いて実行するためにいろいろなパッケージを作りました。 この記事で紹介する内容は次のスライドで発表したものと大体同じです。 スライド: JXA for TypeScript/Node.js リポジトリ: JXA-userland/JXA: JavaScript for Automation(JXA) packages for TypeScript/Node.js. JXAはAppleScriptのJavaScript版(WebKit)のようなもので、macOSにはビルトインされています。 osascript -l javascrript file.jsでJXAを実行できます。 詳しくは次のページで解説されています。 Home · JXA-Cookbook/JXA-Cookbook Wiki [email protected] |
書いた文章をレビューしてGitHubにIssueを切るためのGitBookプラグイン
gitbook-plugin-github-issue-feedbackというGitBookのプラグインを書きました。 次のGIFを見るとどんなものか分かるかもしれません。 gitbook-plugin-github-issue-feedbackはGitBookの右下にBug Reportという雑なボタンを追加します。 このボタンを押すと次のようなことをして該当リポジトリのIssue作成ページを開きます。 選択してる範囲の文字列を取得 現在表示してるページの元ソースであるMarkdownを取得 選択してる文字列がMarkdownの何行目にあるかをposition-map-text-to-markdownで探索 取得した情報を使ってIssueのbodyを埋めた状態でIssueページを開く 次のような感じの情報が入った状態のIssueを作れます。 URL : https://github.co
ルールプリセットを使ってお手軽にtextlint入門
textlintはルールで拡張出来る自然言語向けのLintツールです。 textlint 5.1.0でルールのプリセットをサポートしました。 ルール、プリセット、プラグインは以下のような関係です。 rule いわゆるルール rule-preset ルールをまとめたもの plugin ルールとプロセッサ(拡張機能)を持ってる textlintはデフォルトでは一つもルールを持っていません。 そのため、どのルールを入れたらいいか迷った場合に、誰かがまとめてくれたプリセットをとりあえず入れれば、とりあえず文章のチェックが出来るようになります。 textlintの使い方は以下で解説しているのと基本的に同じですが、今回はプリセットの使い方を紹介します。 textlintで日本語の文章をチェックする | Web Scratch インストール textlint本体と2つのプリセットをインストールしてみます
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.
Living Documentation by design, with Domain-Driven Designを読んだ
Living Documentation by design, with Domain-Driven Designを読んだ Living Documentation by design, with Domain-Driven Design by Cyrille Martraire [PDF/iPad/Kindle]という電子書籍を読んだ。 leanpubで$0から購入できて、任意の値段で購入できるドキュメンテーションとDDDについての書籍。 追記: 書籍版 Amazon.co.jp: Living Documentation: Continuous Knowledge Sharing by Design (English Edition) 電子書籍: Martraire, Cyrille: 洋書 ドキュメンテーションもソフトウェア開発のように設計やテストといったパターンやアプローチがありま
textlintのElectronアプリを作った
textlint-app textlint-appという、インストールするだけで動くtextlintのElectronアプリを作成しました。 インストール方法 https://github.com/textlint/textlint-app/releases/latest からバイナリをダウンロード ダウンロードしたインストーラー（Windows）、app（Mac）を実行すれば動きます。（Node.jsの環境なども不要です） 実行する際に署名されてないバイナリなので警告がでるので、その辺は許可しないと動きません。 Windows: インストーラーで許可を選択する必要がある Mac: /Application/textlint.app をコンテキストメニューから”開く”をして許可する必要がある 特徴 一番の特徴はNode.jsなどの環境を作る必要なくインストールするだけで動く点です。 tex
技術文書を書くためのtextlint校正ルールセット
技術文書向けのtextlintルールプリセットを作りました。 textlint-ja/textlint-rule-preset-ja-technical-writing: 技術文書向けのtextlintルールプリセット 今、書いているjs-primerで使用しています。 元々, JavaScript-Plugin-Architecture: JavaScriptプラグインアーキテクチャの本で実験していたルールをまとめたプリセットになっています。 そのため、実際に適応した状態で書けることは確認した内容がベースです。一部オプションで設定をゆるくしたり、textlint-filter-rule-commentsなどで無視する必要がある部分もありますが、許容範囲な感じでした。 そもそもなんでこういうツールが必要なのかについては以下のスライドを参照してください。 Introduction | 技術文
textlintのルールを簡単に作り始めることができるツールを作りました
textlintはJavaScriptで自由にルールを追加することができる仕組みになっています。 textlintで日本語の文章をチェックする | Web Scratch しかし、普段JavaScriptをあんまり使ってない人にはBabelを使ったコード変換やMochaを使ったテストの設定など、ルールを書き始めるまでの環境づくりの方が大変です。 そのような環境設定をコマンド一発で作れて、textlintルールを作り始めることができるツールを作りました。 create-textlint-rule Scaffolding Tool textlint-scripts BabelやMochaなどのコマンドをラップしたもの 使い方 create-textlint-ruleを npm(Node.jsのパッケージマネージャ)でインストールするだけです。 Node.js(推奨はver6以上)をインストール
#jxck_sushi でserverlessの話をしてきた
#jxck_sushiに参加してきた。 meta-sushi/guideline: Sushiイベントのガイドライン #jxck_sushi - Togetterまとめ 2回目の#jxck_sushiだった。 CROSS 2015 アウトラインメモ | Web Scratch 今回はServerlessを使った匿名でGitHub Issueを立てるAPIを作ったという話をしてきた。 jser/ping: ping! your issusを作ったときに必要だったのAPI Gatewayとlambdaを使ってAPIとして作った話。 Walter TODO: スライドはここに FirebaseとIndexedDBの話 #jxck_sushi 🍣 pic.twitter.com/YcLaJR6dK2 — azu (@azu_re) October 18, 2016 CQRS寿司 #jxck_su
pdf.jsなPDFビューアアプリをElectronで作った
タイトルどおりですが、FirefoxのPDFビューアをスタンドアローン化したようなアプリを作りました。 azu/mu-pdf-viewer: PDF viewer on electron. 特徴は次の通りです。 PDF.jsベース J, Kでスクロールなどいじっています Drag and Dropをサポートしてます Install npm でインストールするか バイナリをダウンロードして使えます(OS Xのみ) https://github.com/azu/mu-pdf-viewer/releases/latest Travis CIとかでelectronを自動ビルドするのがかなり難しくなったので、自分用にOS X版のみバイナリを作ってます。 READMEにその他の環境のバイナリの作り方を書いてあります。 Usage npmでインストールした場合はCLIから起動できます。
performance.markでパフォーマンス計測する
JavaScriptである区間にかかった時間を計測する時に、次のようなコードを書いたことがあると思います。 const start = performance.now(); // 処理 // 色々な処理がすべて終わった doSome(() => { console.log(performance.now() - start); }) Performance Timelineのperformance.markとperformance.measureなどを使うと、ある区間の処理時間をもっと簡単に取ることができます。 APIについて詳しくは以下の記事を見るといいと思います。 User Timing API: あなたの Web アプリをもっと理解するために - HTML5 Rocks Performance.mark() - Web API インターフェイス | MDN 簡単に解説すると perf
Node学園 21時限目でECMAScript as a Living Standardという発表をした
Node学園 21時限目 -ES Modules Meetup-でECMAScript as a Living Standardという発表をしてきました。 スライド: ECMAScript as a Living Standard ECMAScriptの仕様策定は大きなプロジェクトですが、 大部分の作業がGitHub上で見られる形でやり取りされています。 そのため、大きなGitHubプロジェクトとそこまで変わらない感覚で見ることができます。 また標準仕様を作るのでConsensusを取ったり、フォーマルなやり取りもあります。 tc39/proposals: Tracking ECMAScript Proposals tc39/ecma262: Status, process, and documents for ECMA262 tc39/tc39-notes: These are the
textlint + prhで表記ゆれを検出する
proofread-helper proofread-helperは@vvakameさんが作っている文章の校正補助ツールです。(TechBoosterとかの執筆で使っている?らしいです) 機能としては表記ゆれの辞書を指定して、そのルールに則って文章のチェック、また期待する単語への書き換えを行うことができます。 ものすごくざっくり書くと、期待する単語と表記ゆれを補足する正規表現の組み合わせを持った辞書を作ってチェックするような形です。 仕組み的にはazu/technical-word-rulesと殆ど同じですが、辞書をyaml形式で書けたり、辞書内に期待通りに動いているのかの簡単なテストも書くことができます。 なので、辞書の追加や管理がしやすいと思います。 例えば、以下のように辞書を書くことができます。 version: 1 rules: # expectedのみだと 大文字小文字全角半角の
JavaScript Plugin Architectureというプラグイン設計について学ぶ無料の電子書籍を書いた
JavaScript Plugin ArchitectureというJavaScriptのプラグイン設計についての電子書籍を書きました。 この書籍はJavaScriptのライブラリやツールにおけるプラグインアーキテクチャについて見ていく事を目的としたものです。 以下の形式で読むことができます。 Web版 PDF形式 ePub形式 Mobi形式 GitHub上にソースコードも公開されているでので直接Markdownファイルを読むこともできます。 MarkdownよりはWeb版の方が見やすいのでそちらをオススメします。 Twitterのハッシュタグは#js_plugin_book 更新情報はRSSやリリースノートから見ることができます。 v1.0.0 最初に書くと決めたプラグインアーキテクチャが揃ったので1.0.0としてリリースしました。 JavaScript Promiseの本の時と同じく、継
JavaScript ASTを始める最初の一歩
何かJavaScriptのソースコードを機械的にチェックするためのツールを作りたいという場合に、JavaScriptのASTというものを触る必要が出てくると思います。 この記事では、その取っ掛かりとなる案内を簡単にまとめたものです。 ASTとは AST(Abstract Syntax Tree)はコードをパースした抽象構文木のこと。 JavaScriptの場合はJavaScriptオブジェクト(JSON)として表現されます。 コード: { "range": [ 0, 10 ], "type": "Program", "body": [ { "range": [ 0, 10 ], "type": "VariableDeclaration", "declarations": [ { "range": [ 4, 9 ], "type": "VariableDeclarator", "id": {
メモアプリをDayOneからQuiverに移行した
メモアプリとしてEvernote、OneNote、ファイルベースのMarkdown管理アプリ、DayOneなどを使っていました。 EvernoteとOneNoteはメモ機能は強いですが、あんまり気軽に書けるような感じじゃないのでピンときませんでした。 (画像やテーブルは便利ですが、Markdownみたいなプレーンなテキストじゃないのも微妙な点) そのため、ファイルベースのMarkdown管理アプリなどを作ったりしましたが、UIを作りこまないとあんまり使いやすくないということが分かったので、途中で飽きてました。 DayOneは気軽にMarkdownで書けて、iOSアプリもできがいいのは素晴らしいですが、検索機能が微妙でした。 (書くのはいいが、見るのが難しい) 最近Quiverというアプリを見つけて、これを使うようになりました。 AppStore: Quiver: The Programme
npm publishのパターン | Web Scratch
この記事では最近自分が使ってるnpm publishでのモジュール公開のパターンについて紹介します。 npm publishで公開する先は2パターンあるので、以下の2パターンについて書きます。 Public Private(scoped packages) また使用するnpmはv2.7.0以上が対象です。 npm i -g npm するとnpmだけをアップデートできます。 npm publish 先に結論的な今使ってるものを貼っておきます。 zshの関数とaliasですが、基本的にただのコマンドの組み合わせなので大体の環境で動かせる気がします。 (今後gistの方を更新するかもしれないので、記事中に書かれてるものよりgistの方が最新です) 大まかな流れは 事前準備 -> semverでコミット -> push という感じになります。 使い方 npm-patch npm-minor npm
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
