Satyrographos Package Indexの宣伝

SATySFi Conf 2021 LT資料

Transcript

1. Satyrographos Package Index の宣伝
   matsud224
   SATYSFI Conf 2021
   （2021 年 6 月 26 日）
   1/8
   

   View Slide

2. 自己紹介
   Twitter, GitHub, Slack : @matsud224
   SATYSFI との関わり
   コマンド名などの修正候補サジェスト機能（Did you mean?）
   PDF ハイパーリンク・アウトライン（しおり）対応
   OpenType CFF フォントの部分埋め込み対応
   2/8
   

   View Slide

3. 昨年の SATYSFI Conf にて
   na4zagin3 さん作のパッケージマネージャ"Satyrographos"が発表された
   多くのパッケージが登録されていてとても便利
   欲しいパッケージを探すのが大変
   opam search と opam show コマンドが使えるが …
   「パッケージ一覧サイトが欲しい」との声
   3/8
   

   View Slide

4. Satyrographos Package Index
   https://satyrographos-packages.netlify.app/
   Satyrographos のパッケージ一覧サイト
   2020 年 7 月末に公開
   2021 年 2 月頃大幅にリニューアル
   satyrographos-repo
   （Satyrographos の中央リポジトリ） 収録パッケージが
   対象
   情報は自動更新
   4/8
   

   View Slide

5. Satyrographos Package Index
   5/8
   

   View Slide

6. Satyrographos Package Index の機能
   パッケージ情報表示・検索
   基本情報（概要・リポジトリ URL・作者・メンテナ・ライセンス）
   依存・被依存パッケージ
   収録コマンド（例 : \align, +eqn, \adot）
   収録フォントファイル（例 : NotoSans-Regular.ttf）
   ドキュメント閲覧
   ドキュメントパッケージ（*-doc）のビルド生成物
   スナップショット情報
   SATYSFI Slack の #satyrographos-package-updates チャンネルに更新情報通
   知
   6/8
   

   View Slide

7. 実装について
   GitHub リポジトリ
   https://github.com/matsud224/satyrographos-package-index-v2
   パッケージ情報更新の動作
   1. GitHub Actions ワークフロー開始（6 時間毎のスケジュール）
   2. satyrographos-repo 内の opam ファイルをパースしてパッケージデー
   タベース（JSON）を作成
   3. パッケージデータベースに更新があればコミット・プッシュ
   4. リポジトリへのプッシュを契機に Netlify のデプロイが走る
   5. パッケージデータベースを元に各パッケージのページを Gatsby が生成
   7/8
   

   View Slide

8. おわりに
   要望などあればイシューやプルリクエストをお願いします
   satyrographos-package-index-v2/issues
   8/8
   

   View Slide