Fork me on GitHub

JSer.infoの遊び方

Edit on GitHub 編集履歴を見る

JSer.infoに関連するリポジトリやサイトの案内です。
JSer.info自体はただの情報発信ブログというよりは、見ている人も情報を追加できるし、そのデータを使って遊べるみたいなものを目指しています。

この記事はその辺の仕組みとかツールの紹介です。

新しい情報を見たい

  • JSer.info
    • JSer.infoサイトそのもの
    • 週一回程度で更新
  • Realtime JSer.info
    • JSer.infoのリアルタイム版
    • 元データが追加された時点で更新

コミュニケーションを取りたい

  • Issues · jser/jser.info
    • JSer.infoに関連する意見や要望などを管理するIssue
  • Gitter chat
    • Gitterを利用したチャット
    • Issueを立てるまでもない指摘や感想、疑問、オススメ記事など迷ったらチャットへ

Support - JSer.infoに書いていますが、Gitter chatへ"こんなの書いてみました"とかそういうのも気軽に投げてもらって問題ないです。

データや記事を修正したい

  • jser/jser.info
    • サイトデータを修正したい場合
    • 記事として掲載後に元データを修正しても、自動的には記事へ反映はされません
  • jser/jser.github.io
    • JSer.infoの記事を修正したい場合

記事上部の Edit on GitHub 又は 下部の この記事へ修正リクエストをする から該当記事の編集画面が開けます。

掲載済みの記事へのpull-request

紹介して欲しい記事/サイト/ライブラリがある

JSer.infoに載せて欲しい記事はjser.infoへPull Requestできます。

ただしやっぱり手順が面倒であるので、Gitterを使ってもらっても良いです。

関連: JSer.infoに紹介してもらいたい記事のPull Requestが出来るようになりました - JSer.info

データを分析したい

JSer.infoのデータを分析したい場合はJSON APIとライブラリが用意されています。

の2つのJSONを上手く扱えるjser/stat-jsというライブラリが用意されています。

  • jser/stat-js
    • JSer.infoの掲載データを利用出来る統計処理ライブラリ
    • 特定の期間で紹介した記事一覧の取得、関連記事の検索など
  • JSer.info トレンド
    • jser/stat-jsを使ったキーワードトレンド情報のビューア

素材が欲しい

  • jser/media
    • JSer.infoのロゴやアイコンなどの素材

ライセンス

JSer.infoの記事やデータはCC-BY CC-BYで利用できます。

ソースコードなどはMITライセンスです。


データの自動更新の仕組み

どんな感じで掲載サイトデータなどが更新されているかの仕組みの話です。

サイトデータのマスターはjser/jser.infoで管理されています。
(月ごとにJSONでまとめられています)

jser/jser.infoのデータが更新されると、CIが自動的に以下のリポジトリも更新します。

JSer.infoのマスターはJSONデータで管理されていますが、最近はMarkdown + Yaml Headerで管理しているサイトも増えています。

JSONに比べてMarkdown + Yaml Headerはヒトが見てもわかりやすいのでPull Requestがしやすいです。
(また必然的に1コンテンツ1ファイルとなるので対応がわかりやすい)

この辺のデータの扱い方は今後もっと良くしていくかもしれません。

この記事へ修正リクエストをする
記事を紹介する