Hovercraft-api

このリリースでは、いくつかのバグ修正と改善が行われています。

バグ修正

* LLM API 呼び出しのエラー処理とリトライ機能を改善しました。
* 長すぎるプロンプトが原因で発生するエラーを回避するため、エラー発生時にプロンプトを段階的に短縮してリトライするように変更しました。(9cbc2ef, 0a87c55, 218771d)
* エラー発生時のログ出力を改善し、より詳細な情報を含めるようにしました。 (81a2cb7, fe7469b)

改善

* Gemini API を利用するための環境変数 `GEMINI_API_KEY` を `.env.example` に追加しました。 (99ed71a)
* README に新機能を追加しました。 (47f3346)
* HovercraftAPI の使用ガイドを追加しました。 (696c629)

変更点

* LLM API コールのリトライ遅延を 30 秒から 60 秒に延長しました。 (9cbc2ef)

貢献者

このリリースに貢献してくれた皆様に感謝いたします。

* Maki ([hAru_mAki_ch](https://twitter.com/hAru_mAki_ch))

アップグレード方法

HovercraftAPI を最新バージョンにアップグレードするには、次のコマンドを実行してください。

bash
pip install --upgrade hovercraft-api

新機能

- Mermaid.js ダイアグラムの SVG 変換
- Mermaid.js で記述されたダイアグラムを SVG 形式に変換する機能を追加しました。
- 変換された SVG は、プレゼンテーション HTML に埋め込まれます。
- SVG 変換には `mmdc` コマンドラインツールを使用します。
- ローカル Mermaid SVG プレビューサーバー
- `mermaid_server.py` を使用して、ローカルで Mermaid SVG プレビューサーバーを起動できるようになりました。
- これにより、SVG 変換されたダイアグラムをブラウザで簡単にプレビューできます。

変更点

- `HovercraftAPI` クラスに `svg_css_file` パラメータを追加しました。
- これにより、SVG 変換時に使用する CSS ファイルを指定できます。
- `mermaid_svg_converter.py` に `convert_html_mermaid_to_svg()` 関数を追加しました。
- この関数は、HTML ファイル内の Mermaid.js ダイアグラムを SVG に変換します。
- `mermaid_server.py` を追加しました。
- このスクリプトは、ローカルで Mermaid SVG プレビューサーバーを起動します。
- いくつかのバグ修正と改善を行いました。

修正された問題

- Mermaid.js ダイアグラムを SVG に変換できない問題を修正しました.

既知の問題

- 特になし

アップグレード方法

bash
pip install --upgrade hovercraft-api


開発者向け情報

- `mmdc` コマンドラインツールを使用するようにコードを更新しました。
- SVG 変換とプレビューサーバーの機能を追加しました。

謝辞

今回のリリースにあたり、ご協力いただいた皆様に感謝いたします。


HovercraftAPIの新バージョンv0.2.0がリリースされました。このバージョンでは、動的なスライド配置、Mermaidダイアグラムの改善、そしてユーザビリティの向上に焦点を当てた多くの新機能と改善が行われています。

新機能

1. **動的なスライド位置決め** (6388f62)
- `DynamicRSTAdjuster`クラスを導入し、スライドを3D空間上にランダムに配置する機能を追加しました。
- `--enable-dynamic-position`オプションで有効化できます。

2. **Mermaidダイアグラムのサポート強化** (602537d)
- MermaidダイアグラムをSVGに変換し、HTMLに埋め込む機能を追加。
- 新しい`MermaidSVGConverter`クラスを導入しました。

3. **ローカルMermaid SVGプレビューサーバー** (f7453f8)
- Mermaid SVGをローカルで簡単にプレビューできるHTTPサーバーを追加。

4. **SVGアニメーション機能** (c2049fd)
- SVGファイルにアニメーションを追加する機能を実装。

改善点

1. **Mermaid.jsのスタイルカスタマイズ** (66a4a4f)
- Mermaid.jsで生成される図のスタイルをカスタマイズし、より見やすく洗練されたデザインに改善。

2. **コードブロックの処理改善** (71f90ee)
- Mermaid以外のコードブロックも正しく表示されるように改善。

3. **CLIオプションの拡張** (26c3614)
- 動的な位置決めやグリッドサイズなど、新しいオプションを追加。

バグ修正

1. **スライド区切り文字の修正** (a5e6ee1)
- RSTファイルのスライド区切り文字列を修正し、スライドの正しい分割を実現。

その他の変更

1. **開発環境の改善**
- `.gitignore`ファイルを更新し、生成されたSVGファイルやテストファイルを除外。

2. **ドキュメントの更新**
- `README.md`を更新し、新機能の使用方法や例を追加。

今後の開発

今回のアップデートにより、HovercraftAPIはより柔軟で強力なプレゼンテーションツールとなりました。今後も機能の拡張とユーザビリティの向上に努めてまいります。

ユーザーの皆様からのフィードバックを歓迎いたします。バグ報告や機能リクエストは、GitHubのIssueトラッカーまでお寄せください。



新機能

1. **Markdownからスライドへの変換機能** (d899ee2)
- 入力されたMarkdownテキストを、見やすく整理されたスライド形式のMarkdownに変換します。

2. **Markdownから.rstへの変換機能** (f68b271)
- MarkdownファイルをHovercraftで処理可能な.rst形式に変換します。

3. **Hovercraftによるスライド生成機能** (d4075d1)
- .rstファイルをHTMLスライドに変換します。CSSファイルの指定も可能です。

4. **Mermaid図表の統合機能** (9b6420c)
- Markdown内のMermaidコードをHTMLに埋め込み、Mermaid.jsを使って図を描画します。

5. **コードブロックのシンタックスハイライト機能** (fa3fa2a)
- Markdown内のコードブロックを抽出し、HTMLに埋め込んでシンタックスハイライトを適用します。

6. **スライドキャプチャ機能** (aeef491)
- 生成されたHTMLスライドを画像ファイルとしてキャプチャし、動画作成用の画像シーケンスを生成します。

改善

1. **プロジェクト構造の整備** (7d4410e, 62cbe4a)
- 依存関係の定義やテストディレクトリの作成など、プロジェクト構造を整備しました。

2. **カスタムCSSの追加** (79af706)
- スライドのデザインをカスタマイズするためのCSSファイルを追加しました。

3. **ユーティリティ関数の追加** (9dd4700)
- グリッドサイズやスライドサイズなどの共通定数、スライドの位置をランダムに生成する関数を追加しました。

4. **サンプルコードの追加** (75428f8)
- HovercraftAPIを使用してスライドを生成し、動画を作成するサンプルコードを追加しました。

ドキュメント

1. **READMEの更新** (914b826)
- プロジェクトの機能説明、依存関係、プロジェクト構造、開発環境のセットアップ方法などを追加しました。

2. **使用方法ドキュメントの追加** (6d966f1)
- `usage.md`を追加し、今後詳細な使用方法を記載予定です。

3. **サンプルREADMEの追加** (2adf71f)
- Gemini NanoのAndroidでの使用方法に関する詳細な説明を追加しました。

その他

1. **CI/CD設定の追加** (61747cc, 37067ba, 2b3cde3)
- GitHub Actionsを用いたCI/CDパイプラインを構築し、自動テストとデプロイを設定しました。

2. **リリースノート自動生成設定の追加** (2ca1dd4)
- SourceSageを用いたリリースノート自動生成の設定を追加しました。

既知の問題

現在、既知の重大な問題はありません。

今後の予定

- ダイナミックなトランジションシステムの導入
- 生成されたスライドをPNGに変換する機能の追加
- スライドから動画を生成する機能の強化

このバージョンでは、HovercraftAPIの基本機能が実装され、Markdownからインタラクティブなスライドを簡単に作成できるようになりました。今後のアップデートでは、よりダイナミックなプレゼンテーション体験と、多様な出力形式のサポートを予定しています。引き続きHovercraftAPIの進化にご期待ください。